Amazon ECS Managed Instances 태스크용 태스크 메타데이터 v4 예제
Amazon ECS Managed Instances 태스크용 태스크 메타데이터 v4 예제
다음 예제는 Amazon ECS Managed Instances에서 실행되는 Amazon ECS 태스크의 태스크 메타데이터 엔드포인트에서 나오는 샘플 출력을 보여 줘요. 컨테이너에서 curl 다음에 태스크 메타데이터 엔드포인트를 사용해 엔드포인트를 조회할 수 있어요. 예: curl $ { ECS_CONTAINER_METADATA_URI_V4}/task .
출처: 문서
본문
컨테이너 메타데이터 응답 예제
$ { ECS_CONTAINER_METADATA_URI_V4} 엔드포인트를 조회하면 컨테이너 자체에 대한 메타데이터만 반환돼요. 다음은 예제 출력이에요.
{
"DockerId": "400c0466d1e54c0691aae0f86e0f9dc6-2531612879",
"Name": "nginx",
"DockerName": "nginx",
"Image": "public.ecr.aws/nginx/nginx:latest"
"ImageID": "sha256:d5f28ef21aabddd098f3dbc21fe5b7a7d7a184720bc07da0b6c9b9820e97f25e",
"Labels": {
"com.amazonaws.ecs.cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/managed-instances-cluster",
"com.amazonaws.ecs.container-name": "curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6",
"com.amazonaws.ecs.task-definition-family": "ecs-managed-instances-task-def",
"com.amazonaws.ecs.task-definition-version": "7"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 2 },
"CreatedAt": "2025-09-24T19:39:04.88336233Z",
"StartedAt": "2025-09-24T19:39:04.88336233Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/managed-instances-task-def",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/nginx/400c0466d1e54c0691aae0f86e0f9dc6"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6/3703f0e4-a351-4f1e-a0e7-6981ea7adc8b",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": ["172.31.62.223"],
"AttachmentIndex": 0,
"MACAddress": "0e:41:0b:1e:f2:fb",
"IPv4SubnetCIDRBlock": "172.31.48.0/20",
"PrivateDNSName": "ip-172-31-62-223.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "172.31.48.1/20"
}
],
"Snapshotter": "overlayfs"
}
Amazon ECS Managed Instances 태스크용 Amazon ECS 태스크 메타데이터 v4 예제
$ { ECS_CONTAINER_METADATA_URI_V4}/task 엔드포인트를 조회하면 컨테이너가 속한 태스크에 대한 메타데이터가 반환돼요. 다음은 예제 출력이에요.
{
"Cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/managed-instances-cluster",
"TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6",
"Family": "managed-instances-task-def",
"Revision": "7",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 1, "Memory": 3072 },
"PullStartedAt": "2025-09-24T19:38:58.682942001Z",
"PullStoppedAt": "2025-09-24T19:39:03.091597524Z",
"AvailabilityZone": "us-west-2d",
"LaunchType": "MANAGED_INSTANCES",
"Containers": [
{
"DockerId": "400c0466d1e54c0691aae0f86e0f9dc6-2531612879",
"Name": "curl",
"DockerName": "curl",
"Image": "nginx",
"ImageID": "sha256:d5f28ef21aabddd098f3dbc21fe5b7a7d7a184720bc07da0b6c9b9820e97f25e",
"Labels": {
"com.amazonaws.ecs.cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/managed-instances-cluster",
"com.amazonaws.ecs.container-name": "nginx",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6",
"com.amazonaws.ecs.task-definition-family": "managed-instances-task-def",
"com.amazonaws.ecs.task-definition-version": "7"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 2 },
"CreatedAt": "2025-09-24T19:39:04.88336233Z",
"StartedAt": "2025-09-24T19:39:04.88336233Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/managed-instances-task-def",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/nginx/400c0466d1e54c0691aae0f86e0f9dc6"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6/3703f0e4-a351-4f1e-a0e7-6981ea7adc8b",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": ["172.31.62.223"],
"AttachmentIndex": 0,
"MACAddress": "0e:41:0b:1e:f2:fb",
"IPv4SubnetCIDRBlock": "172.31.48.0/20",
"PrivateDNSName": "ip-172-31-62-223.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "172.31.48.1/20"
}
],
"Snapshotter": "overlayfs"
}
],
"ServiceName": "exec-service-2",
"ClockDrift": {
"ClockErrorBound": 0.14120749999999999,
"ReferenceTimestamp": "2025-09-24T19:48:37Z",
"ClockSynchronizationStatus": "SYNCHRONIZED"
},
"FaultInjectionEnabled": false
}
태스크 통계 응답 예제
$ { ECS_CONTAINER_METADATA_URI_V4}/task/stats 엔드포인트를 조회하면 컨테이너가 속한 태스크에 대한 네트워크 메트릭이 반환돼요. 다음은 예제 출력이에요.
{
"400c0466d1e54c0691aae0f86e0f9dc6-2531612879": {
"read": "2025-09-24T19:51:54.899736614Z",
"preread": "2025-09-24T19:51:44.901199024Z",
"pids_stats": {},
"blkio_stats": {
"io_service_bytes_recursive": [
{ "major": 259, "minor": 1, "op": "read", "value": 0 },
{ "major": 259, "minor": 1, "op": "write", "value": 131072 },
{ "major": 259, "minor": 0, "op": "read", "value": 48173056 },
{ "major": 259, "minor": 0, "op": "write", "value": 0 },
{ "major": 252, "minor": 0, "op": "read", "value": 48173056 },
{ "major": 252, "minor": 0, "op": "write", "value": 0 }
],
"io_serviced_recursive": null,
"io_queue_recursive": null,
"io_service_time_recursive": null,
"io_wait_time_recursive": null,
"io_merged_recursive": null,
"io_time_recursive": null,
"sectors_recursive": null
},
"num_procs": 0,
"storage_stats": {},
"cpu_stats": {
"cpu_usage": {
"total_usage": 670462000,
"usage_in_kernelmode": 276072000,
"usage_in_usermode": 394389000
},
"system_cpu_usage": 787660000000,
"online_cpus": 1,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"precpu_stats": {
"cpu_usage": {
"total_usage": 663809000,
"usage_in_kernelmode": 273333000,
"usage_in_usermode": 390476000
},
"system_cpu_usage": 777710000000,
"online_cpus": 1,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"memory_stats": {
"usage": 83562496,
"stats": {
"active_anon": 24576,
"active_file": 258048,
"anon": 32264192,
"anon_thp": 0,
"file": 48533504,
"file_dirty": 0,
"file_mapped": 36286464,
"file_writeback": 0,
"inactive_anon": 32243712,
"inactive_file": 48271360,
"kernel_stack": 442368,
"pgactivate": 6,
"pgdeactivate": 0,
"pgfault": 18936,
"pglazyfree": 0,
"pglazyfreed": 0,
"pgmajfault": 311,
"pgrefill": 0,
"pgscan": 0,
"pgsteal": 0,
"shmem": 4096,
"slab": 1598960,
"slab_reclaimable": 1080040,
"slab_unreclaimable": 518920,
"sock": 0,
"thp_collapse_alloc": 0,
"thp_fault_alloc": 0,
"unevictable": 0,
"workingset_activate": 0,
"workingset_nodereclaim": 0,
"workingset_refault": 0
},
"limit": 18446744073709551615
},
"name": "nginx",
"id": "400c0466d1e54c0691aae0f86e0f9dc6-2531612879"
}
}