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.
# Amazon-ECS-Aufgabenmetadaten für Aufgaben in Fargate verfügbar
Amazon ECS auf Fargate bietet eine Methode zum Abrufen verschiedener Metadaten, Netzwerkmetriken und [Docker-Statistiken](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) zu Ihren Containern und den Aufgaben, von denen sie ein Teil sind. Dies wird als *Endpunkt der Aufgabenmetadaten* bezeichnet. Die folgenden Endpunktversionen für Aufgabenmetadaten sind für Amazon ECS auf Fargate-Aufgaben verfügbar:
+ Aufgabenmetadaten-Endpunkt Version 4: Verfügbar für Aufgaben, die die Plattformversion 1.4.0 oder höher nutzen.
+ Aufgabenmetadaten-Endpunkt Version 3: Verfügbar für Aufgaben, die die Plattformversion 1.1.0 oder höher nutzen.
Alle Container, die zu Aufgaben gehören, die im `awsvpc` Netzwerkmodus gestartet werden, erhalten eine lokale IPv4 Adresse innerhalb eines vordefinierten Link-Local-Adressbereichs. Wenn ein Container den Metadatenendpunkt abfragt, kann der -Containeragent anhand der eindeutigen IP-Adresse die Aufgabe bestimmen, zu der der Container gehört, und gibt die Metadaten und Statistiken für diese Aufgabe zurück.
**Topics**
+ [
# Amazon-ECS-Aufgabenmetaden-Endpunkt Version 4 für Aufgaben in Fargate
](task-metadata-endpoint-v4-fargate.md)
+ [
# Amazon-ECS-Aufgabenmetaden-Endpunkt Version 3 für Aufgaben in Fargate
](task-metadata-endpoint-v3-fargate.md)
# Amazon-ECS-Aufgabenmetaden-Endpunkt Version 4 für Aufgaben in Fargate
**Wichtig**
Wenn Sie Amazon-ECS-Aufgaben verwenden, die auf Amazon-EC2-Instances gehostet werden, finden Sie weitere Informationen unter [Aufgabenmetadaten-Endpunkt von Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html).
Ab Fargate-Plattformversion `1.4.0` wird in jeden Container einer Aufgabe eine Umgebungsvariable mit dem Namen `ECS_CONTAINER_METADATA_URI_V4` eingeschleust. Wenn Sie den Aufgabenmetadaten-Endpunkt Version 4 abfragen, stehen für die Aufgaben verschiedene Aufgabenmetadaten und [Docker-Statistiken](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) zur Verfügung.
Der Aufgabenmetadaten-Endpunkt Version 4 funktioniert wie der Endpunkt der Version 3, stellt jedoch zusätzliche Netzwerkmetadaten für Ihre Container und Aufgaben bereit. Zusätzliche Netzwerkmetriken sind ebenfalls verfügbar, wenn die `/stats`-Endpunkte abgefragt werden.
Der Endpunkt für Aufgabenmetadaten ist standardmäßig für alle Amazon ECS-Aufgaben aktiviert AWS Fargate , die auf dieser Nutzungsplattformversion `1.4.0` oder höher ausgeführt werden.
**Anmerkung**
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.
## Pfade für Fagate-Aufgabenmetadaten-Endpunkt Version 4
Die folgenden 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 [Amazon-ECS-Aufgabenmetaden v4 JSON-Antwort für Aufgaben in Fargate](task-metadata-endpoint-v4-fargate-response.md).
`${ECS_CONTAINER_METADATA_URI_V4}/stats`
Dieser Pfad gibt Docker-Statistiken für den Docker-Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)in der Docker-API-Dokumentation.
Bei aktivierten Amazon ECS-Aufgaben AWS Fargate muss der Container \$11 Sekunde lang laufen, bevor die Container-Statistiken zurückgegeben werden.
`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`
Dieser Pfad gibt Docker-Statistiken für alle der Aufgabe zugeordneten Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)in der Docker-API-Dokumentation.
Bei aktivierten Amazon ECS-Aufgaben AWS Fargate muss der Container \$11 Sekunde lang laufen, bevor die Container-Statistiken zurückgegeben werden.
# Amazon-ECS-Aufgabenmetaden v4 JSON-Antwort für Aufgaben in Fargate
Die folgenden Metadaten werden in der JSON-Antwort des Endpunkts für Aufgabenmetadaten (`${ECS_CONTAINER_METADATA_URI_V4}/task`) zurückgegeben.
`Cluster`
Der Amazon-Ressourcenname (ARN) oder kurzer Name des Amazon ECS-Clusters, zu dem die Aufgabe gehört.
`ServiceName`
Der Name des Dienstes, zu dem die Aufgabe gehört. ServiceName wird für Fargate-Aufgaben angezeigt, die mit einem Dienst verknüpft sind.
`VPCID`
Die VPC-ID der Amazon-EC2-Container-Instance. Dieses Feld wird nur für Amazon-EC2-Instances angezeigt.
Diese `VPCID`-Metadaten sind nur bei Verwendung der Container-Agent-Version `1.63.1` oder höher von Amazon ECS enthalten.
`TaskARN`
Der vollständige Amazon-Ressourcenname (ARN) der Aufgabe, zu der der Container gehört
`Family`
Die Familie der Amazon-ECS-Aufgabendefinition für die Aufgabe.
`Revision`
Die Revision der Amazon-ECS-Aufgabendefinition für die Aufgabe.
`DesiredStatus`
Der gewünschte Status der Aufgabe von Amazon ECS.
`KnownStatus`
Der bekannte Status der Aufgabe von Amazon ECS.
`Limits`
Die auf Aufgabenebene angegebenen Ressourcengrenzen wie CPU (ausgedrückt in VCPUs) und Arbeitsspeicher. Dieser Parameter wird ausgelassen, wenn keine Ressourcenbegrenzungen festgelegt wurden.
`PullStartedAt`
Der Zeitstempel für den Zeitpunkt, an dem der erste Abruf des Container-Image gestartet wurde
`PullStoppedAt`
Der Zeitstempel für den Zeitpunkt, an dem der letzte Abruf des Container-Image abgeschlossen wurde
`AvailabilityZone`
Die Availability Zone, in der sich die Aufgabe befindet.
Die Availability-Zone-Metadaten sind nur für Fargate-Aufgaben verfügbar, die Plattform Version 1.4 oder höher (Linux) oder 1.0.0 (Windows) verwenden.
`LaunchType`
Der Starttyp, den die Aufgabe verwendet. Bei der Verwendung von Clusterkapazitätsanbietern gibt dies an, ob die Aufgabe Fargate oder Amazon EC2-Infrastruktur verwendet.
Diese `LaunchType`-Metadaten sind nur enthalten, wenn Version `1.45.0` oder höher des Amazon-ECs-Linux-Container-Agenten (Linux) oder 1.0.0 oder höher (Windows) verwendet wird.
`EphemeralStorageMetrics`
Die reservierte Größe und aktuelle Nutzung des flüchtigen Speichers dieser Aufgabe.
Fargate reserviert Speicherplatz auf der Festplatte. Er wird nur von Fargate verwendet. Ihnen entstehen dafür keine Kosten. Es wird in diesen Metriken nicht angezeigt. Sie können diesen zusätzlichen Speicherplatz jedoch in anderen Tools sehen, wie z. B. `df`.
`Utilized`
Die aktuelle flüchtige Speichernutzung (in MiB) dieser Aufgabe.
`Reserved`
Der reservierte flüchtige Speicher (in MiB) dieser Aufgabe. Die Größe des flüchtigen Speichers kann in einer ausgeführten Aufgabe nicht geändert werden. Sie können das `ephermalStorage`-Objekt in Ihrer Aufgabendefinition angeben, um die Menge des flüchtigen Speichers zu ändern. Der `ephermalStorage` wird in GB angegeben, nicht in MB. Der `ephermalStorage` und die `EphemeralStorageMetrics` sind nur auf Fargate-Linux-Plattform-Version 1.4.0 oder höher verfügbar.
`Containers`
Eine Liste der Container-Metadaten für jeden Container, der der Aufgabe zugeordnet ist
`DockerId`
Die Docker-ID des Containers
Wenn Sie Fargate verwenden, ist die ID ein 32-stelliger Hex gefolgt von einer 10-stelligen Zahl.
`Name`
Der Name des Containers, wie er in der Aufgabendefinition festgelegt ist
`DockerName`
Der Name des Containers, der vom Docker bereitgestellt wird. Der Amazon-ECS-Containeragent generiert einen eindeutigen Namen für den Container, um Namensüberschneidungen zu vermeiden, wenn mehrere Kopien derselben Aufgabendefinition auf einer einzelnen Instance ausgeführt werden.
`Image`
Das Image für den Container
`ImageID`
Der SHA-256-Digest des Image-Manifests. Dies ist der Digest, mit dem das Image im Format `repository-url/image@sha256:digest` abgerufen werden kann.
`Ports`
Alle für den Container zugänglichen Ports. Dieser Parameter wird ausgelassen, wenn keine zugänglichen Ports verfügbar sind.
`Labels`
Alle auf den Container angewendeten Kennungen. Dieser Parameter wird ausgelassen, wenn keine angewendeten Kennungen verfügbar sind.
`DesiredStatus`
Der gewünschte Status des Containers von Amazon ECS.
`KnownStatus`
Der bekannte Status des Containers von Amazon ECS.
`ExitCode`
Der Beendigungscode für den Container. Dieser Parameter wird ausgelassen, wenn der Container nicht beendet wurde.
`Limits`
Die auf den Containerebenen festgelegten Ressourcenbegrenzungen, wie CPU (ausgedrückt in vCPUs) und Speicher. Dieser Parameter wird ausgelassen, wenn keine Ressourcenbegrenzungen festgelegt wurden.
`CreatedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container erstellt wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht erstellt wurde.
`StartedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container gestartet wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht gestartet wurde.
`FinishedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container angehalten wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht angehalten wurde.
`Type`
Der Typ des Containers. Container, die in der Aufgabendefinition festgelegt sind, haben den Typ `NORMAL`. Sie können andere Containertypen ignorieren, die für die interne Bereitstellung von Aufgabenressourcen durch den Amazon-ECS-Containeragenten verwendet werden.
`LogDriver`
Der Protokolltreiber, den der Container verwendet.
Diese `LogDriver`-Metadaten sind nur bei Verwendung der Amazon ECS Linux-Container-Agent-Version `1.45.0` oder höher enthalten.
`LogOptions`
Die für den Container definierten Protokolltreiber-Optionen.
Diese `LogOptions`-Metadaten sind nur bei Verwendung der Amazon ECS Linux-Container-Agent-Version `1.45.0` oder höher enthalten.
`ContainerARN`
Der Amazon-Ressourcenname (ARN) des Containers.
Diese `ContainerARN`-Metadaten sind nur bei Verwendung der Amazon ECS Linux-Container-Agent-Version `1.45.0` oder höher enthalten.
`Networks`
Die Netzwerkinformationen für den Container, wie Netzwerkmodus und IP-Adresse. Dieser Parameter wird ausgelassen, wenn keine Netzwerkinformationen definiert sind.
`Snapshotter`
snapshotter, der von containerd zum Herunterladen dieses Container-Images verwendet wurde. Gültige Werte sind `overlayfs`, was die Standardeinstellung ist, und `soci`, die beim verzögerten Laden mit einem SOCI-Index verwendet werden. Dieser Parameter ist nur für Aufgaben verfügbar, die auf Linux-Plattformversion `1.4.0` ausgeführt werden.
`RestartCount`
Die Anzahl, wie oft ein Container neu gestartet wurde.
Die `RestartCount`-Metadaten sind nur enthalten, wenn eine Neustartrichtlinie für den Container aktiviert ist. Weitere Informationen finden Sie unter [Einzelne Container in Amazon-ECS-Aufgaben mit Richtlinien für den Container-Neustart neu starten](container-restart-policy.md).
`ClockDrift`
Die Informationen über die Abweichung zwischen der Referenzzeit und der Systemzeit. Diese Funktion verwendet den Amazon Time Sync Service, um die Genauigkeit der Uhr zu messen und den Zeitfehler für Container bereitzustellen. Weitere Informationen finden Sie unter [Einstellen der Zeit für Ihre Linux-Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) im *Amazon-EC2-Benutzerhandbuch für Linux-Instances*.
`ReferenceTime`
Die Grundlage der Taktgenauigkeit. Amazon ECS verwendet beispielsweise den globalen Standard Coordinated Universal Time (UTC) über NTP, z. B. `2021-09-07T16:57:44Z`.
`ClockErrorBound`
Das Maß des Taktfehlers, definiert als Abweichung zu UTC. Dieser Fehler ist der Unterschied in Millisekunden zwischen der Referenzzeit und der Systemzeit.
`ClockSynchronizationStatus`
Gibt an, ob der letzte Synchronisierungsversuch zwischen der Systemzeit und der Referenzzeit erfolgreich war.
Die gültigen Werte sind `SYNCHRONIZED` und ` NOT_SYNCHRONIZED`.
`ExecutionStoppedAt`
Der Zeitstempel des Zeitpunkts, an dem der `DesiredStatus` der Aufgaben zu `STOPPED` gewechselt hat. Dies tritt auf, wenn ein entscheidender Container zu `STOPPED` wechselt.
# Beispiele für Amazon-ECS-Aufgabenmetadaten v4 für Aufgaben in Fargate
Die folgenden Beispiele zeigen Beispielausgaben der Aufgabenmetadaten-Endpunkte für Amazon ECS-Aufgaben, die auf AWS Fargate ausgeführt werden.
Vom Container aus können Sie curl gefolgt vom Endpunkt der Aufgaben-Metadaten verwenden, um den Endpunkt abzufragen, z. B. `curl ${ECS_CONTAINER_METADATA_URI_V4}/task`
## Beispielantwort für Container-Metadaten
Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}` werden nur Metadaten zum Container selbst zurückgegeben. Im Folgenden finden Sie eine Beispielausgabe.
```
{
"DockerId": "cd189a933e5849daa93386466019ab50-2495160603",
"Name": "curl",
"DockerName": "curl",
"Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest",
"ImageID": "sha256:25f3695bedfb454a50f12d127839a68ad3caf91e451c1da073db34c542c4d2cb",
"Labels": {
"com.amazonaws.ecs.cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/default",
"com.amazonaws.ecs.container-name": "curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/cd189a933e5849daa93386466019ab50",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "2"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 10,
"Memory": 128
},
"CreatedAt": "2020-10-08T20:09:11.44527186Z",
"StartedAt": "2020-10-08T20:09:11.44527186Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"192.0.2.3"
],
"AttachmentIndex": 0,
"MACAddress": "0a:de:f6:10:51:e5",
"IPv4SubnetCIDRBlock": "192.0.2.0/24",
"DomainNameServers": [
"192.0.2.2"
],
"DomainNameSearchList": [
"us-west-2.compute.internal"
],
"PrivateDNSName": "ip-10-0-0-222.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "192.0.2.0/24"
}
],
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/05966557-f16c-49cb-9352-24b3a0dcd0e1",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/containerlogs",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/curl/cd189a933e5849daa93386466019ab50"
},
"LogDriver": "awslogs",
"Snapshotter": "overlayfs"
}
```
## Beispiele für Amazon-ECS-Aufgabenmetadaten v4 für Aufgaben in Fargate
Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}/task` werden Metadaten zu der Aufgabe zurückgegeben, zu der der Container gehört. Im Folgenden finden Sie eine Beispielausgabe.
```
{
"Cluster": "arn:aws:ecs:us-east-1:123456789012:cluster/MyEmptyCluster",
"TaskARN": "arn:aws:ecs:us-east-1:123456789012:task/MyEmptyCluster/bfa2636268144d039771334145e490c5",
"Family": "sample-fargate",
"Revision": "5",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 0.25,
"Memory": 512
},
"PullStartedAt": "2023-07-21T15:45:33.532811081Z",
"PullStoppedAt": "2023-07-21T15:45:38.541068435Z",
"AvailabilityZone": "us-east-1d",
"Containers": [
{
"DockerId": "bfa2636268144d039771334145e490c5-1117626119",
"Name": "curl-image",
"DockerName": "curl-image",
"Image": "curlimages/curl",
"ImageID": "sha256:daf3f46a2639c1613b25e85c9ee4193af8a1d538f92483d67f9a3d7f21721827",
"Labels": {
"com.amazonaws.ecs.cluster": "arn:aws:ecs:us-east-1:123456789012:cluster/MyEmptyCluster",
"com.amazonaws.ecs.container-name": "curl-image",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-1:123456789012:task/MyEmptyCluster/bfa2636268144d039771334145e490c5",
"com.amazonaws.ecs.task-definition-family": "sample-fargate",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 128 },
"CreatedAt": "2023-07-21T15:45:44.91368314Z",
"StartedAt": "2023-07-21T15:45:44.91368314Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": ["172.31.42.189"],
"AttachmentIndex": 0,
"MACAddress": "0e:98:9f:33:76:d3",
"IPv4SubnetCIDRBlock": "172.31.32.0/20",
"DomainNameServers": ["172.31.0.2"],
"DomainNameSearchList": ["ec2.internal"],
"PrivateDNSName": "ip-172-31-42-189.ec2.internal",
"SubnetGatewayIpv4Address": "172.31.32.1/20"
}
],
"ContainerARN": "arn:aws:ecs:us-east-1:123456789012:container/MyEmptyCluster/bfa2636268144d039771334145e490c5/da6cccf7-1178-400c-afdf-7536173ee209",
"Snapshotter": "overlayfs"
},
{
"DockerId": "bfa2636268144d039771334145e490c5-3681984407",
"Name": "fargate-app",
"DockerName": "fargate-app",
"Image": "public.ecr.aws/docker/library/httpd:latest",
"ImageID": "sha256:8059bdd0058510c03ae4c808de8c4fd2c1f3c1b6d9ea75487f1e5caa5ececa02",
"Labels": {
"com.amazonaws.ecs.cluster": "arn:aws:ecs:us-east-1:123456789012:cluster/MyEmptyCluster",
"com.amazonaws.ecs.container-name": "fargate-app",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-1:123456789012:task/MyEmptyCluster/bfa2636268144d039771334145e490c5",
"com.amazonaws.ecs.task-definition-family": "sample-fargate",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 2 },
"CreatedAt": "2023-07-21T15:45:44.954460255Z",
"StartedAt": "2023-07-21T15:45:44.954460255Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": ["172.31.42.189"],
"AttachmentIndex": 0,
"MACAddress": "0e:98:9f:33:76:d3",
"IPv4SubnetCIDRBlock": "172.31.32.0/20",
"DomainNameServers": ["172.31.0.2"],
"DomainNameSearchList": ["ec2.internal"],
"PrivateDNSName": "ip-172-31-42-189.ec2.internal",
"SubnetGatewayIpv4Address": "172.31.32.1/20"
}
],
"ContainerARN": "arn:aws:ecs:us-east-1:123456789012:container/MyEmptyCluster/bfa2636268144d039771334145e490c5/f65b461d-aa09-4acb-a579-9785c0530cbc",
"Snapshotter": "overlayfs"
}
],
"LaunchType": "FARGATE",
"ClockDrift": {
"ClockErrorBound": 0.446931,
"ReferenceTimestamp": "2023-07-21T16:09:17Z",
"ClockSynchronizationStatus": "SYNCHRONIZED"
},
"EphemeralStorageMetrics": {
"Utilized": 261,
"Reserved": 20496
}
}
```
## Beispielaufgabe Statistikantwort
Beim Abfragen des Endpunkts `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` werden Netzwerkmetriken zu der Aufgabe zurückgegeben, zu der der Container gehört. Im Folgenden finden Sie eine Beispielausgabe.
```
{
"3d1f891cded94dc795608466cce8ddcf-464223573": {
"read": "2020-10-08T21:24:44.938937019Z",
"preread": "2020-10-08T21:24:34.938633969Z",
"pids_stats": {},
"blkio_stats": {
"io_service_bytes_recursive": [
{
"major": 202,
"minor": 26368,
"op": "Read",
"value": 638976
},
{
"major": 202,
"minor": 26368,
"op": "Write",
"value": 0
},
{
"major": 202,
"minor": 26368,
"op": "Sync",
"value": 638976
},
{
"major": 202,
"minor": 26368,
"op": "Async",
"value": 0
},
{
"major": 202,
"minor": 26368,
"op": "Total",
"value": 638976
}
],
"io_serviced_recursive": [
{
"major": 202,
"minor": 26368,
"op": "Read",
"value": 12
},
{
"major": 202,
"minor": 26368,
"op": "Write",
"value": 0
},
{
"major": 202,
"minor": 26368,
"op": "Sync",
"value": 12
},
{
"major": 202,
"minor": 26368,
"op": "Async",
"value": 0
},
{
"major": 202,
"minor": 26368,
"op": "Total",
"value": 12
}
],
"io_queue_recursive": [],
"io_service_time_recursive": [],
"io_wait_time_recursive": [],
"io_merged_recursive": [],
"io_time_recursive": [],
"sectors_recursive": []
},
"num_procs": 0,
"storage_stats": {},
"cpu_stats": {
"cpu_usage": {
"total_usage": 1137691504,
"percpu_usage": [
696479228,
441212276,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"usage_in_kernelmode": 80000000,
"usage_in_usermode": 810000000
},
"system_cpu_usage": 9393210000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"precpu_stats": {
"cpu_usage": {
"total_usage": 1136624601,
"percpu_usage": [
695639662,
440984939,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"usage_in_kernelmode": 80000000,
"usage_in_usermode": 810000000
},
"system_cpu_usage": 9373330000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"memory_stats": {
"usage": 6504448,
"max_usage": 8458240,
"stats": {
"active_anon": 1675264,
"active_file": 557056,
"cache": 651264,
"dirty": 0,
"hierarchical_memory_limit": 536870912,
"hierarchical_memsw_limit": 9223372036854772000,
"inactive_anon": 0,
"inactive_file": 3088384,
"mapped_file": 430080,
"pgfault": 11034,
"pgmajfault": 5,
"pgpgin": 8436,
"pgpgout": 7137,
"rss": 4669440,
"rss_huge": 0,
"total_active_anon": 1675264,
"total_active_file": 557056,
"total_cache": 651264,
"total_dirty": 0,
"total_inactive_anon": 0,
"total_inactive_file": 3088384,
"total_mapped_file": 430080,
"total_pgfault": 11034,
"total_pgmajfault": 5,
"total_pgpgin": 8436,
"total_pgpgout": 7137,
"total_rss": 4669440,
"total_rss_huge": 0,
"total_unevictable": 0,
"total_writeback": 0,
"unevictable": 0,
"writeback": 0
},
"limit": 9223372036854772000
},
"name": "curltest",
"id": "3d1f891cded94dc795608466cce8ddcf-464223573",
"networks": {
"eth1": {
"rx_bytes": 2398415937,
"rx_packets": 1898631,
"rx_errors": 0,
"rx_dropped": 0,
"tx_bytes": 1259037719,
"tx_packets": 428002,
"tx_errors": 0,
"tx_dropped": 0
}
},
"network_rate_stats": {
"rx_bytes_per_sec": 43.298687872232854,
"tx_bytes_per_sec": 215.39347269466413
}
}
}
```
# Amazon-ECS-Aufgabenmetaden-Endpunkt Version 3 für Aufgaben in Fargate
**Wichtig**
Der Endpunkt der Version-3-Aufgabenmetadaten wird nicht mehr aktiv verwaltet. Es wird empfohlen, den Endpunkt der Version-4-Aufgabenmetadaten zu aktualisieren, um die neuesten Metadatenendpunktinformationen zu erhalten Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabenmetaden-Endpunkt Version 4 für Aufgaben in Fargate](task-metadata-endpoint-v4-fargate.md).
Ab Fargate-Plattformversion `1.1.0` wird in jeden Container einer Aufgabe eine Umgebungsvariable mit dem Namen `ECS_CONTAINER_METADATA_URI` eingeschleust. Wenn Sie den Endpunkt der Aufgaben-Metadaten Version 3 abfragen, stehen für die Aufgaben verschiedene Aufgaben-Metadaten und [Docker Statistiken](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) zur Verfügung.
Das Feature Aufgabenmetadaten-Endpunkt ist standardmäßig für alle Amazon ECS-Aufgaben aktiviert, die auf Fargate gehostet werden und die Plattformversion `1.1.0` oder höher verwenden. Weitere Informationen finden Sie unter [Fargate-Plattformversionen für Amazon ECS](platform-fargate.md).
## Pfade für Aufgabenmetaden-Endpunkt für Aufgaben auf Fargate
Die folgenden API-Endpunkte sind für Container verfügbar:
`${ECS_CONTAINER_METADATA_URI}`
Dieser Pfad gibt JSON-Metadaten für den Container zurück.
`${ECS_CONTAINER_METADATA_URI}/task`
Dieser Pfad gibt JSON-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 [Amazon-ECS-Aufgabenmetaden v3 JSON-Antwort für Aufgaben in Fargate](task-metadata-endpoint-v3-fargate-response.md).
`${ECS_CONTAINER_METADATA_URI}/stats`
Dieser Pfad gibt JSON-Docker-Statistiken für die angegebene Docker-Container-ID zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)in der Docker-API-Dokumentation.
`${ECS_CONTAINER_METADATA_URI}/task/stats`
Dieser Pfad gibt JSON-Docker-Statistiken für alle der Aufgabe zugeordneten Container zurück. Weitere Informationen zu den einzelnen zurückgegebenen Statistiken finden Sie [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)in der Docker-API-Dokumentation.
# Amazon-ECS-Aufgabenmetaden v3 JSON-Antwort für Aufgaben in Fargate
Die folgenden Informationen werden von der JSON-Antwort des Endpunkts für Aufgabenmetadaten (`${ECS_CONTAINER_METADATA_URI}/task`) zurückgegeben.
`Cluster`
Der Amazon-Ressourcenname (ARN) oder kurzer Name des Amazon-ECS-Clusters, zu dem die Aufgabe gehört.
`TaskARN`
Der vollständige Amazon-Ressourcenname (ARN) der Aufgabe, zu der der Container gehört
`Family`
Die Familie der Amazon-ECS-Aufgabendefinition für die Aufgabe.
`Revision`
Die Revision der Amazon-ECS-Aufgabendefinition für die Aufgabe.
`DesiredStatus`
Der gewünschte Status der Aufgabe von Amazon ECS.
`KnownStatus`
Der bekannte Status der Aufgabe von Amazon ECS.
`Limits`
Die auf Aufgabenebene angegebenen Ressourcengrenzen, z. B. CPU (ausgedrückt in vCPUs) und Arbeitsspeicher. Dieser Parameter wird ausgelassen, wenn keine Ressourcenbegrenzungen festgelegt wurden.
`PullStartedAt`
Der Zeitstempel für den Zeitpunkt, an dem der erste Abruf des Container-Image gestartet wurde
`PullStoppedAt`
Der Zeitstempel für den Zeitpunkt, an dem der letzte Abruf des Container-Image abgeschlossen wurde
`AvailabilityZone`
Die Availability Zone, in der sich die Aufgabe befindet.
Die Availability-Zone-Metadaten sind nur für Fargate-Aufgaben verfügbar, die Plattform Version 1.4 oder höher (Linux) oder 1.0.0 oder höher (Windows) verwenden.
`Containers`
Eine Liste der Container-Metadaten für jeden Container, der der Aufgabe zugeordnet ist
`DockerId`
Die Docker-ID des Containers
`Name`
Der Name des Containers, wie er in der Aufgabendefinition festgelegt ist
`DockerName`
Der Name des Containers, der vom Docker bereitgestellt wird. Der Amazon-ECS-Containeragent generiert einen eindeutigen Namen für den Container, um Namensüberschneidungen zu vermeiden, wenn mehrere Kopien derselben Aufgabendefinition auf einer einzelnen Instance ausgeführt werden.
`Image`
Das Image für den Container
`ImageID`
Der SHA-256-Digest des Image-Manifests. Dies ist der Digest, mit dem das Image im Format `repository-url/image@sha256:digest` abgerufen werden kann.
`Ports`
Alle für den Container zugänglichen Ports. Dieser Parameter wird ausgelassen, wenn keine zugänglichen Ports verfügbar sind.
`Labels`
Alle auf den Container angewendeten Kennungen. Dieser Parameter wird ausgelassen, wenn keine angewendeten Kennungen verfügbar sind.
`DesiredStatus`
Der gewünschte Status des Containers von Amazon ECS.
`KnownStatus`
Der bekannte Status des Containers von Amazon ECS.
`ExitCode`
Der Beendigungscode für den Container. Dieser Parameter wird ausgelassen, wenn der Container nicht beendet wurde.
`Limits`
Die auf der Containerebene festgelegten Ressourcenbegrenzungen, wie CPU (ausgedrückt in vCPUs) und Speicher. Dieser Parameter wird ausgelassen, wenn keine Ressourcenbegrenzungen festgelegt wurden.
`CreatedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container erstellt wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht erstellt wurde.
`StartedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container gestartet wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht gestartet wurde.
`FinishedAt`
Der Zeitstempel des Zeitpunkts, an dem der Container angehalten wurde. Dieser Parameter wird ausgelassen, wenn der Container noch nicht angehalten wurde.
`Type`
Der Typ des Containers. Container, die in der Aufgabendefinition festgelegt sind, haben den Typ `NORMAL`. Sie können andere Containertypen ignorieren, die für die interne Bereitstellung von Aufgabenressourcen durch den Amazon-ECS-Containeragenten verwendet werden.
`Networks`
Die Netzwerkinformationen für den Container, wie Netzwerkmodus und IP-Adresse. Dieser Parameter wird ausgelassen, wenn keine Netzwerkinformationen definiert sind.
`ClockDrift`
Die Informationen über die Abweichung zwischen der Referenzzeit und der Systemzeit. Dies gilt für das Linux-Betriebssystem. Diese Funktion verwendet den Amazon Time Sync Service, um die Genauigkeit der Uhr zu messen und den Zeitfehler für Container bereitzustellen. Weitere Informationen finden Sie unter [Einstellen der Zeit für Ihre Linux-Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) im *Amazon-EC2-Benutzerhandbuch für Linux-Instances*.
`ReferenceTime`
Die Grundlage der Taktgenauigkeit. Amazon ECS verwendet beispielsweise den globalen Standard Coordinated Universal Time (UTC) über NTP, z. B. `2021-09-07T16:57:44Z`.
`ClockErrorBound`
Das Maß des Taktfehlers, definiert als Abweichung zu UTC. Dieser Fehler ist der Unterschied in Millisekunden zwischen der Referenzzeit und der Systemzeit.
`ClockSynchronizationStatus`
Gibt an, ob der letzte Synchronisierungsversuch zwischen der Systemzeit und der Referenzzeit erfolgreich war.
Die gültigen Werte sind `SYNCHRONIZED` und ` NOT_SYNCHRONIZED`.
`ExecutionStoppedAt`
Der Zeitstempel des Zeitpunkts, an dem der `DesiredStatus` der Aufgaben zu `STOPPED` gewechselt hat. Dies tritt auf, wenn ein entscheidender Container zu `STOPPED` wechselt.
# Beispiele für Amazon-ECS-Aufgabenmetadaten v3 für Aufgaben in Fargate
Die folgende JSON-Antwort ist für eine Aufgabe mit einem Container.
```
{
"Cluster": "default",
"TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"Family": "nginx",
"Revision": "5",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Containers": [
{
"DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c",
"Name": "~internal~ecs~pause",
"DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700",
"Image": "amazon/amazon-ecs-pause:0.1.0",
"ImageID": "",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "~internal~ecs~pause",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RESOURCES_PROVISIONED",
"KnownStatus": "RESOURCES_PROVISIONED",
"Limits": {
"CPU": 0,
"Memory": 0
},
"CreatedAt": "2018-02-01T20:55:08.366329616Z",
"StartedAt": "2018-02-01T20:55:09.058354915Z",
"Type": "CNI_PAUSE",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
},
{
"DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946",
"Name": "nginx-curl",
"DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901",
"Image": "nrdlngr/nginx-curl",
"ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "nginx-curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 512,
"Memory": 512
},
"CreatedAt": "2018-02-01T20:55:10.554941919Z",
"StartedAt": "2018-02-01T20:55:11.064236631Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
}
],
"PullStartedAt": "2018-02-01T20:55:09.372495529Z",
"PullStoppedAt": "2018-02-01T20:55:10.552018345Z",
"AvailabilityZone": "us-east-2b"
}
```