View a markdown version of this page

Policy di ripetizione dei tentativi e code DLQ - Amazon EventBridge

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Policy di ripetizione dei tentativi e code DLQ

Quando una chiamata di destinazione fallisce, EventBridge riprova fino a raggiungere uno dei due limiti di RetryPolicy ingresso (per impostazione predefinita 5 tentativi o 300 secondi), quindi scrive un record nella coda di Amazon SQS. OnFailureConfiguration.Arn Imposta entrambi quando crei l'abbonato: senza una coda di lettere morte, un evento che esaurisce i tentativi viene eliminato e l'unica traccia è la metrica. EventsDropped

Limiti dei tentativi

La consegna si interrompe al primo limite raggiunto.

LimiteIntervalloPredefinita
MaxRetryAttemptsDa 0 a 1855
MaxEventAgeInSecondsDa 60 a 86.400300

Le impostazioni predefinite sono più brevi delle 24 ore e 185 tentativi di Custom Event Bus - Classic target. Un progetto migrato che si basa su un giorno di tentativi deve essere impostato esplicitamente su 86.400; in caso contrario, gli eventi che falliscono durante un'interruzione di attività di Target MaxEventAgeInSeconds per più di 5 minuti finiscono nella coda delle lettere non ricevute anziché essere consegnati in ritardo. Per un abbonato FIFO, un evento con esito negativo blocca gli eventi successivi del gruppo per tutto il tempo in cui viene riprovato, quindi una finestra di riprova lunga scambia l'ordine con la latenza.

Il record a lettera morta

Il record è un documento JSON, non l'evento. L'esempio seguente mostra un record per due eventi che hanno avuto esito negativo in un unico batch.

{ "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": "..." } ] }

Ogni errore che raggiunge la coda è stato riprovato per primo: non c'è nessun errore di consegna che lo salti. RetryPolicy I fallimenti interni vengono EventBridge ripetuti EventBridge senza limiti e non producono mai alcun record. La tabella seguente elenca i codici che un record può contenere. errorMessageviene troncato a 1.024 caratteri.

errorCodeCosa non è riuscitoerrorMessage
CUSTOMER_VALIDATIONL'API di destinazione ha rifiutato la richiesta (una risposta 4xx): un valore errato, un campo mancante, un corpo non validoIl messaggio proprio dell'API di destinazione
ACCESS_DENIEDEventBridge non ha potuto assumere il ruolo di recapito, al ruolo non è consentito chiamare la destinazione o alla AWS KMS chiave della destinazione è stato negato l'accessoEventBridge non poteva presumererole. Verifica che il ruolo esista e che la sua politica di fiducia consenta al responsabile del EventBridge servizio di assumerlo. o non ha EventBridge potuto accedereresource. Verifica che esista e che il ruolo di consegna dell'abbonato sia autorizzato ad accedervi.
RESOURCE_NOT_FOUNDL'obiettivo, o la sua AWS KMS chiave, non esisteIl messaggio di cui sopra non è possibile accedere o il messaggio generico
INPUT_TRANSFORMATION_FAILUREL'Inputespressione Transformer o universal-target non ha generato o prodotto alcun valoreL'errore di espressione
THROTTLINGIl bersaglio ha rallentato la chiamataIl messaggio generico
EXECUTION_TIMEOUTIl bersaglio non ha risposto entro InvocationTimeoutSecondsIl messaggio generico
REQUEST_TOO_LARGELa richiesta ha superato il limite di dimensione del target; inferiore MaxBatchSizeIl messaggio generico
PARTIAL_BATCH_FAILURELa destinazione ha accettato parte di un batch e ha rifiutato il resto; il record failedMessages elenca solo gli eventi rifiutatiIl messaggio generico
RESOURCE_CONFLICTLa destinazione ha segnalato un conflitto, ad esempio un nome già in usoIl messaggio generico
KMS_INVALID_STATELa AWS KMS chiave della destinazione è disabilitata o è in attesa di eliminazioneIl messaggio generico
SFN_TYPE_NOT_SUPPORTEDREQUEST_RESPONSEè stato utilizzato con una macchina a stati Standard, che non supporta l'esecuzione sincronaIl messaggio generico
COMPUTE_EXECUTION_ERRORUna REQUEST_RESPONSE funzione o un'esecuzione è stata eseguita e ha riportato un erroreIl messaggio generico
INVOCATION_DEPENDENCY_INTERNALLa destinazione ha restituito un errore del server (una risposta 5xx)Il messaggio generico
LOOP_DETECTEDL'evento, o un evento da esso derivato, è già passato attraverso il bus di destinazione; vedi Rilevamento del loopIl messaggio generico
INTERNAL_SERVER_ERRORUn errore interno EventBridge durante la chiamata che ha comunque esaurito i tentativiIl messaggio generico

Il messaggio generico è La consegna non è riuscita. Utilizza il codice di errore e l'ID della richiesta di questo record durante l'analisi e contatta l' AWS assistenza se l'errore persiste. EventBridge lo utilizza ovunque la trasmissione del messaggio sottostante possa rivelare le funzionalità interne di un altro servizio, quindi per quei codici i dati errorCode e targetRequestId sono i dati su cui basarsi, insieme ai record di EVENT_DELIVERY_ATTEMPT registro che contengono la richiesta inviata. Gli stessi valori arrivano come attributi dei messaggi di Amazon SQS (ERROR_CODE,,,,ERROR_MESSAGE,SUBSCRIBER_ARN,RETRY_ATTEMPTS) TARGET_ARN BUS_ARNEXHAUSTED_RETRY_CONDITION, in modo che un consumatore possa indirizzarli su di essi senza analizzarne il corpo. Per un abbonato FIFO, utilizza una coda FIFO come coda delle lettere non scritte; EventBridge imposta ogni record in base agli eventiEventGroupId, in modo che i record MessageGroupId di un gruppo rimangano in ordine.

Il ruolo di consegna deve essere presente in coda. sqs:SendMessage Senza di essa, la OnFailureDestinationFailed metrica conta ogni record che non è stato possibile scrivere e tali eventi vengono persi.

Reindirizzamento degli eventi dalla coda delle lettere non scritte

La coda contiene i record, non gli eventi, quindi puoi riguidare riproducendo gli eventi dal bus. Gli eventi devono ancora rientrare nel periodo di conservazione del bus.

  1. Leggi i record e raccogli tuttifailedMessages[].eventId, oltre a quelli più vecchi e più recentitimestamp.

  2. Correggi la causa e errorCode i nomi: la politica del ruolo, l'obiettivo o l'espressione.

  3. Crea un abbonato sullo stesso bus con lo stesso obiettivo e lo stesso ruolo, una posizione di POINT_IN_TIME partenza il cui timestamp StartingPoint sia il primo e l'ultimo, e un SYSTEM_METADATA filtro sugli identificatori. EndPoint

  4. Quando l'abbonato ha consegnato gli eventi, eliminali ed elimina i record dalla coda.

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" }'

Gli eventi riprodotti arrivano in tempo reale aws:DeliveryTypeREPLAY, in modo che il consumatore possa distinguerli dal traffico in tempo reale.