mcpField
G
gcp-logs-monitoring

gcp-logs-monitoring

github.com/bcremaクラウド・DevOps048 回インストール32 週間前に更新
リポジトリ

gcp-logs-monitoring について

Google Cloud Logging と Cloud Monitoring のデータをターミナルから調べるスキルです。プロジェクトや時間範囲を指定してログと指標を取得し、タイムスタンプを照合して調査を支援します。

主な機能

  1. 01前提条件とプロジェクトアクセスの確認
  2. 02フィルターによる Cloud Logging の検索
  3. 03Cloud Monitoring 時系列データの取得
  4. 04ログと指標のタイムスタンプ照合
  5. 05テーブルまたは JSON 形式での出力

活用シーン

  1. 01Cloud Run や GKE のエラー調査
  2. 02ロードバランサーの HTTP 5xx ログ確認
  3. 03リクエストレイテンシとサービスログの比較
  4. 04仮想マシンの CPU 使用率の確認

インストール

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

$npx skills add https://github.com/bcrema/runwarapp --skill gcp-logs-monitoring

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

同梱ファイル

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

agents/
openai.yaml
scripts/
check_prereqs.sh
read_logs.sh
read_metrics.sh

詳細

目標

ターミナルから Cloud Logging と Cloud Monitoring のデータをすばやく、繰り返し確認します。

収集する入力（不足している場合のみ確認）

  • project_id
  • 調査対象の time_window（例：直近の 30m、2h、または明示的な UTC の start/end）
  • service/resource context（cloud_run_revision、k8s_container、gce_instance、ロードバランサーなど）
  • 関心のある signals（エラー、レイテンシ、CPU、メモリ、リクエスト数、再起動）
  • output_format（すばやく確認する場合は table、詳細に分析する場合は json）

実行ワークフロー

  1. 前提条件を確認します： bash .agents/skills/gcp-logs-monitoring/scripts/check_prereqs.sh --project <project_id>
  2. Cloud Logging にクエリを実行します： bash .agents/skills/gcp-logs-monitoring/scripts/read_logs.sh --project <project_id> --filter '<LOG_FILTER>' --freshness 1h --limit 100 --format json
  3. Cloud Monitoring の時系列データにクエリを実行します： bash .agents/skills/gcp-logs-monitoring/scripts/read_metrics.sh --project <project_id> --filter '<METRIC_FILTER>' --start <UTC_ISO8601> --end <UTC_ISO8601> --format json
  4. ログとメトリクスのタイムスタンプを照合し、考えられる根本原因と次に確認する項目をまとめます。

一般的なフィルターテンプレート

Cloud Logging
  • Cloud Run のエラー： resource.type="cloud_run_revision" severity>=ERROR
  • GKE コンテナーのエラー： resource.type="k8s_container" severity>=ERROR
  • ロードバランサーのログ内の HTTP 5xx： resource.type="http_load_balancer" jsonPayload.statusDetails=~"5.."
  • タイムアウトのテキスト検索： textPayload:"timeout" OR jsonPayload.message:"timeout"
Cloud Monitoring
  • Cloud Run のリクエスト数： metric.type="run.googleapis.com/request_count" AND resource.type="cloud_run_revision"
  • Cloud Run のリクエストレイテンシ： metric.type="run.googleapis.com/request_latencies" AND resource.type="cloud_run_revision"
  • VM の CPU 使用率： metric.type="compute.googleapis.com/instance/cpu/utilization" AND resource.type="gce_instance"

ガードレール

  • グローバルな gcloud 設定を変更するのではなく、各コマンドに --project を指定してください。
  • まず短い期間（15m～2h）を指定し、必要な場合にのみ延長してください。
  • 出力を解析する場合や、複数のソース間で比較する場合は --format json を使用してください。
  • 認証またはプロジェクトの確認に失敗した場合は、まず環境を修正してからクエリを再実行してください。

コメント

Markdown 対応