# 향상된 관찰성 지표를 갖춘 Amazon ECS Container Insights
<a name="Container-Insights-enhanced-observability-metrics-ECS"></a>

향상된 관찰성을 갖춘 Container Insights는 다음 기능을 제공하여 컨테이너화된 워크로드에 대한 심층적인 가시성을 제공합니다.
+ 작업 및 컨테이너 수준 모두에서 보다 높은 지표 세분화
+ 모니터링 및 문제 해결 기능 개선
+ CloudWatch Logs와 통합으로 지원되는 기능:
  + 로그 항목에 지표 이상 연관
  + 더 빠른 근본 원인 분석 수행
  + 복잡한 컨테이너 문제의 해결 시간 단축

**사용 사례**

향상된 관찰성을 갖춘 Container Insights는 표준 Container Insights의 기능을 확장합니다. 다음 사용 사례를 지원합니다.
+ **태스크 수준 문제 해결** - 태스크 수준에서 성능 병목 현상을 식별합니다. 태스크 수준 지표를 분석하고 예약된 리소스와 비교하여 태스크에 충분한 처리 용량이 있는지 확인합니다.
+ **컨테이너 수준 리소스 최적화** - 예약 수준 대비 사용률을 추적하여 리소스가 제한되거나 과다 프로비저닝된 컨테이너 식별 
+ **컨테이너 상태 평가** - 재시작 수 및 상태 전환을 모니터링하여 개입이 필요한 불안정한 컨테이너 감지 
+ **애플리케이션 성능 모니터링** - 애플리케이션이 서로 통신하는 방식을 추적하고, 리소스 사용 패턴을 모니터링하며, 데이터 스토리지 성능 최적화
+ **작업 모니터링** - 배포를 모니터링하고, 블루 또는 그린 배포에 대한 태스크 세트를 추적하며, 서비스 지표를 통해 플랫폼 상태 유지

Amazon ECS 지표에 대한 자세한 내용은 [Amazon ECS 서비스 사용률 지표 사용 사례](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service_utilization-metrics-explanation.html), 향상된 관찰성을 갖춘 Container Insights에 대한 자세한 내용은 [향상된 관찰성 지표를 갖춘 Amazon ECS Container Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-enhanced-observability-metrics-ECS.html)를 참조하세요.

또한 Container Insights는 모든 태스크의 데이터를 평균화하여 클러스터, 서비스 및 대몬 전반의 통계도 표시합니다. 이를 통해 서비스 및 대몬 상태를 더 개략적으로 파악할 수 있으므로 환경 모니터링과 용량 계획에 모두 유용합니다.

**참고**  
Amazon ECS 관리형 대몬 지표는 서비스 지표와 동일한 `ECS/ContainerInsights` 네임스페이스와 `ServiceName` 차원을 사용합니다. 대몬 지표의 경우 `ServiceName` 차원 값은 `daemon:{{daemon-name}}` 형식을 사용합니다. 예를 들어 `my-daemon` 대몬에서 `ServiceName` 차원 값이 `daemon:my-daemon`입니다. `ServiceName` 차원을 포함하는 아래 표의 모든 지표는 관리형 대몬에도 적용됩니다.

