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

Versione 4 degli endpoint dei metadati delle attività di Amazon ECS

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 dei processi e le statistiche sulla velocità di rete vengono inviati a CloudWatch Container Insights e possono essere visualizzati nella the console. Per ulteriori informazioni, consulta Monitora i container di 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 inserita di default nei container dei processi Amazon ECS lanciati su istanze Linux di Amazon EC2 che eseguono almeno la versione 1.39.0 dell'agente del container Amazon ECS. Per istanze Windows di Amazon EC2 che utilizzano la modalità di rete awsvpc, l'agente del container Amazon ECS deve essere almeno versione 1.54.0. Per ulteriori informazioni, consulta Gestione delle istanze di container Amazon ECS Linux.

Nota

Questa caratteristica può essere supportata sulle istanze Amazon EC2 utilizzando versioni precedenti dell'agente di container Amazon ECS aggiornando l'agente alla versione più recente. Per ulteriori informazioni, consulta Aggiornamento dell'agente del container Amazon ECS.

Per l'output di esempio dei metadati delle attività, consulta Esempi della V4 dei metadati delle attività di 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 il processo, compreso un elenco degli ID container e i nomi di tutti i container associati al processo. Per ulteriori informazioni sulle risposte per questo endpoint, consulta Risposta JSON relativa alla 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 campo Errors è presente solo nella risposta per i processi ospitati su istanze Linux di Amazon EC2 che eseguono almeno la versione 1.50.0 dell'agente del container. Per istanze Windows di Amazon EC2 che utilizzano la modalità di rete awsvpc, l'agente del container Amazon ECS deve essere almeno versione 1.54.0.

Questo endpoint richiede l'autorizzazione ecs.ListTagsForResource.

Importante

Quando usi l'endpoint ${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags, tieni presente che ogni chiamata invia fino a due richieste API a ecs:ListTagsForResource (una per i tag delle istanze di container e una per i tag delle attività) e che tutti i container sidecar dell'attività possono effettuare queste chiamate per tuo conto. Le chiamate frequenti agli endpoint possono comportare una limitazione delle API.

Valuta la possibilità di implementare strategie di caching o batch per ridurre la frequenza delle chiamate, specialmente nelle applicazioni ad alto traffico, e di eseguire il debugging dei problemi di limitazione delle API utilizzando AWS CloudTrail. Per informazioni sulle limitazioni per l'API ListTagsForResource, consulta Richiedi la limitazione per l'API di Amazon ECS nella Documentazione di riferimento delle API di Amazon Elastic Container Service. Per ulteriori informazioni sul debugging delle chiamate API di Amazon ECS tramite AWS CloudTrail, consulta Registrazione delle chiamate API Amazon ECS tramite AWS CloudTrail.

${ECS_CONTAINER_METADATA_URI_V4}/stats

Questo percorso restituisce le statistiche Docker per il container specificato. Per ulteriori informazioni sulle diverse statistiche restituite, consulta la sezione relativa alle statistiche dei container nella documentazione API Docker.

Per i processi Amazon ECS che utilizzano le modalità di rete awsvpc o bridge ospitate su istanze Linux Amazon EC2 che eseguono almeno la versione 1.43.0 dell'agente del container, nella risposta saranno presenti anche altre statistiche 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 sulle diverse statistiche restituite, consulta la sezione relativa alle statistiche dei container nella documentazione API Docker.

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