View a markdown version of this page

Konfiguration von Protokollen für EventBridge Amazon-Event-Busse - Amazon EventBridge
Funktionsweise der ProtokollierungAngeben der ProtokollebeneEinschließlich Details in ProtokollenProtokolle werden gekürztFehler bei der Meldung in den Protokollen

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.

Konfiguration von Protokollen für EventBridge Amazon-Event-Busse

Sie können so konfigurieren EventBridge , dass Protokolle gesendet werden, in denen detailliert beschrieben wird, wie ein Event-Bus Ereignisse verarbeitet, um bei der Problembehandlung und beim Debuggen zu helfen.

Sie können die folgenden AWS Dienste als Protokollziele auswählen, an die EventBridge Protokolle für den angegebenen Event-Bus gesendet werden:

  • Amazon CloudWatch Logs

    EventBridge übermittelt Protokolle an die angegebene CloudWatch Logs-Protokollgruppe.

    Verwenden Sie CloudWatch Logs, um die Protokolle aller Ihrer Systeme, Anwendungen und AWS Dienste, die Sie verwenden, in einem einzigen, hochgradig skalierbaren Dienst zu zentralisieren. Weitere Informationen finden Sie unter Arbeiten mit Protokollgruppen und Log-Streams im Amazon CloudWatch Logs-Benutzerhandbuch.

  • Amazon Data Firehose

    EventBridge liefert Protokolle an einen Firehose-Lieferstream.

    Amazon Data Firehose ist ein vollständig verwalteter Dienst für die Bereitstellung von Streaming-Daten in Echtzeit an Ziele wie bestimmte AWS Dienste sowie an benutzerdefinierte HTTP-Endpunkte oder HTTP-Endpunkte, die unterstützten Drittanbietern gehören. Weitere Informationen finden Sie unter Erstellen eines Amazon Data Firehose-Lieferstreams im Amazon Data Firehose-Benutzerhandbuch.

  • Amazon S3

    EventBridge übermittelt Protokolle als Amazon S3-Objekte an den angegebenen Bucket.

    Amazon S3 ist ein Objektspeicherservice, der branchenführende Skalierbarkeit, Datenverfügbarkeit, Sicherheit und Leistung bietet. Weitere Informationen finden Sie unter Hochladen, Herunterladen und Arbeiten mit Objekten in Amazon S3 im Benutzerhandbuch für Amazon Simple Storage Service.

So funktioniert die Protokollierung für Event-Busse

EventBridge generiert Protokolle für:

  • Alle AWS Dienstereignisse, die einer Regel auf dem Event-Bus entsprechen

  • Alle Ereignisse, die mit den folgenden Methoden übermittelt werden, unabhängig davon, ob das Ereignis erfolgreich aufgenommen wurde oder einer Regel entspricht:

EventBridge protokolliert keine Ereignisse, die nur verwalteten Regeln entsprechen.

Die an jedes ausgewählte Protokollziel gesendeten Protokolldaten sind identisch.

Sie können die an die ausgewählten Ziele EventBridge gesendeten Protokolle auf folgende Weise anpassen:

Überlegungen zur Übermittlung von Protokollen

Beachten Sie bei der Konfiguration der Protokollierung für Eventbusse die folgenden Überlegungen:

  • Die Protokolldatensätze für den Event-Bus werden nach bestem Wissen und Gewissen bereitgestellt. Die meisten Anfragen für einen Event-Bus, der ordnungsgemäß für die Protokollierung konfiguriert ist, führen zu einem übermittelten Protokolldatensatz. Die Vollständigkeit und Aktualität der Eventbus-Protokollierung kann nicht garantiert werden.

  • Unter bestimmten Umständen generiert die Übertragung von Event-Bus-Protokolldatensätzen selbst Ereignisse, die dann an diese gesendet werden EventBridge, was zu einer Unterbrechung der Protokolldatensatzübermittlung führen kann. Aus diesem Grund EventBridge protokolliert, werden die folgenden Ereignisse nicht protokolliert:

    • AWS KMS Decryptund GenerateDataKey Ereignisse, die generiert werden, wenn Protokolldatensätze, die mit einem vom Kunden verwalteten Schlüssel verschlüsselt wurden, an ein Protokollziel übermittelt werden.

    • PutRecordBatchEreignisse in Firehose, die durch die Übermittlung von Event-Bus-Protokollen generiert werden.

  • Für S3-Protokollziele wird die Angabe eines Ziel-Buckets mit EventBridge aktivierter Ereignisbenachrichtigung nicht empfohlen, da dies zu einer Unterbrechung der Übermittlung Ihrer Protokolle führen kann.

Protokollierung und Verschlüsselung

EventBridge Verschlüsselt beim Senden von Protokollen die error Abschnitte detail und jedes Protokolldatensatzes mit dem KMS-Schlüssel, der für den Event-Bus angegeben ist. Nach der Übermittlung wird der Datensatz entschlüsselt und anschließend mit dem für das Protokollziel angegebenen KMS-Schlüssel erneut verschlüsselt.

Weitere Informationen finden Sie unter Verschlüsselung von Event-Bus-Protokollen.

