AWS CloudWatch 洞察代理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/aws-cloudwatch-insights-agent。
技能介绍
解决哪些排查痛点
在 AWS 服务运维过程中,Lambda 冷启动异常导致请求超时、API Gateway 延迟突增引发用户体验下降、ECS 容器日志报错影响服务稳定性,这些问题排查往往需要手动编写 CloudWatch Logs Insights 查询语句,不仅耗时还容易遗漏关键指标。本技能通过封装 AWS SDK for JavaScript v3 的查询能力,让开发者无需手动拼写复杂查询语法,即可快速定位上述服务日志中的核心异常,同时支持用数学表达式触发告警,将被动排查转为主动预警。
技能核心能力与工作步骤
技能围绕 CloudWatch Logs Insights 查询展开核心能力:
- 基于
AWS SDK for JavaScript v3构建查询客户端,适配 Node.js 运行环境 - 针对三类高频服务预设分析逻辑:提取 Lambda 冷启动耗时、统计 API Gateway 请求延迟、筛选 ECS 容器日志中的异常堆栈
- 支持通过数学表达式定义告警阈值,例如当冷启动时长超过 1 秒时自动触发告警
工作步骤遵循“客户端创建→查询执行→结果分析→告警生成”流程:先创建对应服务的客户端实例,指定日志组与查询语句,执行查询后解析结果中的异常指标,再根据预设的数学表达式判断是否触发告警。
适用边界与注意要点
本技能依赖 AWS SDK for JavaScript v3 与 Node.js 运行环境,需确保环境中已安装对应 SDK 包并配置 AWS 访问凭证。仅适用于 AWS 生态内的 Lambda、API Gateway、ECS 服务日志分析,不支持其他云服务或本地部署的服务。使用数学表达式生成告警时,需提前明确业务场景中的合理阈值,避免因阈值设置不当导致告警误报或漏报。
使用场景
- Lambda 服务频繁出现请求超时,需要分析冷启动耗时分布并设置异常告警阈值
- API Gateway 生产环境延迟突增,需通过 CloudWatch Logs Insights 定位响应异常的端点
- ECS 集群容器日志中报错增多,需快速筛选关键堆栈并关联到具体服务实例
- 团队需要定期导出 CloudWatch Logs Insights 查询结果,用于周报中的服务健康度复盘
适合人员
- 负责 AWS 服务稳定性的后端工程师,需要快速定位 Lambda、API Gateway 等服务日志中的异常
- 运维团队成员,希望通过自动化查询减少手动编写 CloudWatch Insights 语句的重复工作
- 微服务架构负责人,需要监控 ECS 容器日志并设置合理的异常告警阈值
- Node.js 全栈开发者,需要在项目中集成 AWS SDK for JavaScript v3 进行日志查询与告警