Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Tutoriel : écouter les EventBridge événements Amazon OpenSearch Service
<a name="listening-events"></a>

Dans ce didacticiel, vous allez configurer une AWS Lambda fonction simple qui écoute les événements Amazon OpenSearch Service et les écrit dans un flux de log CloudWatch Logs.

## Conditions préalables
<a name="listening-prereq"></a>

Ce didacticiel part du principe que vous disposez d'un domaine OpenSearch de service existant. Si vous n'avez pas encore créé de domaine, suivez la procédure décrite dans [Création et gestion de domaines Amazon OpenSearch Service](createupdatedomains.md) pour en créer un.

## Étape 1 : Créer la fonction Lambda
<a name="listening-lambda"></a>

Dans cette procédure, vous créez une fonction Lambda simple qui servira de cible aux messages d'événements de OpenSearch service.

**Pour créer une fonction Lambda cible**

1. Ouvrez la AWS Lambda console à l'adresse [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).

1. Choisissez **Create function** (Créer une fonction) et **Author from scratch** (Créer à partir de zéro).

1. Dans le champ **Function name** (Nom de la fonction), saisissez **event-handler**. 

1. Pour **Environnement d’exécution**, sélectionnez **Python 3.8**.

1. Sélectionnez **Create function** (Créer une fonction).

1. Dans la section **Code de fonction**, modifiez l'exemple de code selon l'exemple suivant :

   ```
   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))
   ```

   Il s'agit d'une simple fonction Python 3.8 qui affiche les événements envoyés par OpenSearch Service. Si tout est correctement configuré, à la fin de ce didacticiel, les détails de l'événement apparaissent dans le flux du journal CloudWatch des journaux associé à cette fonction Lambda.

1. Choisissez **Déployer**.

## Étape 2 : Enregistrer une règle d'événement
<a name="listening-rule"></a>

Au cours de cette étape, vous créez une EventBridge règle qui capture les événements provenant de vos domaines de OpenSearch service. Cette règle capturera tous les événements du compte où elle est définie. Les messages d'événement eux-mêmes contiennent des informations sur la source de l'événement, comme le domaine d'origine. Vous pouvez utiliser ces informations pour filtrer et trier les événements par programmation.

**Pour créer une EventBridge règle** 

1. Ouvrez la EventBridge console à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Choisissez **Créer une règle**.

1. Nommez la règle **event-rule**.

1. Choisissez **Next** (Suivant).

1. Pour le modèle d'événement, sélectionnez **AWS services**, **Amazon OpenSearch Service** et **Tous les événements**. Ce modèle s'applique à tous vos domaines de OpenSearch service et à chaque événement OpenSearch de service. Vous pouvez également créer un modèle plus spécifique pour filtrer certains résultats.

1. Appuyez sur **Next** (Suivant).

1. Pour la cible, choisissez **Lambda Function** (Fonction Lambda). Dans la liste déroulante des fonctions, choisissez **event-handler** (gestionnaire d'événements).

1. Appuyez sur **Next** (Suivant).

1. Ignorez les identifications et appuyez à nouveau sur **Next** (Suivant).

1. Vérifiez la configuration et choisissez **Create rule** (Créer une règle).

## Étape 3 : Tester votre configuration
<a name="listening-test"></a>

La prochaine fois que vous recevrez une notification dans la section **Notifications** de la console de OpenSearch service, si tout est correctement configuré, votre fonction Lambda est déclenchée et elle écrit les données de l'événement dans un flux de journal CloudWatch des journaux pour la fonction.

**Pour tester votre configuration**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le volet de navigation, choisissez **Logs et sélectionnez le groupe de journaux** pour votre fonction Lambda (par exemple,**/aws/lambda/event-handler**).

1. Sélectionnez un flux de journaux pour afficher les données d'événement.