Angeben der Berechtigungen für die Eventbus-Protokollierung

Um die Protokollierung über einen Event-Bus zu ermöglichen, fügen Sie Ihrer AWS Identity and Access Management (IAM) -Identität (Benutzer oder Rolle) die folgende identitätsbasierte Richtlinie hinzu. Diese Richtlinie gewährt die events:AllowVendedLogDeliveryForResource Aktion für den Event-Bus.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "ServiceLevelAccessForLogDelivery",
            "Effect": "Allow",
            "Action": [
                "events:AllowVendedLogDeliveryForResource"
            ],
            "Resource": "arn:aws:events:us-east-1:123456789012:event-bus/my-event-bus*"
        }
    ]
}

Weitere Informationen finden Sie unter Service-specific Berechtigungen im CloudWatch Logs-Benutzerhandbuch.

Angabe der Protokollebene für den Event-Bus

Sie können die Typen von Schritten zur Ereignisverarbeitung angeben, die an den ausgewählten Protokollzielen EventBridge protokolliert werden.

Wählen Sie aus den folgenden Detailebenen, die in die Protokolle aufgenommen werden sollen. Die Protokollebene gilt für alle Protokollziele, die für den Event-Bus angegeben sind. Jede Protokollebene umfasst die Schritte der vorherigen Protokollebenen.

  • OFF — sendet EventBridge keine Protokolle. Das ist die Standardeinstellung.

  • ERROR — EventBridge sendet alle Protokolle, die sich auf Fehler beziehen, die während der Ereignisverarbeitung und der Zielübermittlung generiert wurden.

  • INFO — EventBridge sendet alle Protokolle, die sich auf Fehler beziehen, sowie auf wichtige Schritte, die während der Ereignisverarbeitung ausgeführt wurden.

  • TRACE — EventBridge sendet alle Protokolle, die während aller Schritte der Ereignisverarbeitung generiert wurden.

In der folgenden Tabelle sind die Schritte zur Ereignisverarbeitung aufgeführt, die in den einzelnen Protokollebenen enthalten sind.

Schritt TRACE INFO ERROR OFF

Ereignis aufgenommen

 x x

Das Erfassen des Ereignisses ist fehlgeschlagen

 x x x

Ereignis empfangen

 x

Der Aufrufversuch wurde gestartet

 x

Aufrufversuch Dauerhafter Fehler

 x x x

Versuch des Aufrufs ist fehlgeschlagen Retry-able

x x x

Der Aufrufversuch war erfolgreich

 x

Der Aufrufversuch wurde gedrosselt

 x x x

Aufruf DLQ

 x x x

Der Aufruf ist fehlgeschlagen

 x x x

Der Aufruf wurde gestartet

 x x

Der Aufruf war erfolgreich

 x x

Aufruf Throttle wurde gestartet

 x x x

Es wurden keine Regeln gefunden

 x x

Die Regel wurde erfüllt

x x

Der Regelabgleich wurde gestartet

x

Einschließlich detaillierter Daten in den Event-Bus-Protokollen

Sie können angeben EventBridge , dass detailliertere Informationen in die generierten Protokolle aufgenommen werden sollen. Diese Daten können für die Problembehandlung und das Debuggen nützlich sein. Wenn Sie diese Option auswählen, EventBridge werden diese Daten in die entsprechenden Datensätze für alle angegebenen Protokollziele aufgenommen.

Zu den Detailinformationen gehören die folgenden Felder:

  • event_detail: Die Einzelheiten der Veranstaltung selbst.

  • target_input: Die Anfrage EventBridge wird an das Ziel gesendet.

  • target_properties:

Kürzen von Daten in Event-Bus-Protokollen

EventBridge Beschränkt die Protokolldatensätze aufgrund von Einschränkungen für das Protokollziel auf 1 MB. Wenn ein Protokolldatensatz diesen Grenzwert überschreitet, wird der Datensatz EventBridge gekürzt, indem die folgenden Felder in der folgenden Reihenfolge entfernt werden:

  • target_input

  • target_properties

  • target_response_body

EventBridge entfernt das event_detail Feld bei Bedarf aus den folgenden Protokolldatensatztypen:

  • EVENT_RECEIVED

  • EVENT_INGESTED

  • EVENT_INGESTED_FAILED

  • RULE_MATCH_STARTED

Wenn eine Kürzung erforderlich ist, wird das gesamte Feld EventBridge entfernt.

Wenn Felder im Ereignis EventBridge gekürzt werden, enthält das dropped_fields Feld eine Liste der ausgeschnittenen Datenfelder.

Meldung von Fehlern in den Event-Bus-Protokollen

EventBridge enthält auch Fehlerdaten, sofern verfügbar, in Schritten, die Fehlerzustände darstellen. Zu diesen Schritten gehören:

  • EVENT_INGEST_FAILURE

  • INVOCATION_THROTTLE_START

  • INVOCATION_ATTEMPT_THROTTLE

  • INVOCATION_ATTEMPT_RETRYABLE_FAILURE

  • INVOCATION_ATTEMPT_PERMANENT_FAILURE

  • INVOCATION_FAILURE

  • INVOCATION_DLQ