

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Osservabilità per il Custom Event Bus: metriche, registri e CloudTrail

Tre fonti ti dicono cosa stanno facendo un autobus e i suoi abbonati. Le CloudWatch metriche di Amazon nel `AWS/EventsV2` namespace sono attive per tutti gli abbonati; per avvisare quando le consegne falliscono, attiva `OnFailureDestinationDelivered` o `EventsDropped` attiva un segno negativo con numeri matematici metrici. `EventDeliveryAttempts` `EventsDelivered` I log degli abbonati registrano ogni tentativo di consegna come record JSON; sono disattivati finché non imposti il numero dell'abbonato. `LogConfiguration.Level` AWS CloudTrail registra le chiamate API che creano e modificano bus, abbonati e sorgenti di eventi.

## Metriche
<a name="eb-custom-bus-observability-metrics"></a>

Le metriche relative agli abbonati hanno due dimensioni `EventBus` e ciascuna contiene l'`Subscriber`ARN della risorsa. Se l'abbonato appartiene a un account diverso dal bus, emette EventBridge anche la metrica con `EventBus` e in `SubscriberAccount` modo che il proprietario del bus possa vedere il consumo per account. La tabella seguente elenca i parametri .


| Metrica | Unità | Significato | 
| --- | --- | --- | 
| FilterEvaluated | Conteggio | Eventi valutati in base ai filtri dell'abbonato | 
| FilterMatched | Conteggio | Eventi che corrispondono a tutti i filtri | 
| EventDeliveryAttempts | Conteggio | Tentativi di consegna, conteggiati per evento. EventsDeliveredSottrai per contare i tentativi falliti | 
| TargetInvocations | Conteggio | Chiamate effettuate verso la destinazione; una chiamata può comportare una serie di eventi | 
| RetryInvocationAttempts | Conteggio | Emesso solo in caso di nuovo tentativo, valutato come profondità del tentativo: il secondo tentativo è 1, il terzo è 2. Il numero di campioni è il numero di tentativi | 
| EventsDelivered | Conteggio | Eventi accettati dall'obiettivo | 
| EgressBytes | Byte | Byte consegnati alla destinazione | 
| EventTransformationFailures | Conteggio | Eventi la cui espressione Transformer o Input universal-target hanno avuto esito negativo | 
| IngestionToInvocationStartTime | Millisecondi | Tempo che intercorre tra l'arrivo dell'evento sul bus e l'inizio della chiamata target. Non viene emesso quando il tentativo fallisce prima di chiamare il bersaglio | 
| IngestionToInvocationEndTime | Millisecondi | Tempo che intercorre tra l'arrivo dell'evento sull'autobus e la fine della chiamata al bersaglio | 
| OnFailureDestinationDelivered | Conteggio | Documenti scritti nella coda per le lettere morte | 
| OnFailureDestinationFailed | Conteggio | Record che non è stato possibile scrivere nella coda per le lettere morte | 
| EventsDropped | Conteggio | Eventi che hanno esaurito i tentativi senza alcuna coda di lettere morte per registrarli | 
| ApproximateBacklogAge | Millisecondi | Età dell'evento più vecchio che l'abbonato non ha ancora fornito | 
| SubscriberLogRecordsDropped | Conteggio | Record di log che non possono essere scritti, perché la consegna dei log è la soluzione migliore | 

