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