View a markdown version of this page

Abonnieren von Ereignissen auf einem Custom Event Bus - Amazon EventBridge

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Abonnieren von Ereignissen auf einem Custom Event Bus

Ein Abonnent ist eine Ressource, die angibt, welche Ereignisse Sie wünschen und wohin sie gesendet werden sollen. Sie erstellen es mitCreateSubscriber, indem Sie den Bus, die Filter und ein Ziel benennen. Es überwacht diesen Bus, behält die Ereignisse, die seinen Filtern entsprechen, transformiert optional jeden einzelnen und liefert ihn an genau ein Ziel. Um ein Ereignis auf mehrere Ziele auszudehnen, erstellen Sie einen Abonnenten für jedes Ziel auf demselben Bus.

EventBridge gilt für einen bestimmten Bus jeweils nur einen Abonnenten, der erstellt oder gelöscht wird, unabhängig davon, welches Konto anruft. Ein zweiter CreateSubscriber oder DeleteSubscriber auf demselben Bus, während ein Bus gerade läuft, schlägt fehl. Versuchen Sie es erneutConcurrentModificationException. Die Tarife zum Erstellen und Löschen von Tarifen gelten Benutzerdefinierte Event Bus-Kontingente daher pro Bus.

Filtern, welche Ereignisse das Ziel erreichen

FilterConfigurationenthält eine Liste vonFilters. Jeder Filter hat eine Pattern EventBridge In-Event-Muster-Syntax und eineScope. Sie können maximal einen Filter pro Bereich verwenden und EventBridge liefert nur dann ein Ereignis aus, wenn es allen Filtern in der Liste entspricht. Ein Abonnent ohne FilterConfiguration Filter empfängt jedes Ereignis im Bus.

  • DATA: entspricht der Nutzlast. Schreiben Sie das Muster anhand der unter beschriebenen FormEventstruktur: Daten, Metadaten und Systemmetadaten.

  • METADATA: entspricht den Schlüssel-Wert-Paaren, die ein Producer-Set enthältPutRawEvents, nur exakte Übereinstimmung.

  • SYSTEM_METADATA: entspricht den EventBridge Feldsätzen, wie z. B. aws:Source oder. EventGroupId

Die Mustersyntax, die Bereichsregeln und Beispiele finden Sie unterEreignisse für einen Abonnenten filtern.

Die Nutzlast transformieren

Transformer.Typewählt aus, was das Ziel erhält. Ein universelles Ziel verwendet es nicht; sieheUniverselle Ziele für einen Custom Event Bus.

  • RAW, die Standardeinstellung. Allein die Nutzlast.

  • WITH_METADATA. Die gesamte Veranstaltung: DataMetadata, undSystemMetadata.

  • JSONATA. Das Ergebnis des JSONata-Ausdrucks inJsonataConfiguration.Expression, eingeschlossen in {% %} Trennzeichen, wobei das Ereignis als verfügbar ist. $events

EventBridge prüft die Syntax eines Ausdrucks, wenn Sie den Abonnenten erstellen, und wertet sie bei der Zustellung aus. Ein Ausdruck, der auslöst oder keinen Wert erzeugt, schlägt die Übermittlung dieses Ereignisses fehl. Testen Sie Ausdrücke anhand realer Ereignisse, bevor Sie sich auf sie verlassen. Informationen zu den $events geltenden Funktionen, den zusätzlichen Funktionen und den Grenzwerten finden Sie unterTransformieren von Ereignissen mit JSonata.

Ein Ziel erreichen

InvokeConfigurationenthält denTargetArn, den, der RoleArn davon EventBridge ausgeht, das Ziel aufzurufen, und höchstens einen Parameterblock, der dem Zieltyp entspricht. Die meisten Parameterwerte akzeptieren einen JSONata-Ausdruck, sodass ein Wert aus dem Ereignis stammen kann. In der folgenden Tabelle sind die maßgeschneiderten Zieltypen und ihr Parameterblock aufgeführt. Jeder hat seine eigene Seite darunter. Ziele für einen Custom Event Bus-Abonnenten

TargetParameterblock
Amazon-SQS-WarteschlangeSqsParameters
Lambda-FunktionLambdaParameters
Kinesis-StreamKinesisParameters
Step-Functions-ZustandsautomatStepFunctionsParameters
Amazon-SNS-ThemaSnsParameters
HTTP-Endpunkt oder API-ZielHttpParameters
Firehose-StreamFirehoseParameters

