Resposta JSON para metadados de tarefas v4 no Amazon ECS para tarefas no Fargate
Os seguintes metadados são retornados na resposta em formato JSON (${ECS_CONTAINER_METADATA_URI_V4}/task
) do endpoint de metadados da tarefa.
Cluster
-
O nome do recurso da Amazon (ARN) ou nome curto do cluster do Amazon ECS ao qual a tarefa pertence.
VPCID
-
O ID da VPC da instância de contêiner do Amazon EC2. Esse campo é exibido somente para instâncias do Amazon EC2.
nota
Os metadados
VPCID
são incluídos somente quando é usada a versão1.63.1
ou posterior do agente de contêiner do Amazon ECS. TaskARN
-
O nome de recurso da Amazon (ARN) da tarefa à qual o contêiner pertence.
Family
-
A família da definição de tarefa do Amazon ECS para a tarefa.
Revision
-
A revisão da definição de tarefa do Amazon ECS para a tarefa.
DesiredStatus
-
O status desejado para a tarefa do Amazon ECS.
KnownStatus
-
O status conhecido para a tarefa do Amazon ECS.
Limits
-
Os limites de recursos especificados nos níveis da tarefa, como CPU (expresso em vCPUs) e memória. Esse parâmetro será omitido se não houver nenhum limite de recurso definido.
PullStartedAt
-
O timestamp de quando começou a primeira extração de imagem do contêiner.
PullStoppedAt
-
O timestamp de quando a última extração de imagem do contêiner terminou.
AvailabilityZone
-
A zona de disponibilidade em que a tarefa está.
nota
Os metadados da zona de disponibilidade estão disponíveis apenas para tarefas do Fargate que usam a versão 1.4 ou posterior (Linux) ou 1.0.0 (Windows) da plataforma.
LaunchType
-
O tipo de inicialização que a tarefa está usando. Ao usar provedores de capacidade de cluster, isso indica se a tarefa está usando a infraestrutura do Fargate ou do EC2.
nota
Esses metadados
LaunchType
estão incluídos somente quando é usada a versão1.45.0
ou posterior (Linux) ou 1.0.0 ou posterior (Windows) do agente de contêiner do Linux do Amazon ECS. EphemeralStorageMetrics
-
O tamanho reservado e o uso atual do armazenamento temporário dessa tarefa.
nota
O Fargate reserva espaço no disco. Esse espaço é usado apenas pelo Fargate. Você não é cobrado por isso. Ele não é mostrado nessas métricas. Porém, você pode ver esse armazenamento adicional em outras ferramentas, como o
df
.Utilized
-
O uso atual de armazenamento temporário (em MiB) dessa tarefa.
Reserved
-
O armazenamento temporário reservado (em MiB) dessa tarefa. O tamanho do armazenamento temporário não pode ser alterado em uma tarefa em execução. É possível especificar o objeto
ephermalStorage
na sua definição de tarefa para alterar a quantidade de armazenamento temporário. OephermalStorage
é especificado em GiB, não em MiB. OephermalStorage
e asEphemeralStorageMetrics
só estão disponíveis na versão 1.4.0 ou posterior da plataforma Linux do Fargate.
Containers
-
Uma lista de metadados de contêiner para cada contêiner associado com a tarefa.
DockerId
-
O ID do Docker do contêiner.
Quando você usa Fargate, o id é um hexadecimal de 32 dígitos seguido por um número de 10 dígitos.
Name
-
O nome do contêiner, conforme especificado na definição da tarefa.
DockerName
-
O nome do contêiner fornecido para o Docker. O agente de contêiner do Amazon ECS gera um nome exclusivo para o contêiner para evitar colisões de nomes quando várias cópias da mesma definição de tarefa são executadas em uma única instância.
Image
-
A imagem para o contêiner.
ImageID
-
O resumo SHA-256 para a imagem.
Ports
-
Todas as portas expostas para o contêiner. Esse parâmetro será omitido se não houver portas expostas.
Labels
-
Todos os rótulos aplicados ao contêiner. Esse parâmetro será omitido se não houver rótulos aplicados.
DesiredStatus
-
O status desejado para o contêiner do Amazon ECS.
KnownStatus
-
O status conhecido para o contêiner do Amazon ECS.
ExitCode
-
O código de saída para o contêiner. Esse parâmetro é omitido se o contêiner não foi encerrado.
Limits
-
Os limites de recursos especificados no nível do contêiner, como CPU (expresso em unidades de CPU) e memória. Esse parâmetro será omitido se não houver nenhum limite de recurso definido.
CreatedAt
-
O time stamp de quando o contêiner foi criado. Esse parâmetro será omitido se o contêiner ainda não tiver sido criado.
StartedAt
-
O time stamp de quando o contêiner foi iniciado. Esse parâmetro será omitido se o contêiner ainda não tiver sido iniciado.
FinishedAt
-
O time stamp de quando o contêiner foi interrompido. Esse parâmetro será omitido se o contêiner ainda não tiver sido interrompido.
Type
-
O tipo do contêiner. Os contêineres que são especificados em sua definição de tarefa são do tipo
NORMAL
. É possível ignorar outros tipos de contêineres, que são usados para o provisionamento de recursos de tarefas internas pelo agente de contêiner do Amazon ECS. LogDriver
-
O driver de log que o contêiner está usando.
nota
Esses metadados
LogDriver
estão incluídos somente quando é usada a versão1.45.0
ou posterior do agente de contêiner do Linux do Amazon ECS. LogOptions
-
As opções de driver de log definidas para o contêiner.
nota
Esses metadados
LogOptions
estão incluídos somente quando é usada a versão1.45.0
ou posterior do agente de contêiner do Linux do Amazon ECS. ContainerARN
-
O nome completo do recurso da Amazon (ARN) do contêiner.
nota
Esses metadados
ContainerARN
estão incluídos somente quando é usada a versão1.45.0
ou posterior do agente de contêiner do Linux do Amazon ECS. Networks
-
As informações de rede para o contêiner, como o modo de rede e o endereço IP. Esse parâmetro será omitido se não houver informações de rede definidas.
Snapshotter
-
O snapshotter que foi usado pelo containerd para baixar essa imagem do contêiner. Os valores válidos são
overlayfs
, que é o padrão, esoci
, usado no carregamento lento com um índice SOCI. Este parâmetro só está disponível para tarefas executadas na versão da plataforma Linux1.4.0
. RestartCount
-
O número de vezes que um contêiner foi reiniciado.
nota
Os metadados de
RestartCount
são incluídos somente se uma política de reinicialização estiver habilitada para o contêiner. Para ter mais informações, consulte Reiniciar contêineres individuais em tarefas do Amazon ECS com políticas de reinicialização de contêineres.
ClockDrift
-
A informação sobre a diferença entre o tempo de referência e a hora do sistema. Esse recurso usa o Serviço de Sincronização Temporal da Amazon para medir a precisão do relógio e fornecer o erro de relógio vinculado aos contêineres. Para obter mais informações, consulte Definir a hora da instância do Linux no Guia do usuário do Amazon EC2 para instâncias do Linux.
ReferenceTime
-
A base da precisão do relógio. O Amazon ECS usa o padrão global Coordinated Universal Time (UTC — Tempo universal coordenado) por meio do NTP, por exemplo,
2021-09-07T16:57:44Z
. ClockErrorBound
-
A medida do erro do relógio, definida como o deslocamento para UTC. Esse erro é a diferença em milissegundos entre o tempo de referência e a hora do sistema.
ClockSynchronizationStatus
-
Indica se a tentativa de sincronização mais recente entre a hora do sistema e o horário de referência obteve êxito.
Os valores válidos são
SYNCHRONIZED
eNOT_SYNCHRONIZED
.
ExecutionStoppedAt
-
O time stamp de quando o
DesiredStatus
da tarefa mudou paraSTOPPED
. Isso ocorre quando um contêiner essencial muda paraSTOPPED
.