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.

# Tutorial: Cómo escuchar los EventBridge eventos OpenSearch de Amazon Service
<a name="listening-events"></a>

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
<a name="listening-prereq"></a>

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](createupdatedomains.md) para crear uno.

## Paso 1: crear la función Lambda
<a name="listening-lambda"></a>

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/](https://console.aws.amazon.com/lambda/)

1. Seleccione **Crear función** y **Crear desde cero**.

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

1. En **Tiempo de ejecución**, seleccione **Python 3.8**.

1. Seleccione **Crear función**.

1. 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.

1. Seleccione **Implementar**.

## Paso 2: registrar una regla de eventos
<a name="listening-rule"></a>

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/](https://console.aws.amazon.com/events/).

1. Seleccione **Crear regla**.

1. Nombre la regla **event-rule**.

1. Elija **Siguiente**.

1. 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.

1. Pulse **Siguiente**.

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

1. Pulse **Siguiente**.

1. Omita las etiquetas y vuelva a pulsar **Siguiente**.

1. Revise la configuración y elija **Crear regla**.

## Paso 3: probar la configuración
<a name="listening-test"></a>

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/](https://console.aws.amazon.com/cloudwatch/)

1. En el panel de navegación, elija **Registros** y seleccione el grupo de registros para la función Lambda (por ejemplo,**/aws/lambda/event-handler**).

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