Tutoriel : écouter les EventBridge événements Amazon OpenSearch Service

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.

Prérequis

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 pour en créer un.

Étape 1 : Créer la fonction Lambda

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

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

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

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

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

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

7. Choisissez Deploy (Déployer).

Étape 2 : Enregistrer une règle d'événement

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

2. Choisissez Créer une règle.

3. Nommez la règle event-rule.

4. Choisissez Next (Suivant).

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

6. Appuyez sur Next (Suivant).

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

8. Appuyez sur Next (Suivant).

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

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

Étape 3 : Tester votre configuration

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

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

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