Prometheus CloudWatch Exporter配置后部分指标无法采集问题求助

1. IAM权限校验 #

确认Exporter使用的IAM角色/访问密钥是否拥有以下全量权限，若权限规则对指标命名空间、指标名称做了限制，会直接导致限定范围外的指标拉取失败：

{
    "Effect": "Allow",
    "Action": [
        "cloudwatch:GetMetricStatistics",
        "cloudwatch:ListMetrics"
    ],
    "Resource": "*"
}

2. 维度匹配校验 #

你配置的指标维度需要和CloudWatch中实际存储的指标维度完全一致，任意属性不匹配都会返回空数据：

• ALB类指标的LoadBalancer维度值格式必须为app/负载均衡自定义名称/随机后缀，不能仅填写负载均衡的自定义名称
• RequestCountPerTarget的TargetGroup维度值格式必须为targetgroup/目标组名称/随机后缀，格式错误会无法匹配到对应指标
• 可先登录AWS CloudWatch控制台手动查询对应指标，确认你填写的维度组合确实存在历史监控数据

3. 统计类型适配校验 #

部分CloudWatch指标仅支持特定统计类型，若配置了不支持的统计类型，AWS会直接返回空值：

• 比如HTTPCode_ELB_5XX_Count属于计数类指标，默认适配Sum统计，你当前配置的Average统计可能无返回
• 可在CloudWatch指标详情页确认对应指标支持的统计类型列表，再调整配置中的aws_statistics参数

4. 采集周期适配校验 #

CloudWatch Exporter默认采集周期如果短于CloudWatch指标的生成周期，也会出现空数据：

• 建议在Exporter启动参数中添加--cloudwatch-scrape-interval 60s，和AWS基础监控的最小粒度对齐
• 针对ELB这类指标生成延迟较高的服务，可额外添加--cloudwatch-get-metric-data-round-to-period启动参数，避免跨周期拉取返回空值

5. 运行日志排查 #

直接查看CloudWatch Exporter的运行日志，搜索缺失指标名称对应的报错信息，日志中会直接返回AWS API的明确错误提示（比如权限不足、维度不存在、无数据返回等），可快速定位根因。

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