Eventos de cambio de estado de la instancia de contenedor de Amazon ECS

Los siguientes escenarios provocan eventos de cambio de estado de la instancia de contenedor.

El agente de contenedor de Amazon ECS detecta un cambio en el estado del tiempo de ejecución del contenedor.

El agente de contenedor evalúa periódicamente el estado del tiempo de ejecución del contenedor (por ejemplo, el daemon de Docker) en la instancia de contenedor. Si el tiempo de ejecución deja de responder o se recupera, el agente informa el cambio y se genera un evento.

Disponibilidad: tipo de lanzamiento de EC2.

El agente de contenedor de Amazon ECS detecta un cambio en el estado del dispositivo informático acelerado.

En las instancias con dispositivos informáticos acelerados, como las GPU, el agente de contenedor supervisa el estado del dispositivo. Si un dispositivo está deteriorado o se recupera, se genera un evento.

Disponibilidad: tipo de lanzamiento de instancias administradas de Amazon ECS.

El agente de contenedor de Amazon ECS detecta un cambio en el estado del daemon.

El agente de contenedor supervisa las tareas del daemon necesarias en la instancia de contenedor. Si se produce un error en una tarea de daemon, se genera un evento.

Disponibilidad: tipo de lanzamiento de instancias administradas de Amazon ECS.

El agente de contenedores de Amazon ECS pierde la conectividad con el plano de control de Amazon ECS.

Amazon ECS supervisa continuamente la conectividad entre su agente de contenedores y su plano de control. Cuando una instancia de contenedor permanece desconectada más allá de un umbral, Amazon ECS marca la instancia como dañada.

Disponibilidad: tipos de lanzamiento de instancias administradas de Amazon ECS, de AWS Fargate y de Amazon EC2.

El estado general de la instancia de contenedor cambia.

Amazon ECS calcula el estado general a partir de los resultados individuales de la comprobación de estado. Cuando el estado general cambia, se genera un evento.

Disponibilidad: tipo de lanzamiento de instancias administradas de Amazon ECS y de EC2.

Ejemplo de evento de cambio de estado de la instancia de contenedor

Los eventos de cambio de estado de instancia de contenedor se entregan en el siguiente formato. Para obtener más información acerca de los parámetros, consulte Metadatos de eventos de servicio de AWS en la Guía del usuario.

Ejemplo de evento de estado de tiempo de ejecución de contenedor

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

Ejemplo de evento de estado informático acelerado

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

Ejemplo de evento de estado de daemon

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

Ejemplo de evento del estado de conectividad del agente

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