View a markdown version of this page

Observabilidad del bus de eventos personalizado: métricas, registros y CloudTrail - 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.

Observabilidad del bus de eventos personalizado: métricas, registros y CloudTrail

Hay tres fuentes que indican lo que hacen un autobús y sus suscriptores. CloudWatch Las métricas de Amazon en el espacio de AWS/EventsV2 nombres están activadas para todos los suscriptores. En caso de error en las entregas, se activan OnFailureDestinationDelivered o se EventsDropped activan en EventDeliveryAttempts negativo EventsDelivered con el cálculo métrico. Los registros de suscriptores registran cada intento de entrega como un registro JSON; están desactivados hasta que selecciones LogConfiguration.Level el suscriptor. AWS CloudTrail registra las llamadas a la API que crean y cambian los buses, los suscriptores y las fuentes de eventos.

Métricas

Las métricas de los suscriptores tienen dos dimensiones EventBus y Subscriber cada una contiene el ARN del recurso. Cuando el suscriptor pertenece a una cuenta diferente a la del bus, EventBridge también emite la métrica con EventBus y SubscriberAccount para que el propietario del bus pueda ver el consumo por cuenta. En la siguiente tabla se enumeran las métricas de .

MétricaUnidadSignificado
FilterEvaluatedRecuentoLos eventos se comparan con los filtros del suscriptor
FilterMatchedRecuentoEventos que coincidieron con todos los filtros
EventDeliveryAttemptsRecuentoLos intentos de entrega se contabilizan por evento. Resta EventsDelivered para contar los intentos fallidos
TargetInvocationsRecuentoLlamadas realizadas al objetivo; una llamada puede incluir un lote de eventos
RetryInvocationAttemptsRecuentoSe emite solo en un reintento y se valora como la profundidad del reintento: el segundo intento es 1, el tercero es 2. El recuento de muestras es el número de reintentos
EventsDeliveredRecuentoEventos que el objetivo aceptó
EgressBytesBytesBytes entregados al destino
EventTransformationFailuresRecuentoEventos cuya expresión Transformer o la expresión de destino universal fallaron Input
IngestionToInvocationStartTimeMilisegundosTiempo transcurrido desde la llegada del evento al autobús hasta el inicio de la llamada objetivo. No se emite cuando el intento ha fallado antes de llamar al objetivo
IngestionToInvocationEndTimeMilisegundosTiempo transcurrido desde la llegada del evento al autobús hasta el final de la llamada objetivo
OnFailureDestinationDeliveredRecuentoRegistros escritos en la cola de correo muerto
OnFailureDestinationFailedRecuentoRegistros que no se han podido escribir en la cola de correo no enviado
EventsDroppedRecuentoEventos que agotaron los reintentos sin que hubiera ninguna cola de mensajes muertos para registrarlos
ApproximateBacklogAgeMilisegundosAntigüedad del evento más antiguo que el suscriptor aún no ha entregado
SubscriberLogRecordsDroppedRecuentoRegistra los registros que no se pudieron escribir, porque la entrega del registro es lo mejor

El número de autobuses de tu cuenta también aparece en el espacio de AWS/Usage nombres con la letra «ResourceCountcon» Service EventBridge y un Resource valor que empieza por «EventsV2/, de modo que puedes alarmarte cuando te acerques a la cuota de autobuses. Para ver las cuotas, consulteCuotas personalizadas de Event Bus.

Publicar las métricas

Cada PutRawEvents llamada PutEvents y también genera métricas en el espacio de AWS/EventsV2 nombres, por lo que puede emitir una alarma si las llamadas de un bus se publican de forma limitada o fallida, por ejemplo, PublishEventsApproximateThrottledCallCount con la EventBus dimensión establecida en. orders La cuenta del propietario del autobús recibe todas las métricas de publicación. Una cuenta que publica en un autobús que no es de su propiedad también las recibe, en su propia cuenta, para sus propias llamadas.

