Endpunkt für ECS Amazon-Aufgabenmetadaten, Version 4

Der ECS Amazon-Container-Agent fügt in jeden Container eine Umgebungsvariable ein, die als Endpunkt für Aufgabenmetadaten bezeichnet wird und dem Container verschiedene Aufgaben-Metadaten und Docker-Statistiken zur Verfügung stellt.

Die Aufgabenmetadaten und Statistiken zur Netzwerkrate werden an CloudWatch Container Insights gesendet und können im eingesehen werden. AWS Management Console Weitere Informationen finden Sie unter Überwachen Sie ECS Amazon-Container mit Container Insights.

Anmerkung

Amazon ECS stellt frühere Versionen des Aufgabenmetadaten-Endpunkts bereit. Um in Zukunft keine neuen Endpunktversionen für Aufgabenmetadaten erstellen zu müssen, können zusätzliche Metadaten zur Ausgabe der Version 4 hinzugefügt werden. Wir werden keine vorhandenen Metadaten entfernen oder Metadatenfeldnamen ändern.

Die Umgebungsvariable wird standardmäßig in die Container von ECS Amazon-Aufgaben eingefügt, die auf Amazon EC2 Linux-Instances gestartet wurden, auf denen mindestens eine Version 1.39.0 des ECS Amazon-Container-Agenten ausgeführt wird. Für Amazon EC2 Windows-Instances, die den awsvpc Netzwerkmodus verwenden, muss der ECS Amazon-Container-Agent mindestens die Version haben1.54.0. Weitere Informationen finden Sie unter Verwaltung von Amazon ECS Linux-Container-Instances.

Anmerkung

Sie können Unterstützung für diese Funktion auf EC2 Amazon-Instances hinzufügen, die ältere Versionen des ECS Amazon-Container-Agenten verwenden, indem Sie den Agenten auf die neueste Version aktualisieren. Weitere Informationen finden Sie unter Den ECS Amazon-Container-Agenten aktualisieren.

Pfade für Aufgabenmetadaten-Endpunkt Version 4

Die folgenden Pfade für Aufgaben-Metadaten-Endpunkte sind für Container verfügbar:

${ECS_CONTAINER_METADATA_URI_V4}

Dieser Pfad gibt Metadaten für den Container zurück.

${ECS_CONTAINER_METADATA_URI_V4}/task

Dieser Pfad gibt Metadaten für die Aufgabe zurück, einschließlich einer Liste der Container IDs und Namen aller Container, die der Aufgabe zugeordnet sind. Weitere Informationen zu der Antwort für diesen Endpunkt finden Sie unter JSONAntwort auf Amazon ECS Task Metadata V4.

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

Dieser Pfad gibt die Metadaten für die Aufgabe zurück, die im /task Endpunkt enthalten sind, zusätzlich zu den Aufgaben- und Container-Instanz-Tags, die mit dem abgerufen werden können ListTagsForResourceAPI. Alle Fehler, die beim Abrufen der Tag-Metadaten erhalten werden, sind im Errors-Feld in der Antwort enthalten.

Anmerkung

Das Errors Feld ist nur in der Antwort für Aufgaben enthalten, die auf Amazon EC2 Linux-Instances gehostet werden, auf denen mindestens eine Version 1.50.0 des Container-Agenten ausgeführt wird. Für Amazon EC2 Windows-Instances, die den awsvpc Netzwerkmodus verwenden, muss der ECS Amazon-Container-Agent mindestens die Version haben 1.54.0

Für diesen Endpunkt ist die ecs.ListTagsForResource-Genehmigung erforderlich.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Dieser Pfad gibt Docker-Statistiken für die angegebene Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie ContainerStatsin der API Docker-Dokumentation.

Für ECS Amazon-Aufgaben, die die Netzwerkmodi awsvpc oder bridge Netzwerkmodi verwenden, die auf Amazon EC2 Linux-Instances gehostet werden, auf denen mindestens eine Version 1.43.0 des Container-Agenten ausgeführt wird, werden zusätzliche Netzwerktarifstatistiken in der Antwort enthalten sein. Für alle anderen Aufgaben enthält die Antwort nur die kumulativen Netzwerkstatistiken.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Dieser Pfad gibt Docker-Statistiken für alle der Aufgabe zugeordneten Container zurück. Dies kann von Sidecar-Containern verwendet werden, um Netzwerkmetriken zu extrahieren. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie ContainerStatsin der API Docker-Dokumentation.

Für ECS Amazon-Aufgaben, die die Netzwerkmodi awsvpc oder bridge Netzwerkmodi verwenden, die auf Amazon EC2 Linux-Instances gehostet werden, auf denen mindestens eine Version 1.43.0 des Container-Agenten ausgeführt wird, werden zusätzliche Netzwerktarifstatistiken in der Antwort enthalten sein. Für alle anderen Aufgaben enthält die Antwort nur die kumulativen Netzwerkstatistiken.