Point de terminaison des métadonnées des ECS tâches Amazon version 4 pour les tâches sur Fargate

Important

Si vous utilisez des ECS tâches Amazon hébergées sur des EC2 instances Amazon, consultez le point de terminaison des métadonnées des ECS tâches Amazon.

À 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 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 ECS tâches Amazon exécutées sur AWS Fargate une version de plateforme 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 JSONRéponse aux métadonnées de ECS tâches Amazon v4 pour les tâches sur Fargate.

${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 ContainerStatsla API documentation Docker.

Note

ECSLes tâches Amazon 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 ContainerStatsla API documentation Docker.

Note

ECSLes tâches Amazon AWS Fargate nécessitent que le conteneur soit exécuté pendant environ 1 seconde avant de renvoyer les statistiques du conteneur.