Configuración de registros para buses de eventos de Amazon EventBridge - Amazon EventBridge
Cómo funciona el proceso de registroEspecificación del nivel de registroInclusión de datos detallados en los registrosTruncamiento de los registrosInforme de errores en los registros

Configuración de registros para buses de eventos de Amazon EventBridge

Puede configurar EventBridge para que envíe registros que detallen cómo procesa los eventos un bus de eventos, a fin de facilitar la solución de problemas y la depuración.

Puede seleccionar los siguientes servicios de AWS como destinos de registro a los que EventBridge entrega registros para el bus de eventos especificado:

  • Amazon CloudWatch Logs

    EventBridge entrega registros al grupo de registro de Registros de CloudWatch.

    Utilice Registros de CloudWatch para centralizar los registros de todos los sistemas, aplicaciones y servicios de AWS que utilice, en un único servicio de gran escalabilidad. Para obtener más información, consulte Trabajar con grupos de registro y flujos de registro en la Guía del usuario de Registros de Amazon CloudWatch.

  • Amazon Data Firehose

    EventBridge entrega registros a un flujo de entrega de Firehose.

    Amazon Data Firehose es un servicio completamente administrado para entregar datos de transmisión en tiempo real a destinos como determinados servicios de AWS, así como a cualquier punto de conexión HTTP personalizado o puntos de conexión HTTP propiedad de proveedores de servicios de terceros compatibles. Para más información, consulte Creación de un flujo de entrega de Amazon Data Firehose en la Guía del usuario de Amazon Data Firehose.

  • Amazon S3

    EventBridge entrega registros como objetos de Amazon S3 al bucket especificado.

    Amazon S3 es un servicio de almacenamiento de objetos que ofrece escalabilidad, disponibilidad de datos, seguridad y rendimiento líderes del sector. Para obtener más información, consulte Cargar, descargar y trabajar con objetos en Amazon S3 en la Guía del usuario de Amazon Simple Storage Service.

Funcionamiento del proceso de registro para buses de eventos

EventBridge genera registros para:

  • cualquier evento de servicio de AWS que coincida con una regla del bus de eventos,

  • cualquier evento entregado con los siguientes métodos, independientemente de si el evento se ha ingerido correctamente o si coincide con alguna regla:

EventBridge no registra los eventos que solo coinciden con las reglas administradas.

Los datos de registro enviados a cada destino de registro seleccionado son los mismos.

Puede personalizar los registros que EventBridge envía a los destinos seleccionados de la siguiente manera:

Consideraciones sobre la entrega de registro

Tenga en cuenta las siguientes consideraciones al configurar el registro para los buses de eventos:

  • Las entregas de registro de los buses de eventos se envían en la medida de lo posible. Para la mayoría de solicitudes de un bus de eventos configurado correctamente se envían archivos de registro. No se garantiza que los registros de buses de eventos estén completos ni que lleguen de manera oportuna.

  • En algunas circunstancias, la entrega de los registros del bus de eventos por sí misma genera eventos que luego se envían a EventBridge, lo que puede provocar una interrupción en la entrega de los registros. Por este motivo, EventBridge no registra los siguientes eventos:

    • Los eventos Decrypt y GenerateDataKey de AWS KMS que se generan cuando los registros cifrados con una clave administrada por el cliente se envían a un destino de registro.

    • Los eventos PutRecordBatch en Firehose generados por la entrega de registros del bus de eventos.

  • Para los destinos de registro de S3, no se recomienda especificar un bucket de destino con la notificación de eventos para EventBridge activada, ya que esto puede provocar interrupciones en la entrega de los registros.

Cifrado de registros

Al enviar registros, EventBridge cifra las secciones detail y error de cada registro con la clave de KMS especificada para el bus de eventos. Una vez entregado, el registro se descifra y, a continuación, se vuelve a cifrar con la clave de KMS especificada para el destino del registro.

Para obtener más información, consulte Cifrado de registros de bus de eventos.

Especificación de los permisos de registro del bus de eventos

Para activar el registro desde un bus de eventos, debe conceder permisos para que EventBridge envíe registros desde ese bus. Añada una política que conceda el permiso AllowVendedLogDeliveryForResource al bus de eventos.

Para obtener más información, consulte Permisos específicos del servicio en la Guía del usuario de Registros de CloudWatch.

Especificación del nivel de registro del bus de eventos

Puede especificar los tipos de pasos del procesamiento de eventos que registra EventBridge en los destinos de registro seleccionados.

Elija entre los siguientes niveles de detalle para incluirlos en los registros. El nivel de registro se aplica a todos los destinos de registro especificados para el bus de eventos. Cada nivel de registro incluye los pasos de los niveles de registro anteriores.

  • OFF: EventBridge no envía ningún registro. Esta es la opción predeterminada.

  • ERROR: EventBridge envía todos los registros relacionados con los errores generados durante el procesamiento del evento y la entrega de destino.

  • INFO: EventBridge envía todos los registros relacionados con errores, así como los principales pasos realizados durante el procesamiento de los eventos.

  • TRACE: EventBridge envía los registros generados durante todos los pasos del procesamiento del evento.

En la siguiente tabla se enumeran los pasos de procesamiento del evento incluidos en cada nivel de registro.

Paso TRACE INFO ERROR OFF

Evento ingerido

 x x

Error al ingerir el evento

 x x x

Evento recibido

 x

Intento de invocación iniciado

 x

Error permanente del intento de invocación

 x x x

Error del reintento de invocación

 x x x

Intento de invocación correcto

 x

Intento de invocación limitado

 x x x

DLQ de invocación

 x x x

Invocación fallida

 x x x

Invocación iniciada

 x x

Invocación correcta

 x x

Limitación de la invocación iniciada

 x x x

No coincide ninguna regla

 x x

Regla coincidente

x x

Coincidencia de reglas iniciada

x

Inclusión de datos detallados en los registros del bus de eventos

Puede especificar que EventBridge incluya información más detallada en los registros que genere. Los datos son útiles para solucionar problemas y depurar. Si selecciona esta opción, EventBridge incluye estos datos en los registros pertinentes de todos los destinos de registro especificados.

La información detallada incluye los siguientes campos:

  • event_detail: los detalles del evento en sí.

  • target_input: la solicitud que envía EventBridge al destino.

  • target_properties:

Truncamiento de los datos en los registros del bus de eventos

Debido a las restricciones en el destino de los registros, EventBridge limita los registros a 1 MB. Si un registro supera este límite, EventBridge lo trunca eliminando los siguientes campos en el orden indicado:

  • target_input

  • target_properties

  • target_response_body

EventBridge elimina el campo event_detail de los siguientes tipos de registro si es necesario:

  • EVENT_RECEIVED

  • EVENT_INGESTED

  • EVENT_INGESTED_FAILED

  • RULE_MATCH_STARTED

Si es necesario truncarlo, EventBridge elimina todo el campo.

Si EventBridge trunca los campos del evento, el campo dropped_fields incluye una lista de los campos de datos extraídos.

Informe de errores en los registros del bus de eventos

EventBridge también incluye datos de errores, si están disponibles, en pasos que representan estados de error. Estos pasos incluyen:

  • EVENT_INGEST_FAILURE

  • INVOCATION_THROTTLE_START

  • INVOCATION_ATTEMPT_THROTTLE

  • INVOCATION_ATTEMPT_RETRYABLE_FAILURE

  • INVOCATION_ATTEMPT_PERMANENT_FAILURE

  • INVOCATION_FAILURE

  • INVOCATION_DLQ