Uso del conmutador de región en ARC con Amazon EventBridge

Con Amazon EventBridge, puede configurar reglas basadas en eventos que supervisen los recursos del conmutador de región en Amazon Application Recovery Controller (ARC) y, a continuación, iniciar acciones específicas que utilicen otros AWS servicios. Por ejemplo, puede establecer una regla para el envío de notificaciones por correo electrónico mediante la señalización de un tema de Amazon SNS cada vez que se complete la ejecución de un plan de cambio de región.

Puedes crear reglas en Amazon EventBridge para actuar en los siguientes eventos de cambio de región ARC:

• Ejecución del plan de cambio de región. El evento especifica que se ha ejecutado (ejecutado) un plan de cambio de región.

• Evaluación del plan de cambio de región. El evento especifica que se ha completado la evaluación del plan de cambio de región.

Para capturar eventos de ARC 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. En circunstancias operativas normales, se envían desde ARC a prácticamente EventBridge en tiempo real. 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 de región con EventBridge

Con él EventBridge, puede crear reglas que definan las acciones que se deben tomar cuando ARC emita eventos para los recursos del cambio de región.

Para escribir o copiar y pegar un patrón de eventos en la EventBridge consola, en la consola, seleccione la opción Introducir mi propia opción. Para ayudarle a determinar los patrones de eventos que podrían serle útiles, en este tema se incluyen ejemplos de patrones de cambio de región.

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. Región de AWS Para crear la regla, elige la región en la que creaste el plan para el que deseas monitorear 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. Para ver ejemplos, consulta la siguiente sección.

Ejemplo de patrones de cambio de región

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.

Puede copiar y pegar los patrones de eventos de esta sección EventBridge para crear reglas que pueda usar para monitorear las acciones y los recursos de ARC.

Los siguientes patrones de eventos proporcionan ejemplos que puede utilizar EventBridge para la función de cambio de región de ARC.

• Seleccione todos los eventos de la opción Cambiar región por PlanExecution.

  {
      "source": [ "aws.arc-region-switch" ],
      "detail-type": [ "ARC Region switch Plan Execution" ] 
  }

• Selecciona todos los eventos de la opción Cambiar región por PlanEvaluation.

      	{
      	"source": [ "aws.arc-region-switch" ],
      	"detail-type": [ "ARC Region Switch Plan Evaluation" ] 
      	}

El siguiente es un ejemplo de un evento ARC para la ejecución de un plan de cambio de región:

{
  	"version": "0",
  	"id": "1111111-bbbb-aaaa-cccc-dddddEXAMPLE", # Random uuid
  	"detail-type": "ARC Region Switch Plan Execution",
  	"source": "aws.arc-region-switch",
  	"account": "111122223333",
  	"time": "2023-11-16T23:38:14Z",
  	"region": "us-east-1",
  	"resources": ["arn:aws:arc-region-switch::111122223333:plan/aaaaaExample"], # planArn
  	"detail": {
  		"version": "0.0.1",
  		"eventType": "ExecutionStarted",
  		"executionId": "bbbbbbEXAMPLE",
  		"executionAction": "activating/deactivating {region}",
  		"idempotencyKey": "1111111-2222-3333-4444-5555555555", # As there is a possibility of dual logging
  	}
}

El siguiente es un ejemplo de un evento ARC para la ejecución escalonada de un plan de cambio de región:

{
  	"version": "0",
  	"id": "1111111-bbbb-aaaa-cccc-dddddEXAMPLE", # Random uuid
  	"detail-type": "ARC Region Switch Plan Execution",
  	"source": "aws.arc-region-switch",
  	"account": "111122223333",
  	"time": "2023-11-16T23:38:14Z",
  	"region": "us-east-1",
  	"resources": ["arn:aws:arc-region-switch::111122223333:plan/aaaaaExample"], # planArn
  	"detail": {
  		"version": "0.0.1",
  		"eventType": "StepStarted",
  		"executionId": "bbbbbbEXAMPLE",
  		"executionAction": "activating/deactivating {region}",
  		"idempotencyKey": "1111111-2222-3333-4444-5555555555", # As there is a possibility of dual logging
  		"stepDetails" : { 
  			"stepName": "Routing control step",
  			"resource": ["arn:aws:route53-recovery-control::111122223333:controlpanel/abcdefghiEXAMPLE/routingcontrol/jklmnopqrsEXAMPLE"]   
  		}
  	}
}

El siguiente es un ejemplo de un evento ARC para una advertencia de evaluación de un plan de cambio de región.

Para la evaluación de un plan de cambio de región, se emite un evento cuando se devuelve una advertencia. Si la advertencia no se borra, solo se emite un evento para la advertencia una vez cada 24 horas. Cuando se borra el evento, no se emitirán más eventos para esa advertencia.

{
  	"version": "0",
  	"id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4", # Random uuid
  	"detail-type": "ARC Region Switch Plan Execution",
  	"source": "aws.arc-region-switch",
  	"account": "111122223333",
  	"time": "2023-11-16T23:38:14Z",
  	"region": "us-east-1",
  	"resources": ["arn:aws:arc-region-switch::111122223333:plan/a2b89be4821bfd1d"],
  	"detail": {
    	"version": "0.0.1",
    	"idempotencyKey": "1111111-2222-3333-4444-5555555555",
    	"metadata": {
        "evaluationTime" : "timestamp",
        "warning" : "There is a plan evaluation warning for arn:aws:arc-region-switch::111122223333:plan/a2b89be4821bfd1d. Navigate to the Region switch console to resolve."
    	}  	
  	}
}

Especifique un grupo de CloudWatch registros para usarlo como destino

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:

• Cree un nuevo grupo de registros

• Elija un grupo de registros 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 registros existente, tenga en cuenta que solo los grupos de registros 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 registros:

{
  "Statement": [
    {
      "Action": [
        "logs:CreateLogStream",
        "logs:PutLogEvents"
      ],
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "events.amazonaws.com",
          "delivery.logs.amazonaws.com"
        ]
      },
      "Resource": "arn:aws:logs:region:account:log-group:/aws/events/*:*",
      "Sid": "TrustEventsToStoreLogEvent"
    }
  ],
  "Version": "2012-10-17"
}

No puede configurar una política basada en recursos para un grupo de registros 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. Seleccione Crear regla y, a continuación, introduzca cualquier información sobre esa regla, como el patrón de eventos o los detalles de la programación.

   Para obtener más información sobre la creación de EventBridge reglas de preparación, consulte Supervisar un recurso de verificación de preparación con EventBridge.

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

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