Gestión de claves de etiquetas supervisadas

El administrador de capacidad de Amazon EC2 le permite seleccionar claves de etiqueta de sus recursos de Amazon EC2 (por ejemplo, environment o team) para utilizarlas como dimensiones. al analizar sus datos de capacidad. Después de activar una clave de etiqueta, puede agrupar y filtrar las métricas según los valores de esa etiqueta, del mismo modo que puede hacerlo según la región, el tipo de instancia o la zona de disponibilidad.

Cada cuenta puede monitorear hasta cinco claves de etiqueta. Las etiquetas proporcionadas por el administrador de capacidad no computan para este límite.

Etiquetas proporcionadas por el administrador de capacidad

El administrador de capacidad incluye un conjunto de etiquetas predeterminadas para cada cuenta. Estas no se tienen en cuenta al calcular el límite de claves de etiqueta. Las etiquetas proporcionadas por el administrador de capacidad representan las dimensiones de agrupación más utilizadas e incluyen:

Las etiquetas proporcionadas por el administrador de capacidad aparecen en GetCapacityManagerMonitoredTagKeys con CapacityManagerProvided configuradas como true y el cliente no puede activarlas ni desactivarlas. Cuando el administrador de capacidad se habilita por primera vez, las etiquetas proporcionadas por el administrador de capacidad comienzan a estar en estado activating y pasan a un estado activated cuando el administrador de capacidad recibe el primer punto de datos que incluye una etiqueta proporcionada por el administrador de capacidad, normalmente en un plazo de una a dos horas.

Ciclo de vida de las etiquetas

Las claves de etiquetas supervisadas avanzan a través de los siguientes estados:

Cuando una etiqueta está en estado suspended, GetCapacityManagerMonitoredTagKeys devuelve el siguiente mensaje de estado: “Etiqueta suspendida debido a la existencia de demasiados valores de etiqueta. Reduzca el uso de la etiqueta o desactívela”.

Active y desactive las etiquetas supervisadas

Puede activar las claves de etiqueta para empezar a supervisarlas como dimensiones o desactivar las claves de etiqueta que ya no necesite. La activación es asíncrona: la etiqueta entra en un estado activating y pasa a activated cuando el administrador de capacidad comienza a recibir los datos de esa etiqueta. La desactivación elimina la clave de etiqueta del conjunto supervisado.

Console

Para activar y desactivar las etiquetas supervisadas

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, elija Capacity Manager.

3. Elija la pestaña Settings.

4. En la sección de Claves de etiquetas supervisadas, elija Administrar claves de etiquetas.

5. Para activar una clave de etiqueta, introduzca el nombre de la clave y seleccione Añadir. Para desactivar una clave de etiqueta, selecciónela y elija Eliminar.

6. Seleccione Save changes (Guardar cambios).

AWS CLI

Para activar las claves de etiqueta

Utilice el siguiente comando para activar una o más claves de etiqueta:

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

En el resultado, se muestran las claves de etiqueta y sus estados iniciales:

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

Para desactivar las claves de etiqueta

Utilice el siguiente comando para desactivar una o más claves de etiqueta:

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

En el resultado, se observan los estados actualizados:

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

Puede activar y desactivar las claves de etiquetas en la misma solicitud:

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

Consulte las claves de etiquetas supervisadas

Puede ver todas las claves de etiquetas supervisadas de su cuenta, incluido el estado actual y la fecha más temprana de la que hay datos disponibles.

Console

Para ver las claves de etiquetas supervisadas

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, elija Capacity Manager.

3. Elija la pestaña Settings.

4. En la sección de Claves de etiquetas supervisadas, consulte sus claves de etiquetas, sus estados y si son etiquetas proporcionadas por el administrador de capacidad.

AWS CLI

Para ver las claves de etiquetas supervisadas

Use el siguiente comando:

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

En el resultado se muestran todas las claves de etiquetas, incluidas las de etiquetas proporcionadas por el administrador de capacidad y etiquetas administradas por el 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"
        }
    ]
}

El campo de CapacityManagerProvided indica si se trata de una etiqueta proporcionada por el administrador de capacidad (true) o una etiqueta administrada por el cliente (false). Las etiquetas proporcionadas por el administrador de capacidad no computan para el límite de claves de etiqueta. EarliestDatapointTimestamp indica el momento más remoto desde que hay datos disponibles para esa clave de etiqueta.

Consulte las métricas mediante las dimensiones de etiquetas

Cuando una clave de etiqueta alcanza el estado activated, puede usarla como dimensión en GetCapacityManagerMetricDimensions y GetCapacityManagerMetricData.

Para consultar métricas agrupadas por una dimensión de etiqueta

Utilice el siguiente comando:

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

Al agrupar por una dimensión de etiqueta específica, los resultados incluyen todos los recursos de la cuenta, no solo los que tienen la etiqueta. Los recursos que no tienen un valor para la etiqueta se agrupan en un bucket independiente con un valor de cadena vacío. Por ejemplo, si su cuenta usó 800 horas de vCPU en un período determinado y solo algunos de esos recursos tienen una etiqueta environment, la agrupación por la clave de la etiqueta environment podría arrojar el siguiente resultado:

Esto garantiza que los totales de todos los bucket representen el uso total. Puede filtrar los recursos sin etiquetar de forma explícita pasando una cadena vacía como valor del filtro:

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

Etiquetas en exportaciones de datos

Cuando habilita la supervisión de etiquetas, sus exportaciones de datos incluyen las claves de etiquetas activadas y las etiquetas proporcionadas por el administrador de capacidad como columnas adicionales. Las columnas de etiquetas aparecen después de todas las columnas estándar con encabezados como tag:environment y tag:team. Las columnas de etiquetas se ordenan alfabéticamente.

Las exportaciones incluyen solo las etiquetas en estado activated. El administrador de capacidad excluye las etiquetas en estado activating, deactivating o suspended.

Organizaciones y administrador delegado

Si su cuenta forma parte de una organización de AWS con un el administrador de capacidad activado en el nivel de la organización, cada cuenta (el administrador de la organización y el administrador delegado) puede activar, desactivar y consultar las claves de etiquetas de forma independiente. Cada cuenta mantiene su propio estado de etiquetas, EarliestDatapointTimestamp y límite de claves.

Una cuenta solo puede consultar los datos de las métricas de las claves de etiquetas que la propia cuenta haya activado. Si tanto el administrador de la organización como un administrador delegado activan la misma clave de etiqueta (por ejemplo, environment), cada cuenta realizará un seguimiento de su propio estado de activación y de la disponibilidad de los datos de forma independiente.

Cuando el administrador delegado desactiva una clave de etiqueta, ya no puede consultar los datos de esa etiqueta, aunque el administrador de la organización siga teniendo activada la misma clave.

Consideraciones