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.
Topics
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.
Ü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.
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 Tagenvironment
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
activatedStatus übergeht und Daten abfragbar sind. Das gibtEarliestDatapointTimestampan, 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
EarliestDatapointTimestampjeder 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
suspendedStatus 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.