Tutorial: Cómo escuchar los EventBridge eventos OpenSearch de Amazon Service

En este tutorial, configuras una AWS Lambda función sencilla que escucha los eventos de Amazon OpenSearch Service y los escribe en un flujo de registro de CloudWatch Logs.

Requisitos previos

En este tutorial se presupone que ya tienes un dominio OpenSearch de servicio. Si no creó un dominio, siga los pasos de Creación y administración de dominios OpenSearch de Amazon Service para crear uno.

Paso 1: crear la función Lambda

En este procedimiento, se crea una función Lambda sencilla que sirva de destino para los mensajes de eventos de OpenSearch servicio.

Para crear una función de Lambda de destino

1. Abra la AWS Lambda consola en https://console.aws.amazon.com/lambda/.

2. Seleccione Crear función y Crear desde cero.

3. En Nombre de la función, ingrese event-handler.

4. En Tiempo de ejecución, seleccione Python 3.8.

5. Seleccione Crear función.

6. En la sección Código de función, edite el código de muestra de tal modo que coincida con el siguiente ejemplo:

   import json
   
   def lambda_handler(event, context):
       if event["source"] != "aws.es":
           raise ValueError("Function only supports input from events with a source type of: aws.es")
   
       print(json.dumps(event))

   Esta es una función simple de Python 3.8 que imprime los eventos enviados por OpenSearch Service. Si todo está configurado correctamente, al final de este tutorial, los detalles del evento aparecen en el flujo de registro de CloudWatch Logs asociado a esta función de Lambda.

7. Seleccione Implementar.

Paso 2: registrar una regla de eventos

En este paso, creará una EventBridge regla que capture los eventos de sus dominios de OpenSearch servicio. Esta regla captura todos los eventos dentro de la cuenta, en la cual se define. Los propios mensajes de eventos contienen información acerca de la fuente del evento, incluido el dominio desde el que se originó. Puede utilizar esta información para filtrar y ordenar eventos de manera programática.

Para crear una EventBridge regla

1. Abra la EventBridge consola en https://console.aws.amazon.com/events/.

2. Seleccione Crear regla.

3. Nombre la regla event-rule.

4. Seleccione Siguiente.

5. Para el patrón de eventos, selecciona AWS services, Amazon OpenSearch Service y All Events. Este patrón se aplica a todos los dominios de tu OpenSearch Servicio y a todos los eventos del OpenSearch Servicio. También puede crear un patrón más específico para filtrar algunos resultados.

6. Pulse Siguiente.

7. Para el destino, seleccione Función de Lambda. En el menú desplegable de funciones, elija event-handler.

8. Pulse Siguiente.

9. Omita las etiquetas y vuelva a pulsar Siguiente.

10. Revise la configuración y elija Crear regla.

Paso 3: probar la configuración

La próxima vez que reciba una notificación en la sección Notificaciones de la consola de OpenSearch servicio, si todo está configurado correctamente, se activará la función Lambda y escribirá los datos del evento en un flujo de registro de CloudWatch Logs para la función.

Para probar la configuración

1. Abra la CloudWatch consola en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación, seleccione Registros y, a continuación, seleccione el grupo de registro de la función de Lambda (por ejemplo, /aws/lambda/event-handler).

3. Seleccione una secuencia de registro para ver los datos de los eventos.