# Amazon ECS 컨테이너 인스턴스 상태 변경 이벤트
<a name="ecs_container_instance_health_events"></a>

다음과 같은 상황에서 컨테이너 인스턴스 상태 변경 이벤트가 발생합니다.

**Amazon ECS 컨테이너 에이전트가 컨테이너 런타임 상태의 변화를 감지합니다.**

컨테이너 에이전트는 컨테이너 인스턴스에서 컨테이너 런타임(예: Docker 대몬)의 상태를 주기적으로 평가합니다. 런타임이 응답하지 않거나 복구되면 에이전트가 변경 사항을 보고하고 이벤트가 생성됩니다.

가용성: EC2 시작 유형.

**Amazon ECS 컨테이너 에이전트가 가속화된 컴퓨팅 디바이스 상태의 변화를 감지합니다.**

GPU와 같은 가속 컴퓨팅 디바이스를 사용하는 인스턴스에서 컨테이너 에이전트는 디바이스 상태를 모니터링합니다. 디바이스가 손상되거나 복구되면 이벤트가 생성됩니다.

가용성: Amazon ECS 관리형 인스턴스 시작 유형.

**Amazon ECS 컨테이너 에이전트가 대몬 상태의 변화를 감지합니다.**

컨테이너 에이전트는 컨테이너 인스턴스에서 필요한 대몬 태스크를 모니터링합니다. 대몬 태스크가 실패하면 이벤트가 생성됩니다.

가용성: Amazon ECS 관리형 인스턴스 시작 유형.

**컨테이너 인스턴스의 전체 상태가 변경됩니다.**

Amazon ECS는 개별 상태 확인 결과에서 전체 상태를 계산합니다. 전체 상태가 전환되면 이벤트가 생성됩니다.

가용성: Amazon ECS 관리형 인스턴스 및 EC2 시작 유형.

## 컨테이너 인스턴스 상태 변경 이벤트 예제
<a name="ecs_container_instance_health_events_example"></a>

컨테이너 인스턴스 상태 변경 이벤트는 다음 형식으로 전달됩니다. 파라미터에 대한 자세한 내용은 *사용 설명서*의 [AWS 서비스 이벤트 메타데이터](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.

**샘플 컨테이너 런타임 상태 이벤트**

```
{
    "version": "0",
    "id": "EXAMPLE-48f8-c0ff-0dab-EXAMPLE2ac34",
    "detail-type": "ECS Container Instance Health Change",
    "source": "aws.ecs",
    "account": "123456789012",
    "time": "2026-04-11T00:49:09Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/a1b2c3d4EXAMPLE"
    ],
    "detail": {
        "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/my-cluster",
        "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/a1b2c3d4EXAMPLE",
        "capacityProviderName": null,
        "ec2InstanceId": "i-0abcdef1234567890",
        "overallStatus": "OK",
        "healthChecks": [
            {
                "type": "CONTAINER_RUNTIME",
                "status": "OK",
                "lastStatusChange": "2026-04-11T00:48:53Z",
                "lastUpdated": "2026-04-11T00:48:09Z",
                "statusReason": null
            }
        ]
    }
}
```

**샘플 가속 컴퓨팅 상태 이벤트**

```
{
    "version": "0",
    "id": "EXAMPLE-46c3-a48a-1bef-EXAMPLE72f3c",
    "detail-type": "ECS Container Instance Health Change",
    "source": "aws.ecs",
    "account": "123456789012",
    "time": "2026-04-11T00:49:09Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/a1b2c3d4EXAMPLE"
    ],
    "detail": {
        "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/my-cluster",
        "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/a1b2c3d4EXAMPLE",
        "capacityProviderName": "my-capacity-provider",
        "ec2InstanceId": "i-0abcdef1234567890",
        "overallStatus": "IMPAIRED",
        "healthChecks": [
            {
                "type": "ACCELERATED_COMPUTE",
                "status": "IMPAIRED",
                "lastStatusChange": "2026-04-11T00:48:53Z",
                "lastUpdated": "2026-04-11T00:48:09Z",
                "statusReason": "XID_46"
            }
        ]
    }
}
```

**샘플 대몬 상태 이벤트**

```
{
    "version": "0",
    "id": "EXAMPLE-febc-b5e3-054b-EXAMPLE1a1f4f",
    "detail-type": "ECS Container Instance Health Change",
    "source": "aws.ecs",
    "account": "123456789012",
    "time": "2026-04-11T00:49:09Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/a1b2c3d4EXAMPLE"
    ],
    "detail": {
        "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/my-cluster",
        "containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/a1b2c3d4EXAMPLE",
        "capacityProviderName": "my-capacity-provider",
        "ec2InstanceId": "i-0abcdef1234567890",
        "overallStatus": "IMPAIRED",
        "healthChecks": [
            {
                "type": "DAEMON",
                "status": "IMPAIRED",
                "lastStatusChange": "2026-04-11T00:48:53Z",
                "lastUpdated": "2026-04-11T00:48:09Z",
                "statusReason": "Daemon task: EXAMPLE-4af2-4b3c-b9c1-EXAMPLEb2bbf is unhealthy"
            }
        ]
    }
}
```