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.
| Limite | Intervallo | Predefinita |
|---|---|---|
MaxRetryAttempts | Da 0 a 185 | 5 |
MaxEventAgeInSeconds | Da 60 a 86.400 | 300 |
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.
errorCode | Cosa non è riuscito | errorMessage |
|---|---|---|
CUSTOMER_VALIDATION | L'API di destinazione ha rifiutato la richiesta (una risposta 4xx): un valore errato, un campo mancante, un corpo non valido | Il messaggio proprio dell'API di destinazione |
ACCESS_DENIED | EventBridge 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'accesso | EventBridge 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_FOUND | L'obiettivo, o la sua AWS KMS chiave, non esiste | Il messaggio di cui sopra non è possibile accedere o il messaggio generico |
INPUT_TRANSFORMATION_FAILURE | L'Inputespressione Transformer o universal-target non ha generato o prodotto alcun valore | L'errore di espressione |
THROTTLING | Il bersaglio ha rallentato la chiamata | Il messaggio generico |
EXECUTION_TIMEOUT | Il bersaglio non ha risposto entro InvocationTimeoutSeconds | Il messaggio generico |
REQUEST_TOO_LARGE | La richiesta ha superato il limite di dimensione del target; inferiore MaxBatchSize | Il messaggio generico |
PARTIAL_BATCH_FAILURE | La destinazione ha accettato parte di un batch e ha rifiutato il resto; il record failedMessages elenca solo gli eventi rifiutati | Il messaggio generico |
RESOURCE_CONFLICT | La destinazione ha segnalato un conflitto, ad esempio un nome già in uso | Il messaggio generico |
KMS_INVALID_STATE | La AWS KMS chiave della destinazione è disabilitata o è in attesa di eliminazione | Il messaggio generico |
SFN_TYPE_NOT_SUPPORTED | REQUEST_RESPONSEè stato utilizzato con una macchina a stati Standard, che non supporta l'esecuzione sincrona | Il messaggio generico |
COMPUTE_EXECUTION_ERROR | Una REQUEST_RESPONSE funzione o un'esecuzione è stata eseguita e ha riportato un errore | Il messaggio generico |
INVOCATION_DEPENDENCY_INTERNAL | La destinazione ha restituito un errore del server (una risposta 5xx) | Il messaggio generico |
LOOP_DETECTED | L'evento, o un evento da esso derivato, è già passato attraverso il bus di destinazione; vedi Rilevamento del loop | Il messaggio generico |
INTERNAL_SERVER_ERROR | Un errore interno EventBridge durante la chiamata che ha comunque esaurito i tentativi | Il 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.
-
Leggi i record e raccogli tutti
failedMessages[].eventId, oltre a quelli più vecchi e più recentitimestamp. -
Correggi la causa e
errorCodei nomi: la politica del ruolo, l'obiettivo o l'espressione. -
Crea un abbonato sullo stesso bus con lo stesso obiettivo e lo stesso ruolo, una posizione di
POINT_IN_TIMEpartenza il cui timestampStartingPointsia il primo e l'ultimo, e unSYSTEM_METADATAfiltro sugli identificatori.EndPoint -
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.