Uso del cambio automático zonal con Amazon EventBridge - Controlador de recuperación de aplicaciones (ARC) de Amazon
Supervise un recurso de cambio automático zonal con EventBridgeEjemplo de patrones de eventos de cambio automático de zonaEjemplo de eventos de cambio automático de zonaEspecifique un grupo de CloudWatch registros para usarlo como objetivo

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso del cambio automático zonal con Amazon EventBridge

Con Amazon EventBridge, puedes configurar reglas basadas en eventos que supervisen tus recursos de cambio automático zonales e inicien acciones específicas que usen otros servicios. AWS Por ejemplo, puede establecer una regla para el envío de notificaciones por correo electrónico marcando un tema de Amazon SNS cada vez que se inicie una ejecución de práctica de cambio automático de zona.

Puedes crear reglas en Amazon EventBridge para actuar en el cambio automático zonal. Un evento de cambio automático de zona especifica la información de estado sobre las ejecuciones de práctica o los cambios automáticos, por ejemplo, cuándo se inicia una ejecución de práctica. Puede configurar el cambio automático de zona para que le notifique los eventos de cambio automático de zona de los recursos que habilite para el servicio.

También puedes optar por activar, además de otras notificaciones o en lugar de ellas, la notificación automática al observador, que envía un evento de notificación cada vez que se AWS inicia un cambio automático en una zona de disponibilidad potencialmente afectada. La notificación del observador de cambio automático es distinta de las notificaciones que recibe cuando el tráfico de los recursos que ha habilitado para el cambio automático de zona se desvía de una zona de disponibilidad. No es necesario configurar ningún recurso con el cambio automático de zona para habilitar la notificación del observador de cambio automático. Para obtener más información, consulte Habilitación y uso del cambio automático de zona.

Para capturar eventos de cambio automático zonales específicos que le interesen, defina patrones específicos de eventos que EventBridge pueda utilizar para detectarlos. Los patrones de eventos de tienen la misma estructura que los eventos con los que coinciden. El patrón cita los campos para los que se desea encontrar coincidencias y proporciona los valores que está buscando.

Los eventos se emiten en la medida de lo posible. Se envían desde ARC a prácticamente en tiempo real, EventBridge en circunstancias operativas normales. Sin embargo, pueden surgir situaciones que retrasen o impidan la entrega de un evento.

Para obtener información sobre cómo funcionan EventBridge las reglas con los patrones de eventos, consulte Eventos y patrones de eventos en EventBridge.

Supervise un recurso de cambio automático zonal con EventBridge

Con él EventBridge, puede crear reglas que definan las acciones que se deben tomar cuando ARC emita eventos para sus recursos. Por ejemplo, puede crear una regla que envíe un mensaje de correo electrónico cuando se inicie una ejecución de práctica de cambio automático de zona.

Para escribir o copiar y pegar un patrón de eventos en la EventBridge consola, seleccione la opción Introducir mi propia opción en la consola. Para ayudarle a determinar los patrones de eventos que podrían resultarle útiles, este tema incluye ejemplos de patrones de coincidencia de eventos de cambio automático de zona y eventos de cambio automático de zona que puede utilizar.

Para crear una regla para un evento de recurso, realice lo siguiente:

  1. Abre la EventBridge consola de Amazon en https://console.aws.amazon.com/events/.

  2. Elige la región en la Región de AWS que quieres crear la regla, es decir, la región desde la que te interesa ver los eventos.

  3. Seleccione Creación de regla.

  4. Ingrese un Name (Nombre) para la regla y opcionalmente, una descripción.

  5. Para Bus de eventos, deje el valor predeterminado, predeterminado.

  6. Elija Siguiente.

  7. En el paso Crear un patrón de eventos, en Origen del evento, deje el valor predeterminado, Eventos de AWS .

  8. En Ejemplo de evento, elija Introducir el mío.

  9. Para Ejemplos de eventos, escriba o copie y pegue un patrón de eventos.

Ejemplo de patrones de eventos de cambio automático de zona

Los patrones de eventos tienen la misma estructura que los eventos con los que coinciden. El patrón cita los campos para los que se desea encontrar coincidencias y proporciona los valores que está buscando.

Puede copiar y pegar los patrones de eventos de esta sección EventBridge para crear reglas que podrá utilizar para supervisar las acciones y los recursos del cambio automático zonal.

Al crear patrones de eventos para eventos de cambio automático de zona, puede especificar cualquiera de las siguientes opciones para el detail-type:

  • Autoshift In Progress

  • Autoshift Completed

  • Practice Run Started

  • Practice Run Succeeded

  • Practice Run Interrupted

  • Practice Run Failed

  • FIS Experiment Autoshift In Progress

  • FIS Experiment Autoshift Completed

  • FIS Experiment Autoshift Canceled

Cuando se interrumpe una ejecución de práctica, consulte el campo additionalFailureInfo para obtener más información sobre lo que ha provocado la interrupción.

Puede elegir monitorizar todos los AWS cambios automáticos activando las notificaciones del observador de cambios automáticos. Después de habilitar las notificaciones del observador de cambio automático, para recibir las notificaciones, elija que se le notifique el tipo de detalle de cambio automático de zona Autoshift In Progress. Para conocer los pasos necesarios que debe seguir para habilitar la notificación del observador de cambio automático, consulte Habilitación y uso del cambio automático de zona.

