Endpoint di metadati delle attività Amazon ECS versione 4 per attività su Fargate

Importante

Se utilizzi attività Amazon ECS ospitate su istanze Amazon EC2, consulta l'endpoint di metadati delle attività Amazon ECS.

A partire dalla piattaforma Fargate versione 1.4.0, una variabile di ambiente denominata ECS_CONTAINER_METADATA_URI_V4 viene inserita in ogni container di un processo. Quando esegui una query sull'endpoint dei metadati dei processi versione 4, per i processi vengono resi disponibili diversi metadati delle attività e le statistiche Docker.

L'endpoint dei metadati dei processi versione 4 funziona come l'endpoint della versione 3, ma fornisce metadati di rete aggiuntivi per i container e i processi. Ulteriori parametri di rete sono disponibili anche quando si eseguono query sugli endpoint /stats.

L'endpoint dei metadati delle attività è attivo per impostazione predefinita per tutte le attività di Amazon ECS eseguite su AWS Fargate quella versione 1.4.0 della piattaforma di utilizzo o successiva.

Nota

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.

Percorsi per gli endpoint metadati delle attività Fargate versione 4

Per i container sono disponibili i seguenti endpoint dei metadati delle attività:

${ECS_CONTAINER_METADATA_URI_V4}

Questo percorso restituisce i 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 dei metadati delle attività di Amazon ECS v4 per le attività su Fargate.

${ECS_CONTAINER_METADATA_URI_V4}/stats

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

Nota

Le attività di Amazon ECS AWS Fargate richiedono che il contenitore funzioni per circa 1 secondo prima di restituire le statistiche del contenitore.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

Questo percorso restituisce le statistiche Docker per tutti i container associati al processo. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta ContainerStatsla documentazione dell'API Docker.

Nota

Le attività di Amazon ECS AWS Fargate richiedono che il contenitore funzioni per circa 1 secondo prima di restituire le statistiche del contenitore.