Il numero di bus del tuo account viene inoltre riportato nel `AWS/Usage` namespace come `ResourceCount` with `Service` `EventBridge` e con un `Resource` valore che inizia con`EventsV2/`, così puoi attivare un allarme quando ti avvicini alla quota dei bus. Per le quote, consulta. [Quote personalizzate per Event Bus](eb-quota.md#eb-custom-bus-quotas)

## Pubblicazione di parametri
<a name="eb-custom-bus-observability-publish-metrics"></a>

Ogni singola `PutEvents` `PutRawEvents` chiamata genera inoltre delle metriche nel `AWS/EventsV2` namespace, in modo da segnalare eventuali chiamate di pubblicazione limitate o non riuscite per un bus, ad esempio se la dimensione è impostata su`PublishEventsApproximateThrottledCallCount`. `EventBus` `orders` L'account del proprietario del bus riceve tutte le metriche di pubblicazione. Un account che effettua delle pubblicazioni su un autobus di cui non è proprietario le riceve anche, nel proprio account, per le proprie chiamate.


| Metrica | Unità | Significato | 
| --- | --- | --- | 
| PublishEventsApproximateCallCount | Conteggio | Pubblica le chiamate ricevute | 
| PublishEventsApproximateSuccessCallCount | Conteggio | Pubblica le chiamate che hanno restituito HTTP 200 | 
| PublishEventsApproximateFailedCallCount | Conteggio | Pubblica chiamate che hanno restituito un errore | 
| PublishEventsApproximateThrottledCallCount | Conteggio | Pubblica le chiamate rifiutate con ThrottlingException | 
| PublishEventsEntryCount | Conteggio | Inserimenti nelle chiamate di pubblicazione | 
| PublishEventsFailedEntriesCount | Conteggio | Voci non riuscite all'interno di una chiamata accettata, riportate nella risposta come voci non riuscite | 
| PublishEventsIngressBytes | Byte | Byte del payload dell'evento memorizzati. Assente, anziché 0, per le chiamate in cui non è stato memorizzato nulla. L'andamento si riferisce alla voce in ingresso della fattura, che arrotonda ogni voce a un intero KB. | 

Le dimensioni dipendono dalla metrica e dall'autore della pubblicazione.
+ Ogni metrica viene pubblicata con la sola `EventBus` dimensione: i totali per il bus.
+ Per gli eventi che arrivano tramite una fonte di eventi, le metriche di conteggio vengono pubblicate anche con `EventBus` e`EventSource`, in modo da poter vedere la condivisione di una fonte. `PublishEventsIngressBytes`non presenta alcuna `EventSource` ripartizione.
+ `PublishEventsIngressBytes`viene inoltre pubblicato al proprietario del bus con `EventBus` e`PublisherAccount`, in modo che il proprietario del bus possa vedere quanti byte sono memorizzati in ciascun account di pubblicazione.

## Registri degli abbonati
<a name="eb-custom-bus-observability-logs"></a>

Un abbonato può registrare cosa è successo a ogni evento che ha cercato di trasmettere. La registrazione avviene per abbonato e viene disattivata quando ne crei uno, quindi un nuovo iscritto non registra nulla finché non lo imposti. `LogConfiguration` Ogni record è un documento JSON con un simbolo `message_type` che indica ciò che descrive.
+ `SUBSCRIBER_MATCHED`: un evento ha soddisfatto i filtri dell'abbonato ed è entrato nella consegna.
+ `EVENT_DELIVERY_ATTEMPT`: un tentativo di invocare il bersaglio, con il relativo risultato, il numero di tentativi e la durata. Questo è il record descritto nel resto di questa sezione.
+ `EVENT_TRANSFORMATION_FAILURE`: l'`Input`espressione `Transformer` o universal-target non è riuscita per un evento, con l'errore.
+ `ON_FAILURE_DESTINATION_DELIVERY_ATTEMPT`: un tentativo di scrivere un record nella coda delle lettere morte.

La consegna dei log è il massimo impegno. Un record che non può essere scritto viene conteggiato nella `SubscriberLogRecordsDropped` metrica anziché ritentare all'infinito. Quando il bus è crittografato con una chiave gestita dal cliente, EventBridge crittografa i campi di payload di ogni record contenuto in quella chiave prima che esca EventBridge, in modo che un account di destinazione che non può utilizzare la chiave possa visualizzare il record senza di essi. Il record di un evento riprodotto viene mantenuto `details.delivery_type``REPLAY`; quello di un evento dal vivo. `LIVE`

### Le due impostazioni che producono un record
<a name="eb-custom-bus-observability-configuration"></a>

È necessario che esistano entrambe due impostazioni indipendenti prima di poter leggere un singolo record.

1. **Il livello di registro dell'abbonato. **`LogConfiguration.Level`decide quali record EventBridge emettere. Il valore predefinito è`OFF`, che non ne emette nessuno.

1. **A CloudWatch Consegna dei registri. ** I record ti arrivano tramite il meccanismo di distribuzione CloudWatch dei log fornito da Amazon Logs, che associa l'abbonato a una destinazione di tua proprietà. Senza di esso, i record non hanno nessun posto dove atterrare e nessun gruppo di log viene visualizzato da solo.

Effettua entrambe le impostazioni prima di iniziare a diagnosticare un problema di consegna anziché dopo. Solo gli abbonati dispongono di una configurazione di registro. I bus e le sorgenti di eventi non ne hanno, quindi è possibile attivare l'accesso un abbonato alla volta. `LogConfiguration`ha due membri.

`Level`  
Il livello minimo di un record. I record al di sotto di esso non vengono emessi. `OFF`, impostazione predefinita, non emette nulla. `ERROR`emette solo tentativi di consegna falliti. `INFO`emette tutti i tentativi di consegna, compresi quelli andati a buon fine.

`IncludePayload`  
Se un record contiene il payload del tuo evento. `ON_ERROR_ONLY`, impostazione predefinita, lo inserisce solo nei record di errore. `FULL`lo inserisce in ogni record. Consulta [Carichi utili nei record di registro](#eb-custom-bus-observability-payload).

È possibile impostare `LogConfiguration` quando si crea un abbonato o successivamente con`UpdateSubscriber`. Un aggiornamento ha effetto senza ricreare il sottoscrittore. Né la risposta di creazione né la risposta di aggiornamento restituiscono il campo, quindi conferma il valore memorizzato con`DescribeSubscriber`, che lo restituisce.

### Attiva la registrazione per un abbonato
<a name="eb-custom-bus-observability-setup"></a>

I passaggi seguenti registrano ogni tentativo di consegna per un abbonato esistente e inviano i record a un gruppo di CloudWatch log Logs nello stesso account. Il primo comando è una EventBridge chiamata e gli altri sono chiamate CloudWatch Logs. Inizia aumentando il livello di registro dell'abbonato. `INFO`registra sia i successi che i fallimenti, ovvero ciò che ti dice se un evento è stato effettivamente consegnato.

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

Quindi, crea il gruppo di log di destinazione. Il nome deve iniziare con`/aws/vendedlogs/`. CloudWatch Logs gestisce automaticamente la policy relativa alle risorse di distribuzione solo con quel prefisso; per un gruppo di log esterno, è necessario gestire personalmente tale policy.

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

Crea una fonte di consegna. `--resource-arn`È l'ARN dell'abbonato, che è ciò che fa sì che la fonte produca i record di quell'abbonato. Imposta `--log-type` in modo che corrisponda al livello configurato: `INFO_LOGS` per o per `Level``INFO`. `ERROR_LOGS` `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
```

Crea una destinazione di consegna assegnando un nome al gruppo di log. La risposta contiene l'ARN di destinazione, necessario per il comando successivo.

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

Infine, associa l'origine alla destinazione. Usa l'ARN di destinazione della risposta precedente.

```bash
aws logs create-delivery \
    --delivery-source-name large-orders-source \
    --delivery-destination-arn {{destination-arn}}
```

I record ora vengono visualizzati nel gruppo di log. Arrivano più tardi della consegna stessa, perché la pipeline di log li raggruppa in batch, quindi tenete conto di questo ritardo quando leggete un gruppo di log subito dopo la pubblicazione. Tre proprietà di questo cablaggio determinano la sua estensione. Una destinazione è un gruppo di log, un bucket Amazon S3 o uno stream Amazon Data Firehose e i comandi precedenti sono gli stessi per ciascuno: solo modifiche. `destinationResourceArn` Una consegna associa esattamente una fonte a una destinazione, quindi l'invio dei record di un abbonato a una seconda destinazione richiede una seconda consegna. La destinazione può trovarsi in un account diverso da quello dell'abbonato e, in tal caso, l'account di destinazione deve richiamare `PutDeliveryDestinationPolicy` la destinazione per consentire la consegna, ovvero il modo in cui un account centrale raccoglie i record degli abbonati di cui non è proprietario.

### Leggere un registro di consegna
<a name="eb-custom-bus-observability-records"></a>

EventBridge emette un record per tentativo di consegna per evento. Quattro campi sono al livello superiore. `message_type`si `EVENT_DELIVERY_ATTEMPT` riferisce a un tentativo di consegna; gli altri tipi sono elencati all'inizio di questa sezione. `resource_arn`è l'ARN dell'abbonato che ha effettuato il tentativo, ovvero il modo in cui si separano gli abbonati che condividono un gruppo di log. `log_level`è il livello del record stesso: un tentativo è `INFO` andato a buon fine e un tentativo fallito sì`ERROR`, motivo per cui registra `Level` `ERROR` ancora gli errori. `details`è un oggetto che contiene lo stato di consegna e contiene i campi su cui si generano query e allarmi.

`outcome` e `attempt_count`  
`SUCCESS`o `FAILURE` per questo tentativo, e a quale tentativo si è trattato, quindi i tentativi sono numerabili.

`terminal_kind`  
È presente nell'unico record che indica come è terminato l'evento:`EVENTS_DELIVERED`,`ON_FAILURE_DESTINATION_DELIVERED`, o `EVENTS_DROPPED` quando i tentativi sono scaduti e non è stata configurata alcuna destinazione in caso di errore.

`target_arn` e `target_properties`  
La destinazione su cui è stato effettuato il tentativo e i parametri di destinazione risolti dal sottoscrittore per questo evento. `target_properties`viene omesso quando il sottoscrittore non configura alcun parametro.

`ingestion_to_start_latency_ms` e `ingestion_to_complete_latency_ms`  
Millisecondi dall'inserimento dell'evento all'inizio e alla fine di questo tentativo.

`target_input`  
I byte inviati alla destinazione, parola per parola. Questo è un campo di payload; vedi. [Carichi utili nei record di registro](#eb-custom-bus-observability-payload)

`event_detail`, `event_metadata` e `event_system_metadata`  
L'evento lo EventBridge ha tenuto. `event_system_metadata`contiene gli identificatori con cui correlate i record. `event_detail`appare solo quando è diverso da`target_input`, come nel caso in cui l'abbonato ha un trasformatore.

Per diagnosticare una consegna che non è mai arrivata, leggi i registri dell'abbonato in questo ordine. `outcome`indica se EventBridge è stato raggiunto l'obiettivo. `attempt_count`indica se sta ancora riprovando, perché un evento senza `terminal_kind` record non è terminato. `terminal_kind`indica come è andato a finire e separa un evento in lettere morte da uno che è stato eliminato. `target_arn``target_properties`, e indica `target_input` cosa è stato inviato e dove, ed è qui che si presenta un problema con il trasformatore o il parametro di destinazione. Un errore è visibile nel record non appena il tentativo fallisce, quindi non è necessario attendere la scadenza dei tentativi. Per la procedura completa, consulta [Risoluzione dei problemi: hai pubblicato e nulla è arrivato a destinazione](eb-custom-bus-subscribers.md#eb-custom-bus-subscribers-nothing-arrived).

### Carichi utili nei record di registro
<a name="eb-custom-bus-observability-payload"></a>

`IncludePayload`controlla due campi e nessun altro: `details.target_input` e`details.event_detail`. Ogni altro campo viene emesso indipendentemente dal valore scelto, quindi un abbonato che tiene i payload fuori dai suoi registri riporta comunque il risultato, l'obiettivo, il numero di tentativi e le latenze. `FULL`incorpora il payload in ogni record, compresi i record relativi alle consegne riuscite. `ON_ERROR_ONLY`, impostazione predefinita, lo incorpora solo nei record di errori e omette entrambi i campi da un record per una consegna corretta.

**Importante**  
Un record di registro contenente un payload contiene i tuoi dati. Con`FULL`, il gruppo di log contiene una copia di tutti i corpi degli eventi forniti dall'abbonato e chiunque sia in grado di leggere il gruppo di log può leggere quei corpi. Usalo `FULL` mentre esegui il debug di un abbonato, quindi restituiscilo a. `ON_ERROR_ONLY` Ciò limita sia l'esposizione che il volume memorizzato.

## L'API effettua chiamate AWS CloudTrail
<a name="eb-custom-bus-observability-cloudtrail"></a>

L'abbonato registra le consegne registrate, non le chiamate effettuate per configurarle. AWS CloudTrail registra le chiamate all'API di gestione, in modo che una modifica a un bus, a un abbonato o a una fonte di eventi sia verificabile dal percorso anziché da un gruppo di log. Per sapere come si EventBridge integra con CloudTrail, consulta. [Registrazione dei log Amazon EventBridge Chiamate API utilizzando AWS CloudTrail](logging-using-cloudtrail.md)