MétricaUnidadSignificado
PublishEventsApproximateCallCountRecuentoPublica las llamadas recibidas
PublishEventsApproximateSuccessCallCountRecuentoPublica las llamadas que devolvieron HTTP 200
PublishEventsApproximateFailedCallCountRecuentoPublica las llamadas que devolvieron un error
PublishEventsApproximateThrottledCallCountRecuentoPublica las llamadas rechazadas con ThrottlingException
PublishEventsEntryCountRecuentoEntradas en las convocatorias de publicación
PublishEventsFailedEntriesCountRecuentoLas entradas que fallaron en una llamada aceptada se indican en la respuesta como entradas fallidas
PublishEventsIngressBytesBytesSe almacenaron los bytes de la carga útil del evento. Ausente, en lugar de 0, para las llamadas que no almacenaron nada. La tendencia se basa en la línea de entrada de la factura, que redondea cada entrada a una KB completa.

Las dimensiones dependen de la métrica y de quién la publicó.

  • Cada métrica se publica solo con la EventBus dimensión: los totales del bus.

  • En el caso de los eventos que llegan a través de una fuente de eventos, las métricas de recuento también se publican con EventBus yEventSource, por lo que puedes ver el porcentaje de participación de una fuente. PublishEventsIngressBytesno tiene ningún EventSource desglose.

  • PublishEventsIngressBytestambién se publica para el propietario del autobús con EventBus yPublisherAccount, por lo tanto, el propietario del autobús puede ver cuántos bytes ha almacenado cada cuenta de publicación.

Registros de suscriptores

Un suscriptor puede registrar lo que ocurrió con cada evento que intentó entregar. El registro se realiza por suscriptor y se desactiva cuando creas uno, por lo que un nuevo suscriptor no registra nada hasta que tú lo configuresLogConfiguration. Cada registro es un documento JSON con una message_type que dice lo que describe.

  • SUBSCRIBER_MATCHED: un evento coincidió con los filtros del suscriptor y entró en la sección de entrega.

  • EVENT_DELIVERY_ATTEMPT: un intento de invocar el objetivo, con su resultado, número de intentos y duración. Este es el registro que se describe en el resto de esta sección.

  • EVENT_TRANSFORMATION_FAILURE: la expresión Transformer o la Input expresión de destino universal fallaron para un evento, con el error.

  • ON_FAILURE_DESTINATION_DELIVERY_ATTEMPT: un intento de escribir un registro en la cola de mensajes muertos.

La entrega del registro es el mejor esfuerzo. Un registro que no se puede escribir se cuenta en la SubscriberLogRecordsDropped métrica en lugar de volver a intentarlo indefinidamente. Cuando el bus se cifra con una clave gestionada por el cliente, EventBridge cifra los campos de carga útil de cada registro que se encuentran bajo esa clave antes de que salgan EventBridge, de modo que la cuenta de destino que no pueda usar la clave vea el registro sin ellos. El registro de un evento reproducido se conserva details.delivery_typeREPLAY; el de un evento en vivo, sí. LIVE

Los dos escenarios que producen un registro

Deben existir dos configuraciones independientes para poder leer un solo registro.

  1. El nivel de registro del suscriptor. LogConfiguration.Leveldecide qué registros EventBridge emite. El valor predeterminado esOFF, que no emite ninguno.

  2. Una entrega de CloudWatch registros. Los registros llegan a usted a través del mecanismo de entrega de CloudWatch registros vendidos de Amazon Logs, que vincula al suscriptor con un destino de su propiedad. Sin él, los registros no tienen adónde llegar y ningún grupo de registros aparece por sí solo.

Realice ambos ajustes antes de empezar a diagnosticar un problema de entrega y no después. Solo los suscriptores tienen una configuración de registro. Los buses y las fuentes de eventos no tienen ninguna, por lo que se activa el inicio de sesión de un suscriptor a la vez. LogConfigurationtiene dos miembros.

Level

