Fargate 태스크용 Amazon ECS 태스크 메타데이터 v4 JSON 응답
Fargate 태스크용 Amazon ECS 태스크 메타데이터 v4 JSON 응답
다음 메타데이터는 태스크 메타데이터 엔드포인트(${ECS_CONTAINER_METADATA_URI_V4}/task) JSON 응답에서 반환돼요.
출처: 문서
본문
Cluster— 태스크가 속한 Amazon ECS 클러스터의 Amazon Resource Name(ARN) 또는 짧은 이름.ServiceName— 태스크가 속한 서비스의 이름. 태스크가 서비스와 연결되어 있으면ServiceName이 Fargate 태스크에 나타납니다.VPCID— Amazon EC2 컨테이너 인스턴스의 VPC ID. 이 필드는 Amazon EC2 인스턴스에만 나타나요. 참고:VPCID메타데이터는 Amazon ECS 컨테이너 에이전트 버전 1.63.1 이상을 사용할 때만 포함됩니다.TaskARN— 컨테이너가 속한 태스크의 Amazon Resource Name(ARN).Family— 태스크의 Amazon ECS 태스크 정의 패밀리.Revision— 태스크의 Amazon ECS 태스크 정의 리비전.DesiredStatus— Amazon ECS가 제공하는 태스크의 원하는 상태.KnownStatus— Amazon ECS가 제공하는 태스크의 알려진 상태.Limits— 태스크 수준에서 지정된 리소스 제한. 예를 들어 CPU(vCPU 단위)와 메모리. 리소스 제한이 정의되지 않으면 이 파라미터는 생략됩니다.PullStartedAt— 첫 컨테이너 이미지 풀이 시작된 타임스탬프.PullStoppedAt— 마지막 컨테이너 이미지 풀이 완료된 타임스탬프.AvailabilityZone— 태스크가 있는 가용 영역. 참고: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). 임시 스토리지 크기는 실행 중인 태스크에서 변경할 수 없어요. 임시 스토리지 양을 변경하려면 태스크 정의에ephemeralStorage객체를 지정할 수 있습니다.ephemeralStorage는 MiB가 아닌 GiB로 지정됩니다.ephemeralStorage와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— 컨테이너가 사용하는 로그 드라이버. 참고: 이 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상을 사용할 때만 포함됩니다.LogOptions— 컨테이너에 정의된 로그 드라이버 옵션. 참고: 이 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상을 사용할 때만 포함됩니다.ContainerARN— 컨테이너의 Amazon Resource Name(ARN). 참고: 이 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상을 사용할 때만 포함됩니다.Networks— 네트워크 모드와 IP 주소 같은 컨테이너의 네트워크 정보. 네트워크 정보가 정의되지 않으면 이 파라미터는 생략됩니다.Snapshotter— containerd가 이 컨테이너 이미지를 다운로드하는 데 사용한 스냅샷터. 유효 값은 기본값인overlayfs와 SOCI 인덱스로 지연 로딩할 때 사용하는soci입니다. 이 파라미터는 Linux 플랫폼 버전 1.4.0에서 실행되는 태스크에서만 사용할 수 있어요.RestartCount— 컨테이너가 다시 시작된 횟수. 참고:RestartCount메타데이터는 컨테이너에 대해 재시작 정책이 활성화된 경우에만 포함됩니다.ClockDrift— 기준 시간(reference time)과 시스템 시간 사이의 차이에 대한 정보. 이 기능은 Amazon Time Sync Service를 사용해 클록 정확도를 측정하고 컨테이너의 클록 오류 한계를 제공합니다. 자세한 내용은 Amazon EC2 사용자 가이드(Linux 인스턴스)의 Linux 인스턴스 시간 설정(Set the time for your Linux instance)을 참고하세요.ReferenceTime— 클록 정확도의 기준. Amazon ECS는 NTP를 통해 UTC(Coordinated Universal Time) 글로벌 표준을 사용해요. 예:2021-09-07T16:57:44Z.ClockErrorBound— 클록 오류의 측정값으로, UTC로부터의 오프셋으로 정의됩니다. 이 오류는 기준 시간과 시스템 시간 사이의 밀리초 차이입니다.ClockSynchronizationStatus— 시스템 시간과 기준 시간 사이의 가장 최근 동기화 시도가 성공했는지 여부를 나타냅니다. 유효 값은SYNCHRONIZED와NOT_SYNCHRONIZED.
ExecutionStoppedAt— 태스크의DesiredStatus가STOPPED로 이동한 타임스탬프. 이는 essential 컨테이너가STOPPED로 이동할 때 발생합니다.