# Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 엔드포인트 버전 4 **중요** Amazon EC2 인스턴스에서 호스팅된 Amazon ECS 작업을 사용하는 경우 [Amazon ECS 작업 메타데이터 엔드포인트](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint.html)를 참조하세요. Fargate 플랫폼 버전 `1.4.0`부터 `ECS_CONTAINER_METADATA_URI_V4`라는 환경 변수가 태스크의 각 컨테이너에 주입됩니다. 작업 메타데이터 엔드포인트 버전 4를 쿼리하면 다양한 작업 메타데이터와 [Docker 통계](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)를 작업에 사용할 수 있습니다. 작업 메타데이터 엔드포인트 버전 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 응답](task-metadata-endpoint-v4-fargate-response.md) 섹션을 참조하세요. `${ECS_CONTAINER_METADATA_URI_V4}/stats` 이 경로는 Docker 컨테이너에 대한 Docker 통계를 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)를 참조하세요. AWS Fargate의 Amazon ECS 태스크는 컨테이너 통계를 반환하기 전에 \$11초 동안 컨테이너를 실행해야 합니다. `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` 이 경로는 태스크와 연결된 모든 컨테이너에 대한 Docker 통계를 반환합니다. 반환된 각 통계에 대한 자세한 내용은 Docker API 설명서의 [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)를 참조하세요. AWS Fargate의 Amazon ECS 태스크는 컨테이너 통계를 반환하기 전에 \$11초 동안 컨테이너를 실행해야 합니다. # Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v4 JSON 응답 다음 메타데이터가 작업 메타데이터 엔드포인트(`${ECS_CONTAINER_METADATA_URI_V4}/task`) JSON 응답에서 반환됩니다. `Cluster` 태스크가 속한 Amazon ECS 클러스터의 Amazon 리소스 이름(ARN) 또는 약어입니다. `ServiceName` 태스크가 속한 서비스의 이름입니다. 서비스와 연결된 Fargate 태스크에 대해 ServiceName이 표시됩니다. `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 작업의 개별 컨테이너 재시작](container-restart-policy.md) 섹션을 참조하세요. `ClockDrift` 기준 시간과 시스템 시간의 차이에 대한 정보입니다. 이 기능은 Amazon Time Sync Service를 사용하여 클럭 정확도를 측정하고 컨테이너에 대한 클록 오류 범위를 제공합니다. 자세한 내용은 *Amazon EC2 Linux용 사용 설명서*의 [Linux 인스턴스에 대한 시간 설정](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html)을 참조하세요. `ReferenceTime` 클록 정확도의 기초입니다. Amazon ECS는 NTP를 통해 협정 세계시(UTC) 글로벌 표준을 사용합니다(예: `2021-09-07T16:57:44Z`). `ClockErrorBound` UTC에 대한 오프셋으로 정의되는 클록 오류 측정값입니다. 이 오류는 기준 시간과 시스템 시간의 차이(밀리초)입니다. `ClockSynchronizationStatus` 시스템 시간과 기준 시간 간의 가장 최근 동기화 시도가 성공했는지를 나타냅니다. 유효 값은 `SYNCHRONIZED` 및 ` NOT_SYNCHRONIZED`입니다. `ExecutionStoppedAt` 태스크의 `DesiredStatus`가 `STOPPED`로 이동한 시간에 대한 타임스탬프입니다. 이 동작은 필수 컨테이너가 `STOPPED`로 이동할 때 발생합니다. # Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v4 예제 다음 예제에서는 AWS Fargate에서 실행되는 Amazon ECS 작업에 대한 작업 메타데이터 엔드포인트의 샘플 출력을 보여줍니다. 컨테이너에서 curl 뒤에 작업 메타데이터 엔드포인트를 사용하여 엔드포인트를 쿼리할 수 있습니다(예: `curl ${ECS_CONTAINER_METADATA_URI_V4}/task`). ## 예제 컨테이너 메타데이터 응답 `${ECS_CONTAINER_METADATA_URI_V4}` 엔드포인트를 쿼리할 때 컨테이너 자체에 대한 메타데이터만 반환됩니다. 다음은 예시 출력입니다. ``` { "DockerId": "cd189a933e5849daa93386466019ab50-2495160603", "Name": "curl", "DockerName": "curl", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:25f3695bedfb454a50f12d127839a68ad3caf91e451c1da073db34c542c4d2cb", "Labels": { "com.amazonaws.ecs.cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/cd189a933e5849daa93386466019ab50", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "2" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-08T20:09:11.44527186Z", "StartedAt": "2020-10-08T20:09:11.44527186Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "192.0.2.3" ], "AttachmentIndex": 0, "MACAddress": "0a:de:f6:10:51:e5", "IPv4SubnetCIDRBlock": "192.0.2.0/24", "DomainNameServers": [ "192.0.2.2" ], "DomainNameSearchList": [ "us-west-2.compute.internal" ], "PrivateDNSName": "ip-10-0-0-222.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "192.0.2.0/24" } ], "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/05966557-f16c-49cb-9352-24b3a0dcd0e1", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/containerlogs", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/cd189a933e5849daa93386466019ab50" }, "LogDriver": "awslogs", "Snapshotter": "overlayfs" } ``` ## Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v4 예제 `${ECS_CONTAINER_METADATA_URI_V4}/task` 엔드포인트를 쿼리할 때 컨테이너가 속한 태스크에 대한 메타데이터가 반환됩니다. 다음은 예시 출력입니다. ``` { "Cluster": "arn:aws:ecs:us-east-1:123456789012:cluster/MyEmptyCluster", "TaskARN": "arn:aws:ecs:us-east-1:123456789012:task/MyEmptyCluster/bfa2636268144d039771334145e490c5", "Family": "sample-fargate", "Revision": "5", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 0.25, "Memory": 512 }, "PullStartedAt": "2023-07-21T15:45:33.532811081Z", "PullStoppedAt": "2023-07-21T15:45:38.541068435Z", "AvailabilityZone": "us-east-1d", "Containers": [ { "DockerId": "bfa2636268144d039771334145e490c5-1117626119", "Name": "curl-image", "DockerName": "curl-image", "Image": "curlimages/curl", "ImageID": "sha256:daf3f46a2639c1613b25e85c9ee4193af8a1d538f92483d67f9a3d7f21721827", "Labels": { "com.amazonaws.ecs.cluster": "arn:aws:ecs:us-east-1:123456789012:cluster/MyEmptyCluster", "com.amazonaws.ecs.container-name": "curl-image", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-1:123456789012:task/MyEmptyCluster/bfa2636268144d039771334145e490c5", "com.amazonaws.ecs.task-definition-family": "sample-fargate", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 128 }, "CreatedAt": "2023-07-21T15:45:44.91368314Z", "StartedAt": "2023-07-21T15:45:44.91368314Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": ["172.31.42.189"], "AttachmentIndex": 0, "MACAddress": "0e:98:9f:33:76:d3", "IPv4SubnetCIDRBlock": "172.31.32.0/20", "DomainNameServers": ["172.31.0.2"], "DomainNameSearchList": ["ec2.internal"], "PrivateDNSName": "ip-172-31-42-189.ec2.internal", "SubnetGatewayIpv4Address": "172.31.32.1/20" } ], "ContainerARN": "arn:aws:ecs:us-east-1:123456789012:container/MyEmptyCluster/bfa2636268144d039771334145e490c5/da6cccf7-1178-400c-afdf-7536173ee209", "Snapshotter": "overlayfs" }, { "DockerId": "bfa2636268144d039771334145e490c5-3681984407", "Name": "fargate-app", "DockerName": "fargate-app", "Image": "public.ecr.aws/docker/library/httpd:latest", "ImageID": "sha256:8059bdd0058510c03ae4c808de8c4fd2c1f3c1b6d9ea75487f1e5caa5ececa02", "Labels": { "com.amazonaws.ecs.cluster": "arn:aws:ecs:us-east-1:123456789012:cluster/MyEmptyCluster", "com.amazonaws.ecs.container-name": "fargate-app", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-1:123456789012:task/MyEmptyCluster/bfa2636268144d039771334145e490c5", "com.amazonaws.ecs.task-definition-family": "sample-fargate", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 2 }, "CreatedAt": "2023-07-21T15:45:44.954460255Z", "StartedAt": "2023-07-21T15:45:44.954460255Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": ["172.31.42.189"], "AttachmentIndex": 0, "MACAddress": "0e:98:9f:33:76:d3", "IPv4SubnetCIDRBlock": "172.31.32.0/20", "DomainNameServers": ["172.31.0.2"], "DomainNameSearchList": ["ec2.internal"], "PrivateDNSName": "ip-172-31-42-189.ec2.internal", "SubnetGatewayIpv4Address": "172.31.32.1/20" } ], "ContainerARN": "arn:aws:ecs:us-east-1:123456789012:container/MyEmptyCluster/bfa2636268144d039771334145e490c5/f65b461d-aa09-4acb-a579-9785c0530cbc", "Snapshotter": "overlayfs" } ], "LaunchType": "FARGATE", "ClockDrift": { "ClockErrorBound": 0.446931, "ReferenceTimestamp": "2023-07-21T16:09:17Z", "ClockSynchronizationStatus": "SYNCHRONIZED" }, "EphemeralStorageMetrics": { "Utilized": 261, "Reserved": 20496 } } ``` ## 작업 통계 응답 예 `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` 엔드포인트를 쿼리할 때 컨테이너가 속한 태스크에 대한 네트워크 지표가 반환됩니다. 다음은 예시 출력입니다. ``` { "3d1f891cded94dc795608466cce8ddcf-464223573": { "read": "2020-10-08T21:24:44.938937019Z", "preread": "2020-10-08T21:24:34.938633969Z", "pids_stats": {}, "blkio_stats": { "io_service_bytes_recursive": [ { "major": 202, "minor": 26368, "op": "Read", "value": 638976 }, { "major": 202, "minor": 26368, "op": "Write", "value": 0 }, { "major": 202, "minor": 26368, "op": "Sync", "value": 638976 }, { "major": 202, "minor": 26368, "op": "Async", "value": 0 }, { "major": 202, "minor": 26368, "op": "Total", "value": 638976 } ], "io_serviced_recursive": [ { "major": 202, "minor": 26368, "op": "Read", "value": 12 }, { "major": 202, "minor": 26368, "op": "Write", "value": 0 }, { "major": 202, "minor": 26368, "op": "Sync", "value": 12 }, { "major": 202, "minor": 26368, "op": "Async", "value": 0 }, { "major": 202, "minor": 26368, "op": "Total", "value": 12 } ], "io_queue_recursive": [], "io_service_time_recursive": [], "io_wait_time_recursive": [], "io_merged_recursive": [], "io_time_recursive": [], "sectors_recursive": [] }, "num_procs": 0, "storage_stats": {}, "cpu_stats": { "cpu_usage": { "total_usage": 1137691504, "percpu_usage": [ 696479228, 441212276, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ], "usage_in_kernelmode": 80000000, "usage_in_usermode": 810000000 }, "system_cpu_usage": 9393210000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 1136624601, "percpu_usage": [ 695639662, 440984939, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ], "usage_in_kernelmode": 80000000, "usage_in_usermode": 810000000 }, "system_cpu_usage": 9373330000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 6504448, "max_usage": 8458240, "stats": { "active_anon": 1675264, "active_file": 557056, "cache": 651264, "dirty": 0, "hierarchical_memory_limit": 536870912, "hierarchical_memsw_limit": 9223372036854772000, "inactive_anon": 0, "inactive_file": 3088384, "mapped_file": 430080, "pgfault": 11034, "pgmajfault": 5, "pgpgin": 8436, "pgpgout": 7137, "rss": 4669440, "rss_huge": 0, "total_active_anon": 1675264, "total_active_file": 557056, "total_cache": 651264, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 3088384, "total_mapped_file": 430080, "total_pgfault": 11034, "total_pgmajfault": 5, "total_pgpgin": 8436, "total_pgpgout": 7137, "total_rss": 4669440, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 9223372036854772000 }, "name": "curltest", "id": "3d1f891cded94dc795608466cce8ddcf-464223573", "networks": { "eth1": { "rx_bytes": 2398415937, "rx_packets": 1898631, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 1259037719, "tx_packets": 428002, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 43.298687872232854, "tx_bytes_per_sec": 215.39347269466413 } } } ```