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.
Funcionamiento del proceso de registro para buses de eventos
EventBridge genera registros para:
-
Cualquier evento AWS de servicio 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:
Eventos de orígenes de eventos de socios
Eventos reproducidos desde un archivo
Eventos enviados al bus a través de PutEvents
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 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 Especificación del 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 del destino
Información de solicitud del destino
Para obtener más información, consulte Inclusión de datos detallados en los registros del bus de eventos.
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 a los que luego se envían EventBridge, lo que puede provocar interrupciones en la entrega de los registros del 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.Los eventos
PutRecordBatchen Firehose generados por la entrega de registros del bus de eventos.
-
Para los destinos de registro de S3, no se recomienda especificar un depósito de destino con la 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 las error secciones detail y 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 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 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.
Especificación del 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 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.
-
DESACTIVADO: EventBridge no envía ningún registro. Este es el valor predeterminado.
-
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.
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 si EventBridge desea incluir información más detallada en los registros que genera. 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 se EventBridge envía al destino.target_properties:
Truncamiento de 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, si están disponibles, en pasos que representan los estados de fallo. Estos pasos incluyen:
EVENT_INGEST_FAILUREINVOCATION_THROTTLE_STARTINVOCATION_ATTEMPT_THROTTLEINVOCATION_ATTEMPT_RETRYABLE_FAILUREINVOCATION_ATTEMPT_PERMANENT_FAILUREINVOCATION_FAILUREINVOCATION_DLQ