Ein benutzerdefinierter Event-Bus oder ein benutzerdefinierter Event-Bus — Classic können ebenfalls das Ziel sein: Stellen Sie den Bus-ARN als einTargetArn. Legen Sie für ein FIFO-Ziel wie eine Amazon SQS-FIFO-Warteschlange die eigene Deduplizierungs-ID des Ziels im Parameterblock fest, z. B. SqsParameters.MessageDeduplicationId auf einen Wert pro Nachricht, der aus dem Ereignis mit einem JSONata-Ausdruck abgeleitet wird. Eine Konstante veranlasst das Ziel, jede Nachricht nach der ersten zu verwerfen.

Ein universelles Ziel ruft direkt eine AWS API-Aktion auf, ohne dass eine Funktion dazwischen liegt. Sein ARN hat arn:aws:events:::aws-sdk:service:apiAction beispielsweise arn:aws:events:::aws-sdk:dynamodb:putItem die Form und er UniversalTargetParameters.Input enthält die Anforderung als JSON oder als JSONata-Ausdruck, der sie generiert. Informationen zu Benennungsregeln, Stapelverarbeitung und Fehlerverhalten finden Sie unter. Universelle Ziele für einen Custom Event Bus

Wenn Sie den Abonnenten erstellen, EventBridge löst er den Zieltyp aus dem ARN auf und überprüft drei Dinge: ob der Parameterblock mit dem Zieltyp übereinstimmt, ob der ARN zu Ihrem Konto gehört und dass jeder Ausdruck analysiert wird. Ob das Ziel existiert, ob die Rolle es erreichen kann und ob die Ziel-API die Werte akzeptiert, wird bei der Auslieferung überprüft. Bestätigen Sie also die erste Lieferung am Ziel.

Wiederholungsversuche und Warteschlangen mit unleserem Text

RetryPolicylegt fest, wie lange eine fehlgeschlagene Zustellung wiederholt werden soll (standardmäßig 5 Versuche innerhalb von 300 Sekunden), und OnFailureConfiguration.Arn benennt die Amazon SQS-Warteschlange, die für jedes Ereignis, das ihre EventBridge Wiederholungsversuche ausgeschöpft hat, einen Datensatz erhält. Legen Sie beide fest, wenn Sie den Abonnenten erstellen. Die Grenzwerte, das Datensatzformat und Hinweise zur Neuansteuerung finden Sie unterRichtlinien für Wiederholungsversuche und Warteschlangen für unzustellbare Nachrichten.

Die Rolle des Auslieferers

Die Rolle in RoleArn muss zu Ihrem Konto gehören und dem events.amazonaws.com Service Principal vertrauen. Ihr Anrufer benötigt iam:PassRole die Rolle, um den Abonnenten zu erstellen, oder EventBridge lehnt die Anfrage ab, bevor er den Ziel-ARN überprüft. Für die Berechtigungsrichtlinie der Rolle sind zwei Berechtigungen erforderlich.

  • Die Aktion, die das Ziel benötigt, z. B. sqs:SendMessage für eine Warteschlange, lambda:InvokeFunction eine Funktion, ein sns:Publish kinesis:PutRecords Thema oder einen Stream.

  • sqs:SendMessagein der Warteschlange für tote Buchstaben in. OnFailureConfiguration.Arn Ohne sie kann eine fehlgeschlagene Lieferung nirgends aufgezeichnet werden, und diese Ereignisse gehen ohne Signal verloren.

Die folgende Vertrauensrichtlinie ermöglicht es EventBridge , diese Rolle zu übernehmen.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "events.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Die folgende Berechtigungsrichtlinie sendet Daten an eine Amazon SQS-Warteschlange und leerlose Nachrichten an eine zweite Warteschlange.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "InvokeTheTarget", "Effect": "Allow", "Action": "sqs:SendMessage", "Resource": "arn:aws:sqs:us-east-1:111122223333:large-orders" }, { "Sid": "WriteToTheDeadLetterQueue", "Effect": "Allow", "Action": "sqs:SendMessage", "Resource": "arn:aws:sqs:us-east-1:111122223333:large-orders-dlq" } ] }

Beispiel: Große Bestellungen an eine Warteschlange ausliefern

Mit dem folgenden Befehl wird ein Abonnent erstellt, der Bestellungen über 500 für Ereignisse, die mit veröffentlicht wurden, an eine Amazon SQS-Warteschlange ausliefert und Fehler an eine Warteschlange sendetPutEvents, in der keine Meldung mehr erfolgt.

aws eventsv2 create-subscriber \ --name large-orders \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --filter-configuration '{ "Filters": [ { "Scope": "DATA", "Pattern": "{\"detail\":{\"total\":[{\"numeric\":[\">\",500]}]}}" } ] }' \ --invoke-configuration '{ "TargetArn": "arn:aws:sqs:us-east-1:111122223333:large-orders", "RoleArn": "arn:aws:iam::111122223333:role/EventBusDeliveryRole" }' \ --on-failure-configuration '{ "Arn": "arn:aws:sqs:us-east-1:111122223333:large-orders-dlq" }'