아래 표에는 향상된 관찰성을 갖춘 Container Insights가 Amazon ECS에 대해 수집하는 지표 및 측정기준이 나와 있습니다. 이러한 지표는 `ECS/ContainerInsights` 네임스페이스에 있습니다. 자세한 내용은 [Metrics](cloudwatch_concepts.md#Metric) 섹션을 참조하세요.

콘솔에 Container Insights 지표가 표시되지 않는 경우, 향상된 관찰성을 갖춘 Container Insights 설정을 완료했는지 확인합니다. 향상된 관찰성을 갖춘 Container Insights 설정이 완료되기 전에는 지표가 표시되지 않습니다. 자세한 내용은 [향상된 관찰 기능을 갖춘 Container Insights 설정](deploy-container-insights-ECS-cluster.md#set-container-insights-ECS-cluster-enhanced) 섹션을 참조하세요.

아래의 지표는 모든 시작 유형에 사용 가능합니다.


| 지표 이름 | 측정 기준 | 설명 | 
| --- | --- | --- | 
| `ContainerInstanceCount` | `ClusterName` | 클러스터에 등록된 Amazon ECS 에이전트를 실행하는 EC2 인스턴스의 수입니다.<br />이 지표는 클러스터에서 Amazon ECS 작업을 실행하는 컨테이너 인스턴스에 대해서만 수집됩니다. Amazon ECS 작업이 없는 빈 컨테이너 인스턴스에 대해서는 수집되지 않습니다.<br />단위: 수 | 
| `ContainerCpuUtilized` | `ClusterName`<br />`ContainerName`, `TaskId`, `ServiceName`, `ClusterName`<br />`ContainerName`, `TaskDefinitionFamily`, `ClusterName`, `TaskId`<br />`TaskDefinitionFamily`, `ClusterName`, `ContainerName`<br />`ServiceName`, `ClusterName`, `ContainerName` | 사용 중인 측정기준 세트로 지정된 리소스의 컨테이너에서 사용하는 CPU 단위입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 없음 | 
| `ContainerCpuReserved` | `ClusterName`<br />`ContainerName`, `TaskId`, `ServiceName`, `ClusterName`<br />`ContainerName`, `TaskDefinitionFamily`, `ClusterName`, `TaskId`<br />`TaskDefinitionFamily`, `ClusterName`, `ContainerName`<br />`ServiceName`, `ClusterName`, `ContainerName` | 사용 중인 측정기준 세트에서 지정한 리소스의 컨테이너에서 예약된 CPU 단위입니다. 이 지표는 작업 또는 모든 컨테이너 수준과 같이 작업 정의에 정의된 CPU 예약을 기반으로 수집됩니다. 작업 정의에 지정되지 않은 경우 인스턴스 CPU 예약이 사용됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 없음 | 
| `ContainerCpuUtilization` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`  | 사용 중인 측정기준 세트로 지정된 리소스의 컨테이너에서 사용 중인 총 CPU 단위의 비율입니다.<br />단위: 퍼센트 | 
| `ContainerMemoryUtilized` | `ClusterName`<br />`ContainerName`, `TaskId`, `ServiceName`, `ClusterName`<br />`ContainerName`, `TaskDefinitionFamily`, `ClusterName`, `TaskId`<br />`TaskDefinitionFamily`, `ClusterName`, `ContainerName`<br />`ServiceName`, `ClusterName`, `ContainerName` | 사용 중인 측정기준 세트로 지정된 리소스의 컨테이너에서 사용 중인 메모리입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 메가바이트 | 
| `ContainerMemoryReserved` | `ClusterName`<br />`ContainerName`, `TaskId`, `ServiceName`, `ClusterName`<br />`ContainerName`, `TaskDefinitionFamily`, `ClusterName`, `TaskId`<br />`TaskDefinitionFamily`, `ClusterName`, `ContainerName`<br />`ServiceName`, `ClusterName`, `ContainerName` | 사용 중인 측정기준 세트에서 지정한 리소스의 컨테이너에서 예약된 메모리입니다.<br />이 지표는 작업 또는 모든 컨테이너 수준과 같이 작업 정의에 정의된 메모리 예약을 기반으로 수집됩니다. 작업 정의에 지정되지 않은 경우 인스턴스 메모리 예약이 사용됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 메가바이트 | 
| `ContainerMemoryUtilization` | `ClusterName`<br />`ContainerName`, `TaskId`, `ServiceName`, `ClusterName`<br />`ContainerName`, `TaskDefinitionFamily`, `ClusterName`, `TaskId`<br />`TaskDefinitionFamily`, `ClusterName`, `ContainerName`<br />`ServiceName`, `ClusterName`, `ContainerName` | 사용 중인 측정기준 세트로 지정된 리소스의 컨테이너에서 사용 중인 총 메모리 비율입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 퍼센트 | 
| `ContainerNetworkRxBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 측정기준에서 지정한 컨테이너에서 수신된 바이트의 숫자입니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />이 지표는 `awsvpc` 또는 `bridge` 네트워크 모드를 사용하는 태스크의 컨테이너에 대해서만 제공됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트/초 | 
| `ContainerNetworkTxBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 측정기준에서 지정한 컨테이너에서 전송된 바이트의 숫자입니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />이 지표는 `awsvpc` 또는 `bridge` 네트워크 모드를 사용하는 태스크의 컨테이너에 대해서만 제공됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트/초 | 
| `ContainerStorageReadBytes` | `ClusterName`<br />`ClusterName`, `ServiceName`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `ContainerName`<br />`ClusterName`, `ServiceName`, `TaskId`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`, `ContainerName` | 사용 중인 측정기준에서 지정한 리소스의 컨테이너에 있는 스토리지에서 읽힌 바이트의 숫자입니다. 스토리지 디바이스의 읽기 바이트는 여기에 포함되지 않습니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트 | 
| `ContainerStorageWriteBytes` | `ClusterName`<br />`ClusterName`, `ServiceName`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `ContainerName`<br />`ClusterName`, `ServiceName`, `TaskId`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`, `ContainerName` | 사용 중인 측정기준에서 지정한 컨테이너의 스토리지에서 쓰여진 바이트의 숫자입니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트 | 
| `CpuUtilized` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`  | 사용 중인 측정기준 세트로 지정된 리소스의 작업에서 사용하는 CPU 단위입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 없음 | 
| `CpuReserved` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 측정기준 세트에서 지정한 리소스의 작업에서 예약된 CPU 단위입니다. 이 지표는 작업 또는 모든 컨테이너 수준과 같이 작업 정의에 정의된 CPU 예약을 기반으로 수집됩니다. 작업 정의에 지정되지 않은 경우 인스턴스 CPU 예약이 사용됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 없음 | 
| `DeploymentCount` | `ServiceName`, `ClusterName` | Amazon ECS 서비스의 배포 수입니다.<br />단위: 수 | 
| `DesiredTaskCount` | `ServiceName`, `ClusterName` | Amazon ECS 서비스에 대해 원하는 태스크 수입니다.<br />단위: 수 | 
| `EBSFilesystemSize` | `ClusterName` ,`TaskDefinitionFamily`, `VolumeName`<br />`TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName` | 사용 중인 차원으로 지정된 리소스에 할당된 Amazon EBS 파일 시스템 스토리지의 총량(GB)<br />이 지표는 플랫폼 버전 `1.4.0`을(를) 사용하는 Fargate에서 실행되는 Amazon ECS 인프라 또는 컨테이너 에이전트 버전 `1.79.0` 이상을 사용하는 Amazon EC2 인스턴스에서 실행되는 작업에만 사용할 수 있습니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 기가바이트(GB) | 
| `EBSFilesystemUtilized` | `ClusterName` ,`TaskDefinitionFamily`, `VolumeName`<br />`TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName` | 사용 중인 차원으로 지정된 리소스에서 사용하는 Amazon EBS 파일 시스템 스토리지의 총량(GB)<br />이 지표는 플랫폼 버전 `1.4.0`을(를) 사용하는 Fargate에서 실행되는 Amazon ECS 인프라 또는 컨테이너 에이전트 버전 `1.79.0` 이상을 사용하는 Amazon EC2 인스턴스에서 실행되는 작업에만 사용할 수 있습니다.<br />Fargate에서 실행되는 작업의 경우 Fargate는 Fargate만 사용하는 디스크 공간을 예약합니다. Fargate가 사용하는 공간에는 비용이 들지 않지만 `df`와 같은 도구를 사용하면 이 추가 스토리지를 확인할 수 있습니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 기가바이트(GB) | 
| `TaskEBSFilesystemUtilization` | `TaskDefinitionFamily`, `ClusterName`<br />`ClusterName`, `ServiceName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`TaskDefinitionFamily`, `ClusterName`, `TaskId` | 사용 중인 차원으로 지정된 태스크에서 사용 중인 Amazon EBS 파일 시스템 스토리지의 백분율.<br />이 지표는 플랫폼 버전 `1.4.0`을(를) 사용하는 Fargate에서 실행되는 Amazon ECS 인프라 또는 컨테이너 에이전트 버전 `1.79.0` 이상을 사용하는 Amazon EC2 인스턴스에서 실행되는 작업에만 사용할 수 있습니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 퍼센트 | 
|  EphemeralStorageReserved [1](#ci-enhanced-metrics-ecs-storage-fargate-note)  | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 차원으로 지정된 리소스의 임시 스토리지에서 예약된 바이트 수입니다. 임시 스토리지는 컨테이너 루트 파일 시스템과 컨테이너 이미지 및 작업 정의에 정의된 모든 바인드 마운트 호스트 볼륨에 사용됩니다. 임시 스토리지의 양은 실행 중인 작업에서 변경할 수 없습니다.<br />이 지표는 Fargate Linux 플랫폼 버전 1.4.0 이상에서 실행되는 작업에만 사용할 수 있습니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 기가바이트(GB) | 
|  EphemeralStorageUtilized [1](Container-Insights-metrics-ECS.md#ci-metrics-ecs-storage-fargate-note)  | `ClusterName`<br />`ClusterName`, `TaskDefinitionFamily`<br />`ClusterName`, `ServiceName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 차원으로 지정된 리소스의 임시 스토리지에서 사용된 바이트 수입니다. 임시 스토리지는 컨테이너 루트 파일 시스템과 컨테이너 이미지 및 작업 정의에 정의된 모든 바인드 마운트 호스트 볼륨에 사용됩니다. 임시 스토리지의 양은 실행 중인 작업에서 변경할 수 없습니다.<br />이 지표는 Fargate Linux 플랫폼 버전 1.4.0 이상에서 실행되는 작업에만 사용할 수 있습니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 기가바이트(GB) | 
| `MemoryUtilized` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 측정기준 세트로 지정된 리소스의 작업에서 사용 중인 메모리입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 메가바이트 | 
| `MemoryReserved` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 측정기준 세트에서 지정한 리소스의 작업에서 예약된 메모리입니다.<br />이 지표는 작업 또는 모든 컨테이너 수준과 같이 작업 정의에 정의된 메모리 예약을 기반으로 수집됩니다. 작업 정의에 지정되지 않은 경우 인스턴스 메모리 예약이 사용됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 메가바이트 | 
| `NetworkRxBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용중인 측정기준에서 지정한 리소스에서 수신된 바이트의 숫자입니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />이 지표는 `awsvpc` 또는 `bridge` 네트워크 모드를 사용하는 태스크의 컨테이너에 대해서만 제공됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트/초 | 
| `NetworkTxBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용중인 측정기준에서 지정한 리소스에서 전송된 바이트의 숫자입니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />이 지표는 `awsvpc` 또는 `bridge` 네트워크 모드를 사용하는 태스크의 컨테이너에 대해서만 제공됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트/초 | 
| `PendingTaskCount` | `ServiceName`, `ClusterName` | 현재 `PENDING` 상태인 작업의 숫자입니다.<br />단위: 수 | 
| `RunningTaskCount` | `ServiceName`, `ClusterName` | 현재 `RUNNING` 상태인 작업의 숫자입니다.<br />단위: 수 | 
| `RestartCount` | `ClusterName`<br />`ClusterName`, `ServiceName`<br />`ClusterName`, `TaskDefinitionFamily`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`<br />`ClusterName`, `ServiceName`, `ContainerName`<br />`ClusterName`, `ServiceName`, `TaskId`, `ContainerName`<br />`TaskDefinitionFamily`, `ClusterName`, `ContainerName`<br />`TaskDefinitionFamily`, `ClusterName`, `TaskId`, `ContainerName` | Amazon ECS 태스크에서 컨테이너가 다시 시작된 횟수입니다.<br />이 지표는 재시작 정책이 활성화된 컨테이너의 경우에만 수집됩니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 수 | 
| `UnHealthyContainerHealthStatus` | `ClusterName`<br />`ClusterName`, `ServiceName`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `ContainerName`<br />`ClusterName`, `ServiceName`, `TaskId`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`, `ContainerName` | 컨테이너 상태 확인 상태에 기반한 비정상 컨테이너 수. 상태 확인에서 비정상 상태가 반환되면 컨테이너는 비정상으로 간주됩니다.<br />이 지표는 태스크 정의에 상태 확인이 구성된 컨테이너에 대해서만 수집됩니다.<br />지표 값은 컨테이너 상태가 `UNHEALTHY`인 경우 1, 상태가 `HEALTHY`인 경우 0입니다.<br />단위: 수 | 
| `ServiceCount` | `ClusterName` | 클러스터의 서비스 숫자입니다.<br />단위: 수 | 
| `StorageReadBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 측정기준에서 지정한 리소스의 인스턴스에 있는 스토리지에서 읽힌 바이트의 숫자입니다. 스토리지 디바이스의 읽기 바이트는 여기에 포함되지 않습니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트 | 
| `StorageWriteBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId` | 사용 중인 측정기준에서 지정한 리소스의 스토리지에서 쓰여진 바이트의 숫자입니다. 이 지표는 Docker 런타임에서 가져옵니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 바이트 | 
| `TaskCount` | `ClusterName` | 클러스터에서 실행 중인 태스크의 수입니다.<br />단위: 수 | 
| `TaskCpuUtilization` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`  | 태스크에서 사용 중인 총 CPU 유닛의 백분율입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 퍼센트 | 
| `TaskEphemeralStorageUtilization` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`  | 태스크에서 사용 중인 임시 스토리지의 총 백분율입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 퍼센트 | 
| `TaskMemoryUtilization` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`  | 태스크에서 사용 중인 메모리의 총 백분율입니다.<br />관리형 대몬에도 적용됩니다.<br />단위: 퍼센트 | 
| `TaskSetCount` | `ServiceName`, `ClusterName` | 서비스의 작업 세트 숫자입니다.<br />단위: 수 | 
| `ContainerGPUUtilization` | `ClusterName`<br />`ClusterName`, `ServiceName`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `ContainerName`<br />`ClusterName`, `ServiceName`, `TaskId`, `ContainerName`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`, `ContainerName`<br />`ClusterName`, `ServiceName`, `TaskId`, `ContainerName`, `AcceleratedDevice` | 컨테이너에 할당된 GPU의 활용률.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 퍼센트 | 
| `ContainerGPUMemoryUtilization` | `ContainerGPUUtilization`와 동일합니다. | 컨테이너에 할당된 GPU에서 사용되는 프레임 버퍼 메모리 비율.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 퍼센트 | 
| `ContainerGPUMemoryTotal` | `ContainerGPUUtilization`와 동일합니다. | 컨테이너에 할당된 GPU의 총 프레임 버퍼 바이트 규모.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 바이트 | 
| `ContainerGPUMemoryUsed` | `ContainerGPUUtilization`와 동일합니다. | 컨테이너에 할당된 GPU에서 사용되는 프레임 버퍼 메모리(바이트).<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 바이트 | 
| `ContainerGPUPowerDraw` | `ContainerGPUUtilization`와 동일합니다. | 컨테이너에 할당된 GPU의 전력 사용량(와트).<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 와트 | 
| `ContainerGPUTemperature` | `ContainerGPUUtilization`와 동일합니다. | 컨테이너에 할당된 GPU의 온도(섭씨).<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 섭씨 | 
| `ContainerGPURestartAppXidCount` | `ContainerGPUUtilization`와 동일합니다. | 컨테이너에 할당된 GPU에서 관찰된 즉각적인 작업 해결 버킷이 `RESTART_APP`인 NVIDIA Xid 오류 수.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 수 | 
| `TaskGPUUtilization` | `ClusterName`<br />`ClusterName`, `ServiceName`<br />`ClusterName`, `TaskDefinitionFamily`<br />`ClusterName`, `ServiceName`, `TaskId`<br />`ClusterName`, `TaskDefinitionFamily`, `TaskId`<br />`ClusterName`, `ServiceName`, `TaskId`, `AcceleratedDevice` | 태스크에 할당된 GPU의 활용률.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 퍼센트 | 
| `TaskGPUMemoryUtilization` | `TaskGPUUtilization`와 동일합니다. | 태스크에 할당된 GPU에서 사용되는 프레임 버퍼 메모리 비율.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 퍼센트 | 
| `TaskGPUMemoryTotal` | `TaskGPUUtilization`와 동일합니다. | 태스크에 할당된 GPU의 총 프레임 버퍼 크기(바이트).<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 바이트 | 
| `TaskGPUMemoryUsed` | `TaskGPUUtilization`와 동일합니다. | 태스크에 할당된 GPU에서 사용되는 프레임 버퍼 메모리(바이트).<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 바이트 | 
| `TaskGPUPowerDraw` | `TaskGPUUtilization`와 동일합니다. | 태스크에 할당된 GPU의 전력 사용량(와트).<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 와트 | 
| `TaskGPUTemperature` | `TaskGPUUtilization`와 동일합니다. | 태스크에 할당된 GPU 온도(섭씨).<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 섭씨 | 
| `TaskGPURestartAppXidCount` | `TaskGPUUtilization`와 동일합니다. | 태스크에 할당된 GPU에서 관찰된 즉각적인 작업 해결 버킷이 `RESTART_APP`인 NVIDIA Xid 오류 수.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 수 | 

**참고**  
`EphemeralStorageReserved` 및 `EphemeralStorageUtilized` 지표는 Fargate Linux 플랫폼 버전 1.4.0 이상에서 실행되는 작업에만 사용할 수 있습니다.  
Fargate는 디스크 공간을 예약합니다. Fargate에서만 사용됩니다. 이에 대한 요금은 청구되지 않습니다. 이러한 지표에는 표시되지 않습니다. 그러나 `df` 등의 다른 도구에서는 이 추가 스토리지를 볼 수 있습니다.

다음 지표는 [CloudWatch 에이전트를 배포하여 Amazon ECS의 EC2 인스턴스 수준 지표 수집](deploy-container-insights-ECS-instancelevel.md)의 단계를 완료하고 EC2 시작 유형을 사용하는 경우 사용 가능합니다.


| 지표 이름 | 측정 기준 | 설명 | 
| --- | --- | --- | 
| `instance_cpu_limit` | `ClusterName` | 클러스터의 단일 EC2 인스턴스에 할당할 수 있는 최대 CPU 단위 수입니다.<br />단위: 없음 | 
| `instance_cpu_reserved_capacity` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 현재 예약 중인 CPU의 비율입니다.<br />단위: 퍼센트 | 
| `instance_cpu_usage_total` | `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 사용 중인 CPU 단위 수입니다.<br />단위: 없음 | 
| `instance_cpu_utilization` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 사용 중인 CPU 단위의 총 비율입니다.<br />단위: 퍼센트 | 
| `instance_filesystem_utilization` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 사용 중인 파일 시스템 용량의 총 비율입니다.<br />단위: 퍼센트 | 
| `instance_memory_limit` | `ClusterName` | 이 클러스터의 단일 EC2 인스턴스에 할당할 수 있는 최대 메모리 양(바이트)입니다.<br />단위: 바이트 | 
| `instance_memory_reserved_capacity` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 현재 예약 중인 메모리의 비율입니다.<br />단위: 퍼센트 | 
| `instance_memory_utilization` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 사용 중인 메모리의 총 비율입니다. 애플리케이션에 Java ZGC 가비지 수집기를 사용하는 경우에는 이 지표가 부정확할 수 있습니다. <br />단위: 퍼센트 | 
| `instance_memory_working_set` | `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 사용 중인 메모리의 양(바이트)입니다. 애플리케이션에 Java ZGC 가비지 수집기를 사용하는 경우에는 이 지표가 부정확할 수 있습니다. <br />단위: 바이트 | 
| `instance_network_total_bytes` | `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 네트워크를 통해 전송 및 수신된 초당 총 바이트 수입니다.<br />단위: 바이트/초 | 
| `instance_number_of_running_tasks` | `ClusterName` | 클러스터의 단일 EC2 인스턴스에서 실행 중인 작업 수입니다.<br />단위: 수 | 
| `InstanceGPULimit` | `ClusterName`<br />`ClusterName`, `CapacityProviderName`<br />`ClusterName`, `CapacityProviderName`, `ContainerInstanceId`, `EC2InstanceId` | 인스턴스에서 사용 가능한 총 GPU 수.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 수 | 
| `InstanceGPUUsageTotal` | `InstanceGPULimit`와 동일합니다. | 인스턴스에서 실행 중인 태스크에 현재 할당된 GPU 수.<br />NVIDIA GPU 지원 Amazon EC2 인스턴스 유형을 실행하는 Amazon ECS 관리형 인스턴스에 대해서만 사용할 수 있습니다.<br />단위: 수 |