gcp-monitoring-diagnose

plugin-gcp-monitoring-diagnose

用 gcloud + Cloud Monitoring API 對任意 GCP 專案做被動根因排查的 Claude Code skill。

特色

• 告警驅動:GCP 沒有「列出 open incidents」API,本 skill 重放每條告警的 PromQL/threshold 條件,算出「現在哪些告警正在燒」。
• 下鑽 time series:gcloud CLI 沒有的指標數據能力,以 REST API 補上(uptime、GKE 容器 CPU/記憶體…)。
• 確認後安全修復:身分 guard(擋 service account)+ 動作意圖留痕 + 確認 + GCP audit log 可追溯。

前置需求

• 已安裝並認證 gcloud(個人帳號)
• jq、python3
• 目標 project 具 roles/monitoring.viewer(讀);修復另需對應寫入權限

用法

在 Claude Code 中,描述症狀或請它「排查 的 monitoring」。skill 會:

1. snapshot.sh <project> 掃描告警 → 2. metrics.sh 下鑽 → 3. 報告根因 → 4. 必要時 safe-apply.sh 修復(需確認)。

結構

• skills/gcp-monitoring-diagnose/SKILL.md — playbook
• skills/gcp-monitoring-diagnose/scripts/ — lib.sh / metrics.sh / snapshot.sh / safe-apply.sh
• docs/plans/ — 設計文件與實作計畫