Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 엔드포인트 버전 4 - Amazon Elastic Container Service

Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 엔드포인트 버전 4

중요

Amazon EC2 인스턴스에서 호스팅된 Amazon ECS 작업을 사용하는 경우 Amazon ECS 작업 메타데이터 엔드포인트를 참조하세요.

Fargate 플랫폼 버전 1.4.0부터 ECS_CONTAINER_METADATA_URI_V4라는 환경 변수가 태스크의 각 컨테이너에 주입됩니다. 작업 메타데이터 엔드포인트 버전 4를 쿼리하면 다양한 작업 메타데이터와 Docker 통계를 작업에 사용할 수 있습니다.

작업 메타데이터 엔드포인트 버전 4는 버전 3 엔드포인트와 유사하지만 컨테이너 및 작업에 대한 추가 네트워크 메타데이터를 제공합니다. /stats 엔드포인트를 쿼리할 때도 추가 네트워크 지표를 사용할 수 있습니다.

작업 메타데이터 엔드포인트는 기본적으로 플랫폼 버전 1.4.0 이상을 사용하는 AWS Fargate에서 실행되는 모든 Amazon ECS 작업에 대해 켜집니다.

참고

나중에 새 태스크 메타데이터 엔드포인트 버전을 생성할 필요가 없도록 버전 4 출력에 메타데이터를 추가할 수 있습니다. 기존 메타데이터를 제거하거나 메타데이터 필드 이름을 변경하지 않습니다.

Fargate 작업 메타데이터 엔드포인트 버전 4 경로

다음의 태스크 메타데이터 엔드포인트를 컨테이너에 사용할 수 있습니다.

${ECS_CONTAINER_METADATA_URI_V4}

이 경로는 컨테이너에 대한 메타데이터를 반환합니다.

${ECS_CONTAINER_METADATA_URI_V4}/task

이 경로는 태스크와 연결된 모든 컨테이너의 컨테이너 ID 및 이름 목록을 포함하여 작업에 대한 메타데이터를 반환합니다. 이 엔드포인트의 응답에 대한 자세한 내용은 Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v4 JSON 응답 섹션을 참조하세요.

${ECS_CONTAINER_METADATA_URI_V4}/stats

이 경로는 Docker 컨테이너에 대한 Docker 통계를 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 ContainerStats를 참조하세요.

참고

AWS Fargate의 Amazon ECS 태스크는 컨테이너 통계를 반환하기 전에 ~1초 동안 컨테이너를 실행해야 합니다.

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

이 경로는 태스크와 연결된 모든 컨테이너에 대한 Docker 통계를 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 ContainerStats를 참조하세요.

참고

AWS Fargate의 Amazon ECS 태스크는 컨테이너 통계를 반환하기 전에 ~1초 동안 컨테이너를 실행해야 합니다.