View a markdown version of this page

Richtlinien für Wiederholungsversuche und Warteschlangen für unzustellbare Nachrichten - 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.

Richtlinien für Wiederholungsversuche und Warteschlangen für unzustellbare Nachrichten

Wenn ein Zielaufruf fehlschlägt, EventBridge versucht er es erneut, bis einer der beiden Grenzwerte erreicht RetryPolicy ist, standardmäßig 5 Versuche oder 300 Sekunden, und schreibt dann einen Datensatz in die Amazon SQS SQS-Warteschlange in. OnFailureConfiguration.Arn Legen Sie beides fest, wenn Sie den Abonnenten erstellen: Ohne eine Warteschlange mit unerlaubten Briefen wird ein Ereignis, dessen Wiederholungsversuche aufgebraucht sind, verworfen, und der einzige Trace ist die Metrik. EventsDropped

Grenzwerte für Wiederholungsversuche

Die Lieferung stoppt bei dem Limit, das zuerst erreicht wird.

LimitRangeStandard
MaxRetryAttempts0 bis 1855
MaxEventAgeInSeconds60 bis 86.400300

Die Standardwerte sind kürzer als die 24 Stunden und 185 Versuche eines Custom Event Bus — Classic-Ziels. Ein migriertes Design, das auf einem Tag mit Wiederholungsversuchen beruhte, muss explizit auf 86.400 gesetzt MaxEventAgeInSeconds werden. Andernfalls werden Ereignisse, die bei einem Ausfall des Ziels länger als 5 Minuten fehlschlagen, in die Warteschlange für unzustellbare Briefe verschoben, anstatt verspätet zugestellt zu werden. Bei einem FIFO-Abonnenten blockiert ein fehlgeschlagenes Ereignis die späteren Ereignisse in seiner Gruppe, solange es erneut versucht wird. Bei einem langen Wiederholungsfenster wird also Reihenfolge gegen Latenz eingetauscht.

Der Rekord mit unbestätigten Buchstaben

Der Datensatz ist ein JSON-Dokument, nicht das Ereignis. Das folgende Beispiel zeigt einen Datensatz für zwei Ereignisse, die zusammen in einem Batch fehlgeschlagen sind.

