Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v4 JSON 응답
다음 메타데이터가 작업 메타데이터 엔드포인트(${ECS_CONTAINER_METADATA_URI_V4}/task
) JSON 응답에서 반환됩니다.
Cluster
-
태스크가 속한 Amazon ECS 클러스터의 Amazon 리소스 이름(ARN) 또는 약어입니다.
VPCID
-
Amazon EC2 컨테이너 인스턴스의 VPC ID입니다. 이 필드는 Amazon EC2 인스턴스에 대해서만 표시됩니다.
참고
이
VPCID
메타데이터는 Amazon ECS 컨테이너 버전1.63.1
이상을 사용할 때만 포함됩니다. TaskARN
-
컨테이너가 속한 태스크의 Amazon 리소스 이름(ARN)입니다.
Family
-
태스크에 대한 Amazon ECS 태스크 정의의 패밀리입니다.
Revision
-
작업에 대한 Amazon ECS 태스크 정의의 개정입니다.
DesiredStatus
-
Amazon ECS의 태스크에 대해 원하는 상태입니다.
KnownStatus
-
Amazon ECS의 태스크에 대해 알려진 상태입니다.
Limits
-
작업 수준에서 지정된 리소스 제한입니다(예: CPU(vCPU로 표시) 및 메모리). 리소스 제한이 정의되지 않은 경우 이 파라미터가 생략됩니다.
PullStartedAt
-
첫 번째 컨테이너 이미지 풀이 시작된 시간에 대한 타임스탬프입니다.
PullStoppedAt
-
마지막 컨테이너 이미지 풀이 완료된 시간에 대한 타임스탬프입니다.
AvailabilityZone
-
태스크가 위치한 가용 영역입니다.
참고
가용 영역 메타데이터는 플랫폼 버전 1.4 이상(Linux) 또는 1.0.0(Windows)을 사용하는 Fargate 태스크에만 사용할 수 있습니다.
LaunchType
-
태스크에서 사용 중인 시작 유형. 클러스터 용량 공급자를 사용할 경우 해당 태스크가 Fargate 또는 EC2 인프라를 사용한다는 것을 의미합니다.
참고
이
LaunchType
메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전1.45.0
이상(Linux) 또는 1.0.0 이상(Windows)을 사용할 때만 포함됩니다. EphemeralStorageMetrics
-
이 작업의 임시 스토리지에 대한 예약된 크기와 현재 사용량입니다.
참고
Fargate는 디스크 공간을 예약합니다. Fargate에서만 사용됩니다. 이에 대한 요금은 청구되지 않습니다. 이러한 지표에는 표시되지 않습니다. 그러나
df
등의 다른 도구에서는 이 추가 스토리지를 볼 수 있습니다.Utilized
-
이 작업의 현재 임시 스토리지 사용량(MiB)입니다.
Reserved
-
이 작업의 예약된 임시 스토리지(MiB)입니다. 임시 스토리지의 크기는 실행 중인 작업에서 변경할 수 없습니다. 작업 정의에서
ephermalStorage
객체를 지정하여 임시 스토리지의 양을 변경할 수 있습니다.ephermalStorage
는 MiB가 아닌 GiB 단위로 지정됩니다.ephermalStorage
및EphemeralStorageMetrics
는 Fargate Linux 플랫폼 버전 1.4.0 이상에서만 사용할 수 있습니다.
Containers
-
태스크와 연결된 각 컨테이너에 대한 컨테이너 메타데이터의 목록입니다.
DockerId
-
컨테이너의 Docker ID입니다.
Fargate를 사용할 때 ID는 32자리 16진수이고 그 뒤에 10자리 숫자가 붙습니다.
Name
-
태스크 정의에 지정된 컨테이너의 이름입니다.
DockerName
-
Docker에 제공된 컨테이너의 이름입니다. 동일한 태스크 정의의 여러 복사본이 단일 인스턴스에서 실행될 때 이름 충돌을 방지하기 위해 Amazon ECS 컨테이너 에이전트는 컨테이너에 고유의 이름을 생성합니다.
Image
-
컨테이너에 대한 이미지입니다.
ImageID
-
이미지 매니페스트의 SHA-256 다이제스트입니다.
repository-url/image@sha256:digest
형식을 통해 이미지를 가져오는 데 사용할 수 있는 다이제스트입니다. Ports
-
컨테이너에 대해 노출된 포트입니다. 노출된 포트가 없는 경우 이 파라미터가 생략됩니다.
Labels
-
컨테이너에 적용된 레이블입니다. 적용된 레이블이 없는 경우 이 파라미터가 생략됩니다.
DesiredStatus
-
Amazon ECS의 컨테이너에 대해 원하는 상태입니다.
KnownStatus
-
Amazon ECS의 컨테이너에 대해 알려진 상태입니다.
ExitCode
-
컨테이너에 대한 종료 코드입니다. 컨테이너가 종료되지 않은 경우 이 파라미터가 생략됩니다.
Limits
-
컨테이너 수준에서 지정된 리소스 제한입니다(예: CPU(CPU 단위로 표시) 및 메모리). 리소스 제한이 정의되지 않은 경우 이 파라미터가 생략됩니다.
CreatedAt
-
컨테이너가 생성된 시간에 대한 타임스탬프입니다. 컨테이너가 아직 생성되지 않은 경우 이 파라미터가 생략됩니다.
StartedAt
-
컨테이너가 시작된 시간에 대한 타임스탬프입니다. 컨테이너가 아직 시작되지 않은 경우 이 파라미터가 생략됩니다.
FinishedAt
-
컨테이너가 중지된 시간에 대한 타임스탬프입니다. 컨테이너가 아직 중지되지 않은 경우 이 파라미터가 생략됩니다.
Type
-
컨테이너의 유형입니다. 태스크 정의에서 지정된 컨테이너는
NORMAL
유형입니다. Amazon ECS 컨테이너 에이전트가 내부 작업 리소스 프로비저닝에 사용하는 기타 컨테이너 유형은 무시할 수 있습니다. LogDriver
-
컨테이너가 사용하는 로그 드라이버입니다.
참고
이
LogDriver
메타데이터는 Amazon ECS Linux 컨테이너 버전1.45.0
이상을 사용할 때만 포함됩니다. LogOptions
-
컨테이너에 정의된 로그 드라이버 옵션입니다.
참고
이
LogOptions
메타데이터는 Amazon ECS Linux 컨테이너 버전1.45.0
이상을 사용할 때만 포함됩니다. ContainerARN
-
컨테이너의 Amazon 리소스 이름(ARN)입니다.
참고
이
ContainerARN
메타데이터는 Amazon ECS Linux 컨테이너 버전1.45.0
이상을 사용할 때만 포함됩니다. Networks
-
컨테이너에 대한 네트워크 정보(예: 네트워크 모드 및 IP 주소)입니다. 네트워크 정보가 정의되지 않은 경우 이 파라미터가 생략됩니다.
Snapshotter
-
containerd가 이 컨테이너 이미지를 다운로드하는 사용한 snapshotter입니다. 유효한 값은 기본값인
overlayfs
및 SOCI 인덱스로 지연 로드할 때 사용되는soci
입니다. 이 파라미터는 Linux 플랫폼 버전1.4.0
에서 실행되는 작업에만 사용할 수 있습니다. RestartCount
-
컨테이너가 재시작된 횟수입니다.
참고
RestartCount
메타데이터는 컨테이너에 대해 재시작 정책이 활성화된 경우에만 포함됩니다. 자세한 정보는 컨테이너 재시작 정책이 있는 Amazon ECS 작업의 개별 컨테이너 재시작을 참조하세요.
ClockDrift
-
기준 시간과 시스템 시간의 차이에 대한 정보입니다. 이 기능은 Amazon Time Sync Service를 사용하여 클럭 정확도를 측정하고 컨테이너에 대한 클록 오류 범위를 제공합니다. 자세한 내용은 Amazon EC2 Linux용 사용 설명서의 Linux 인스턴스에 대한 시간 설정을 참조하세요.
ReferenceTime
-
클록 정확도의 기초입니다. Amazon ECS는 NTP를 통해 협정 세계시(UTC) 글로벌 표준을 사용합니다(예:
2021-09-07T16:57:44Z
). ClockErrorBound
-
UTC에 대한 오프셋으로 정의되는 클록 오류 측정값입니다. 이 오류는 기준 시간과 시스템 시간의 차이(밀리초)입니다.
ClockSynchronizationStatus
-
시스템 시간과 기준 시간 간의 가장 최근 동기화 시도가 성공했는지를 나타냅니다.
유효 값은
SYNCHRONIZED
및NOT_SYNCHRONIZED
입니다.
ExecutionStoppedAt
-
태스크의
DesiredStatus
가STOPPED
로 이동한 시간에 대한 타임스탬프입니다. 이 동작은 필수 컨테이너가STOPPED
로 이동할 때 발생합니다.