El nivel mínimo de un registro. Los registros inferiores a este no se emiten. OFF, el valor predeterminado, no emite nada. ERRORsolo emite los intentos de entrega fallidos. INFOemite todos los intentos de entrega, incluidos los que se han realizado correctamente.

IncludePayload

Si un registro contiene la carga útil de tu evento. ON_ERROR_ONLY, el valor predeterminado, solo lo incluye en los registros de errores. FULLlo incluye en todos los registros. Consulte Cargas útiles en los registros de registro.

Puedes configurarlo LogConfiguration cuando creas un suscriptor, o más tarde conUpdateSubscriber. Una actualización surte efecto sin necesidad de volver a crear el suscriptor. Ni la respuesta de creación ni la respuesta de actualización se hacen eco del campo; por lo tanto, confirme el valor almacenado con la DescribeSubscriber opción de devolverlo.

Activa el registro para un suscriptor

Los pasos siguientes registran cada intento de entrega para un suscriptor existente y envían los registros a un grupo de CloudWatch registros de la misma cuenta. El primer comando es una EventBridge llamada y el resto son llamadas de CloudWatch Logs. Comience por aumentar el nivel de registro del suscriptor. INFOregistra tanto los éxitos como los errores, que es lo que indica si un evento se ha realizado o no.

aws eventsv2 update-subscriber \ --subscriber-arn arn:aws:events:us-east-1:111122223333:subscriber/large-orders/EXAMPLE1234567890abcdef \ --log-configuration '{ "Level": "INFO", "IncludePayload": "FULL" }'

A continuación, cree el grupo de registros de destino. El nombre debe empezar por/aws/vendedlogs/. CloudWatch Logs administra la política de recursos de entrega solo con ese prefijo; en el caso de un grupo de registros que no pertenezca a ese prefijo, debe administrar esa política usted mismo.

aws logs create-log-group \ --log-group-name /aws/vendedlogs/large-orders-delivery

Creación de origen de entrega. --resource-arnEs el ARN del suscriptor, que es lo que hace que la fuente genere los registros de ese suscriptor. --log-typeConfigúralo para que coincida con el nivel que configuraste: INFO_LOGS para Level INFO o ERROR_LOGS para LevelERROR.

aws logs put-delivery-source \ --name large-orders-source \ --resource-arn arn:aws:events:us-east-1:111122223333:subscriber/large-orders/EXAMPLE1234567890abcdef \ --log-type INFO_LOGS

Cree un destino de entrega que asigne un nombre al grupo de registros. La respuesta contiene el ARN de destino, que necesitará el siguiente comando.

aws logs put-delivery-destination \ --name large-orders-destination \ --delivery-destination-configuration destinationResourceArn=arn:aws:logs:us-east-1:111122223333:log-group:/aws/vendedlogs/large-orders-delivery

Por último, empareja el origen con el destino. Usa el ARN de destino de la respuesta anterior.

aws logs create-delivery \ --delivery-source-name large-orders-source \ --delivery-destination-arn destination-arn

Los registros ahora aparecen en el grupo de registros. Llegan más tarde que la entrega propiamente dicha, ya que el proceso de registro los agrupa en lotes, así que ten en cuenta ese retraso cuando lees un grupo de registros justo después de publicarlo. Tres propiedades de este cableado deciden qué tan lejos se extiende. Un destino es un grupo de registros, un bucket de Amazon S3 o una transmisión de Amazon Data Firehose, y los comandos anteriores son los mismos para cada uno de ellos: solo destinationResourceArn cambian. Una entrega empareja exactamente una fuente con un destino exacto, por lo que enviar los registros de un suscriptor a un segundo destino requiere una segunda entrega. El destino puede estar en una cuenta diferente a la del suscriptor y, en ese caso, la cuenta de destino debe llamar al destino para permitir la entrega, que es la forma PutDeliveryDestinationPolicy en que una cuenta central recopila los registros de los suscriptores que no son de su propiedad.

Leer un registro de entrega