{ "version": "1.0", "busArn": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef", "subscriberArn": "arn:aws:events:us-east-1:111122223333:subscriber/large-orders/EXAMPLEabcdef1234567890", "targetArn": "arn:aws:sqs:us-east-1:111122223333:large-orders", "errorCode": "ACCESS_DENIED", "errorMessage": "The delivery role is not authorized to perform sqs:SendMessage on the target.", "exhaustedRetryCondition": "MaximumEventAgeInSeconds", "retryAttempts": 4, "failedMessages": [ { "eventId": "a1b2c3d4-...", "eventGroupId": "order-1001", "deduplicationId": null, "timestamp": "2026-09-16T18:40:12Z", "targetRequestId": "..." }, { "eventId": "e5f6a7b8-...", "eventGroupId": "order-1001", "deduplicationId": null, "timestamp": "2026-09-16T18:40:13Z", "targetRequestId": "..." } ] }

Jeder Fehler, der die Warteschlange erreicht, wurde zuerst wiederholt: Es gibt keinen Übertragungsfehler, der übersprungen RetryPolicy wird. Fehler an EventBridge sich selbst werden EventBridge unbegrenzt wiederholt und führen nie zu einem Datensatz. In der folgenden Tabelle sind die Codes aufgeführt, die ein Datensatz enthalten kann. errorMessagewird auf 1.024 Zeichen gekürzt.

errorCodeWas ist gescheiterterrorMessage
CUSTOMER_VALIDATIONDie Ziel-API hat die Anfrage zurückgewiesen (eine 4xx-Antwort): ein falscher Wert, ein fehlendes Feld, ein fehlerhafter TextDie eigene Nachricht der Ziel-API
ACCESS_DENIEDEventBridge konnte die Zustellungsrolle nicht übernehmen, die Rolle darf das Ziel nicht aufrufen, oder dem AWS KMS Schlüssel des Ziels wurde der Zugriff verweigertEventBridge konnte nicht annehmenrole. Vergewissern Sie sich, dass die Rolle existiert und dass ihre Vertrauensrichtlinie es dem EventBridge Dienstprinzipal ermöglicht, sie zu übernehmen. oder EventBridge konnte nicht zugreifenresource. Vergewissern Sie sich, dass es existiert und dass die Zustellungsrolle des Abonnenten darauf zugreifen darf.
RESOURCE_NOT_FOUNDDas Ziel oder sein AWS KMS Schlüssel ist nicht vorhandenDie obige Meldung, auf die nicht zugegriffen werden konnte, oder die generische Meldung
INPUT_TRANSFORMATION_FAILUREDer Ausdruck Transformer oder der Input Universal-Target-Ausdruck hat keinen Wert ausgegeben oder erzeugtDer Ausdrucksfehler
THROTTLINGDas Ziel hat den Anruf gedrosseltDie generische Nachricht
EXECUTION_TIMEOUTDas Ziel hat nicht innerhalb von InvocationTimeoutSecondsDie generische Nachricht
REQUEST_TOO_LARGEDie Anfrage hat die Größenbeschränkung des Ziels überschritten. Sie ist niedriger MaxBatchSizeDie generische Nachricht
PARTIAL_BATCH_FAILUREDas Ziel hat einen Teil eines Batches akzeptiert und den Rest zurückgewiesen. Im Datensatz failedMessages sind nur die abgelehnten Ereignisse aufgeführtDie generische Nachricht
RESOURCE_CONFLICTDie Zielperson hat einen Konflikt gemeldet, z. B. einen Namen, der bereits verwendet wirdDie generische Nachricht
KMS_INVALID_STATEDer AWS KMS Schlüssel des Ziels ist deaktiviert oder steht kurz vor dem LöschenDie generische Nachricht
SFN_TYPE_NOT_SUPPORTEDREQUEST_RESPONSEwurde mit einer Standard-Zustandsmaschine verwendet, die keine synchrone Ausführung unterstütztDie generische Nachricht
COMPUTE_EXECUTION_ERROREine REQUEST_RESPONSE Funktion oder Ausführung wurde ausgeführt und es wurde ein Fehler gemeldetDie generische Nachricht
INVOCATION_DEPENDENCY_INTERNALDas Ziel hat einen Serverfehler zurückgegeben (eine 5xx-Antwort)Die generische Nachricht
LOOP_DETECTEDDas Ereignis oder ein davon abgeleitetes Ereignis hat den Zielbus bereits durchlaufen; siehe Erkennung von SchleifenDie generische Nachricht
INTERNAL_SERVER_ERROREin Fehler im Inneren des EventBridge Anrufs, der die Wiederholungsversuche immer noch erschöpft hatDie generische Nachricht

Die generische Nachricht lautet Die Zustellung ist fehlgeschlagen. Verwenden Sie bei der Untersuchung den Fehlercode und die Anforderungs-ID dieses Datensatzes und wenden Sie sich an den AWS Support, falls der Fehler weiterhin besteht. EventBridge verwendet ihn überall dort, wo die Weitergabe der zugrundeliegenden Nachricht die internen Daten eines anderen Dienstes offenlegen könnte. Für diese Codes targetRequestId sind das errorCode und die Fakten, auf deren Grundlage gearbeitet werden kann, zusammen mit den EVENT_DELIVERY_ATTEMPT Protokolldatensätzen, die die gesendete Anfrage enthalten. Dieselben Werte werden als Amazon SQS SQS-Nachrichtenattribute (ERROR_CODE,,ERROR_MESSAGE,SUBSCRIBER_ARN,TARGET_ARN, BUS_ARNEXHAUSTED_RETRY_CONDITION,RETRY_ATTEMPTS) empfangen, sodass ein Verbraucher sie weiterleiten kann, ohne den Text zu analysieren. Verwenden Sie für einen FIFO-Abonnenten eine FIFO-Warteschlange als Warteschlange für eingehende Briefe; EventBridge legt die Datensätze der Ereignisse festEventGroupId, sodass die Datensätze für eine Gruppe in der richtigen Reihenfolge bleiben. MessageGroupId

Die Zustellungsrolle muss sich in der Warteschlange befinden. sqs:SendMessage Ohne sie zählt die OnFailureDestinationFailed Metrik jeden Datensatz, der nicht geschrieben werden konnte, und diese Ereignisse gehen verloren.

Ereignisse aus der Warteschlange mit unzustellbaren Nachrichten werden erneut abgerufen

In der Warteschlange befinden sich Aufzeichnungen, keine Ereignisse. Sie fahren also erneut, indem Sie die Ereignisse aus dem Bus erneut abspielen. Die Ereignisse müssen immer noch innerhalb der Aufbewahrungsfrist des Busses liegen.

  1. Lesen Sie die Aufzeichnungen und sammeln Sie allefailedMessages[].eventId, sowie die frühesten und letztentimestamp.

  2. Korrigieren Sie die Ursache und die errorCode Namen: die Richtlinie der Rolle, das Ziel oder den Ausdruck.

  3. Erstellen Sie einen Teilnehmer auf demselben Bus mit demselben Ziel und derselben Rolle, einer POINT_IN_TIME Startposition, deren StartingPoint frühester und dessen spätester Zeitstempel EndPoint ist, und einem SYSTEM_METADATA Filter nach den Kennungen.

  4. Wenn der Abonnent die Ereignisse übermittelt hat, löschen Sie sie und löschen Sie die Datensätze aus der Warteschlange.

aws eventsv2 create-subscriber \ --name redrive-2026-09-16 \ --event-bus-arn arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --starting-position POINT_IN_TIME \ --point-in-time-configuration '{ "PointType": "TIMESTAMP", "StartingPoint": "2026-09-16T18:40:00Z", "EndPoint": "2026-09-16T18:41:00Z" }' \ --filter-configuration '{ "Filters": [ { "Scope": "SYSTEM_METADATA", "Pattern": "{\"aws:EventId\":[\"a1b2c3d4-...\",\"e5f6a7b8-...\"]}" } ] }' \ --invoke-configuration '{ "TargetArn": "arn:aws:sqs:us-east-1:111122223333:large-orders", "RoleArn": "arn:aws:iam::111122223333:role/EventBusDeliveryRole" }'

Die wiedergegebenen Ereignisse kommen mit an aws:DeliveryTypeREPLAY, sodass ein Verbraucher sie anhand des Live-Traffics unterscheiden kann.