如何基于EC2标签为AWS CloudWatch Agent分配指标维度？

为每台启动的EC2实例分配了特定标签task_type，希望将该标签作为CloudWatch指标的维度，但配置后${aws:ec2:tag:task_type}变量未被替换为实际值，日志无报错，当前配置如下：

"agent": {
  "metrics_collection_interval": 60,
  "logfile": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log"
},
"metrics": {
  "namespace": "CustomEC2",
  "metrics_collected": {
    "mem": {
      "measurement": [
        "mem_used_percent"
      ],
      "metrics_collection_interval": 60
    },
    "disk": {
      "measurement": [
        "used_percent"
      ],
      "metrics_collection_interval": 60,
      "resources": [
        "/tmp"
      ],
      "append_dimensions": {
        "taskType": "${aws:ec2:tag:task_type}"
      }
    }
  }
}

1. 确认IAM权限配置 #

CloudWatch Agent需要读取EC2标签的权限，确保实例关联的IAM角色满足以下任一条件：

• 自定义政策中包含ec2:DescribeTags权限；
• 直接关联AWS托管政策CloudWatchAgentServerPolicy（该政策已包含标签读取所需的全部权限）。

2. 修正配置细节 #

• 标签键大小写敏感：EC2实例上的标签键必须与配置中的task_type完全一致（包括大小写），否则变量无法匹配解析。
• 维度配置范围：如果希望所有收集的指标都带上该维度，将append_dimensions移至metrics层级下（全局生效）；如果仅需给disk指标添加，保留当前位置即可，但需确保JSON格式完整（注意闭合所有大括号）。全局配置示例：

"metrics": {
  "namespace": "CustomEC2",
  "append_dimensions": {
    "InstanceId": "${aws:ec2:instance_id}",
    "taskType": "${aws:ec2:tag:task_type}"
  },
  "metrics_collected": {
    "mem": {
      "measurement": [
        "mem_used_percent"
      ],
      "metrics_collection_interval": 60
    },
    "disk": {
      "measurement": [
        "used_percent"
      ],
      "metrics_collection_interval": 60,
      "resources": [
        "/tmp"
      ]
    }
  }
}

3. 重新加载配置并验证 #

• 执行命令重新加载CloudWatch Agent配置：

amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -c file:/path/to/your/config.json -s

• 验证指标维度：使用AWS CLI查看CustomEC2命名空间下的指标，确认是否包含taskType维度：

aws cloudwatch list-metrics --namespace CustomEC2

4. 额外排查点 #

• 检查Agent版本：旧版本可能不支持标签变量替换，可通过amazon-cloudwatch-agent -version查看版本，必要时更新至最新版；
• 确认实例标签存在：检查EC2实例确实带有task_type标签，且标签值不为空。

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