Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Point de terminaison des métadonnées de tâches Amazon ECS version 4 pour les tâches sur Fargate
**Important**
Si vous utilisez des tâches Amazon ECS hébergées sur des instances Amazon EC2, consultez la section [Point de terminaison des métadonnées de tâche Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html).
À partir de la version `1.4.0` de la plateforme Fargate, une variable d'environnement nommée `ECS_CONTAINER_METADATA_URI_V4` est injectée dans chaque conteneur d'une tâche. Lorsque vous interrogez le point de terminaison des métadonnées de tâches version 4, diverses métadonnées de tâches et [statistiques Docker](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) sont disponibles pour les tâches.
Le point de terminaison des métadonnées de tâche version 4 fonctionne comme dans la version 3, mais fournit des métadonnées réseau supplémentaires pour vos conteneurs et tâches. Des métriques réseau supplémentaires sont disponibles lors de l'interrogation des points de terminaison `/stats`.
Le point de terminaison des métadonnées des tâches est activé par défaut pour toutes les tâches Amazon ECS exécutées sur AWS Fargate une version de plate-forme `1.4.0` ou ultérieure.
**Note**
Pour éviter de créer d'autres versions de point de terminaison de métadonnées de tâche à l'avenir, des métadonnées supplémentaires peuvent être ajoutées à la sortie de la version 4. Nous ne supprimons pas les métadonnées existantes et ne modifions pas les noms des champs de métadonnées.
## Chemins des points de terminaison des métadonnées de tâches Fargate version 4
Les points de terminaison des métadonnées de tâches suivants sont disponibles pour les conteneurs :
`${ECS_CONTAINER_METADATA_URI_V4}`
Ce chemin renvoie des métadonnées pour le conteneur.
`${ECS_CONTAINER_METADATA_URI_V4}/task`
Ce chemin renvoie les métadonnées de la tâche, y compris une liste des conteneurs IDs et les noms de tous les conteneurs associés à la tâche. Pour plus d'informations sur la réponse pour ce point de terminaison, consultez [Réponse JSON des métadonnées de tâches Amazon ECS v4 pour les tâches sur Fargate](task-metadata-endpoint-v4-fargate-response.md).
`${ECS_CONTAINER_METADATA_URI_V4}/stats`
Ce chemin renvoie les statistiques Docker pour le conteneur Docker. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)de l'API Docker.
Les tâches Amazon ECS suivantes AWS Fargate nécessitent que le conteneur soit exécuté pendant environ 1 seconde avant de renvoyer les statistiques du conteneur.
`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`
Ce chemin renvoie les statistiques Docker pour tous les conteneurs associés à la tâche. Pour plus d'informations sur chacune des statistiques renvoyées, consultez la documentation [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)de l'API Docker.
Les tâches Amazon ECS suivantes AWS Fargate nécessitent que le conteneur soit exécuté pendant environ 1 seconde avant de renvoyer les statistiques du conteneur.
# Réponse JSON des métadonnées de tâches Amazon ECS v4 pour les tâches sur Fargate
Les métadonnées suivantes sont renvoyées dans la réponse JSON du point de terminaison de métadonnées de la tâche (`${ECS_CONTAINER_METADATA_URI_V4}/task`).
`Cluster`
Amazon Resource Name (ARN) ou nom abrégé du cluster Amazon ECS auquel la tâche appartient.
`ServiceName`
Nom du service auquel appartient la tâche. ServiceName apparaîtra lorsque les tâches Fargate sont associées à un service.
`VPCID`
L'identifiant VPC de l'instance de conteneur Amazon EC2. Ce champ apparaît uniquement pour les instances Amazon EC2.
Les métadonnées `VPCID` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS `1.63.1` ou version ultérieure.
`TaskARN`
L’Amazon Resource Name (ARN) de la tâche à laquelle le conteneur appartient.
`Family`
Famille de la définition de tâche Amazon ECS pour la tâche.
`Revision`
Révision de la définition de tâche Amazon ECS pour la tâche.
`DesiredStatus`
État souhaité pour la tâche à partir d'Amazon ECS.
`KnownStatus`
État connu pour la tâche à partir d'Amazon ECS.
`Limits`
Les limites de ressources spécifiées au niveau des tâches, telles que le processeur (exprimé en vCPUs) et la mémoire. Ce paramètre n'est pas spécifié si aucune limite de ressource n'a été définie.
`PullStartedAt`
Horodatage au moment où la première extraction de l'image de conteneur a commencé.
`PullStoppedAt`
Horodatage au moment où la dernière extraction de l'image de conteneur s'est terminée.
`AvailabilityZone`
Zone de disponibilité dans laquelle se trouve la tâche.
Les métadonnées de la zone de disponibilité sont uniquement disponibles pour les tâches Fargate qui utilisent la version 1.4 de la plateforme ou ultérieure (Linux) ou la version 1.0.0 de la plateforme (Windows).
`LaunchType`
Type de lancement utilisé par la tâche. Lorsque vous utilisez des fournisseurs de capacité de cluster, cela indique si la tâche utilise l'infrastructure Fargate ou EC2.
Ces métadonnées `LaunchType` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure (Linux) ou 1.0.0 ou ultérieure (Windows).
`EphemeralStorageMetrics`
La taille réservée et l'utilisation actuelle du stockage éphémère de cette tâche.
Fargate réserve de l'espace sur le disque. Il n'est utilisé que par Fargate. Vous n'êtes pas facturé pour cela. Cela n'apparaît pas dans ces statistiques. Toutefois, vous pouvez voir ce stockage supplémentaire dans d'autres outils tels que `df`.
`Utilized`
La quantité de stockage éphémère actuellement utilisée (en Mio) pour cette tâche.
`Reserved`
La quantité de stockage éphémère réservée (en Mio) pour cette tâche. La taille de stockage éphémère ne peut pas être modifiée dans une tâche en cours d'exécution. Vous pouvez spécifier l'objet du `ephermalStorage` dans la définition de votre tâche pour modifier la quantité de stockage éphémère. Le `ephermalStorage` est spécifié en Gio, et non en Mio. Le `ephermalStorage` et les `EphemeralStorageMetrics` sont uniquement disponibles sur la plateforme Fargate Linux version 1.4.0 ou ultérieure.
`Containers`
Liste de métadonnées de conteneur pour chaque conteneur associé à la tâche.
`DockerId`
ID Docker du conteneur.
Lorsque vous utilisez Fargate, l'ID est un hexadécimal de 32 chiffres suivi d'un nombre de 10 chiffres.
`Name`
Nom du conteneur tel que spécifié dans la définition de tâche.
`DockerName`
Nom du conteneur fourni à Docker. L'agent de conteneur Amazon ECS génère un nom unique pour le conteneur afin d'éviter les conflits de noms lorsque plusieurs copies de la même définition de tâche sont exécutées sur une seule instance.
`Image`
Image à utiliser pour le conteneur.
`ImageID`
Le condensé SHA-256 du manifeste de l’image. Il s’agit du condensé qui peut être utilisé pour extraire l’image en utilisant le format `repository-url/image@sha256:digest`.
`Ports`
Tous les ports exposés pour le conteneur. Ce paramètre n'est pas spécifié s'il n'y a pas de ports exposés.
`Labels`
Toutes les étiquettes appliquées au conteneur. Ce paramètre n'est pas spécifié si aucune étiquette n'est appliquée.
`DesiredStatus`
État souhaité pour le conteneur à partir d'Amazon ECS.
`KnownStatus`
État connu pour le conteneur à partir d'Amazon ECS.
`ExitCode`
Code de sortie pour le conteneur. Ce paramètre n'est pas spécifié si le conteneur n'est pas sorti.
`Limits`
Limites de ressource spécifiées au niveau du conteneur, par exemple, le processeur (exprimé en unités de processeur) et la mémoire. Ce paramètre n'est pas spécifié si aucune limite de ressource n'a été définie.
`CreatedAt`
Horodatage de création du conteneur. Ce paramètre n'est pas spécifié si le conteneur n'a pas encore été créé.
`StartedAt`
Horodatage de démarrage du conteneur. Ce paramètre n'est pas spécifié si le conteneur n'a pas encore été démarré.
`FinishedAt`
Horodatage d'arrêt du conteneur. Ce paramètre n'est pas spécifié si le conteneur n'a pas encore été arrêté.
`Type`
Type du conteneur. Les conteneurs qui sont spécifiés dans votre définition de tâche sont de type `NORMAL`. Vous pouvez ignorer les autres types de conteneurs, qui sont utilisés pour l'approvisionnement des ressources de tâches internes par l'agent de conteneur Amazon ECS.
`LogDriver`
Pilote de journal utilisé par le conteneur.
Ces métadonnées `LogDriver` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure.
`LogOptions`
Options de pilote de journal définies pour le conteneur.
Ces métadonnées `LogOptions` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure.
`ContainerARN`
L'Amazon Resource Name (ARN) du conteneur.
Ces métadonnées `ContainerARN` sont incluses uniquement lors de l'utilisation de la version de l'agent de conteneur Amazon ECS Linux `1.45.0` ou version ultérieure.
`Networks`
Informations de réseau du conteneur, par exemple le mode réseau et l'adresse IP. Ce paramètre n'est pas spécifié si aucune information de réseau n'est définie.
`Snapshotter`
Le snapshotter qui a été utilisé par containerd pour télécharger cette image de conteneur. Les valeurs valides sont `overlayfs`, qui est la valeur par défaut, et `soci`, utilisées en cas de chargement différé avec un index SOCI. Ce paramètre est uniquement disponible pour les tâches qui s'exécutent sur une version de plateforme Linux `1.4.0`.
`RestartCount`
Nombre de fois où le conteneur a été redémarré.
Les métadonnées `RestartCount` ne sont incluses que si une politique de redémarrage est activée pour le conteneur. Pour de plus amples informations, veuillez consulter [Redémarrage de conteneurs individuels dans les tâches Amazon ECS à l’aide de politiques de redémarrage de conteneurs](container-restart-policy.md).
`ClockDrift`
Informations sur la différence entre l'heure de référence et l'heure du système. Cette fonctionnalité utilise le Service de synchronisation temporelle d’Amazon pour mesurer la précision de l’horloge et fournir l’erreur d’horloge liée aux conteneurs. Pour plus d’informations, consultez la section [Réglage de l’heure pour votre instance Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) dans le *Guide de l’utilisateur Amazon EC2 pour les instances Linux*.
`ReferenceTime`
La base de la précision de l'horloge. Amazon ECS utilise la norme mondiale du temps universel coordonné (UTC) via NTP, par exemple `2021-09-07T16:57:44Z`.
`ClockErrorBound`
La mesure de l'erreur de l'horloge est exprimée par le décalage par rapport à l'UTC. Cette erreur correspond à la différence en millisecondes entre l'heure de référence et l'heure du système.
`ClockSynchronizationStatus`
Indique si la tentative de synchronisation la plus récente entre l'heure système et l'heure de référence a réussi.
Les valeurs valides sont `SYNCHRONIZED` et ` NOT_SYNCHRONIZED`.
`ExecutionStoppedAt`
Horodatage au moment où l'état des tâches est passé de `DesiredStatus` à `STOPPED`. Cela se produit lorsqu'un conteneur essentiel passe à `STOPPED`.
# Exemples de métadonnées de tâches Amazon ECS v4 pour les tâches sur Fargate
Les exemples suivants présentent des sorties de points de terminaison des métadonnées de tâche pour les tâches Amazon ECS exécutées sur AWS Fargate.
Depuis le conteneur, vous pouvez utiliser curl suivi du point de terminaison des métadonnées de la tâche pour interroger le point de terminaison, par exemple `curl ${ECS_CONTAINER_METADATA_URI_V4}/task`.
## Exemple de réponse de métadonnées du conteneur
Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}`, seules les métadonnées sur le conteneur lui-même vous sont renvoyées. Voici un exemple de sortie.
```
{
"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"
}
```
## Exemples de métadonnées de tâches Amazon ECS v4 pour les tâches sur Fargate
Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/task`, les métadonnées relatives à la tâche dont le conteneur fait partie vous sont renvoyées. Voici un exemple de sortie.
```
{
"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
}
}
```
## Exemple de réponse des statistiques de tâche
Lors de l'interrogation du point de terminaison `${ECS_CONTAINER_METADATA_URI_V4}/task/stats`, les métriques réseau dont le conteneur fait partie vous sont renvoyées. Voici un exemple de sortie.
```
{
"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
}
}
}
```