View a markdown version of this page

Politiques relative aux nouvelles tentatives et files d’attente de lettres mortes - Amazon EventBridge

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Politiques relative aux nouvelles tentatives et files d’attente de lettres mortes

Lorsqu'un appel cible échoue, EventBridge réessayez jusqu'à ce que l'une des deux limites RetryPolicy soit atteinte, par défaut 5 tentatives ou 300 secondes, puis écrit un enregistrement dans la file d'attente Amazon SQS. OnFailureConfiguration.Arn Définissez les deux lorsque vous créez l'abonné : sans file d'attente de lettres mortes, un événement qui a épuisé ses tentatives est supprimé et la seule trace est la métrique. EventsDropped

Limites de nouvelles tentatives

La livraison s'arrête à la première limite atteinte.

LimiteRangePar défaut
MaxRetryAttempts0 à 1855
MaxEventAgeInSeconds60 à 86 400300

Les valeurs par défaut sont plus courtes que celles d'un Custom Event Bus - Classic Target (24 heures et 185 tentatives). Une conception migrée qui repose sur un jour de tentatives doit être définie MaxEventAgeInSeconds explicitement sur 86 400 ; sinon, les événements qui échouent pendant une interruption cible de plus de 5 minutes sont placés dans la file d'attente des lettres mortes au lieu d'être livrés en retard. Pour un abonné FIFO, un événement défaillant bloque les derniers événements de son groupe tant qu'il fait l'objet d'une nouvelle tentative. Ainsi, une longue fenêtre de tentatives échange l'ordre contre la latence.

Le record de lettres mortes

L'enregistrement est un document JSON, pas l'événement. L'exemple suivant montre un enregistrement pour deux événements qui ont échoué ensemble dans un lot.

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

Chaque échec atteint la file d'attente a d'abord fait l'objet d'une nouvelle tentative : aucun échec de livraison n'est ignoréRetryPolicy. Les échecs EventBridge internes sont réessayés EventBridge sans limite et ne produisent jamais d'enregistrement. Le tableau suivant répertorie les codes qu'un enregistrement peut contenir. errorMessageest tronqué à 1 024 caractères.

errorCodeQu'est-ce qui a échouéerrorMessage
CUSTOMER_VALIDATIONL'API cible a rejeté la demande (une réponse 4xx) : une valeur incorrecte, un champ manquant, un corps mal forméLe propre message de l'API cible
ACCESS_DENIEDEventBridge n'a pas pu assumer le rôle de livraison, le rôle n'est pas autorisé à appeler la cible ou la AWS KMS clé de la cible a refusé l'accèsEventBridge Je ne pouvais pas supposerrole. Vérifiez que le rôle existe et que sa politique de confiance autorise le principal du EventBridge service à l'assumer. ou n'EventBridge a pas pu y accéderresource. Vérifiez qu'il existe et que le rôle de livraison de l'abonné est autorisé à y accéder.
RESOURCE_NOT_FOUNDLa cible, ou sa AWS KMS clé, n'existe pasImpossible d'accéder au message ci-dessus ou au message générique
INPUT_TRANSFORMATION_FAILUREL'Inputexpression Transformer ou universal-target n'a généré ou produit aucune valeurL'erreur d'expression
THROTTLINGLa cible a limité l'appelLe message générique
EXECUTION_TIMEOUTLa cible n'a pas répondu dans les délais InvocationTimeoutSecondsLe message générique
REQUEST_TOO_LARGELa demande a dépassé la limite de taille de la cible ; inférieure MaxBatchSizeLe message générique
PARTIAL_BATCH_FAILURELa cible a accepté une partie d'un lot et a rejeté le reste ; l'enregistrement ne failedMessages répertorie que les événements rejetésLe message générique
RESOURCE_CONFLICTLa cible a signalé un conflit, par exemple un nom déjà utiliséLe message générique
KMS_INVALID_STATELa AWS KMS clé de la cible est désactivée ou en attente de suppressionLe message générique
SFN_TYPE_NOT_SUPPORTEDREQUEST_RESPONSEa été utilisé avec une machine à états standard, qui ne prend pas en charge l'exécution synchroneLe message générique
COMPUTE_EXECUTION_ERRORUne REQUEST_RESPONSE fonction ou une exécution a été exécutée et a signalé une erreurLe message générique
INVOCATION_DEPENDENCY_INTERNALLa cible a renvoyé une erreur de serveur (une réponse 5xx)Le message générique
LOOP_DETECTEDL'événement, ou un événement dérivé de celui-ci, est déjà passé par le bus cible ; voir Détection de boucleLe message générique
INTERNAL_SERVER_ERRORUn échec interne EventBridge lors de l'appel qui a toujours épuisé les tentativesLe message générique

Le message générique est La livraison a échoué. Utilisez le code d'erreur et l'identifiant de demande de cet enregistrement lors de l'enquête, et contactez le AWS Support si l'échec persiste. EventBridge l'utilise chaque fois que la transmission du message sous-jacent peut exposer les composants internes d'un autre service. Ainsi, pour ces codes, ce targetRequestId sont les faits à partir desquels travailler, ainsi que les enregistrements du EVENT_DELIVERY_ATTEMPT journal, qui contiennent la demande envoyée. errorCode Les mêmes valeurs arrivent sous forme d'attributs de message Amazon SQS (ERROR_CODE,,ERROR_MESSAGE,SUBSCRIBER_ARN,TARGET_ARN,BUS_ARN,RETRY_ATTEMPTS)EXHAUSTED_RETRY_CONDITION, afin qu'un consommateur puisse les acheminer sans en analyser le corps. Pour un abonné au FIFO, utilisez une file d'attente FIFO comme file d'attente de lettres mortes ; EventBridge définit chaque enregistrement à MessageGroupId partir de celui des événementsEventGroupId, de sorte que les enregistrements d'un groupe restent dans l'ordre.

Le rôle de livraison doit figurer dans sqs:SendMessage la file d'attente. Sans cela, la OnFailureDestinationFailed métrique compte chaque enregistrement qui n'a pas pu être écrit, et ces événements sont perdus.

Reproduction d'événements depuis la file d'attente des lettres mortes

La file d'attente contient des records, et non des événements. Vous pouvez donc repartir en rejouant les événements depuis le bus. Les événements doivent toujours se dérouler pendant la période de conservation du bus.

  1. Lisez les dossiers et collectez tous les documentsfailedMessages[].eventId, ainsi que les plus anciens et les plus récentstimestamp.

  2. Corrigez la cause par les errorCode noms : la politique du rôle, la cible ou l'expression.

  3. Créez un abonné sur le même bus avec la même cible et le même rôle, une position de POINT_IN_TIME départ dont l'horodatage StartingPoint est le plus ancien et le plus récent, et un SYSTEM_METADATA filtre sur les identifiants. EndPoint

  4. Lorsque l'abonné a diffusé les événements, supprimez-les et supprimez les enregistrements de la file d'attente.

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

Les événements rejoués arrivent avec aws:DeliveryTypeREPLAY, ce qui permet au consommateur de les connaître grâce au trafic en direct.