Endpoint di metadati delle attività Amazon ECS versione 4 - Amazon Elastic Container Service
Percorsi dell'endpoint dei metadati dei processi versione 4

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Endpoint di metadati delle attività Amazon ECS versione 4

L'agente del container Amazon ECS inserisce una variabile di ambiente in ogni container denominata endpoint dei metadati dei processi che fornisce vari metadati di processi e statistiche Docker al container.

I metadati delle attività e le statistiche sulla velocità di rete vengono inviati a CloudWatch Container Insights e possono essere visualizzati in. AWS Management Console Per ulteriori informazioni, consulta Monitora i contenitori Amazon ECS utilizzando Container Insights con osservabilità migliorata.

Nota

Amazon ECS offre versioni precedenti dell'endpoint dei metadati dei processi. Per evitare la necessità di creare nuove versioni degli endpoint dei metadati delle attività in futuro, ulteriori metadati potrebbero essere aggiunti all'output della versione 4. Non rimuoveremo i metadati esistenti né modificheremo i nomi dei campi dei metadati.

La variabile di ambiente viene iniettata per impostazione predefinita nei contenitori delle attività di Amazon ECS avviate su istanze Amazon EC2 Linux che eseguono almeno una versione 1.39.0 dell'agente container Amazon ECS. Per le istanze Amazon EC2 Windows che utilizzano la modalità di awsvpc rete, l'agente contenitore Amazon ECS deve avere almeno una versione. 1.54.0 Per ulteriori informazioni, consulta Gestione delle istanze di container Amazon ECS Linux.

Nota

Puoi aggiungere il supporto per questa funzionalità sulle EC2 istanze Amazon che utilizzano versioni precedenti dell'agente container Amazon ECS aggiornando l'agente alla versione più recente. Per ulteriori informazioni, consulta Aggiornamento dell'agente del container Amazon ECS.

Percorsi dell'endpoint dei metadati dei processi versione 4

Per i container sono disponibili i seguenti endpoint dei metadati dei processi:

${ECS_CONTAINER_METADATA_URI_V4}

Questo percorso restituisce il file JSON dei metadati per il container.

${ECS_CONTAINER_METADATA_URI_V4}/task

Questo percorso restituisce i metadati per l'attività, incluso un elenco del contenitore IDs e i nomi di tutti i contenitori associati all'attività. Per ulteriori informazioni sulle risposte per questo endpoint, consulta Risposta JSON V4 dei metadati delle attività di Amazon ECS.

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

Questo percorso restituisce i metadati per il processo incluso nell'endpoint /task oltre ai tag dell'istanza di processo e container che possono essere recuperati utilizzando l'API ListTagsForResource. Eventuali errori ricevuti durante il recupero dei metadati del tag saranno inclusi nel campo Errors della risposta.

Nota

Il Errors campo è solo nella risposta per le attività ospitate su istanze Amazon EC2 Linux che eseguono almeno una versione 1.50.0 dell'agente contenitore. Per le istanze Amazon EC2 Windows che utilizzano la modalità di awsvpc rete, l'agente contenitore Amazon ECS deve avere almeno una versione 1.54.0

Questo endpoint richiede l'autorizzazione ecs.ListTagsForResource.

Importante

Quando usi l'${ECS_CONTAINER_METADATA_URI_V4}/taskWithTagsendpoint, tieni presente che ogni chiamata effettua fino a due richieste API a ecs:ListTagsForResource (una per i tag delle istanze del contenitore e una per i tag delle attività). Ciò può comportare una limitazione delle API se viene chiamata frequentemente.

Prendi in considerazione l'implementazione di strategie di caching o batch per ridurre la frequenza delle chiamate, specialmente nelle applicazioni ad alto traffico. Per informazioni sui limiti di limitazione per l'ListTagsForResourceAPI, consulta Request throttling for the Amazon ECS API.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Questo percorso restituisce le statistiche Docker per il container specificato. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta ContainerStatsla documentazione dell'API Docker.

Per le attività di Amazon ECS che utilizzano le modalità di bridge rete awsvpc o ospitate su istanze Amazon EC2 Linux che eseguono almeno una versione 1.43.0 dell'agente container, nella risposta saranno incluse statistiche aggiuntive sulla velocità di rete. Per tutti gli altri processi, la risposta includerà solo le statistiche cumulative di rete.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Questo percorso restituisce le statistiche Docker per tutti i container associati al processo. Questo può essere utilizzato dai container sidecar per estrarre i parametri di rete. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta ContainerStatsla documentazione dell'API Docker.

Per le attività di Amazon ECS che utilizzano le modalità di bridge rete awsvpc o ospitate su istanze Amazon EC2 Linux che eseguono almeno una versione 1.43.0 dell'agente container, nella risposta saranno incluse statistiche aggiuntive sulla velocità di rete. Per tutti gli altri processi, la risposta includerà solo le statistiche cumulative di rete.