Comment filtrer les événements avec EventBridge Pipes ?
Je souhaite utiliser Amazon EventBridge Pipes pour capturer un événement à partir de sources AWS et le connecter à des cibles.
Brève description
EventBridge Pipes reçoit des données d'événement provenant des sources suivantes :
- Flux Amazon DynamoDB
- Flux Amazon Kinesis
- Amazon MQ
- Flux Amazon Managed Streaming for Apache Kafka (Amazon MSK)
- Flux Apache Kafka autogéré
- File d'attente Amazon Simple Queue Service (Amazon SQS)
Si vous envoyez des événements de données de leur source à la cible, vous générez une surcharge de ressources et des coûts supplémentaires vous sont facturés. La cible doit traiter tous les événements de données et implémenter la logique métier pour éliminer les événements inutiles. Il est recommandé d'envoyer uniquement des événements de données spécifiques à la cible.
Pour améliorer les événements filtrés avant de les envoyer à la cible, utilisez une destination d'API ou les services AWS suivants :
- Amazon API Gateway
- AWS Lambda
- AWS Step Functions
Résolution
Remarque : EventBridge Pipes utilise des modèles d'événements. Chaque source EventBridge Pipes inclut des champs qui contiennent le message ou les données principaux.
Utiliser les critères de filtrage pour réduire les frais généraux
Pour filtrer les événements envoyés par la source, EventBridge Pipes utilise les critères de filtrage suivants :
- La propriété de métadonnées inclut des informations au format JSON concernant la source qui génère l'événement de données.
- La propriété de données inclut le corps du message de l'événement de données provenant de la source. Le format du corps du message varie d'une source à l'autre.
Exemple de corps de message envoyé par une file d'attente Amazon SQS :
{ "key": "example-key-1", "tag": "eb-pipe-filter", "object name": "sampleimage-11.png", "sequencer": "617f0837b476e463", "Order Status": "Approved" }
Exemple d'événement reçu par le pipeline :
{ "messageId": "c9652226-2d8f-49e9-9f06-beeb2a6f55ce", "receiptHandle": "AQEBoteuDChpmsb6765tA//hqtPta1W/utSYlmWuw3fjZnVvY+dxOUdj4cEjYZtLKGMGT4LUuvWbQPHb96Wwa+X0zUJo8ZiHC7dbul62hVbFTXjB7+cOKH91RXc3YMllpnd6nB3CNAOGIig6suCpEOGcrhTJ6dC45KoacROua1PIH454Ji8AP51TkQSnhkkeOJHInLHkvrd2sfoBo037kmMKJSo3kDgU7y92jbpJphRmijnNQX6gPQYSVifF3n3ApvSBMGQIUzQb65ZRLl6Mp2VPJQYF2RRjYShdrzhe3uON9H01m9f3LGcpL3yaX6yqFahfoEe3PiT6MMXHvIAaj+dKVSUqmnnk3n7X0n4WX1uFPgyjrI5KuJ64j2lf/dkcPMQEUPorjmagECmYpMrGlkBbZw==", "body": { "key": "example-key-1", "tag": "eb-pipe-filter", "object name": "sampleimage-11.png", "sequencer": "617f0837b476e463", "Order Status": "Approved" }, "attributes": { "ApproximateReceiveCount": "1", "SentTimestamp": "1690589578649", "SenderId": "AIDAIMWXWRRSWVPYSJEH6", "ApproximateFirstReceiveTimestamp": "1690589578654" }, "messageAttributes": { "Name": { "stringValue": "TestMessage", "stringListValues": [], "binaryListValues": [], "dataType": "String" } }, "md5OfMessageAttributes": "62bd1c2ea8c5344caa6852a77543892d", "md5OfBody": "388e8d9be1776f61c0be0a089807afbc", "eventSource": "aws:sqs", "eventSourceARN": "arn:aws:sqs:ap-southeast-2:123456789012:test-sqs-source-pipe", "awsRegion": "ap-southeast-2" }
Remarque : Dans l'exemple d'événement précédent, vous ne pouvez pas utiliser eventSource, eventSourceARN et awsRegion pour créer un modèle d'événement car EventBridge ajoute les données lors de l’interrogation.
Consulter des exemples de modèles de filtres d'événements
Correspondance du modèle de filtre d'événements avec les propriétés de métadonnées
Le modèle de filtre d'événements suivant correspond aux événements que le pipeline a reçus avec les propriétés de métadonnées attributes et stringValue :
{ "attributes": { "ApproximateReceiveCount": ["1"] }, "messageAttributes": { "Name": { "stringValue": ["TestMessage"] } } }
Correspondance du modèle de filtre d'événements avec les propriétés des données
Le modèle de filtre d'événements suivant correspond aux événements que le pipeline a reçus avec la propriété de données Statut de la commande et la valeur Approuvé :
{ "body": { "Order Status": ["Approved"] } }
Correspondance du modèle de filtre d'événements avec les métadonnées et les propriétés de données
Le modèle de filtre d'événements suivant correspond aux événements que le pipeline a reçus avec la propriété de données Statut de la commande et la propriété de métadonnées SenderId :
{ "attributes": { "SenderId": ["AIDAIMWXWRRSWVPYSJEH6"] }, "body": { "Order Status": ["Approved"] } }
Modèle de filtre d'événements sans correspondance
Le modèle de filtre d'événements suivant ne peut pas correspondre aux événements que le pipeline a reçus car il contient le champ awsRegion :
{ "body": { "Order Status": ["Approved"] }, "awsRegion": ["ap-southeast-2"] }
Remarque : EventBridge ajoute le champ awsRegion lorsqu'il ajoute les données pendant l’interrogation. Même si les champs de propriétés de données correspondaient, le modèle de filtre d'événements a échoué.
Examinez les critères d'une correspondance réussie
Si vous ne configurez pas correctement le corps du message entrant et le modèle de filtre d'événements, EventBridge Pipes supprime le message.
Lorsque vous créez un modèle de filtre d'événements pour le corps du message de l'événement, le modèle doit correspondre au format utilisé par les sources. Par exemple, le corps du message pour SQS peut être une chaîne simple ou un script JSON. Les enregistrements Kinesis Stream et DynamoDB doivent être dans un format JSON valide. Les flux Apache Kafka autogérés et les messages Amazon MQ utilisent des chaînes codées en UTF-8, sous forme de chaînes simples ou au format JSON.
Pour plus d'informations sur les sources et leurs modèles de filtre, consultez la section Filtrage des événements dans Amazon EventBridge Pipes.
Créer un pipeline EventBridge
Procédez comme suit :
- Ouvrez la console EventBridge.
- Dans le volet de navigation, choisissez Pipelines.
- Choisissez Créer un pipeline, puis saisissez un nom pour le pipeline.
- (Facultatif) Dans Description, ajoutez une description du pipeline.
- Dans l'onglet Construire un pipeline, sélectionnez le type de source, puis configurez la source.
- Pour Source, saisissez les paramètres, puis choisissez Suivant.
- Dans Exemple de type d'événement, sélectionnez Événements AWS ou Saisir mon propre.
- Dans Modèle d'événement, saisissez le modèle d'événement requis pour filtrer les événements.
- (Facultatif) Choisissez Modèle de test.
- (Facultatif) Cliquez sur Suivant pour accéder à Enrichissement.
- Cliquez sur Suivant pour accéder à Cible.
- Dans Détails, pour Service cible, sélectionnez la cible dans la liste déroulante, puis saisissez les informations sur la ressource cible.
- Configurez les réglages des pipelines.
- Choisissez Créer un pipeline.
Informations connexes
- Sujets
- Application Integration
- Balises
- Amazon EventBridge
- Langue
- Français

Contenus pertinents
demandé il y a un an
demandé il y a 2 ans
AWS OFFICIELA mis à jour il y a 2 ans
AWS OFFICIELA mis à jour il y a 2 ans
AWS OFFICIELA mis à jour il y a 2 ans