View a markdown version of this page

Políticas de reintentos y colas de mensajes fallidos - Amazon EventBridge

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ímiteRangePredeterminado
MaxRetryAttempts0 a 1855
MaxEventAgeInSeconds60 a 86.400300

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_VALIDATIONLa API de destino rechazó la solicitud (una respuesta de 4 veces): un valor incorrecto, un campo faltante, un cuerpo mal formadoEl propio mensaje de la API de destino
ACCESS_DENIEDEventBridge 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 objetivoEventBridge 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_FOUNDEl objetivo, o su AWS KMS clave, no existeNo se pudo acceder al mensaje anterior o al mensaje genérico
INPUT_TRANSFORMATION_FAILURELa expresión Transformer o Input expresión de uso universal no arrojó ni produjo ningún valorEl error de expresión
THROTTLINGEl objetivo estranguló la llamadaEl mensaje genérico
EXECUTION_TIMEOUTEl objetivo no respondió en un momento InvocationTimeoutSecondsEl mensaje genérico
REQUEST_TOO_LARGELa solicitud ha superado el límite de tamaño del objetivo; es inferior MaxBatchSizeEl mensaje genérico
PARTIAL_BATCH_FAILUREEl destinatario aceptó parte de un lote y rechazó el resto; el registro solo failedMessages muestra los eventos rechazadosEl mensaje genérico
RESOURCE_CONFLICTEl objetivo informó de un conflicto, por ejemplo, un nombre que ya estaba en usoEl mensaje genérico
KMS_INVALID_STATELa AWS KMS clave del objetivo está deshabilitada o pendiente de ser eliminadaEl mensaje genérico
SFN_TYPE_NOT_SUPPORTEDREQUEST_RESPONSEse usó con una máquina de estados estándar, que no admite la ejecución sincrónicaEl mensaje genérico
COMPUTE_EXECUTION_ERRORSe ejecutó una REQUEST_RESPONSE función o ejecución e informó de un errorEl mensaje genérico
INVOCATION_DEPENDENCY_INTERNALEl objetivo devolvió un error de servidor (una respuesta de 5 veces mayor)El mensaje genérico
LOOP_DETECTEDEl evento, o un evento derivado de él, ya ha pasado por el bus de destino; consulte Detección de buclesEl mensaje genérico
INTERNAL_SERVER_ERRORUn error interno EventBridge al realizar la llamada que agotó los reintentosEl 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.

  1. Lea los registros y recopile todos los registrosfailedMessages[].eventId, además de los más antiguos y los más recientestimestamp.

  2. Fija la causa de errorCode los nombres: la política del rol, el objetivo o la expresión.

  3. Cree un suscriptor en el mismo bus con el mismo objetivo y el mismo rol, una posición POINT_IN_TIME inicial que StartingPoint sea la marca de tiempo más temprana y la EndPoint última, y un SYSTEM_METADATA filtro en los identificadores.

  4. 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.