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

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

다음 시나리오가 컨테이너 인스턴스 상태 변경 이벤트를 발생시켜요.

출처: 문서

본문

• 컨테이너 런타임 상태 변경: Amazon ECS 컨테이너 에이전트가 컨테이너 런타임 상태의 변경을 감지해요. 컨테이너 에이전트는 컨테이너 인스턴스의 컨테이너 런타임(Docker 데몬 등) 상태를 주기적으로 평가해요. 런타임이 응답하지 않게 되거나 복구되면 에이전트가 변경을 보고하고 이벤트가 생성돼요. 가용성: EC2 실행 유형.
• 가속 컴퓨팅 디바이스 상태 변경: Amazon ECS 컨테이너 에이전트가 가속 컴퓨팅 디바이스 상태의 변경을 감지해요. GPU 같은 가속 컴퓨팅 디바이스가 있는 인스턴스에서 컨테이너 에이전트는 디바이스 상태를 모니터링해요. 디바이스가 손상(impaired)되거나 복구되면 이벤트가 생성돼요. 가용성: Amazon ECS Managed Instances 실행 유형.
• 데몬 상태 변경: Amazon ECS 컨테이너 에이전트가 데몬 상태의 변경을 감지해요. 컨테이너 에이전트는 컨테이너 인스턴스의 필수 데몬 태스크를 모니터링해요. 데몬 태스크가 실패하면 이벤트가 생성돼요. 가용성: Amazon ECS Managed Instances 실행 유형.
• Amazon ECS 컨트롤 플레인과의 연결 손실: Amazon ECS 컨테이너 에이전트가 Amazon ECS 컨트롤 플레인과의 연결을 잃어요. Amazon ECS는 컨테이너 에이전트와 Amazon ECS 컨트롤 플레인 사이의 연결을 지속적으로 모니터링해요. 컨테이너 인스턴스가 임계값을 넘어 연결이 끊긴 상태로 남아 있으면 Amazon ECS는 인스턴스를 손상(impaired) 상태로 표시해요. 가용성: Amazon ECS Managed Instances, AWS Fargate, Amazon EC2 실행 유형.
• 컨테이너 인스턴스의 전체 상태 변경: Amazon ECS 컨테이너 인스턴스의 전체 상태가 변경돼요. Amazon ECS는 개별 상태 검사 결과에서 전체 상태를 계산해요. 전체 상태가 전환되면 이벤트가 생성돼요. 가용성: Amazon ECS Managed Instances와 EC2 실행 유형.

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

컨테이너 인스턴스 상태 변경 이벤트는 다음 형식으로 전달돼요. 파라미터에 대한 자세한 내용은 User Guide의 AWS service event metadata를 참고하세요.

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

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

샘플 에이전트 연결 상태 이벤트

{
    "version": "0",
    "id": "EXAMPLE-7d2a-9f1c-4b6e-EXAMPLE9c8d1",
    "detail-type": "ECS Container Instance Health Change",
    "source": "aws.ecs",
    "account": "123456789012",
    "time": "2026-07-29T22:34:13Z",
    "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": "AGENT_CONNECTIVITY",
                "status": "IMPAIRED",
                "lastStatusChange": "2026-07-29T22:34:13Z",
                "lastUpdated": "2026-07-29T22:34:09Z",
                "statusReason": "Agent disconnected since 2026-07-29T22:34:13Z"
            }
        ]
    }
}