Amazon ECS 컨테이너 인스턴스 상태 변경 이벤트

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

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

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

가용성: EC2 시작 유형.

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

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

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

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

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

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

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

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

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

컨테이너 인스턴스 상태 변경 이벤트 예제

컨테이너 인스턴스 상태 변경 이벤트는 다음 형식으로 전달됩니다. 파라미터에 대한 자세한 내용은 사용 설명서의 AWS 서비스 이벤트 메타데이터를 참조하세요.

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

{
    "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"
            }
        ]
    }
}