Tutorial: Listening for Amazon OpenSearch Service EventBridge events
En este tutorial, configurará una función AWS Lambda sencilla que escucha eventos de Amazon OpenSearch Service y los escribe en un flujo de registros en Registros de CloudWatch.
Requisitos previos
En este tutorial se da por hecho que dispone de un dominio de OpenSearch Service existente. Si no creó un dominio, siga los pasos de Creación y administración de dominios de Amazon OpenSearch Service para crear uno.
Paso 1: crear la función Lambda
En este procedimiento, creará una función Lambda sencilla que servirá como destino para los mensajes de eventos de OpenSearch Service.
Para crear una función de Lambda de destino
Abra la consola de AWS Lambda en https://console.aws.amazon.com/lambda/
. -
Seleccione Crear función y Crear desde cero.
-
En Nombre de la función, ingrese event-handler.
-
En Tiempo de ejecución, seleccione Python 3.8.
-
Seleccione Crear función.
-
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))Se trata de 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 verá los detalles de los eventos del flujo de registros de Registros de CloudWatch asociado a esta función de Lambda.
-
Seleccione Implementar.
Paso 2: registrar una regla de eventos
En este paso, creará una regla de EventBridge que captura eventos de los dominios de OpenSearch Service. 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 regla de EventBridge
-
Abra la consola de EventBridge en https://console.aws.amazon.com/events/
. -
Seleccione Crear regla.
-
Nombre la regla event-rule.
-
Seleccione Siguiente.
-
En el patrón de eventos, seleccione Servicios de AWS, Amazon OpenSearch Service y Todos los eventos. Este patrón se aplica a todos los dominios de OpenSearch Service y a todos los eventos de OpenSearch Service. También puede crear un patrón más específico para filtrar algunos resultados.
-
Pulse Siguiente.
-
Para el destino, seleccione Función de Lambda. En el menú desplegable de funciones, elija event-handler.
-
Pulse Siguiente.
-
Omita las etiquetas y vuelva a pulsar Siguiente.
-
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 Service, si todo está configurado correctamente, la función de Lambda se activa y escribe los datos del evento en un flujo de registros de Registros de CloudWatch para la función.
Para probar la configuración
-
Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/
. -
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).
-
Seleccione una secuencia de registro para ver los datos de los eventos.