

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
<a name="eb-custom-bus-observability-metrics"></a>

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étrica | Unidad | Significado | 
| --- | --- | --- | 
| FilterEvaluated | Recuento | Los eventos se comparan con los filtros del suscriptor | 
| FilterMatched | Recuento | Eventos que coincidieron con todos los filtros | 
| EventDeliveryAttempts | Recuento | Los intentos de entrega se contabilizan por evento. Resta EventsDelivered para contar los intentos fallidos | 
| TargetInvocations | Recuento | Llamadas realizadas al objetivo; una llamada puede incluir un lote de eventos | 
| RetryInvocationAttempts | Recuento | Se 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 | 
| EventsDelivered | Recuento | Eventos que el objetivo aceptó | 
| EgressBytes | Bytes | Bytes entregados al destino | 
| EventTransformationFailures | Recuento | Eventos cuya expresión Transformer o la expresión de destino universal fallaron Input | 
| IngestionToInvocationStartTime | Milisegundos | Tiempo 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 | 
| IngestionToInvocationEndTime | Milisegundos | Tiempo transcurrido desde la llegada del evento al autobús hasta el final de la llamada objetivo | 
| OnFailureDestinationDelivered | Recuento | Registros escritos en la cola de correo muerto | 
| OnFailureDestinationFailed | Recuento | Registros que no se han podido escribir en la cola de correo no enviado | 
| EventsDropped | Recuento | Eventos que agotaron los reintentos sin que hubiera ninguna cola de mensajes muertos para registrarlos | 
| ApproximateBacklogAge | Milisegundos | Antigüedad del evento más antiguo que el suscriptor aún no ha entregado | 
| SubscriberLogRecordsDropped | Recuento | Registra 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 «`ResourceCount`con» `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, consulte[Cuotas personalizadas de Event Bus](eb-quota.md#eb-custom-bus-quotas).

## Publicar las métricas
<a name="eb-custom-bus-observability-publish-metrics"></a>

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étrica | Unidad | Significado | 
| --- | --- | --- | 
| PublishEventsApproximateCallCount | Recuento | Publica las llamadas recibidas | 
| PublishEventsApproximateSuccessCallCount | Recuento | Publica las llamadas que devolvieron HTTP 200 | 
| PublishEventsApproximateFailedCallCount | Recuento | Publica las llamadas que devolvieron un error | 
| PublishEventsApproximateThrottledCallCount | Recuento | Publica las llamadas rechazadas con ThrottlingException | 
| PublishEventsEntryCount | Recuento | Entradas en las convocatorias de publicación | 
| PublishEventsFailedEntriesCount | Recuento | Las entradas que fallaron en una llamada aceptada se indican en la respuesta como entradas fallidas | 
| PublishEventsIngressBytes | Bytes | Se 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` y`EventSource`, por lo que puedes ver el porcentaje de participación de una fuente. `PublishEventsIngressBytes`no tiene ningún `EventSource` desglose.
+ `PublishEventsIngressBytes`también se publica para el propietario del autobús con `EventBus` y`PublisherAccount`, por lo tanto, el propietario del autobús puede ver cuántos bytes ha almacenado cada cuenta de publicación.

## Registros de suscriptores
<a name="eb-custom-bus-observability-logs"></a>

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 configures`LogConfiguration`. 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_type``REPLAY`; el de un evento en vivo, sí. `LIVE`

### Los dos escenarios que producen un registro
<a name="eb-custom-bus-observability-configuration"></a>

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

1. **El nivel de registro del suscriptor. **`LogConfiguration.Level`decide qué registros EventBridge emite. El valor predeterminado es`OFF`, que no emite ninguno.

1. **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. `LogConfiguration`tiene 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. `ERROR`solo emite los intentos de entrega fallidos. `INFO`emite 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. `FULL`lo incluye en todos los registros. Consulte [Cargas útiles en los registros de registro](#eb-custom-bus-observability-payload).

Puedes configurarlo `LogConfiguration` cuando creas un suscriptor, o más tarde con`UpdateSubscriber`. 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
<a name="eb-custom-bus-observability-setup"></a>

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. `INFO`registra tanto los éxitos como los errores, que es lo que indica si un evento se ha realizado o no.

```bash
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.

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

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

```bash
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.

```bash
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.

```bash
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
<a name="eb-custom-bus-observability-records"></a>

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

`outcome` y `attempt_count`  
`SUCCESS`o `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_DELIVERED``ON_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_properties`se 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](#eb-custom-bus-observability-payload)

`event_detail`, `event_metadata`, y `event_system_metadata`  
El evento tal como EventBridge se celebró. `event_system_metadata`contiene los identificadores con los que se correlacionan los registros. `event_detail`aparece solo cuando difiere de`target_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. `outcome`indica si EventBridge se ha alcanzado o no el objetivo. `attempt_count`indica si aún se está reintentando porque un evento sin `terminal_kind` registro no ha finalizado. `terminal_kind`explica cómo terminó y separa un evento que estaba inactivo de uno que se descartó. `target_arn``target_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](eb-custom-bus-subscribers.md#eb-custom-bus-subscribers-nothing-arrived).

### Cargas útiles en los registros de registro
<a name="eb-custom-bus-observability-payload"></a>

`IncludePayload`controla dos campos y ningún otro: `details.target_input` y`details.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. `FULL`incrusta 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. Con`FULL`, 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 a`ON_ERROR_ONLY`. Esto limita tanto la exposición como el volumen que almacenas.

## La API llama AWS CloudTrail
<a name="eb-custom-bus-observability-cloudtrail"></a>

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, consulte[Registro Amazon EventBridge Llamadas a la API mediante AWS CloudTrail](logging-using-cloudtrail.md).