View a markdown version of this page

Verwaltung überwachter Tag-Schlüssel - Amazon Elastic Compute Cloud

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 oderteam) 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.

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/.

  2. Wählen Sie im Navigationsbereich Capacity Manager aus.

  3. Wählen Sie die Registerkarte Einstellungen.

  4. Wählen Sie im Abschnitt Überwachte Tag-Schlüssel die Option Tag-Schlüssel verwalten aus.

  5. 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.

  6. 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/.

  2. Wählen Sie im Navigationsbereich Capacity Manager aus.

  3. Wählen Sie die Registerkarte Einstellungen.

  4. 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 verwendenGetCapacityManagerMetricData.

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 verwendetGetCapacityManagerMonitoredTagKeys, 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 activatingdeactivating, 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.