Point de terminaison des métadonnées des ECS tâches Amazon, version 4

L'agent de ECS conteneur Amazon injecte une variable d'environnement dans chaque conteneur, appelée point de terminaison des métadonnées de tâche, qui fournit diverses métadonnées de tâches et statistiques Docker au conteneur.

Les métadonnées des tâches et les statistiques du débit du réseau sont envoyées à CloudWatch Container Insights et peuvent être consultées dans le AWS Management Console. Pour de plus amples informations, veuillez consulter Surveillez les ECS conteneurs Amazon à l'aide de Container Insights.

Note

Amazon ECS fournit des versions antérieures du point de terminaison des métadonnées des tâches. 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.

La variable d'environnement est injectée par défaut dans les conteneurs des ECS tâches Amazon lancées sur les instances Amazon EC2 Linux qui exécutent au moins une version 1.39.0 de l'agent de ECS conteneur Amazon. Pour les instances Amazon EC2 Windows qui utilisent le mode awsvpc réseau, l'agent de ECS conteneur Amazon doit être au moins une version1.54.0. Pour de plus amples informations, veuillez consulter Gestion des instances de conteneurs Amazon ECS Linux.

Note

Vous pouvez ajouter la prise en charge de cette fonctionnalité sur les EC2 instances Amazon utilisant d'anciennes versions de l'agent de ECS conteneur Amazon en mettant à jour l'agent vers la dernière version. Pour de plus amples informations, veuillez consulter Mise à jour de l'agent de ECS conteneur Amazon.

Chemins des points de terminaison des métadonnées de tâches version 4

Les chemins des 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 JSONRéponse V4 aux métadonnées des ECS tâches Amazon.

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

Ce chemin renvoie les métadonnées de la tâche incluse dans le /task point de terminaison, en plus des balises d'instance de tâche et de conteneur qui peuvent être récupérées à l'aide du ListTagsForResourceAPI. Toutes les erreurs reçues lors de la récupération des métadonnées de balise seront incluses dans le champ Errors de la réponse.

Note

Le Errors champ figure uniquement dans la réponse pour les tâches hébergées sur des instances Amazon EC2 Linux exécutant au moins une version 1.50.0 de l'agent de conteneur. Pour les instances Amazon EC2 Windows qui utilisent le mode awsvpc réseau, l'agent de ECS conteneur Amazon doit être au moins la version 1.54.0

Ce point de terminaison nécessite l'autorisation ecs.ListTagsForResource.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Ce chemin renvoie les statistiques Docker pour ce conteneur spécifique. Pour plus d'informations sur chacune des statistiques renvoyées, consultez ContainerStatsla API documentation Docker.

Pour les ECS tâches Amazon qui utilisent le mode bridge réseau awsvpc ou le mode réseau hébergés sur des instances Amazon EC2 Linux exécutant au moins une version 1.43.0 de l'agent de conteneur, des statistiques supplémentaires sur le débit du réseau seront incluses dans la réponse. Pour toutes les autres tâches, la réponse inclura uniquement les statistiques cumulatives du réseau.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Ce chemin renvoie les statistiques Docker pour tous les conteneurs associés à la tâche. Il peut être utilisé par les conteneurs sidecar pour extraire les métriques réseau. Pour plus d'informations sur chacune des statistiques renvoyées, consultez ContainerStatsla API documentation Docker.

Pour les ECS tâches Amazon qui utilisent le mode bridge réseau awsvpc ou le mode réseau hébergés sur des instances Amazon EC2 Linux exécutant au moins une version 1.43.0 de l'agent de conteneur, des statistiques supplémentaires sur le débit du réseau seront incluses dans la réponse. Pour toutes les autres tâches, la réponse inclura uniquement les statistiques cumulatives du réseau.