Endpoint de metadados de tarefas do Amazon ECS versão 4 - Amazon Elastic Container Service
Caminhos do endpoint de metadados de tarefas versão 4

Endpoint de metadados de tarefas do Amazon ECS versão 4

O agente de contêiner do Amazon ECS injeta uma variável de ambiente em cada contêiner, conhecida como endpoint de metadados de tarefas, que fornece vários metadados de tarefas e dados estatísticos do Docker ao contêiner.

Os metadados de tarefas os dados estatísticos de taxa de rede são enviados para o CloudWatch Container Insights e podem ser visualizados no AWS Management Console. Para ter mais informações, consulte Monitorar contêineres do Amazon ECS utilizando o Container Insights com observabilidade aprimorada.

nota

O Amazon ECS fornece versões anteriores do endpoint de metadados de tarefas. Para evitar a necessidade de criar novas versões de endpoint de metadados de tarefas no futuro, os metadados adicionais podem ser adicionados à saída da versão 4. Não removeremos quaisquer metadados existentes nem alteraremos os nomes dos campos de metadados.

A variável de ambiente é injetada por padrão nos contêineres das tarefas do Amazon ECS inicializadas em instâncias do Linux do Amazon EC2 que estão executando pelo menos a versão 1.39.0 do agente de contêiner do Amazon ECS. Para instâncias do Windows do Amazon EC2 que usam o modo de rede awsvpc, o agente de contêiner do Amazon ECS deve ter pelo menos a versão 1.54.0. Para ter mais informações, consulte Gerenciamento de instâncias de contêiner do Linux no Amazon ECS.

nota

É possível adicionar suporte a esse recurso em instâncias do Amazon EC2 usando versões mais antigas do agente de contêiner do Amazon ECS atualizando o agente para a versão mais recente. Para ter mais informações, consulte Atualizar o agente de contêiner do Amazon ECS.

Caminhos do endpoint de metadados de tarefas versão 4

Os seguintes caminhos de endpoints de metadados de tarefas estão disponíveis para contêineres.

${ECS_CONTAINER_METADATA_URI_V4}

Esse caminho retorna metadados para o contêiner.

${ECS_CONTAINER_METADATA_URI_V4}/task

Esse caminho retorna metadados para a tarefa, incluindo uma lista dos nomes e IDs de todos os contêineres associados à tarefa. Para obter mais informações sobre a resposta para esse endpoint, consulte Resposta JSON para metadados de tarefas v4 no Amazon ECS.

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

Esse caminho retorna os metadados para a tarefa incluída no endpoint /task além das etiquetas de tarefa e de instância de contêiner que podem ser recuperadas usando a API ListTagsForResource. Todos os erros recebidos ao serem recuperados os metadados da etiqueta serão incluídos no campo Errors da resposta.

nota

O campo Errors existe apenas na resposta para tarefas hospedadas em instâncias do Linux do Amazon EC2 executando pelo menos a versão 1.50.0 do agente de contêiner. Para instâncias do Windows do Amazon EC2 que usam o modo de rede awsvpc, o agente de contêiner do Amazon ECS deve ter pelo menos a versão 1.54.0

Esse endpoint requer a permissão ecs.ListTagsForResource.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Esse caminho retorna dados estatísticos do Docker para o contêiner específico. Para obter mais informações sobre cada uma das estatísticas retornadas, consulte ContainerStats na documentação da API do Docker.

Para tarefas do Amazon ECS que usam o modo de rede awsvpc ou bridge hospedado em instâncias do Linux do Amazon EC2 executando pelo menos a versão 1.43.0 do agente de contêiner, haverá dados estatísticos adicionais de taxa de rede incluídos na resposta. Para todas as outras tarefas, a resposta só incluirá os dados estatísticos de rede cumulativos.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Esse caminho retorna os dados estatísticos do Docker para todos os contêineres associados à tarefa. Isso pode ser usado por contêineres de arquivos associados para extrair métricas de rede. Para obter mais informações sobre cada uma das estatísticas retornadas, consulte ContainerStats na documentação da API do Docker.

Para tarefas do Amazon ECS que usam o modo de rede awsvpc ou bridge hospedado em instâncias do Linux do Amazon EC2 executando pelo menos a versão 1.43.0 do agente de contêiner, haverá dados estatísticos adicionais de taxa de rede incluídos na resposta. Para todas as outras tarefas, a resposta só incluirá os dados estatísticos de rede cumulativos.