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.
Configuración de registros para los buses de EventBridge eventos de Amazon
Puede configurarlos EventBridge para enviar registros que detallen cómo un bus de eventos procesa los eventos, a fin de facilitar la resolución de problemas y la depuración.
Puede seleccionar los siguientes AWS servicios como destinos de registro a los que se envían EventBridge los registros del bus de eventos especificado:
Amazon CloudWatch Logs
EventBridge entrega los registros al grupo CloudWatch de registros especificado.
Utilice CloudWatch los registros para centralizar los registros de todos los sistemas, aplicaciones y AWS servicios que utilice en un único servicio altamente escalable. Para obtener más información, consulte Trabajar con grupos de registros y transmisiones de CloudWatch registros en la Guía del usuario de Amazon Logs.
Amazon Data Firehose
EventBridge entrega troncos a un flujo de entrega de Firehose.
Amazon Data Firehose es un servicio totalmente gestionado para entregar datos de streaming en tiempo real a destinos como determinados AWS servicios, así como a cualquier punto de enlace HTTP personalizado o punto de enlace HTTP propiedad de proveedores de servicios externos 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 los 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.
Cómo funciona el registro para los buses de eventos
EventBridge genera registros para:
-
Cualquier evento AWS de servicio que coincida con una regla del bus de eventos
-
Cualquier evento entregado mediante los siguientes métodos, independientemente de si el evento se ingirió correctamente o si coincidió con alguna regla:
Eventos de fuentes de eventos asociadas
Eventos reproducidos desde un archivo
Eventos enviados al autobús a través de PutEvents
EventBridge no registra los eventos que solo coinciden con las reglas gestionadas.
Los datos de registro que se envían a cada destino de registro seleccionado son los mismos.
Puede personalizar los registros que se EventBridge envían a los destinos seleccionados de la siguiente manera:
Puede especificar el nivel de registro, que determina los pasos para EventBridge enviar los registros a los destinos seleccionados. Para obtener más información, consulte Especificar el nivel de registro del bus de eventos.
-
Puede especificar si EventBridge incluye información más detallada cuando sea pertinente, como:
Detalles del evento
Información de entrada de Target
Información sobre la solicitud de Target
Para obtener más información, consulte Inclusión de datos detallados en los registros del bus de eventos.
Consideraciones sobre la entrega de registros
Tenga en cuenta las siguientes consideraciones al configurar el registro para los buses de eventos:
Los registros del bus de eventos se entregan haciendo el mejor esfuerzo posible. La mayoría de las solicitudes de un bus de eventos que esté correctamente configurado para el registro dan como resultado un registro de registro entregado. No se garantiza la integridad y puntualidad del registro del bus de eventos.
En algunas circunstancias, la entrega de los registros de registro del bus de eventos por sí misma genera eventos a los que luego se envían EventBridge, lo que puede provocar interrupciones en la entrega de los registros de registro. Por este motivo, EventBridge no registra los siguientes eventos:
AWS KMS
DecryptyGenerateDataKeylos eventos que se generan cuando los registros cifrados con una clave gestionada por el cliente se envían a un destino de registro.PutRecordBatcheventos en Firehose generados por la entrega de registros del bus de eventos.
-
En el caso de los destinos de registros de S3, no se recomienda especificar un depósito de destino con la opción de notificación de eventos EventBridge habilitada, ya que esto puede provocar interrupciones en la entrega de los registros.
Cifrado de registros
Al enviar registros, EventBridge cifra error las secciones detail y las secciones de cada registro con la clave 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 KMS especificada para el destino del registro.
Para obtener más información, consulte Cifrar los registros del bus de eventos.
Especificar los permisos de registro del bus de eventos
Para habilitar el registro desde un bus de eventos, debe conceder permisos EventBridge para enviar registros desde ese bus. Agregue una política que los conceda AllowVendedLogDeliveryForResourceal bus de eventos.
Para obtener más información, consulte los permisos específicos del servicio en la Guía del usuario de CloudWatch Logs.
Especificar el nivel de registro del bus de eventos
Puede especificar los tipos de pasos de procesamiento de eventos que se EventBridge registran en los destinos de registro seleccionados.
Elija uno de 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.
-
DESACTIVADO: 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 objetivo.
-
INFORMACIÓN: EventBridge envía todos los registros relacionados con los errores, así como los principales pasos realizados durante el procesamiento del evento.
-
TRACE: EventBridge envía todos los registros generados durante todos los pasos del procesamiento del evento.
La siguiente tabla muestra los pasos del procesamiento de eventos incluidos en cada nivel de registro.
| Paso | TRACE | INFO | ERROR | OFF |
|---|---|---|---|---|
|
Evento ingerido |
x | x | ||
|
Error en la ingestión del evento |
x | x | x | |
|
Evento recibido |
x | |||
|
Se ha iniciado un intento de invocación |
x | |||
|
Error permanente en el intento de invocación |
x | x | x | |
|
Error en el intento de invocación que se puede intentar |
x | x | x | |
|
El intento de invocación se realizó correctamente |
x | |||
|
Intento de invocación retrasado |
x | x | x | |
|
DLQ de invocación |
x | x | x | |
|
Falló la invocación |
x | x | x | |
|
Se inició la invocación |
x | x | ||
|
La invocación se realizó correctamente |
x | x | ||
|
Se ha iniciado el acelerador de invocación |
x | x | x | |
|
No hay reglas que coincidan |
x | x | ||
|
Regla coincidente |
x | x | ||
|
Se ha iniciado la coincidencia de reglas |
x |
Inclusión de datos detallados en los registros del bus de eventos
Puede especificar si EventBridge desea incluir información más detallada en los registros que genera. Estos datos pueden resultar útiles para solucionar problemas y depurar errores. 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 se EventBridge envía al objetivo.target_properties:
Truncar los datos en los registros del bus de eventos
Debido a las restricciones de destino del registro, EventBridge limita los registros a 1 MB. Si un registro supera este límite, EventBridge trunca el registro quitando los siguientes campos en el orden siguiente:
-
target_input -
target_properties -
target_response_body
EventBridge elimina el event_detail campo de los siguientes tipos de registros si es necesario:
EVENT_RECEIVEDEVENT_INGESTEDEVENT_INGESTED_FAILEDRULE_MATCH_STARTED
Si es necesario truncarlo, EventBridge elimina todo el campo.
Si EventBridge trunca los campos en el caso, el dropped_fields campo incluye una lista de los campos de datos eliminados.
Informe de errores en los registros del bus de eventos
EventBridge también incluye los datos de error, cuando están disponibles, en pasos que representan los estados de error. Estos pasos incluyen:
EVENT_INGEST_FAILUREINVOCATION_THROTTLE_STARTINVOCATION_ATTEMPT_THROTTLEINVOCATION_ATTEMPT_RETRYABLE_FAILUREINVOCATION_ATTEMPT_PERMANENT_FAILUREINVOCATION_FAILUREINVOCATION_DLQ
