mcpField
L
log-analyzer

log-analyzer

github.com/laolaoshirenクラウド・DevOps90089 回インストール4 日前に更新
リポジトリ

log-analyzer について

log-analyzerは、アプリケーションやシステムのログを調べるスキルで、障害対応や集計に利用できます。多様な形式の認識、絞り込み、エラー分類、指標抽出を行い、分析レポートを作成します。

主な機能

  1. 01一般的な形式と独自形式を認識
  2. 02時間、レベル、出所で絞り込み
  3. 03類似エラーを分類し頻度を分析
  4. 04イベントを関連付け因果関係を追跡
  5. 05ステータスコードと応答時間を集計
  6. 06ログ分析レポートを作成

活用シーン

  1. 01本番アプリケーションの異常を調査
  2. 02期間内のエラーと警告を集計
  3. 03HTTPステータスコードと応答時間を分析
  4. 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、電話番号など)
  • メモリ不足を避けるため、大きなファイルは分割して処理します
  • タイムゾーンを統一して処理します
  • ログに存在しない情報を捏造しないでください

コメント