# Amazon ECS 컨테이너 인스턴스 상태 모니터링
<a name="container-instance-health"></a>

Amazon ECS는 컨테이너 인스턴스 상태 모니터링을 제공합니다. Amazon ECS가 컨테이너 인스턴스에서 컨테이너를 실행하지 못하게 할 수 있는 문제를 감지했는지를 빠르게 확인할 수 있습니다. Amazon ECS는 문제를 식별하기 위해 에이전트 버전 `1.57.0` 이상으로 실행 중인 모든 컨테이너 인스턴스에 대해 자동 검사를 수행합니다. 컨테이너 인스턴스의 에이전트 버전 확인에 대한 자세한 정보는 [Amazon ECS 컨테이너 에이전트 업데이트](ecs-agent-update.md) 섹션을 참조하세요.

AWS CLI 버전 `1.22.3` 이상 또는 AWS CLI 버전 `2.3.6` 이상을 사용해야 합니다. AWS CLI 업데이트 방법에 대한 자세한 정보는 *AWS Command Line Interface 버전 2 사용 설명서*의 [최신 버전의 AWS CLI 설치 또는 업데이트](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)를 참조하세요.

`CONTAINER_INSTANCE_HEALTH` 옵션과 함께 `describe-container-instances`를 실행하여 컨테이너 인스턴스를 보는 방법.

`overallStatus`은(는) `details` 배열의 개별 상태 확인 상태에 따라 결정됩니다. 가장 심각한 상태가 `IMPAIRED`, `INSUFFICIENT_DATA`, `INITIALIZING`, `OK` 순서대로 우선순위를 갖습니다.

`overallStatus`의 유효한 값은 다음과 같습니다.
+ `OK` – 모든 상태 확인이 통과되었습니다.
+ `IMPAIRED` – 하나 이상의 상태 확인이 실패했습니다.
+ `INSUFFICIENT_DATA` – 하나 이상의 상태 확인을 사용할 수 없습니다.
+ `INITIALIZING` – 하나 이상의 상태 확인이 초기화 중입니다.

다음은 `describe-container-instances`를 실행하는 방법을 보여주는 예제입니다.

```
aws ecs describe-container-instances \
     --cluster cluster_name \
     --container-instances 47279cd2cadb41cbaef2dcEXAMPLE \
     --include CONTAINER_INSTANCE_HEALTH
```

다음은 출력에 있는 상태 객체의 예입니다.

```
"healthStatus": {
	"overallStatus": "OK",
	"details": [{
		"type": "CONTAINER_RUNTIME",
		"status": "OK",
		"lastUpdated": "2021-11-10T03:30:26+00:00",
		"lastStatusChange": "2021-11-10T03:26:41+00:00"
	}]
}
```

## 컨테이너 인스턴스 상태 문제
<a name="container-instance-health-action"></a>

`OK` 이외의 `overallStatus` 상태가 있을 경우 다음을 시도하세요.
+ `describe-container-instances` 대기 후 실행
+ EC2 콘솔에서 또는 CLI를 사용하여 컨테이너 인스턴스 상태를 확인합니다.
+ CloudWatch 지표 검토 자세한 내용은 [CloudWatch를 사용하여 Amazon ECS 모니터링](cloudwatch-metrics.md) 섹션을 참조하세요.
+ AWS Health Dashboard를 확인하여 서비스에 알려진 문제가 있는지 확인합니다.