Fehlerbehebung: Sie haben veröffentlicht und nichts ist am Ziel angekommen

Eine Antwort auf die Veröffentlichung besagt lediglich, dass der Bus das Ereignis akzeptiert und gespeichert hat; die Zustellung wird nicht bestätigt. Führen Sie die folgenden Prüfungen der Reihe nach durch.

Symptom

Der Veröffentlichungsaufruf gab HTTP 200 ohne fehlgeschlagene Eingaben zurück, und das Ziel hat nach einigen Minuten nichts erhalten.

Ursache

Eines von fünf Dingen, in der Reihenfolge ihrer Häufigkeit: Die Zustellung wird immer noch wiederholt; der Abonnent ist STOPPED oder gesperrt; der Abonnent StartingPosition ist LATEST und das Ereignis wurde veröffentlicht, bevor der Abonnent existierte; der Filter wurde für die andere Veröffentlichungs-API geschrieben und entspricht nichts; oder die Zustellungsrolle kann das Ziel oder die Warteschlange für unzustellbare Briefe nicht erreichen. TargetInvocationssagt Ihnen, welche Hälfte des Problems Sie haben. Wenn keine Datenpunkte angezeigt TargetInvocations werden, EventsDelivered bedeutet das, dass Zustellungen versucht werden und fehlschlagen. Wenn keine Datenpunkte aktiviert sind, TargetInvocations solange sie verfügbar sind, bedeutet dies, dass kein Zustellversuch unternommen FilterEvaluated wurde. Vergewissern Sie sich, dass der Abonnent anwesend istRUNNING, und überprüfen Sie dann. EventTransformationFailures

Lösung
  1. Lesen Sie den Abonnenten. Statemuss sein RUNNING und Revoked muss fehlen; es erscheint nur, wenn es wahr ist. Hinweis StartingPosition und die Filter.

    aws eventsv2 describe-subscriber \ --subscriber-arn arn:aws:events:us-east-1:111122223333:subscriber/large-orders/EXAMPLE1234567890abcdef
  2. Lesen Sie die Kennzahlen des Abonnenten einAWS/EventsV2. FilterEvaluatedNull bedeutet, dass kein Ereignis diesen Abonnenten erreicht hat: Der Hersteller hat auf einem anderen Bus veröffentlicht, oder bevor der Abonnent mit existierteLATEST. FilterEvaluatedEin Wert über FilterMatched Null und ein Wert von Null bedeutet, dass der Filter nichts gefunden hat; sieheEventstruktur: Daten, Metadaten und Systemmetadaten. Wenn FilterMatched Datenpunkte vorhanden sind und EventsDelivered nicht, schlagen Lieferungen fehl, und welche Metrik das Ergebnis aufzeichnet, hängt vom Abonnenten ab: EventsDropped wann keine Warteschlange für unleserliche Nachrichten konfiguriert ist, OnFailureDestinationDelivered wann das Ereignis die Warteschlange erreicht hat und OnFailureDestinationFailed wann nicht.

  3. Logs einschalten und reproduzieren. Auf INFO und LogConfiguration.Level IncludePayload auf setzenFULL, eine Protokollzustellung verkabeln, erneut veröffentlichen und die EVENT_DELIVERY_ATTEMPT Datensätze lesen. Jeder enthält den eigenen Fehlercode und die eigene Meldung des Ziels unddetails.target_input, was EventBridge gesendet wurde, und nicht das, was Sie senden wollten. Siehe Beobachtbarkeit für den Custom Event Bus: Metriken, Protokolle und CloudTrail.

  4. Wenn der Filter verdächtig ist, fügen Sie einen Diagnose-Abonnenten auf demselben Bus ohne Filter und eine Warteschlange Transformer.TypeWITH_METADATA, die Ihnen gehört, als Ziel hinzu. Er liefert jedes Ereignis genau so aus, EventBridge wie es angezeigt wirdData, nämlich alsMetadata, undSystemMetadata. Vereinfachen Sie dann Ihren Filter um eine Bedingung nach der anderen. Die letzte Bedingung, die Sie entfernen, ist die Ursache.

Verifizierung

Veröffentlichen Sie ein Ereignis, das übereinstimmen sollte, und eines, das nicht passen sollte. Das erste erreicht das Ziel und EventsDelivered erhöht sich um eins; das zweite kommt nicht an und FilterEvaluated erhöht sich, solange FilterMatched es nicht passiert.

Anmerkung

Die Messwerte eines Abonnenten stehen dem Busbesitzer und dem Eigentümer des Abonnenten zur Verfügung. Die zugehörigen Protokolle werden nur dem Eigentümer des Abonnenten zugestellt.