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 exemple`environment`, `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. **Topics** + [Tags fournis par Capacity Manager](#cm-provided-tags) + [Cycle de vie des balises](#tag-lifecycle) + [Activer et désactiver les clés de tag surveillées](#activate-deactivate-tag-keys) + [Afficher les clés de tag surveillées](#view-monitored-tag-keys) + [Interroger les métriques à l'aide des dimensions des balises](#query-metrics-tag-dimensions) + [Balises dans les exportations de données](#tags-in-data-exports) + [Organisations et administrateur délégué](#tag-keys-organizations) + [Considérations](#tag-keys-considerations) ## 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 : + `aws:autoscaling:groupName`— Groupe EC2 Auto Scaling + `aws:eks:cluster-name`— Nom du cluster EKS + `eks:kubernetes-node-pool-name`— Pool de nœuds EKS Kubernetes + `karpenter.sh/nodepool`— Pool de nœuds Karpenter 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 : | Statut | Description | | --- | --- | | activating | La clé du tag est enregistrée. Capacity Manager s'apprête à collecter des données pour cette balise. Vous ne pouvez pas interroger les métriques à l'aide d'une balise ayant ce statut. | | activated | Les données des balises sont ingérées et peuvent être interrogées par le biais de la métrique APIs et lors des exportations de données. | | suspended | La clé de balise a dépassé le seuil de 100 000 valeurs de balise uniques. La balise est toujours prise en compte dans votre limite, mais Capacity Manager n'ingère plus les données correspondantes. Si l'utilisation de la valeur de votre tag diminue en dessous du seuil pendant une période prolongée, le tag est automatiquement réactivé. | | deactivating | La clé du tag est en cours de suppression. Il n'apparaîtra plus une GetCapacityManagerMonitoredTagKeys fois la désactivation terminée. | 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. » **Note** Si vous désactivez une clé de balise et que vous réactivez ultérieurement la même clé, seules les données ingérées après la réactivation sont interrogeables. Les données historiques de l'activation précédente ne sont pas accessibles. Les `EarliestDatapointTimestamp` réinitialisations à chaque nouvelle activation. ## 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é. **Note** Lorsque vous activez une clé de balise, entrez uniquement le nom de la clé (par exemple,`environment`). Capacity Manager le rend automatiquement disponible en tant que dimension permettant de regrouper et de filtrer vos statistiques. ------ #### [ 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/](https://console.aws.amazon.com/ec2/). 1. Dans le volet de navigation, choisissez **Gestionnaire de capacité**. 1. Sélectionnez l’onglet **Paramètres**. 1. Dans la section **Clés de balise surveillées**, choisissez **Gérer les clés de balise**. 1. 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**. 1. 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/](https://console.aws.amazon.com/ec2/). 1. Dans le volet de navigation, choisissez **Gestionnaire de capacité**. 1. Sélectionnez l’onglet **Paramètres**. 1. 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. `EarliestDatapointTimestamp`Indique 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` et`GetCapacityManagerMetricData`. **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 : + `prod`— 300 heures de vCPU + `staging`— 200 heures de vCPU + `""`(chaîne vide) — 300 heures de vCPU à partir de ressources sans étiquette `environment` 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=[""]}' ``` **Note** Si vous interrogez avec une clé de balise dont le `activating` statut est toujours en cours, la requête est rejetée avec une erreur 400. Attendez que le statut du tag passe à `activated` avant de lancer une requête. Vous pouvez vérifier le statut en utilisant`GetCapacityManagerMonitoredTagKeys`. **Note** Les requêtes dont l'heure de début est antérieure à la dimension `EarliestDatapointTimestamp` de balise fournie sont rejetées. Permet `GetCapacityManagerMonitoredTagKeys` de vérifier à quel moment les données sont devenues disponibles pour chaque balise. ## 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` et`tag: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. **Note** Si vous activez une nouvelle clé de balise, les exportations de données existantes n'incluent pas automatiquement la nouvelle balise. Vous devez créer une nouvelle exportation de données pour inclure la clé de balise nouvellement activée sous forme de colonne. ## 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 + **Mises à jour des valeurs des balises :** les valeurs des balises pour les nouvelles ressources et les balises récemment appliquées aux ressources existantes sont disponibles en quelques heures. Si vous modifiez la valeur d'une balise existante sur une ressource, la valeur mise à jour peut prendre jusqu'à 24 heures pour être prise en compte dans Capacity Manager. + **Durée d'activation :** après avoir activé une clé de balise, il peut s'écouler jusqu'à 24 heures avant que la balise passe à l'`activated`état et que les données puissent être consultées. Cela `EarliestDatapointTimestamp` représente le moment où les données sont disponibles, et non le moment où le tag a été activé. + **Limite de clés de tag :** 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. + **Exigences relatives aux caractères clés des balises :** Les clés des balises peuvent contenir des lettres Unicode, des chiffres, des espaces blancs et les caractères suivants :`_ . : / = + @ -`. Les clés de balise ne doivent pas dépasser 128 caractères. + **Réactivation :** si vous désactivez et réactivez la même clé de tag, seules les nouvelles données sont disponibles. Les `EarliestDatapointTimestamp` réinitialisations à chaque activation. + **Balises suspendues :** chaque clé de balise prend en charge jusqu'à 100 000 valeurs de balise uniques. Si une clé de balise dépasse ce seuil, elle passe en `suspended` statut. Le tag compte toujours dans votre limite, mais les données ne sont plus ingérées. Réduisez le nombre de valeurs uniques pour la balise ou désactivez-la pour libérer de l'espace pour une autre clé de balise.