1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | cloud-monitoring-alert-configuration-google-skills |
| 作者/维护者 | Google(官方) |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/cloud-monitoring-alert-configuration |
| 许可证 | Apache-2.0 |
| GitHub Stars / Forks | 21,805 / 1,861(所属仓库整体数字,不代表本技能自身热度;GitHub API,2026-11-07 读取) |
| 最新版本 | 技能内标注 1.0.0;仓库主分支最近一次提交 2026-11-06 |
| 安装方式 | 把技能目录复制进 agent 的 skills 目录;命令经 gcloud/API 执行 |
数据来源:上述数字取自 GitHub API;功能与评分依据来自技能正文与官方文档。
2. 功能介绍与亮点
一句话:用 Terraform 与 PromQL 写 Cloud Monitoring 的告警策略,覆盖 Cloud Run、GKE、Compute Engine、AI 预留与 Vertex AI 等场景。
- 按场景给模板:延迟、流量、错误率、饱和度四类黄金信号,以及主机/预留维护、GPU XID、AI agent 遥测。
- Terraform 优先:告警策略以代码形式管理,可评审、可复用、可回滚。
- PromQL 辅助:需要自定义指标时给出查询写法,并提醒与告警窗口、静默规则的配合。
- 去重与迁移:帮助识别重复策略、从旧配置迁移,避免同一条告警在多个策略里重复触发。
- 边界清楚:只写 PromQL 不配告警、查日志、审账单,都不在本技能范围内。
3. 适用场景
所属分类:DevOps 与基础设施。
- 要把告警策略从控制台点击改成 Terraform 代码的 SRE;
- 新服务上线,需要一套延迟/错误率/饱和度的标准告警;
- GPU 或预留实例维护、XID 报错需要专门的告警;
- 告警太多太吵,想做去重与分级的人。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,按描述触发 |
| Codex | 需适配 | 技能正文通用,Terraform 与 gcloud 调用需按平台调整 |
| OpenClaw | 需适配 | 需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
告警的难点不是「配一条」,而是「配得对且不吵」:窗口多长、阈值多少、同类资源要不要合并。这份技能按服务类型给出策略模板与去重思路,并把 Terraform 作为首选载体——对准备把监控配置纳入代码评审的团队,这比在控制台里点更可靠。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方出品;所属仓库 21,805 stars 是整个合集热度,不代表本技能自身热度 |
| 可用性 | 8 | 模板与查询写法完整;前置是 GCP 项目、gcloud 与 Terraform 环境 |
| 安全性 | 9 | 见下方清单;官方开源,命令范围限于用户自己的项目 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 通过 gcloud 与 Terraform 操作用户自己的项目 |
| ② 联网外发 | 只与 Google Cloud 端点通信,目标透明 |
| ③ 凭据 | 使用既有 gcloud/服务账号凭据,不要求写进对话 |
| ④ 可疑指令 | 未见注入或夹带推广 |
| ⑤ 作者信誉 | Google 官方仓库,Apache-2.0 |
| ⑥ License | Apache-2.0,全文可查 |
| ⑦ 维护时间 | 2026-11-06 仍在更新 |
扣分点:需要真实的 GCP 项目与监控数据才能验证阈值是否合理。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| cloud-monitoring-notification-channels-configuration | 通知渠道配置 | 管「告警发给谁」;本技能管「什么条件触发」 |
| compute-future-reservations | 未来预留实例 | 管容量预定;本技能管容量与维护的告警 |
| k8s-investigation-elastic-agent-skills | K8s 故障调查 | 事后排查;本技能是事前设防 |
核心差异:同类或管通知、或管容量、或管事后调查,它专管告警策略本身的写法与去重。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价(2026-11-07)。
9. 其他补充
- 技能内容整合自 Cloud Run、GKE、Compute Engine 与 Vertex AI 的告警最佳实践。
- 属于
google/skills合集(180 个技能),可按需只装这一条。
10. 安装使用方式
git clone https://github.com/google/skills
mkdir -p ~/.claude/skills
cp -r skills/skills/cloud/cloud-monitoring-alert-configuration ~/.claude/skills/
装好后说「给这个 Cloud Run 服务配一套告警:延迟、错误率、实例饱和度,写成 Terraform」,它会按模板给出策略。
11. 注意事项
- 阈值要结合真实监控数据调,模板只给起点。
- Terraform 变更前先 plan,确认不会误删既有策略。
- 告警窗口与静默规则要一起设计,否则容易吵。
- 需要 GCP 项目与相应权限。