Versión 4 del punto de conexión de metadatos de tareas de Amazon ECS

El agente de contenedor de Amazon ECS introduce una variable de entorno en cada contenedor, denominada punto de enlace de metadatos de tareas, que proporciona varios metadatos y estadísticas de Docker de tareas al contenedor.

Los metadatos y las estadísticas de velocidad de red de las tareas se envían a CloudWatch Container Insights y se pueden consultar desde la AWS Management Console. Para obtener más información, consulte Supervisión de los contenedores de Amazon ECS mediante Información de contenedores.

nota

Amazon ECS ofrece versiones anteriores del punto de enlace de metadatos de tareas. Para no tener que crear nuevas versiones de los puntos de enlace de metadatos de tareas en el futuro, se pueden agregar otros metadatos a la salida de la versión 4. No vamos a eliminar ningún metadato existente ni a modificar los nombres de los campos de metadatos.

La variable de entorno se introduce de forma predeterminada en los contenedores de las tareas de Amazon ECS lanzadas en instancias de Linux de Amazon EC2 que ejecutan la versión 1.39.0 del agente de contenedor de Amazon ECS como mínimo. Para instancias de Windows de Amazon EC2 que utilizan el modo de red awsvpc, el agente de contenedor de Amazon ECS debe ser versión 1.54.0 como mínimo. Para obtener más información, consulte Administración de instancias de contenedor de Linux de Amazon ECS.

nota

Puede agregar compatibilidad con esta característica en instancias de Amazon EC2 que utilizan versiones anteriores del agente de contenedor de Amazon ECS si actualiza el agente a la versión más reciente. Para obtener más información, consulte Actualización del agente de contenedor de Amazon ECS.

Rutas de la versión 4 del punto de enlace de metadatos de tareas

Están disponibles los siguientes puntos de enlace de metadatos de tareas para los contenedores:

${ECS_CONTAINER_METADATA_URI_V4}

Esta ruta devuelve metadatos del contenedor.

${ECS_CONTAINER_METADATA_URI_V4}/task

Esta ruta devuelve metadatos de la tarea, incluso una lista de los nombres e ID de contenedor de todos los contenedores asociados a la tarea. Para obtener más información sobre la respuesta de este punto de enlace, consulte Respuesta JSON para la versión 4 de los metadatos de tareas de Amazon ECS.

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

Esta ruta muestra los metadatos de la tarea incluidos en el punto de enlace /task además de en las etiquetas de instancia de contenedor y tarea que se pueden recuperar mediante la API ListTagsForResource. Todos los errores recibidos al recuperar los metadatos de la etiqueta se incluirán en la respuesta, en el campo Errors.

nota

El campo Errors solo aparece en la respuesta para tareas alojadas en instancias de Linux de Amazon EC2 que ejecutan la versión 1.50.0 del agente de contenedor como mínimo. Para instancias de Windows de Amazon EC2 que utilizan el modo de red awsvpc, el agente contenedor de Amazon ECS debe ser versión 1.54.0 como mínimo

Este punto de conexión requiere el permiso ecs.ListTagsForResource.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Esta ruta muestra estadísticas de Docker para el contenedor específico. Para obtener más información acerca de cada una de las estadísticas devueltas, consulte ContainerStats en la documentación del API de Docker.

Para las tareas de Amazon ECS que utilizan los modos de red awsvpco bridge alojados en instancias de Linux de Amazon EC2 que ejecutan la versión 1.43.0 del agente de contenedor como mínimo, habrá estadísticas de velocidad de red adicionales incluidas en la respuesta. Para todas las demás tareas, la respuesta solo incluirá las estadísticas de red acumuladas.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Esta ruta devuelve estadísticas de Docker de todos los contenedores asociados a la tarea. Se puede utilizar en contenedores asociados para extraer métricas de red. Para obtener más información acerca de cada una de las estadísticas devueltas, consulte ContainerStats en la documentación del API de Docker.

Para las tareas de Amazon ECS que utilizan los modos de red awsvpco bridge alojados en instancias de Linux de Amazon EC2 que ejecutan la versión 1.43.0 del agente de contenedor como mínimo, habrá estadísticas de velocidad de red adicionales incluidas en la respuesta. Para todas las demás tareas, la respuesta solo incluirá las estadísticas de red acumuladas.