Didacticiel : Écoute des EventBridge événements Amazon OpenSearch Service - Amazon OpenSearch Service

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.

Didacticiel : Écoute des EventBridge événements Amazon OpenSearch Service

Dans le cadre de ce tutoriel, vous allez configurer une AWS Lambda fonction simple qui écoutera les événements Amazon OpenSearch Service et les écrira dans un flux de CloudWatch journaux.

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

Au cours de cette procédure, vous allez créer une fonction Lambda simple à utiliser comme cible pour les messages d'événements OpenSearch de 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 fonction Python 3.8 simple qui imprime les événements envoyés par OpenSearch Service. Si tout est correctement configuré, à la fin de ce tutoriel, les détails de l'événement apparaissent dans le flux de CloudWatch journaux qui est associé à cette fonction Lambda.

  7. Choisissez Déployer.

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

Au cours de cette étape, vous allez créer une EventBridge règle pour capturer les événements 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 sera déclenchée et écrira les données d'événement dans un flux de CloudWatch journaux 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.