Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Verwaltung überwachter Tag-Schlüssel Mit Amazon EC2 Capacity Manager können Sie Tag-Schlüssel aus Ihren Amazon EC2 EC2-Ressourcen (z. B. `environment` oder`team`) auswählen, um sie als Dimensionen bei der Analyse Ihrer Kapazitätsdaten zu verwenden. Nachdem ein Tag-Schlüssel aktiviert wurde, können Sie Ihre Metriken nach den Werten dieses Tags gruppieren und filtern — genau wie bei Region, Instance-Typ oder Availability Zone. Jedes Konto kann bis zu fünf Tag-Schlüssel überwachen. Von Capacity Manager bereitgestellte Tags werden auf dieses Limit nicht angerechnet. **Topics** + [Von Capacity Manager bereitgestellte Tags](#cm-provided-tags) + [Lebenszyklus von Tags](#tag-lifecycle) + [Aktiviert und deaktiviert die überwachten Tag-Schlüssel](#activate-deactivate-tag-keys) + [Überwachte Tag-Schlüssel anzeigen](#view-monitored-tag-keys) + [Abfragen von Kennzahlen mithilfe von Tag-Dimensionen](#query-metrics-tag-dimensions) + [Tags in Datenexporten](#tags-in-data-exports) + [Organizations und delegierter Administrator](#tag-keys-organizations) + [Überlegungen](#tag-keys-considerations) ## Von Capacity Manager bereitgestellte Tags Capacity Manager enthält eine Reihe von Standard-Tags für jedes Konto. Diese werden nicht auf Ihr Tag-Schlüssellimit angerechnet. Von Capacity Manager bereitgestellte Tags stellen häufig verwendete Gruppierungsdimensionen dar und beinhalten: + `aws:autoscaling:groupName`— EC2 Auto Scaling Scaling-Gruppe + `aws:eks:cluster-name`— Name des EKS-Clusters + `eks:kubernetes-node-pool-name`— EKS Kubernetes-Knotenpool + `karpenter.sh/nodepool`— Karpenter-Knotenpool Von Capacity Manager bereitgestellte Tags werden `GetCapacityManagerMonitoredTagKeys` mit der `CapacityManagerProvided` Einstellung auf angezeigt `true` und können vom Kunden nicht aktiviert oder deaktiviert werden. Wenn Capacity Manager zum ersten Mal aktiviert wird, beginnen die von Capacity Manager bereitgestellten Tags im `activating` Status und wechseln zu `activated` dem Zeitpunkt, zu dem Capacity Manager den ersten Datenpunkt, der ein von Capacity Manager bereitgestelltes Tag enthält, empfangen hat, normalerweise innerhalb von ein bis zwei Stunden. ## Lebenszyklus von Tags Überwachte Tag-Schlüssel durchlaufen die folgenden Status: | Status | Description | | --- | --- | | activating | Der Tag-Schlüssel ist registriert. Capacity Manager bereitet die Erfassung von Daten für dieses Tag vor. Mit einem Tag in diesem Status können Sie keine Metriken abfragen. | | activated | Tag-Daten werden aufgenommen und können über die Metrik APIs und in Datenexporten abgefragt werden. | | suspended | Der Tag-Schlüssel hat den Schwellenwert von 100.000 eindeutigen Tag-Werten überschritten. Das Tag wird immer noch auf Ihr Limit angerechnet, aber Capacity Manager nimmt dafür keine Daten mehr auf. Wenn Ihre Nutzung von Tagwerten über einen längeren Zeitraum unter den Schwellenwert fällt, wird das Tag automatisch reaktiviert. | | deactivating | Der Tag-Schlüssel wird entfernt. GetCapacityManagerMonitoredTagKeysNach Abschluss der Deaktivierung wird er nicht mehr angezeigt. | Wenn sich ein Tag im `suspended` Status befindet, wird die folgende Statusmeldung `GetCapacityManagerMonitoredTagKeys` zurückgegeben: „Tag wurde aufgrund zu vieler Tag-Werte gesperrt. Reduzieren Sie die Verwendung des Tags oder deaktivieren Sie es.“ **Anmerkung** Wenn Sie einen Tag-Schlüssel deaktivieren und später denselben Schlüssel erneut aktivieren, können nur Daten abgefragt werden, die nach der Reaktivierung aufgenommen wurden. Auf historische Daten der vorherigen Aktivierung kann nicht zugegriffen werden. Die werden bei jeder neuen Aktivierung `EarliestDatapointTimestamp` zurückgesetzt. ## Aktiviert und deaktiviert die überwachten Tag-Schlüssel Sie können Tag-Schlüssel aktivieren, um sie als Dimensionen zu überwachen, oder Tag-Schlüssel deaktivieren, die Sie nicht mehr benötigen. Die Aktivierung erfolgt asynchron — das Tag geht in einen `activating` Zustand über und geht in diesen über, `activated` nachdem Capacity Manager mit dem Empfang von Daten für dieses Tag begonnen hat. Durch die Deaktivierung wird der Tag-Schlüssel aus Ihrem überwachten Set entfernt. **Anmerkung** Geben Sie bei der Aktivierung eines Tag-Schlüssels nur den Schlüsselnamen ein (z. B.`environment`). Capacity Manager stellt es automatisch als Dimension für die Gruppierung und Filterung Ihrer Metriken zur Verfügung. ------ #### [ Console ] **Um die Schlüssel für überwachte Tags zu aktivieren oder zu deaktivieren** 1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. Wählen Sie im Navigationsbereich **Capacity Manager** aus. 1. Wählen Sie die Registerkarte **Einstellungen**. 1. Wählen Sie im Abschnitt **Überwachte Tag-Schlüssel** die Option **Tag-Schlüssel verwalten** aus. 1. Um einen Tag-Schlüssel zu aktivieren, geben Sie den Tag-Schlüsselnamen ein und wählen Sie **Hinzufügen**. Um einen Tag-Schlüssel zu deaktivieren, wählen Sie den Tag-Schlüssel aus und wählen Sie **Entfernen**. 1. Wählen Sie **Änderungen speichern ** aus. ------ #### [ AWS CLI ] **Um Tag-Schlüssel zu aktivieren** Verwenden Sie den folgenden Befehl, um einen oder mehrere Tag-Schlüssel zu aktivieren: ``` aws ec2 update-capacity-manager-monitored-tag-keys \ --activate-tag-keys "environment" "teamId" ``` Die Ausgabe zeigt die Tag-Schlüssel und ihren Anfangsstatus: ``` { "CapacityManagerTagKeys": [ { "TagKey": "environment", "Status": "activating" }, { "TagKey": "teamId", "Status": "activating" } ] } ``` **Um Tag-Schlüssel zu deaktivieren** Verwenden Sie den folgenden Befehl, um einen oder mehrere Tag-Schlüssel zu deaktivieren: ``` aws ec2 update-capacity-manager-monitored-tag-keys \ --deactivate-tag-keys "project" ``` Die Ausgabe zeigt die aktualisierten Status: ``` { "CapacityManagerTagKeys": [ { "TagKey": "project", "Status": "deactivating" } ] } ``` Sie können Tag-Schlüssel in derselben Anfrage aktivieren und deaktivieren: ``` aws ec2 update-capacity-manager-monitored-tag-keys \ --activate-tag-keys "environment" "teamId" \ --deactivate-tag-keys "project" ``` ------ ## Überwachte Tag-Schlüssel anzeigen Sie können alle überwachten Tag-Schlüssel für Ihr Konto einsehen, einschließlich ihres aktuellen Status und des frühesten Zeitstempels, ab dem Daten verfügbar sind. ------ #### [ Console ] **Um die überwachten Tag-Schlüssel einzusehen** 1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). 1. Wählen Sie im Navigationsbereich **Capacity Manager** aus. 1. Wählen Sie die Registerkarte **Einstellungen**. 1. Sehen Sie sich im Abschnitt **Überwachte Tag-Schlüssel** Ihre Tag-Schlüssel und deren Status an und ob es sich um von Capacity Manager bereitgestellte Tags handelt. ------ #### [ AWS CLI ] **So zeigen Sie überwachte Tag-Schlüssel an** Führen Sie den folgenden Befehl aus: ``` aws ec2 get-capacity-manager-monitored-tag-keys ``` In der Ausgabe werden alle Tagschlüssel aufgeführt, einschließlich der von Capacity Manager bereitgestellten Tags und der vom Kunden verwalteten Tags: ``` { "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" } ] } ``` Das `CapacityManagerProvided` Feld gibt an, ob es sich bei einem Tag um ein von Capacity Manager bereitgestelltes Tag (`true`) oder um ein vom Kunden verwaltetes Tag () handelt. `false` Von Capacity Manager bereitgestellte Tags werden nicht auf Ihr Tag-Schlüssellimit angerechnet. Das `EarliestDatapointTimestamp` gibt den frühesten Zeitpunkt an, ab dem Daten für diesen Tag-Schlüssel verfügbar sind. ------ ## Abfragen von Kennzahlen mithilfe von Tag-Dimensionen Wenn ein Tag-Schlüssel `activated` den Status erreicht hat, können Sie ihn als Dimension in `GetCapacityManagerMetricDimensions` und verwenden`GetCapacityManagerMetricData`. **Um Metriken abzufragen, die nach einer Tag-Dimension gruppiert sind** Verwenden Sie den folgenden Befehl: ``` aws ec2 get-capacity-manager-metric-dimensions \ --group-by tag:environment account-id \ --filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[prod]}' ``` Wenn Sie nach einer Tag-Dimension gruppieren, umfassen die Ergebnisse alle Ressourcen in Ihrem Konto — nicht nur die, die das Tag haben. Ressourcen, die keinen Wert für das Tag haben, werden in einem separaten Bucket mit einem leeren Zeichenfolgenwert gruppiert. Wenn Ihr Konto beispielsweise in einem bestimmten Zeitraum 800 vCPU-Stunden verbraucht hat und nur einige dieser Ressourcen über ein `environment` Tag verfügen, kann die Gruppierung nach dem `environment` Tag-Schlüssel Folgendes zurückgeben: + `prod`— 300 vCPU-Stunden + `staging`— 200 vCPU-Stunden + `""`(leere Zeichenfolge) — 300 vCPU-Stunden von Ressourcen ohne Tag `environment` Dadurch wird sichergestellt, dass die Gesamtwerte aller Buckets Ihre volle Nutzung ausmachen. Sie können explizit nach Ressourcen ohne Tags filtern, indem Sie eine leere Zeichenfolge als Filterwert übergeben: ``` --filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[""]}' ``` **Anmerkung** Wenn Sie eine Abfrage mit einem Tag-Schlüssel durchführen, der sich noch im `activating` Status befindet, wird die Abfrage mit einem 400-Fehler zurückgewiesen. Warten Sie, bis sich der Status des Tags geändert hat, `activated` bevor Sie eine Abfrage durchführen. Sie können den Status mit `GetCapacityManagerMonitoredTagKeys` überprüfen. **Anmerkung** Abfragen, deren Startzeit vor `EarliestDatapointTimestamp` der angegebenen Tag-Dimension liegt, werden zurückgewiesen. Wird verwendet`GetCapacityManagerMonitoredTagKeys`, um zu überprüfen, wann Daten für jedes Tag verfügbar wurden. ## Tags in Datenexporten Wenn Sie die Tag-Überwachung aktivieren, enthalten Ihre Datenexporte aktivierte Tag-Schlüssel und von Capacity Manager bereitgestellte Tags als zusätzliche Spalten. Tag-Spalten werden nach allen Standardspalten mit Überschriften wie und angezeigt. `tag:environment` `tag:team` Tag-Spalten sind alphabetisch sortiert. Exporte enthalten nur `activated` Status-Tags. Capacity Manager schließt Tags mit dem `suspended` Status `activating``deactivating`, oder aus. **Anmerkung** Wenn Sie einen neuen Tag-Schlüssel aktivieren, enthalten bestehende Datenexporte das neue Tag nicht automatisch. Sie müssen einen neuen Datenexport erstellen, um den neu aktivierten Tag-Schlüssel als Spalte einzubeziehen. ## Organizations und delegierter Administrator Wenn Ihr Konto Teil einer AWS Organisation ist, für die ein Capacity Manager auf Organisationsebene aktiviert ist, kann jedes Konto (der Organisationsadministrator und der delegierte Administrator) Tag-Schlüssel unabhängig aktivieren, deaktivieren und abfragen. Jedes Konto hat seinen eigenen Tag-Status und sein eigenes Tag-Schlüssellimit. `EarliestDatapointTimestamp` Ein Konto kann nur Metrikdaten für Tag-Schlüssel abfragen, die das Konto selbst aktiviert hat. Wenn sowohl der Organisationsadministrator als auch ein delegierter Administrator denselben Tag-Schlüssel aktivieren (z. B.`environment`), verfolgt jedes Konto seinen eigenen Aktivierungsstatus und seine Datenverfügbarkeit unabhängig voneinander. Wenn der delegierte Administrator einen Tagschlüssel deaktiviert, kann der delegierte Administrator keine Daten für dieses Tag mehr abfragen, auch wenn der Organisationsadministrator immer noch denselben Tagschlüssel aktiviert hat. ## Überlegungen + **Tag-Wert-Updates:** Tag-Werte für neue Ressourcen und Tags, die neu auf bestehende Ressourcen angewendet wurden, sind innerhalb weniger Stunden verfügbar. Wenn Sie den Wert eines vorhandenen Tags auf einer Ressource ändern, kann es bis zu 24 Stunden dauern, bis der aktualisierte Wert in Capacity Manager angezeigt wird. + **Aktivierungszeit:** Nach der Aktivierung eines Tag-Schlüssels kann es bis zu 24 Stunden dauern, bis das Tag in den `activated` Status übergeht und Daten abfragbar sind. Das gibt `EarliestDatapointTimestamp` an, wann Daten verfügbar sind, nicht wann das Tag aktiviert wurde. + **Limit für Tag-Schlüssel:** Jedes Konto kann bis zu fünf Tag-Schlüssel überwachen. Von Capacity Manager bereitgestellte Tags werden auf dieses Limit nicht angerechnet. + **Anforderungen an Tag-Schlüsselzeichen:** Tag-Schlüssel können Unicode-Buchstaben, Ziffern, Leerzeichen und die folgenden Zeichen enthalten:. `_ . : / = + @ -` Tag-Schlüssel dürfen 128 Zeichen nicht überschreiten. + **Reaktivierung:** Wenn Sie denselben Tag-Schlüssel deaktivieren und erneut aktivieren, sind nur neue Daten verfügbar. Das wird bei `EarliestDatapointTimestamp` jeder Aktivierung zurückgesetzt. + **Gesperrte Tags:** Jeder Tag-Schlüssel unterstützt bis zu 100.000 eindeutige Tag-Werte. Wenn ein Tag-Schlüssel diesen Schwellenwert überschreitet, wird er in den `suspended` Status versetzt. Das Tag wird immer noch auf Ihr Limit angerechnet, aber es werden keine Daten mehr aufgenommen. Reduzieren Sie die Anzahl der Einzelwerte für das Tag oder deaktivieren Sie es, um Speicherplatz für einen anderen Tag-Schlüssel freizugeben.