EventBridge emite un registro por intento de entrega por evento. Hay cuatro campos en el nivel superior. message_typees EVENT_DELIVERY_ATTEMPT para un intento de entrega; los demás tipos se enumeran al principio de esta sección. resource_arnes el ARN del suscriptor que realizó el intento, que es la forma de separar a los suscriptores que comparten un grupo de registros. log_leveles el nivel del registro en sí mismo: un intento exitoso es INFO y un intento fallido lo esERROR, por lo que Level ERROR sigue registrando los errores. detailses un objeto que contiene el estado de entrega y contiene los campos en los que se crean consultas y alarmas.

outcome y attempt_count

SUCCESSo FAILURE para este intento y para qué intento se realizó, por lo que los reintentos se contabilizan.

terminal_kind

Está presente en el único registro que indica cómo terminó el evento: EVENTS_DELIVEREDON_FAILURE_DESTINATION_DELIVERED, o EVENTS_DROPPED cuando se acabaron los reintentos y no se configuró ningún destino en caso de error.

target_arn y target_properties

El objetivo contra el que se realizó el intento y los parámetros de destino que el suscriptor resolvió para este evento. target_propertiesse omite cuando el suscriptor no configura ningún parámetro.

ingestion_to_start_latency_ms y ingestion_to_complete_latency_ms

Milésimas de segundo desde la ingesta del evento hasta el inicio y el final de este intento.

target_input

Los bytes enviados al destino, literalmente. Se trata de un campo de carga útil; consulte. Cargas útiles en los registros de registro

event_detail, event_metadata, y event_system_metadata

El evento tal como EventBridge se celebró. event_system_metadatacontiene los identificadores con los que se correlacionan los registros. event_detailaparece solo cuando difiere detarget_input, como es el caso cuando el suscriptor tiene un transformador.

Para diagnosticar una entrega que nunca llegó, lee los registros del suscriptor en este orden. outcomeindica si EventBridge se ha alcanzado o no el objetivo. attempt_countindica si aún se está reintentando porque un evento sin terminal_kind registro no ha finalizado. terminal_kindexplica cómo terminó y separa un evento que estaba inactivo de uno que se descartó. target_arntarget_properties, y target_input diga qué se envió y dónde, y ahí es donde aparece un problema con un transformador o un parámetro objetivo. El error aparece en el registro tan pronto como se produce un error en el intento, por lo que no tiene que esperar a que se acaben los reintentos. Para ver el procedimiento completo, consulte Solución de problemas: publicaste y no llegó nada al objetivo.

Cargas útiles en los registros de registro

IncludePayloadcontrola dos campos y ningún otro: details.target_input ydetails.event_detail. Todos los demás campos se emiten con el valor que se elija, por lo que un suscriptor que no incluya cargas útiles en sus registros seguirá informando del resultado, el objetivo, el recuento de intentos y las latencias. FULLincrusta la carga útil en todos los registros, incluidos los registros de las entregas realizadas correctamente. ON_ERROR_ONLY, el valor predeterminado, la incrusta únicamente en los registros de errores y omite ambos campos de un registro para que la entrega se realice correctamente.

importante

Un registro que contiene una carga útil contiene sus datos. ConFULL, el grupo de registro contiene una copia de todos los cuerpos de eventos enviados por el suscriptor, y cualquiera que pueda leer el grupo de registros puede leer esos cuerpos. Utilízalo FULL mientras depuras a un suscriptor y, a continuación, devuélvelo aON_ERROR_ONLY. Esto limita tanto la exposición como el volumen que almacenas.

La API llama AWS CloudTrail

Los registros de suscriptores registran las entregas, no las llamadas que realizas para configurarlas. AWS CloudTrail registra las llamadas a la API de administración, por lo que un cambio en un bus, un suscriptor o una fuente de eventos se puede auditar a partir de tu registro en lugar de hacerlo desde un grupo de registros. Para saber cómo EventBridge se integra con CloudTrail, consulteRegistro Amazon EventBridge Llamadas a la API mediante AWS CloudTrail.