View a markdown version of this page

Configuración de registros para buses de EventBridge eventos de Amazon - 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

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 buses de EventBridge eventos de Amazon

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

Puede seleccionar los siguientes AWS servicios como destinos de registro a los que enviar EventBridge los registros del bus de eventos especificado:

  • CloudWatch Registros de Amazon

    EventBridge entrega los registros al grupo de CloudWatch registros 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 Cómo trabajar con grupos de registros y transmisiones de registros en la guía del usuario de Amazon CloudWatch Logs.

  • Amazon Data Firehose

    EventBridge entrega los registros a una transmisión 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 que pertenezca a 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:

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:

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 algunos casos, la entrega por sí sola de los registros del bus de eventos genera eventos a los que luego se envían EventBridge, lo que puede provocar interrupciones en la entrega de los registros. Por este motivo, EventBridge no registra los siguientes eventos:

    • AWS KMS Decrypty GenerateDataKey los eventos generados cuando los registros cifrados con una clave gestionada por el cliente se entregan a un destino de registro.

    • Los eventos PutRecordBatch 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 bucket 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 secciones 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 habilitar el registro desde un bus de eventos, adjunte la siguiente política basada en la identidad a su identidad (usuario o rol) de AWS Identity and Access Management (IAM). Esta política otorga la events:AllowVendedLogDeliveryForResource acción al bus de eventos.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "ServiceLevelAccessForLogDelivery",
            "Effect": "Allow",
            "Action": [
                "events:AllowVendedLogDeliveryForResource"
            ],
            "Resource": "arn:aws:events:us-east-1:123456789012:event-bus/my-event-bus*"
        }
    ]
}

Para obtener más información, consulte Service-specific los permisos 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. Es el valor predeterminado.

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

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

  • 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

Fallo en el intento Retry-able 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 incluya estos datos en los registros pertinentes para 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 de los registros, EventBridge limita los registros a 1 MB. Si un registro supera este límite, lo EventBridge trunca 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 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 en ese caso, el dropped_fields campo incluye una lista de los campos de datos suprimidos.

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 falla. Estos pasos incluyen:

  • EVENT_INGEST_FAILURE

  • INVOCATION_THROTTLE_START

  • INVOCATION_ATTEMPT_THROTTLE

  • INVOCATION_ATTEMPT_RETRYABLE_FAILURE

  • INVOCATION_ATTEMPT_PERMANENT_FAILURE

  • INVOCATION_FAILURE

  • INVOCATION_DLQ