1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | aws-cloudwatch-investigation | —— |
| 作者/维护者 | github/awesome-copilot 社区贡献(提交者 Sukanth Gunda、Mammon Baloch) | GitHub API |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/aws-cloudwatch-investigation | —— |
| 许可证 | MIT | GitHub API |
| GitHub Stars/Forks | 39,435 / 5,009(该数字属整个合集仓库,不代表本技能自身热度) | GitHub API |
| 最新版本 | 未标注独立版本号,最近一次内容更新为 2026-06-29 | GitHub API |
| 安装方式 | GitHub CLI 或手动复制目录 | —— |
2. 功能介绍与亮点
这是一套面向 AWS CloudWatch 的生产事件排查参考手册,把“遇到告警后该查什么”整理成五组可直接套用的模式:
- Logs Insights 查询模板:错误突增定位、P99 延迟按操作拆解、Lambda 冷启动统计、内存溢出(OOM)检测、超时检测,每条都是可直接粘贴执行的完整查询语句;
- 告警→部署事件关联:给出从告警触发时间反查 CloudTrail 部署事件的具体查询与“强关联”判定标准(同资源、CI/CD 身份、15 分钟窗口内完成);
- 影响范围缩小决策树:按账号→区域→服务→操作→资源五层逐步收窄排查范围,并给出共享依赖(VPC/IAM/下游服务/部署管线/AWS 侧故障)的排查顺序;
- PromQL 风格指标查询:错误率、延迟异常对比基线、限流压力、并发余量四类复合指标的 CloudWatch Metric Math 写法;
- 事件时间线重建:汇总告警、指标、日志、CloudTrail、AWS Health 五类时间源的取数方式,并列出常见的时间戳陷阱(指标时间戳是周期末尾、CloudTrail 有最多 15 分钟投递延迟等)。
亮点是内容颗粒度落到“可直接执行的查询语句”而非泛泛的排查思路,且每类模式都配了输出示例,降低了值班工程师现场现编查询的门槛。
3. 适用场景
所属分类:DevOps 与基础设施
面向使用 AWS CloudWatch 做可观测性的团队,典型场景:
- 值班/SRE 收到 CloudWatch 告警后,需要快速定位是哪次部署引发的问题;
- 排查 Lambda 冷启动、内存溢出、超时等具体故障模式,但记不住对应的 Logs Insights 查询写法;
- 跨账号/跨服务的复杂事件需要系统性缩小排查范围,而不是逐个资源排查;
- 事故复盘前需要把告警、日志、部署、AWS 侧事件拼成一条完整时间线。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准 SKILL.md,符合 Agent Skills 规范,可直接放入 .claude/skills/ |
| Codex | ⚠️ 需适配 | Codex 不会自动发现 ~/.codex/skills 下的技能,需在提示词中手动引用技能路径 |
| OpenClaw | ✅ 原生支持 | 按目录扫描机制探测子目录下的 SKILL.md,可直接识别 |
| Hermes Agent | ✅ 原生支持 | 同样按路径扫描子目录探测 SKILL.md,原生识别 |
5. 推荐理由
排查 AWS CloudWatch 故障时最耗时的往往不是“看数据”而是“想清楚该查哪张表、写什么查询”——这份技能把五类最常用的排查动作(错误定位、部署关联、范围缩小、指标复合分析、时间线重建)都写成了拿来即用的查询语句和判定标准,且完全不需要额外配置或凭据,装上就能用,特别适合刚接触 CloudWatch 排障、还没积累一套自己的查询库的用户。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 所属合集仓库 39,435 星,该数字属整个合集,不代表本技能个体热度;未检索到该技能自身的独立第三方评价 |
| 可用性 | 9 | 单文件即可用,无需 API key、无外部依赖;五组模式均含可直接执行的查询语句与输出示例,并附时间戳陷阱等实操细节;仓库持续活跃维护 |
| 安全性 | 9 | 纯参考型技能,不含可执行脚本;涉及的全部操作均为只读查询(Logs Insights、CloudTrail Lake、GetMetricData),无凭据存储与外发行为 |
安全检查清单:① 无 shell 命令执行,仅提供查询语句文本 ② 无联网外发 ③ 不涉及 API key/凭据 ④ 未发现可疑指令 ⑤ 合集仓库社区贡献,个人提交者信誉未见异常 ⑥ License 明确(MIT) ⑦ 仓库整体持续活跃维护
综合评分:(7+9+9)/3 ≈ 8.33
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| incident-postmortem(同合集) | 事故复盘文档生成 | 聚焦事后复盘产出物,不含具体排查时用的查询语句 |
| grafana / alerting-irm(Grafana 生态) | 告警配置与 Grafana 生态运维 | 聚焦告警本身的搭建与管理,不是事中排查手册 |
| redis-observability | Redis 专属可观测性排障 | 限定在 Redis 数据存储场景,不覆盖 Lambda/API Gateway 等计算侧故障 |
本技能的差异化在于专门针对 AWS CloudWatch 生态、且把查询语句写到可直接复制执行的程度,而非停留在流程建议层面。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;检索到的第三方站点(如技能聚合目录)均为该合集的自动化镜像列表,未见独立评测或使用反馈。
9. 安装使用方式
渠道一:GitHub CLI(v2.90.0+):gh skills install github/awesome-copilot aws-cloudwatch-investigation
渠道二:手动复制 skills/aws-cloudwatch-investigation/ 整个目录到本地 agent 的技能目录(如 .claude/skills/)。
基本用法:技能安装后无需重启 agent;使用时直接向 agent 描述当前故障现象(如“CloudWatch 告警 XXX 触发了,帮我查是不是最近的部署导致的”),agent 会引用技能内对应的查询模板生成具体的 CloudWatch Logs Insights / CloudTrail 查询语句,需要用户自行在已配置好凭据的 AWS CLI 或控制台中执行。
10. 注意事项
- 技能本身不执行任何查询,只提供查询语句与判断逻辑,实际执行仍需用户具备 AWS CloudWatch/CloudTrail 的读取权限;
- 查询模板基于 Lambda/API Gateway/DynamoDB 等常见资源类型编写,覆盖其他 AWS 资源类型(如 ECS、RDS 特有指标)需自行调整;
- 使用前建议留意文档中列出的时间戳陷阱(指标周期末尾对齐、CloudTrail 投递延迟等),避免据此得出错误的事件时序结论。