Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Políticas de reintentos y colas de mensajes fallidos
Cuando se produce un error en una llamada de destino, EventBridge vuelve a intentarlo hasta que RetryPolicy se alcance uno de los dos límites (de forma predeterminada, 5 intentos o 300 segundos) y, a continuación, escribe un registro en la cola de Amazon SQS. OnFailureConfiguration.Arn Al crear el suscriptor, defina ambas opciones: si no hay una cola con letra muerta, se descarta el evento que agota los reintentos y el único rastro es la métrica. EventsDropped
Límites de reintentos
La entrega se detiene en el límite que se alcance primero.
| Límite | Range | Predeterminado |
|---|---|---|
MaxRetryAttempts | 0 a 185 | 5 |
MaxEventAgeInSeconds | 60 a 86.400 | 300 |
Los valores predeterminados son más cortos que los de un bus de eventos personalizado: el objetivo clásico es de 24 horas y 185 intentos. Un diseño migrado que se basara en un día de reintentos debe MaxEventAgeInSeconds configurarse en 86 400 de forma explícita; de lo contrario, los eventos que fallan durante una interrupción objetivo de más de 5 minutos pasan a la cola de espera en lugar de entregarse con retraso. En el caso de un suscriptor de FIFO, un evento fallido bloquea los eventos posteriores de su grupo mientras se vuelva a intentar, por lo que en una ventana de reintentos larga se cambia el orden de latencia.
El registro en letra muerta
El registro es un documento JSON, no el evento. El siguiente ejemplo muestra un registro para dos eventos que fallaron juntos en un lote.
{ "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": "..." } ] }
Cada error que llegaba a la cola se reintentaba primero: no hay ningún error de entrega que se salte. RetryPolicy Los fallos en EventBridge sí mismos se vuelven a intentar EventBridge sin límite y nunca producen un registro. En la siguiente tabla se enumeran los códigos que puede contener un registro. errorMessageestá truncado a 1024 caracteres.
errorCode | ¿Qué falló | errorMessage |
|---|---|---|
CUSTOMER_VALIDATION | La API de destino rechazó la solicitud (una respuesta de 4 veces): un valor incorrecto, un campo faltante, un cuerpo mal formado | El propio mensaje de la API de destino |
ACCESS_DENIED | EventBridge no pudo asumir la función de entrega, la función no puede llamar al objetivo o se ha denegado el acceso a la AWS KMS clave del objetivo | EventBridge no podía asumirlorole. Compruebe que la función existe y que su política de confianza permite que el director del EventBridge servicio la asuma. o no EventBridge pudo accederresource. Comprueba que existe y que el rol de entrega del suscriptor tiene permiso para acceder a él. |
RESOURCE_NOT_FOUND | El objetivo, o su AWS KMS clave, no existe | No se pudo acceder al mensaje anterior o al mensaje genérico |
INPUT_TRANSFORMATION_FAILURE | La expresión Transformer o Input expresión de uso universal no arrojó ni produjo ningún valor | El error de expresión |
THROTTLING | El objetivo estranguló la llamada | El mensaje genérico |
EXECUTION_TIMEOUT | El objetivo no respondió en un momento InvocationTimeoutSeconds | El mensaje genérico |
REQUEST_TOO_LARGE | La solicitud ha superado el límite de tamaño del objetivo; es inferior MaxBatchSize | El mensaje genérico |
PARTIAL_BATCH_FAILURE | El destinatario aceptó parte de un lote y rechazó el resto; el registro solo failedMessages muestra los eventos rechazados | El mensaje genérico |
RESOURCE_CONFLICT | El objetivo informó de un conflicto, por ejemplo, un nombre que ya estaba en uso | El mensaje genérico |
KMS_INVALID_STATE | La AWS KMS clave del objetivo está deshabilitada o pendiente de ser eliminada | El mensaje genérico |
SFN_TYPE_NOT_SUPPORTED | REQUEST_RESPONSEse usó con una máquina de estados estándar, que no admite la ejecución sincrónica | El mensaje genérico |
COMPUTE_EXECUTION_ERROR | Se ejecutó una REQUEST_RESPONSE función o ejecución e informó de un error | El mensaje genérico |
INVOCATION_DEPENDENCY_INTERNAL | El objetivo devolvió un error de servidor (una respuesta de 5 veces mayor) | El mensaje genérico |
LOOP_DETECTED | El evento, o un evento derivado de él, ya ha pasado por el bus de destino; consulte Detección de bucles | El mensaje genérico |
INTERNAL_SERVER_ERROR | Un error interno EventBridge al realizar la llamada que agotó los reintentos | El mensaje genérico |
El mensaje genérico es Se ha producido un error en la entrega. Usa el código de error y el identificador de solicitud de este registro cuando investigues y ponte en contacto con AWS Support si el error persiste. EventBridge lo utiliza siempre que al pasar el mensaje subyacente se puedan exponer las partes internas de otro servicio, por lo que, en el caso errorCode de esos códigos, targetRequestId son los hechos a partir de los cuales se trabaja, junto con los EVENT_DELIVERY_ATTEMPT registros que contienen la solicitud que se envió. Los mismos valores llegan como atributos de los mensajes de Amazon SQS (ERROR_CODE,,ERROR_MESSAGE,SUBSCRIBER_ARN,TARGET_ARN,RETRY_ATTEMPTS) BUS_ARNEXHAUSTED_RETRY_CONDITION, por lo que el consumidor puede enrutarlos sin necesidad de analizar el cuerpo. En el caso de un suscriptor de FIFO, utilice una cola de FIFO como cola de letra muerta; EventBridge establezca cada registro a MessageGroupId partir de los eventos para que los EventGroupId registros de un grupo permanezcan en orden.
La función de entrega debe estar en la cola. sqs:SendMessage Sin ella, la OnFailureDestinationFailed métrica cuenta cada registro que no se pudo escribir y esos eventos se pierden.
Retirar los eventos de la cola de letra muerta
La cola contiene récords, no eventos, por lo que para volver a conducir se reproducen los eventos desde el autobús. Los eventos aún deben estar dentro del período de retención del autobús.
-
Lea los registros y recopile todos los registros
failedMessages[].eventId, además de los más antiguos y los más recientestimestamp. -
Fija la causa de
errorCodelos nombres: la política del rol, el objetivo o la expresión. -
Cree un suscriptor en el mismo bus con el mismo objetivo y el mismo rol, una posición
POINT_IN_TIMEinicial queStartingPointsea la marca de tiempo más temprana y laEndPointúltima, y unSYSTEM_METADATAfiltro en los identificadores. -
Cuando el suscriptor haya entregado los eventos, elimínelos y borre los registros de la cola.
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" }'
Los eventos reproducidos llegan juntos aws:DeliveryTypeREPLAY, por lo que el consumidor puede distinguirlos a partir del tráfico en directo.