1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | GKE Observability Skill（gke-observability） |
| 作者/维护者 | Google（google/skills 官方仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/gke-observability |
| 许可证 | Apache-2.0（数据来自 GitHub API） |
| GitHub Stars | 18,036（数据来自 GitHub API；为合集仓库整体星数，不代表本技能自身热度） |
| Forks | 1,428（同上，合集仓库整体数据） |
| 最新版本 | 无独立版本号，跟随主分支滚动更新；本技能文档最近一次实质修改于 2026-07-10 |
| 安装方式 | npx skills add google/skills，安装时从交互列表勾选本技能 |
2. 功能介绍与亮点
配置 GKE 集群的可观测性体系：Cloud Logging、Cloud Monitoring、Google Managed Prometheus 三件套的启用与调优，覆盖控制面到工作负载的全链路监控。
亮点：① “黄金路径”默认配置对照表，含易被忽略的控制面指标（API Server 延迟、调度器队列深度）；② 可直接套用的告警阈值表（API 延迟 P99>5s、Pod 10 分钟内重启>5次、GPU 利用率>95% 等）；③ LQL 与 PromQL 常见排障查询范例，覆盖 OOMKilled、调度失败等场景；④ 单列“成本考量”小节，说明各组件计费方式与降本手法。
3. 适用场景
所属分类：DevOps 与基础设施。
面向已在运行 GKE 集群、需建立监控日志基线的 SRE 与后端运维人员：新建集群后配置可观测性、补齐控制面指标缺口、或搭建告警规则时均可使用。不适用于集群创建、故障即时诊断或安全加固——同仓库另有职责边界清晰的独立技能覆盖这几类需求。
4. 跨 Agent 兼容性
Claude Code / Codex / OpenClaw / Hermes Agent：均未验证——SKILL.md 为标准 Agent Skills 格式，指令内容以 gcloud/kubectl 通用命令与可选 MCP 工具调用为主，不绑定特定运行时，但仓库未列出各平台适配说明，如实标注未验证。
5. 推荐理由
GKE 集群“能跑”和“可观测”是两件事：多数团队默认配置下缺少控制面指标与规范告警，出问题时两眼一抹黑。这个技能把 Google 官方的黄金路径可观测性配置、具体告警阈值与常用查询范例打包成一份可直接照做的参考手册，省去东拼西凑文档的过程，并明确标注每项配置的计费影响，便于在成本与覆盖度之间权衡。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google 官方出品；第三方安装统计平台 skills.sh 显示该子技能安装量约 2,400 次，在同仓库 100 余个子技能中处于前列（仅次于安装量 9,200 次的 gke-basics，明显高于多数同仓库子技能的数百至一两千次区间） |
| 可用性 | 9 | 文档给出可直接执行的 gcloud 命令、具体告警阈值表与查询语句范例，无需额外编码；仅依赖用户本就需要的 GKE 集群与已认证的 gcloud/kubectl，无额外付费依赖；本技能文档最近一次实质修改在 2026-07-10，约一个月前 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.3 | 三项均值 |
安全检查清单：①指令内容为配置指导与只读查询命令，无自带可执行脚本，实际执行范围由用户在自己的 gcloud/kubectl 会话中掌控 ②仅连接用户自己项目下的 Cloud Logging/Monitoring，无第三方外发 ③复用已有 gcloud 认证凭据，不新增凭据存储 ④通读全文无可疑指令或隐蔽指示 ⑤Google 官方出品 ⑥License Apache-2.0，明确 ⑦近一个月内有实质更新。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| gke-platform-security（同仓库） | 集群安全加固：RBAC、Binary Authorization、Shielded Nodes | 解决“是否安全”，本技能解决“是否可观测”，两者常配套使用 |
| gke-workload-troubleshooting（同仓库） | Pod 崩溃等故障的即时诊断决策树，可生成修复补丁 | 面向事后救火，本技能面向事前建监控基线，为故障诊断提供数据基础 |
| grafana-oss-grafana-skills（另一仓库） | 通用 Grafana 仪表盘搭建，不限定云平台 | 需自行对接数据源；本技能直接给出 Google Cloud 原生服务的配置细节与 GKE 专属指标 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；skills.sh 收录了安装量数据，但未提供具名评价内容。
9. 其他补充
本技能与同仓库 gke-platform-security、gke-workload-troubleshooting 构成互补组合——分别回答“是否安全”“是否可观测”“出问题怎么办”三个独立问题，三者可按需分别安装。
10. 安装使用方式
运行 npx skills add google/skills 并从交互列表中勾选本技能安装，或手动下载 SKILL.md 放入 Agent 的 skills 目录。安装后无需重启，描述“给 GKE 集群配置监控”“设置 GKE 日志与告警”等诉求即可触发。使用前需已具备可用的 GKE 集群，并预先完成 gcloud/kubectl 的身份认证。
11. 注意事项
内容为配置参考与命令范例，不含自动化脚本，执行前需自行确认命令中的集群名、区域等参数；Cloud Logging/Monitoring/Managed Prometheus 均按量计费，启用全量控制面与自定义指标会产生额外费用，正文附有成本说明与降本命令；分布式追踪与持续性能分析部分标注为非默认项，按需另行评估。