Grafana中CloudWatch自定义命名空间指标名称无法显示问题咨询

排查&解决步骤 #

• 校验自定义命名空间填写格式
  CloudWatch命名空间完全大小写敏感，Namespaces of Custom Metrics字段内填写的命名空间必须和CloudWatch控制台显示的名称完全一致，不能带前后空格、大小写偏差、多余特殊字符。多个自定义命名空间用英文逗号分隔，不要添加换行或中文标点。
• 补全IAM角色权限
  如果EC2绑定的IAM角色限制了仅能访问AWS/开头的官方命名空间，会直接导致自定义指标列表拉取失败。修改角色对应的CloudWatch权限策略，在Resource字段加入自定义命名空间的ARN，参考配置片段：

  {
    "Effect": "Allow",
    "Action": "cloudwatch:ListMetrics",
    "Resource": [
      "arn:aws:cloudwatch:*:*:namespace/AWS/*",
      "arn:aws:cloudwatch:*:*:namespace/替换为你的自定义命名空间全称"
    ]
  }
  

  注意不要给cloudwatch:ListMetrics权限加额外的条件限制，否则会拦截自定义指标的拉取请求。
• 调整自定义指标拉取时间范围
  Grafana对AWS官方命名空间内置了全量指标缓存，因此无论指标是否有近期数据都能正常显示；但对自定义命名空间，Grafana会实时调用CloudWatch的ListMetrics接口拉取列表，默认仅返回最近72小时（3天）内有数据上报的指标。如果你的自定义指标上报间隔长、最近3天没有数据上报，就不会出现在下拉选项中：
  1. 进入CloudWatch数据源配置页
  2. 找到Custom Metrics配置区块，将List metrics from the last的时间范围调大到7天或30天
  3. 保存数据源配置后刷新查询页面重试
• 排查版本兼容问题
  7.0以下版本的Grafana处理包含/、.等特殊字符的自定义命名空间时存在转义bug，会导致指标列表拉取失败，升级到8.0以上的稳定版本即可修复。

验证方法 #

如果调整完配置后下拉列表仍未加载选项，直接在指标名称输入框手动输入已知存在的指标名，选择对应维度后发起查询，若能正常返回数据说明核心链路配置正常，等待5-10分钟让Grafana完成CloudWatch指标列表同步即可。

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