mcpField
L
log-analysis

log-analysis

github.com/aj-geddesクラウド・DevOps373660 回インストール34 週間前に更新
リポジトリ

log-analysis について

アプリケーションログを分析し、デバッグ、監視、根本原因の調査を支援するスキルです。構造化ログ、ログレベル、分析ツール、一般的なクエリを扱います。

主な機能

  1. 01構造化ログのガイド
  2. 02ログレベルとパターンの資料
  3. 03ログ分析ツールの概要
  4. 04一般的な分析クエリの例

活用シーン

  1. 01アプリケーションエラーの調査
  2. 02パフォーマンス問題の調査
  3. 03セキュリティインシデントの分析
  4. 04ユーザー操作の監査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill log-analysis

インストール後、Claude Code で/log-analysisを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
common-log-analysis-queries.md
log-analysis-tools.md
log-levels-patterns.md
structured-logging.md
scripts/
security-checklist.sh

詳細

ログ分析

目次

概要

ログは、デバッグと監視に不可欠です。効果的なログ分析により、問題をすばやく特定し、根本原因を分析できます。

使用する場面

  • エラーのトラブルシューティング
  • パフォーマンスの調査
  • セキュリティインシデントの分析
  • ユーザー操作の監査
  • アプリケーションの健全性の監視

クイックスタート

最小限の動作例：

// Good: Structured logs (machine-readable)
logger.info({
  level: 'INFO',
  timestamp: '2024-01-15T10:30:00Z',
  service: 'auth-service',
  user_id: '12345',
  action: 'user_login',
  status: 'success',
  duration_ms: 150,
  ip_address: '192.168.1.1'
});

// Bad: Unstructured logs (hard to parse)
console.log('User 12345 logged in successfully in 150ms from 192.168.1.1');

// JSON Format (Elasticsearch friendly)
{
  "@timestamp": "2024-01-15T10:30:00Z",
  "level": "ERROR",
  "service": "api-gateway",
  "trace_id": "abc123",
  "message": "Database connection failed",
  "error": {
    "type": "ConnectionError",
    "code": "ECONNREFUSED"
// ... (see reference guides for full implementation)

リファレンスガイド

詳細な実装は references/ ディレクトリにあります：

ガイド内容
構造化ロギング構造化ロギング
ログレベルとパターンログレベルとパターン
ログ分析ツールログ分析ツール
一般的なログ分析クエリ一般的なログ分析クエリ

ベストプラクティス

✅ 実施すること
  • 確立されたパターンと規約に従います
  • クリーンで保守しやすいコードを書きます
  • 適切なドキュメントを追加します
  • デプロイ前に十分にテストします
❌ 避けること
  • テストや検証を省略します
  • エラー処理を無視します
  • 設定値をハードコードします

コメント

Markdown 対応