Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des clés de balise surveillées

Amazon EC2 Capacity Manager vous permet de sélectionner des clés de balise à partir de vos ressources Amazon EC2 (par exempleenvironment, team ou) à utiliser comme dimensions lors de l'analyse de vos données de capacité. Une fois qu'une clé de balise est activée, vous pouvez regrouper et filtrer vos statistiques en fonction des valeurs de cette balise, comme vous le pouvez avec la région, le type d'instance ou la zone de disponibilité.

Chaque compte peut surveiller jusqu'à cinq clés de tag. Les tags fournis par Capacity Manager ne sont pas pris en compte dans cette limite.

Tags fournis par Capacity Manager

Capacity Manager inclut un ensemble de balises par défaut pour chaque compte. Ils ne sont pas pris en compte dans le calcul de la limite de clés de votre tag. Les balises fournies par Capacity Manager représentent les dimensions de regroupement couramment utilisées et incluent :

Les balises fournies par Capacity Manager apparaissent GetCapacityManagerMonitoredTagKeys avec CapacityManagerProvided set to true et ne peuvent pas être activées ou désactivées par le client. Lorsque Capacity Manager est activé pour la première fois, les balises fournies par Capacity Manager commencent par activating leur statut et passent à une activated fois que Capacity Manager a reçu le premier point de données contenant une balise fournie par Capacity Manager, généralement dans un délai d'une à deux heures.

Cycle de vie des balises

Les clés de balise surveillées passent par les états suivants :

Lorsqu'une balise est en suspended état, GetCapacityManagerMonitoredTagKeys renvoie le message d'état suivant : « La balise est suspendue en raison d'un trop grand nombre de valeurs de balise. Réduisez l'utilisation du tag ou désactivez-le. »

Activer et désactiver les clés de tag surveillées

Vous pouvez activer les clés de balise pour commencer à les surveiller en tant que dimensions, ou désactiver les clés de balise dont vous n'avez plus besoin. L'activation est asynchrone : la balise entre dans un activating état et passe à un état une activated fois que Capacity Manager a commencé à recevoir des données pour cette balise. La désactivation supprime la clé du tag de votre ensemble surveillé.

Console

Pour activer ou désactiver les clés de balise surveillées

1. Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.

2. Dans le volet de navigation, choisissez Gestionnaire de capacité.

3. Sélectionnez l’onglet Paramètres.

4. Dans la section Clés de balise surveillées, choisissez Gérer les clés de balise.

5. Pour activer une clé de balise, entrez le nom de la clé de balise et choisissez Ajouter. Pour désactiver une clé de balise, sélectionnez-la et choisissez Supprimer.

6. Sélectionnez Enregistrer les modifications.

AWS CLI

Pour activer les touches de tag

Utilisez la commande suivante pour activer une ou plusieurs clés de balise :

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

La sortie indique les clés des balises et leur statut initial :

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

Pour désactiver les touches de tag

Utilisez la commande suivante pour désactiver une ou plusieurs clés de balise :

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

La sortie indique les statuts mis à jour :

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

Vous pouvez activer et désactiver les clés de tag dans la même demande :

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

Afficher les clés de tag surveillées

Vous pouvez consulter toutes les clés de balise surveillées pour votre compte, y compris leur statut actuel et le premier horodatage à partir duquel les données sont disponibles.

Console

Pour afficher les clés de balise surveillées

1. Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.

2. Dans le volet de navigation, choisissez Gestionnaire de capacité.

3. Sélectionnez l’onglet Paramètres.

4. Dans la section Clés de balise surveillées, consultez vos clés de balise, leur statut et vérifiez s'il s'agit de balises fournies par Capacity Manager.

AWS CLI

Pour afficher les clés de balise surveillées

Exécutez la commande suivante :

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

Le résultat répertorie toutes les clés de balise, y compris les balises fournies par Capacity Manager et les balises gérées par le client :

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

Le CapacityManagerProvided champ indique si un tag est un tag fourni par Capacity Manager (true) ou un tag géré par le client (). false Les tags fournis par Capacity Manager ne sont pas pris en compte dans le calcul de votre limite de clés de tag. EarliestDatapointTimestampIndique le premier moment à partir duquel les données sont disponibles pour cette clé de balise.

Interroger les métriques à l'aide des dimensions des balises

Une fois qu'une clé de balise atteint le activated statut, vous pouvez l'utiliser comme dimension dans GetCapacityManagerMetricDimensions etGetCapacityManagerMetricData.

Pour interroger des métriques groupées par dimension de balise

Utilisez la commande suivante :

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

Lorsque vous regroupez par dimension de tag, les résultats incluent toutes les ressources de votre compte, et pas uniquement celles qui possèdent le tag. Les ressources qui n'ont pas de valeur pour la balise sont regroupées dans un compartiment séparé avec une valeur de chaîne vide. Par exemple, si votre compte a utilisé 800 heures de vCPU au cours d'une période donnée et que seules certaines de ces ressources possèdent une environment balise, le regroupement par clé de environment balise peut renvoyer :

Cela garantit que les totaux de tous les compartiments tiennent compte de votre utilisation complète. Vous pouvez filtrer explicitement les ressources non balisées en passant une chaîne vide comme valeur de filtre :

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

Balises dans les exportations de données

Lorsque vous activez la surveillance des balises, vos exportations de données incluent les clés de balise activées et les balises fournies par Capacity Manager sous forme de colonnes supplémentaires. Les colonnes de balises apparaissent après toutes les colonnes standard avec des en-têtes tels que tag:environment ettag:team. Les colonnes de balises sont triées par ordre alphabétique.

Les exportations incluent uniquement les balises dans activated le statut. Capacity Manager exclut activating les deactivating balises ou suspended le statut.

Organisations et administrateur délégué

Lorsque votre compte fait partie d'une AWS organisation pour laquelle un gestionnaire de capacités est activé au niveau de l'organisation, chaque compte (l'administrateur de l'organisation et l'administrateur délégué) peut activer, désactiver et interroger les clés de tag de manière indépendante. Chaque compte conserve son propre statut de tag et son propre nombre de clés de tag. EarliestDatapointTimestamp

Un compte ne peut interroger les données métriques que pour les clés de balise que le compte lui-même a activées. Si l'administrateur de l'organisation et un administrateur délégué activent la même clé de balise (par exemple,environment), chaque compte suit son propre statut d'activation et la disponibilité des données de manière indépendante.

Lorsque l'administrateur délégué désactive une clé de balise, il ne peut plus demander de données pour cette balise, même si la même clé de balise est toujours activée pour l'administrateur de l'organisation.

Considérations