log-analyzer について
log-analyzerは、アプリケーションやシステムのログを調べるスキルで、障害対応や集計に利用できます。多様な形式の認識、絞り込み、エラー分類、指標抽出を行い、分析レポートを作成します。
主な機能
- 01一般的な形式と独自形式を認識
- 02時間、レベル、出所で絞り込み
- 03類似エラーを分類し頻度を分析
- 04イベントを関連付け因果関係を追跡
- 05ステータスコードと応答時間を集計
- 06ログ分析レポートを作成
活用シーン
- 01本番アプリケーションの異常を調査
- 02期間内のエラーと警告を集計
- 03HTTPステータスコードと応答時間を分析
- 04コンテナやシステムログを報告
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ laolaoshiren/ claude-code-skills-zh --skill log-analyzerインストール後、Claude Code で/log-analyzerを入力して読み込まれたか確認します。
詳細
📋 log-analyzer — ログ分析アシスタント
起動条件
ユーザーが以下の操作を求めた場合に、このスキルを有効にします:
- アプリケーションのログファイル(.log、.txt、journalctl の出力など)を分析する
- 本番環境の問題や異常を調査する
- ログから統計情報を抽出する
- ログ分析レポートを作成する
ワークフロー
1. ログ形式の識別
ログ形式を自動的に検出します:
- 構造化ログ: JSON logs、Logfmt
- 一般的な形式: Nginx/Apache access log、Spring Boot、Django、Rails
- システムログ: syslog、journalctl、Windows Event Log
- カスタム形式: 正規表現を使用してフィールドを抽出
2. ログの前処理
- 時間範囲でフィルタリング(「直近 1 時間」「今日」など)
- ログレベルで絞り込み(ERROR、WARN、INFO、DEBUG)
- 送信元/モジュール/サービスでフィルタリング
- 重複を除去し、類似するエラーを集約
3. 異常パターンの検出
- エラーのクラスタリング: 類似するエラーをグループ化し、重複した分析を避けます
- 頻度分析: 頻出するエラーや突発的な異常を特定します
- 時間的な関連性: エラーが特定のイベント(デプロイ、トラフィックのピーク)に関連しているかを検出します
- 因果関係の追跡: 根本原因となるエラーから最終的な現象まで追跡します
4. 重要情報の抽出
- エラースタックの分析(ソースコードの位置を特定)
- HTTP ステータスコードの分布(4xx/5xx の割合)
- 応答時間の統計(P50/P95/P99)
- メモリ/CPU の異常指標
5. 分析レポートの作成
## 📊 日志分析报告
### 概览
- 时间范围: 2024-01-15 10:00 ~ 12:00
- 总日志量: 12,847 条
- 错误数: 234 (1.8%)
- 警告数: 567 (4.4%)
### Top 5 异常
| 排名 | 错误类型 | 次数 | 首次出现 | 最近出现 |
|------|---------|------|---------|---------|
| 1 | NullPointerException | 89 | 10:15 | 11:42 |
| 2 | ConnectionTimeout | 67 | 10:23 | 11:58 |
### 根因分析
最可能的原因:数据库连接池耗尽(线索:连续出现 ConnectionTimeout 后跟大量 NullPointerException)
### 建议
1. 检查数据库连接池配置(当前可能 maxActive 太小)
2. 排查是否存在连接泄漏
3. 添加连接池监控告警
対応するログのソース
- ファイルシステムのログ(*.log)
- Docker/Kubernetes のコンテナログ
- journalctl のシステムログ
- AWS CloudWatch / GCP Logging
- ELK Stack(Elasticsearch のクエリ結果)
- アプリケーションが直接出力したテキスト
注意事項
- 機密情報をマスキングします(パスワード、token、電話番号など)
- メモリ不足を避けるため、大きなファイルは分割して処理します
- タイムゾーンを統一して処理します
- ログに存在しない情報を捏造しないでください
コメント
Markdown 対応