Gerenciar chaves de tag monitoradas

O Amazon EC2 Gerenciador de Capacidade permite selecionar as chaves de tag dos recursos do Amazon EC2 (por exemplo, environment ou team) para usar como dimensões ao analisar os dados de capacidade. Depois que uma chave de tag é ativada, você pode agrupar e filtrar as métricas pelos valores dessa tag, exatamente como acontece com Região, Tipo de instância ou Zona de disponibilidade.

Cada conta pode monitorar até cinco chaves de tag. As tags fornecidas pelo Gerenciador de Capacidade não contam para esse limite.

Tags fornecidas pelo Gerenciador de Capacidade

O Gerenciador de Capacidade inclui um conjunto de tags padrão para toda conta. Essas tags não contam para os limites de tags. As tags fornecidas pelo Gerenciador de Capacidade representam dimensões de agrupamento usadas frequentemente e incluem:

As tags fornecidas pelo Gerenciador de Capacidade aparecem em GetCapacityManagerMonitoredTagKeys com CapacityManagerProvided definidas como true e não podem ser ativadas nem desativadas pelo cliente. A primeira vez que o Gerenciador de Capacidade é ativado, as tags fornecidas pelo Gerenciador de Capacidade estão no status activating e passam para activated depois que o Gerenciador de Capacidade recebe o primeiro ponto de dados que inclui uma tag fornecida pelo Gerenciador de Capacidade, normalmente dentro de uma a duas horas.

Ciclo de vida da tag

As chaves de tag monitoradas avançam pelos seguintes status:

Quando uma tag está no status suspended, GetCapacityManagerMonitoredTagKeys retorna a seguinte mensagem de status: “Tag suspensa devido a muitos valores de tag. Reduza o uso da tag ou desative-a.”

Ativar e desativar chaves de tag monitoradas

É possível ativar as chaves de tag para começar a monitorá-las como dimensões ou desativar as chaves de tag que não são mais necessárias. A ativação é assíncrona: a tag entra em um estado activating e passa para activated depois que o Gerenciador de Capacidade começa a receber dados dessa tag. A desativação remove a chave de tag do conjunto monitorado.

Console

Para ativar e desativar chaves de tag monitoradas

1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, selecione Capacity Manager.

3. Escolha a guia Configurações.

4. Na seção Chaves de tag monitoradas, escolha Gerenciar chaves de tag.

5. Para ativar uma chave de tag, insira o nome da chave de tag e escolha Adicionar. Para desativar uma chave de tag, selecione a chave de tag e escolha Remover.

6. Escolha Salvar alterações.

AWS CLI

Para ativar chaves de tag

Use o seguinte comando para ativar uma ou mais chaves de tag:

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

A saída mostra as chaves de tag e seus status iniciais:

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

Para desativar chaves de tag

Use o seguinte comando para desativar uma ou mais chaves de tag:

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

A saída mostra os status atualizados:

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

Você pode ativar e desativar chaves de tag na mesma solicitação:

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

Visualizar as chaves de tag monitoradas

Você pode visualizar todas as chaves de tag monitoradas da sua conta, incluindo seu status atual e o timestamp de quando os dados estão foram disponibilizados a primeira vez.

Console

Para visualizar as chaves de tag monitoradas

1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, selecione Capacity Manager.

3. Escolha a guia Configurações.

4. Na seção Chaves de tag monitoradas, visualize as chaves de tag, seus status e se elas são tags fornecidas pelo Gerenciador de Capacidade.

AWS CLI

Para visualizar as chaves de tag monitoradas

Execute o seguinte comando:

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

O resultado lista todas as chaves de tag, incluindo as tags fornecidas pelo Gerenciador de Capacidade e as tags gerenciadas pelo cliente:

{
    "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"
        }
    ]
}

O campo CapacityManagerProvided indica se uma tag é fornecida pelo Gerenciador de Capacidade (true) ou gerenciada pelo cliente (false). As tags fornecidas pelo Gerenciador de Capacidade não contam para o limite de chaves de tag. O EarliestDatapointTimestamp Indica quando os dados foram disponibilizados para essa chave de tag a primeira vez.

Métricas de consulta usando dimensões de tag

Depois que uma chave de tag atinge o status activated, você pode usá-la como uma dimensão em GetCapacityManagerMetricDimensions e GetCapacityManagerMetricData.

Para consultar métricas agrupadas por uma dimensão de tag

Use o seguinte comando:

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

Quando você agrupa por uma dimensão de tag, os resultados incluem todos os recursos da sua conta, não apenas os que têm a tag. Os recursos que não têm um valor para a tag são agrupados em um bucket separado com um valor de string vazio. Por exemplo, se sua conta tivesse usado 800 horas de vCPU em um determinado período e apenas alguns desses recursos tivessem uma tag environment, o agrupamento pela chave de tag environment poderia retornar:

Isso garante que os totais de todos os buckets incluam seu uso total. Você pode filtrar explicitamente por recursos sem tag passando uma string vazia como o valor de filtro:

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

Tags em exportações de dados

Quando você habilita o monitoramento de tags, as exportações de dados incluem as chaves de tag ativadas e as tags fornecidas pelo Gerenciador de Capacidade como colunas adicionais. As colunas de tags aparecem depois de todas as colunas padrão com títulos como tag:environment e tag:team. As colunas de tags são classificadas em ordem alfabética.

As exportações incluem apenas as tags com o status activated. O Gerenciador de Capacidade exclui as tags com o status activating, deactivating ou suspended.

Organizações e administrador delegado

Quando sua conta faz parte de uma organização da AWS com um Gerenciador de Capacidade de nível organizacional habilitado, cada conta (a conta de administrador da organização e de administrador delegado) pode ativar, desativar e consultar chaves de tag de modo independente. Cada conta mantém o seu próprio status da tag, EarliestDatapointTimestamp e limite de chaves de tag.

Uma conta pode consultar apenas os dados de métricas das chaves de tag que ela mesma ativou. Se o administrador da organização e um administrador delegado ativarem a mesma chave de tag (por exemplo, environment), cada conta rastreará seu próprio status de ativação e disponibilidade de dados de forma independente.

Quando o administrador delegado desativa uma chave de tag, ele não pode mais consultar os dados dessa tag, mesmo que o administrador da organização ainda tenha a mesma chave de tag ativada.

Considerações