Para ver ejemplos, consulte la sección Ejemplos de eventos de cambio automático de zona.

  • Seleccione todos los eventos de cambio automático de zona en los que se haya iniciado un cambio automático.

    Tenga en cuenta lo siguiente:

    • Si tiene habilitada la notificación del observador de cambio automático, ARC devuelve todos los eventos de cambio automático.

    • Si no tiene habilitada la notificación del observador de cambio automático, ARC devuelve eventos de cambio automático solo cuando un recurso que ha configurado para el cambio automático de zona se incluye en un cambio automático.

    {
    "source": [
        "aws.arc-zonal-shift"
    ],
    "detail-type": [
        "Autoshift In Progress"
    ]
}

  • Seleccione todos los eventos del cambio automático de zona en los que se haya iniciado una ejecución de práctica.

    {
    "source": [
        "aws.arc-zonal-shift"
    ],
    "detail-type": [
        "Practice Run Started"
    ]
}

  • Seleccione todos los eventos del cambio automático de zona en los que no se haya podido realizar una ejecución de práctica.

    {
    "source": [
        "aws.arc-zonal-shift"
    ],
    "detail-type": [
        "Practice Run Failed"
    ]
}

Ejemplo de eventos de cambio automático de zona

En esta sección se incluyen ejemplos de eventos para acciones de cambio automático de zona.

A continuación, se muestra un ejemplo de evento para la acción Autoshift In Progress, cuando 1) la notificación del observador de cambio automático está habilitada y 2) no se ha configurado un recurso con el cambio automático de zona que esté incluido en un cambio automático:

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":"AWS has started an autoshift for an impaired Availability Zone. This notification 
            is separate from autoshift notifications for resources, if any, that you have configured for 
            zonal autoshift. For details, see the Developer Guide."
        }
    }
}

A continuación, se muestra un ejemplo de evento para la acción Autoshift In Progress, cuando 1) la notificación del observador de cambio automático está deshabilitada y 2) se ha configurado un recurso con el cambio automático de zona que está incluido en un cambio automático:

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}

A continuación, se muestra un ejemplo de un evento para la acción Practice Run Interrupted:

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Practice Run Interrupted",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": {
            "additionalFailureInfo": "Practice run interrupted. The blocking alarm entered ALARM state."
        },
        "metadata": {
            "awayFrom": "use1-az2"
        }
    }
}

A continuación, se muestra un ejemplo de un evento para la acción FIS Experiment Autoshift In Progress:

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "FIS Experiment Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}

Especifique un grupo de CloudWatch registros para usarlo como objetivo

Al crear una EventBridge regla, debe especificar el destino al que se envían los eventos que coinciden con la regla. Para obtener una lista de los objetivos disponibles EventBridge, consulte Objetivos disponibles en la EventBridge consola. Uno de los destinos que puedes añadir a una EventBridge regla es un grupo de CloudWatch registros de Amazon. En esta sección se describen los requisitos para añadir grupos de CloudWatch registros como objetivos y se proporciona un procedimiento para añadir un grupo de registros al crear una regla.

Para agregar un grupo de CloudWatch registros como destino, puede realizar una de las siguientes acciones:

  • Crear un nuevo grupo de registro

  • Seleccionar un grupo de registro existente

Si especifica un nuevo grupo de registros mediante la consola al crear una regla, crea EventBridge automáticamente el grupo de registros. Asegúrese de que el grupo de registros que utilice como destino para la EventBridge regla comience por/aws/events. Si desea elegir un grupo de registro existente, tenga en cuenta que solo los grupos de registro que comiencen por /aws/events aparecen como opciones en el menú desplegable. Para obtener más información, consulta Crear un nuevo grupo de registros en la Guía del CloudWatch usuario de Amazon.

Si crea o usa un grupo de CloudWatch registros para usarlo como destino mediante CloudWatch operaciones fuera de la consola, asegúrese de configurar los permisos correctamente. Si usa la consola para agregar un grupo de registros a una EventBridge regla, la política basada en recursos del grupo de registros se actualiza automáticamente. Sin embargo, si usa el SDK AWS Command Line Interface o un AWS SDK para especificar un grupo de registros, debe actualizar la política basada en recursos para el grupo de registros. El siguiente ejemplo de política ilustra los permisos que debe definir en una política basada en recursos para el grupo de registro:

JSON
{
    "Version":"2012-10-17",		 	 	 

    "Statement": [
        {
            "Action": [
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "events.amazonaws.com",
                    "delivery.logs.amazonaws.com"
                ]
            },
            "Resource": "arn:aws:logs:us-east-1:222222222222:log-group:/aws/events/*:*",
            "Sid": "TrustEventsToStoreLogEvent"
        }
    ]
}

No puede configurar una política basada en recursos para un grupo de registro mediante la consola. Para añadir los permisos necesarios a una política basada en recursos, utilice la operación de API. CloudWatch PutResourcePolicy A continuación, puede utilizar el comando describe-resource-policiesCLI para comprobar que la política se ha aplicado correctamente.

Para crear una regla para un evento de recurso y especificar un objetivo de grupo de CloudWatch registros

  1. Abre la EventBridge consola de Amazon en https://console.aws.amazon.com/events/.

  2. Elige en Región de AWS qué quieres crear la regla.

  3. Elija Crear regla y, a continuación, introduzca cualquier información sobre esa regla, como el patrón del evento o los detalles de la programación.

    Para obtener más información sobre la creación de EventBridge reglas para ARC, consulte las secciones anteriores de este tema.

  4. En la página Seleccionar destino, elija CloudWatchcomo objetivo.

  5. Elija un grupo de CloudWatch registros en el menú desplegable.