AWS CloudWatch Dashboard CLI部署：Lambda SEARCH表达式失效问题排查

核心排查方向 #

1. 指标命名空间与维度的大小写/拼写问题 #

CloudWatch的命名空间和维度键严格区分大小写：

• Lambda的标准命名空间是AWS/Lambda，别写成AWS/lambda或其他变体；
• Lambda常用维度是FunctionName，如果表达式里写成functionname会直接匹配失败。
  对比Connect的有效表达式，检查Lambda相关的命名空间、维度名是否完全符合官方规范。

2. 验证Lambda指标的实际存在性 #

先通过CLI确认目标指标是否真的存在：

aws cloudwatch list-metrics --namespace AWS/Lambda --metric-name Invocations

如果返回结果里没有你要监控的Lambda函数指标，要么是函数还没产生对应数据，要么是维度参数错误。同时检查时间范围，Lambda的部分指标需要一定时间聚合，Dashboard配置里的period和时间范围是否覆盖了指标产生的时段。

3. SEARCH表达式的JSON转义问题 #

在Dashboard的JSON配置中，SEARCH表达式里的双引号必须转义，否则会导致JSON解析失败：
错误示例：

["SEARCH", "{AWS/Lambda,FunctionName} MetricName="Invocations"", "Sum", 300]

正确示例：

["SEARCH", "{AWS/Lambda,FunctionName} MetricName=\"Invocations\"", "Sum", 300]

可以用jq工具验证JSON语法是否合法：

cat your-dashboard-config.json | jq .

如果报错，先修复JSON格式问题。

4. 聚合函数与指标兼容性 #

Lambda的部分指标对聚合函数有要求，比如Invocations用Sum合理，但如果用Average可能没有实际意义，甚至CloudWatch不支持该聚合方式。对比Connect的有效表达式里的聚合函数，确认Lambda指标使用的聚合是否符合官方文档要求。

5. IAM权限的针对性检查 #

虽然Connect指标能正常查询，但运行CLI的IAM身份可能缺少Lambda指标的权限：

• 确保权限策略包含cloudwatch:GetMetricData和cloudwatch:ListMetrics动作，且资源覆盖arn:aws:cloudwatch:*:*:metric/AWS/Lambda/*。

内容的提问来源于stack exchange，提问作者Stephen Smith