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.
Eine EventBridge Amazon-Pipe erstellen
EventBridge Pipes ermöglicht Ihnen, point-to-point Integrationen zwischen Quellen und Zielen zu erstellen, einschließlich erweiterter Event-Transformationen und Anreicherungen. Um eine EventBridge Pipe zu erstellen, führen Sie die folgenden Schritte aus:
Informationen zum Erstellen einer Pipe mit dem AWS CLI finden Sie unter create-pipe
Angeben einer Quelle
Geben Sie zunächst die Quelle an, von der die Pipe Ereignisse empfangen soll.
So geben Sie eine Pipe-Quelle mithilfe der Konsole an
Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/
. -
Wählen Sie im Navigationsbereich die Option Pipes aus.
-
Wählen Sie Pipe erstellen aus.
-
Geben Sie einen Namen für die Pipe ein.
-
(Optional) Geben Sie eine Beschreibung für die Pipe ein.
-
Wählen Sie auf der Registerkarte Pipe erstellen unter Quelle den Quellentyp aus, den Sie für diese Pipe angeben möchten, und konfigurieren Sie die Quelle.
Konfigurationseigenschaften unterscheiden sich je nach ausgewähltem Quellentyp:
Konfigurieren der Ereignisfilterung (optional)
Sie können Ihrer Pipe Filter hinzufügen, sodass Sie nur eine Teilmenge der Ereignisse von Ihrer Quelle zum Ziel senden.
So konfigurieren Sie die Filterung mithilfe der Konsole
-
Wählen Sie Filtern aus.
-
Sie finden unter Beispielereignis – optional ein Beispielereignis, mit dem Sie Ihr Ereignismuster erstellen können, oder Sie können Ihr eigenes Ereignis eingeben, indem Sie Eigenes eingeben wählen.
-
Geben Sie unter Ereignismuster das Ereignismuster ein, das Sie zum Filtern der Ereignisse verwenden möchten. Weitere Informationen zum Erstellen von Filtern finden Sie unterFilterung von Ereignissen in Amazon EventBridge Pipes.
Im Folgenden finden Sie ein Beispiel für ein Ereignismuster, bei dem nur Ereignisse mit dem Wert Seattle im Feld Stadt gesendet werden.
{ "data": { "City": ["Seattle"] } }
Jetzt, da die Ereignisse gefiltert werden, können Sie eine optionale Anreicherung und ein Ziel für die Pipe hinzufügen.
Definieren der Ereignisanreicherung (optional)
Sie können die Ereignisdaten zur Anreicherung an eine Lambda-Funktion, eine AWS Step Functions Zustandsmaschine, ein Amazon API Gateway oder API ein Ziel senden.
So wählen Sie die Anreicherung aus
-
Wählen Sie Anreicherung aus.
-
Wählen Sie unter Details für Service den Service und die zugehörigen Einstellungen aus, die Sie für die Anreicherung verwenden möchten.
Sie können die Daten auch transformieren, bevor Sie sie zur Optimierung senden.
(Optional) So definieren Sie den Eingabe-Transformator
-
Wählen Sie Eingabe-Transformator für die Anreicherung – optional.
-
Wählen Sie für Beispielereignisse/Ereignisnutzlast den Typ des Beispielereignisses aus.
-
Geben Sie für Transformator die Transformator-Syntax ein, z. B.
"Event happened at <$.detail.field>."
, wobei<$.detail.field>
ein Verweis auf ein Feld aus dem Beispielereignis ist. Sie können auch auf ein Feld aus dem Beispielereignis doppelklicken, um es dem Transformator hinzuzufügen. -
Stellen Sie für Ausgabe sicher, dass die Ausgabe Ihren Vorstellungen entspricht.
Nachdem die Daten nun gefiltert und optimiert wurden, müssen Sie ein Ziel definieren, an das die Ereignisdaten gesendet werden sollen.
Konfigurieren eines Ziels
So konfigurieren Sie ein Ziel
-
Wählen Sie Target aus.
-
Wählen Sie unter Details für Zielservice das Ziel aus. Welche Felder angezeigt werden, hängt vom ausgewählten Ziel ab. Geben Sie nach Bedarf Informationen ein, die für diesen Zieltyp spezifisch sind.
Sie können die Daten auch transformieren, bevor Sie sie an das Ziel senden.
(Optional) So definieren Sie den Eingabe-Transformator
-
Wählen Sie Eingabe-Transformator für das Ziel – optional aus.
-
Wählen Sie für Beispielereignisse/Ereignisnutzlast den Typ des Beispielereignisses aus.
-
Geben Sie für Transformator die Transformator-Syntax ein, z. B.
"Event happened at <$.detail.field>."
, wobei<$.detail.field>
ein Verweis auf ein Feld aus dem Beispielereignis ist. Sie können auch auf ein Feld aus dem Beispielereignis doppelklicken, um es dem Transformator hinzuzufügen. -
Stellen Sie für Ausgabe sicher, dass die Ausgabe Ihren Vorstellungen entspricht.
Nachdem die Pipe konfiguriert ist, stellen Sie sicher, dass ihre Einstellungen korrekt konfiguriert sind.
Konfigurieren der Pipe-Einstellungen
Eine Pipe ist standardmäßig aktiv, aber Sie können sie deaktivieren. Sie können auch die Berechtigungen der Pipe angeben, die Pipe-Protokollierung einrichten und Tags hinzufügen.
So konfigurieren Sie die Pipe-Einstellungen
-
Wählen Sie die Registerkarte Pipe-Einstellungen aus.
-
Standardmäßig sind neu erstellte Pipes aktiv, sobald sie erstellt wurden. Wenn Sie eine inaktive Pipe erstellen möchten, deaktivieren Sie unter Aktivierung für Pipe aktivieren die Option Aktiv.
-
Führen Sie unter Berechtigungen für Ausführungsrolle einen der folgenden Schritte aus:
-
Um eine neue Ausführungsrolle für diese Pipe EventBridge erstellen zu lassen, wählen Sie Create a new role for this specific resource. Sie können unter Rollenname optional den Rollennamen bearbeiten.
-
Wählen Sie Vorhandene Rolle verwenden aus, wenn Sie eine vorhandene Ausführungsrolle verwenden möchten. Wählen Sie unter Rollenname die Rolle aus.
-
-
(Optional) Wenn Sie einen DynamoDB Stream Kinesis oder als Pipe-Quelle angegeben haben, können Sie eine Wiederholungsrichtlinie und eine Warteschlange mit unerlaubten Briefen () konfigurieren. DLQ
Gehen Sie für Wiederholungsrichtlinie und Warteschlange für unzustellbare Nachrichten – optional wie folgt vor:
Gehen Sie unter Wiederholungsrichtlinie wie folgt vor:
-
Wenn Sie Wiederholungsrichtlinien aktivieren möchten, aktivieren Sie Wiederholen. Standardmäßig ist für neu erstellte Pipes keine Wiederholungsrichtlinie aktiviert.
-
Geben Sie für Maximum age of event (Maximales Alter des Ereignisses) einen Wert zwischen einer Minute (00:01) und 24 Stunden (24:00) ein.
-
Geben Sie für Wiederholungsversuche eine Zahl zwischen 0 und 185 ein.
-
Wenn Sie eine Warteschlange für unzustellbare Briefe (DLQ) verwenden möchten, aktivieren Sie die Warteschlange für unzustellbare Briefe, wählen Sie die Methode Ihrer Wahl und wählen Sie die Warteschlange oder das Thema aus, das Sie verwenden möchten. Standardmäßig verwenden neu erstellte Pipes kein. DLQ
-
-
Wählen Sie die KMS key für die Verschlüsselung von Pipe-Daten EventBridge zu verwendende Form aus.
Weitere Informationen zur EventBridge Verwendung finden Sie KMS keys unterVerschlüsselung im Ruhezustand.
-
Wählen Sie Verwenden AWS-eigener Schlüssel für EventBridge , um die Daten mit einem AWS-eigener Schlüssel zu verschlüsseln.
Dies AWS-eigener Schlüssel ist eine KMS key , die mehrere Konten EventBridge besitzt und für die Verwendung in mehreren AWS Konten verwaltet wird. Generell gilt: Sofern Sie nicht verpflichtet sind, den Verschlüsselungsschlüssel, der Ihre Ressourcen schützt, zu überprüfen oder zu kontrollieren, AWS-eigener Schlüssel ist an eine gute Wahl.
Dies ist die Standardeinstellung.
-
Wählen Sie Verwenden Kundenverwalteter Schlüssel für EventBridge , um die Daten mit dem zu verschlüsseln Kundenverwalteter Schlüssel , den Sie angeben oder erstellen.
Kundenverwaltete Schlüssel befinden sich KMS keys in Ihrem AWS Konto, das Sie erstellen, besitzen und verwalten. Sie haben die volle Kontrolle über diese KMS keys.
-
Geben Sie ein vorhandenes an Kundenverwalteter Schlüssel, oder wählen Sie Neues erstellen KMS key.
EventBridge zeigt den Schlüsselstatus und alle Schlüsselaliase an, die dem angegebenen Kundenverwalteter Schlüssel Schlüssel zugeordnet wurden.
-
-
-
(Optional) Sie können unter Protokolle – optional festlegen, wie EventBridge Pipes Protokollierungsinformationen an unterstützte Services sendet, einschließlich der Konfiguration dieser Protokolle.
Weitere Informationen zur Protokollierung von Pipe-Datensätzen finden Sie unter Protokollierung der Leistung von Amazon EventBridge Pipes.
CloudWatch logs ist standardmäßig als Protokollziel ausgewählt, ebenso wie die
ERROR
Protokollebene. Daher erstellt EventBridge Pipes standardmäßig eine neue CloudWatch Protokollgruppe, an die Protokolldatensätze gesendet werden, die denERROR
Detaillierungsgrad enthalten.Gehen Sie wie folgt vor, damit EventBridge Pipes Protokolldatensätze an eines der unterstützten Protokollziele sendet:
-
Wählen Sie unter Protokolle – optional die Ziele aus, an die Protokolldatensätze gesendet werden sollen.
-
Wählen Sie unter Protokollebene die Informationsebene aus, die in EventBridge die Protokolldatensätze aufgenommen werden soll. Die
ERROR
-Protokollebene ist standardmäßig ausgewählt.Weitere Informationen finden Sie unter Angabe der EventBridge Pipes-Protokollebene.
-
Wählen Sie Ausführungsdaten einbeziehen aus, wenn Sie Informationen EventBridge zur Ereignisnutzlast sowie Informationen zu Serviceanfragen und -antworten in die Protokolldatensätze aufnehmen möchten.
Weitere Informationen finden Sie unter Inklusive Ausführungsdaten in EventBridge Pipes-Protokollen.
-
Konfigurieren Sie jedes ausgewählte Protokollziel:
Gehen Sie bei CloudWatch Logs Protokollen unter CloudWatch Protokolle wie folgt vor:
-
Wählen Sie für CloudWatch Protokollgruppe aus, ob Sie eine neue Protokollgruppe EventBridge erstellen möchten, oder wählen Sie eine bestehende Protokollgruppe aus oder geben Sie die ARN einer vorhandenen Protokollgruppe an.
-
Bearbeiten Sie für neue Protokollgruppen den Namen der Protokollgruppe nach Bedarf.
CloudWatch logs ist standardmäßig ausgewählt.
Wählen Sie für Firehose Stream-Logs unter Firehose Stream-Protokoll den Firehose Stream aus.
Gehen Sie bei Amazon S3 Protokollen unter S3-Logs wie folgt vor:
-
Geben Sie den Namen des Buckets ein, der als Protokollziel verwendet werden soll.
-
Geben Sie die AWS Konto-ID des Bucket-Besitzers ein.
-
Geben Sie einen beliebigen Präfixtext ein, der verwendet werden soll, wenn EventBridge S3-Objekte erstellt.
Weitere Informationen finden Sie unter Organisieren von Objekten mit Präfixen im Amazon Simple Storage Service -Benutzerhandbuch.
-
Wählen Sie aus, wie Sie S3-Protokolldatensätze formatieren möchten EventBridge :
-
json
: JSON -
plain
: Klartext
-
-
-
-
(Optional) Wählen Sie unter Tags – optional die Option Neues Tag hinzufügen und geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter Ressourcen in Amazon taggen EventBridge.
-
Wählen Sie Pipe erstellen aus.
Validieren von Konfigurationsparameter
EventBridge Validiert nach der Erstellung einer Pipe die folgenden Konfigurationsparameter:
-
IAMRolle — Da die Quelle einer Pipe nach der Erstellung der Pipe nicht geändert werden kann, wird EventBridge überprüft, ob die angegebene IAM Rolle auf die Quelle zugreifen kann.
Anmerkung
EventBridge führt nicht dieselbe Überprüfung für Anreicherungen oder Ziele durch, da diese nach der Erstellung der Pipe aktualisiert werden können.
-
Batching — EventBridge überprüft, ob die Batchgröße der Quelle die maximale Batchgröße des Ziels nicht überschreitet. Ist dies der Fall, ist eine geringere Batchgröße EventBridge erforderlich. Wenn ein Ziel die Batchverarbeitung nicht unterstützt, können Sie außerdem die Batching-Funktion EventBridge für die Quelle nicht konfigurieren.
-
Anreicherungen — EventBridge überprüft, ob die Batchgröße für API Gateway- und API Zielanreicherungen 1 ist, da nur Batchgrößen von 1 unterstützt werden.