管理受监控的标签键

借助 Amazon EC2 容量管理器，您可以从 Amazon EC2 资源（例如 environment 或 team）中选择标签键，以便在分析容量数据时用作维度。标签键激活后，您就可以像按区域、实例类型或可用区一样，按该标签的值对指标进行分组和筛选。

每个账户最多可以监控五个标签键。容量管理器提供的标签不计入此限额。

容量管理器提供的标签

容量管理器为每个账户提供一组默认标签。这些标签不计入标签键限额。容量管理器提供的标签代表常用的分组维度，包括：

容量管理器提供的标签在 GetCapacityManagerMonitoredTagKeys 中显示，且 CapacityManagerProvided 设置为 true，客户无法将其激活或停用。首次启用容量管理器时，容量管理器提供的标签将以 activating 状态开始，并在容量管理器收到包含容量管理器提供标签的第一个数据点后（通常在一到两小时内）转换为 activated 状态。

标签生命周期

受监控的标签键会经历以下状态：

当标签处于 suspended 状态时，GetCapacityManagerMonitoredTagKeys 会返回以下状态消息：“标签因标签值过多而暂停。请减少该标签的使用量或将其停用。”

激活和停用受监控的标签键

您可以激活标签键以开始将其作为维度进行监控，也可以停用不再需要的标签键。激活是异步的，标签会进入 activating 状态，并在容量管理器开始接收该标签的数据后转换为 activated 状态。停用之后，标签键将从受监控集中移除。

Console

激活或停用受监控的标签键

1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

2. 在导航窗格中，选择容量管理器。

3. 选择设置选项卡。

4. 在受监控的标签键部分中，选择管理标签键。

5. 要激活标签键，请输入标签键名称，然后选择添加。要停用标签键，请选择该标签键，然后选择移除。

6. 选择保存更改。

AWS CLI

激活标签键

使用以下命令激活一个或多个标签键：

aws ec2 update-capacity-manager-monitored-tag-keys \
    --activate-tag-keys "environment" "teamId"
                

输出显示了标签键及其初始状态：

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "environment",
            "Status": "activating"
        },
        {
            "TagKey": "teamId",
            "Status": "activating"
        }
    ]
}

停用标签键

使用以下命令停用一个或多个标签键：

aws ec2 update-capacity-manager-monitored-tag-keys \
    --deactivate-tag-keys "project"
                

输出显示了更新后的状态：

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "project",
            "Status": "deactivating"
        }
    ]
}

您可以在同一个请求中同时激活和停用标签键：

aws ec2 update-capacity-manager-monitored-tag-keys \
    --activate-tag-keys "environment" "teamId" \
    --deactivate-tag-keys "project"
                

查看受监控的标签键

您可以查看账户中所有受监控的标签键，包括其当前状态以及数据可用的最早时间戳。

Console

查看受监控的标签键

1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

2. 在导航窗格中，选择容量管理器。

3. 选择设置选项卡。

4. 在受监控的标签键部分，查看标签键及其状态，以及它们是否为容量管理器提供的标签。

AWS CLI

查看受监控的标签键

运行如下命令：

aws ec2 get-capacity-manager-monitored-tag-keys
                

输出列出了所有标签键，包括容量管理器提供的标签和客户自主管理型标签：

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "aws:autoscaling:groupName",
            "Status": "activated",
            "CapacityManagerProvided": true,
            "earliestDatapointTimestamp": "2026-04-08T00:00:00"
        },
        {
            "TagKey": "environment",
            "Status": "activated",
            "CapacityManagerProvided": false,
            "earliestDatapointTimestamp": "2025-08-11T22:00:00"
        }
    ]
}

CapacityManagerProvided 字段指示标签是容量管理器提供的标签 (true) 还是客户自主管理型标签 (false)。容量管理器提供的标签不计入标签键限额。EarliestDatapointTimestamp 指示该标签键数据可用的最早时间点。

使用标签维度查询指标

标签键达到 activated 状态后，您可以在 GetCapacityManagerMetricDimensions 和 GetCapacityManagerMetricData 中将其用作维度。

按标签维度分组查询指标

使用以下命令：

aws ec2 get-capacity-manager-metric-dimensions \
    --group-by tag:environment account-id \
    --filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[prod]}'
          

当您按标签维度分组时，结果将包含账户中的所有资源，而不仅仅是带有标签的资源。没有为该标签设置值的资源将分组到一个单独的存储桶中，其值为空字符串。例如，如果账户在特定时段内使用了 800 个 vCPU 小时，但只有部分资源带有 environment 标签，则按 environment 标签键分组可能会返回：

这样可以确保所有存储桶的总量可以计入全部使用量。可以通过传递空字符串作为筛选值，以显式筛选未标记的资源：

--filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[""]}'
          

数据导出中的标签

启用标签监控后，数据导出会将已激活的标签键和容量管理器提供的标签作为附加列包含在内。标签列会在所有标准列（具有 tag:environment 和 tag:team 等标题）之后显示。标签列按字母顺序排序。

导出仅包含处于 activated 状态的标签。容量管理器会排除处于 activating、deactivating 或 suspended 状态的标签。

组织和委托管理员

如果账户属于已启用组织级别容量管理器的 AWS Organizations，每个账户（组织管理员和委托管理员）都将可以独立激活、停用和查询标签键。每个账户都需维护自己的标签状态、EarliestDatapointTimestamp 和标签键限额。

账户只能查询其自身已激活的标签键的指标数据。如果组织管理员和委托管理员都激活了同一个标签键（例如 environment），则每个账户将独立跟踪自己的激活状态和数据可用性。

当委托管理员停用某个标签键后，即使组织管理员仍激活了同一个标签键，该委托管理员也无法再查询该标签的数据。

注意事项