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à.
# Configurazione dei log per i bus di eventi Amazon EventBridge
È possibile configurare l'invio EventBridge di registri che descrivono in dettaglio il modo in cui un bus di eventi elabora gli eventi, per facilitare la risoluzione dei problemi e il debug.
È possibile selezionare i seguenti AWS servizi come *destinazioni di registro* a cui inviare i registri per il bus EventBridge di eventi specificato:
+ CloudWatch Registri Amazon
EventBridge consegna i log al gruppo di CloudWatch log Logs specificato.
Utilizza CloudWatch Logs per centralizzare i log di tutti i sistemi, le applicazioni e i AWS servizi che utilizzi, in un unico servizio altamente scalabile. Per ulteriori informazioni, consulta [Working with log groups and log stream](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) nella *Amazon CloudWatch Logs User* Guide.
+ Amazon Data Firehose
EventBridge invia i log a un flusso di distribuzione Firehose.
Amazon Data Firehose è un servizio completamente gestito per la distribuzione di dati di streaming in tempo reale a destinazioni come determinati AWS servizi, nonché a qualsiasi endpoint HTTP personalizzato o endpoint HTTP di proprietà di provider di servizi terzi supportati. Per ulteriori informazioni, consulta [Creazione di un flusso di distribuzione di Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) nella *Amazon Data Firehose User Guide*.
+ Simple Storage Service (Amazon S3)
EventBridge consegna i log come oggetti Amazon S3 al bucket specificato.
Amazon S3 è un servizio di archiviazione di oggetti che offre scalabilità, disponibilità dei dati, sicurezza e prestazioni tra le migliori del settore. Per ulteriori informazioni, consulta [Caricamento, download e utilizzo di oggetti in Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-downloading-objects.html) nella *Guida per l'utente di Amazon Simple Storage Service*.
## Come funziona la registrazione per gli event bus
EventBridge genera registri per:
+ Qualsiasi evento AWS di servizio che corrisponde a una regola sul bus degli eventi
+ Qualsiasi evento fornito con i seguenti metodi, indipendentemente dal fatto che l'evento sia stato importato correttamente o che corrisponda a una regola:
+ Eventi provenienti da fonti di eventi [partner](eb-saas.md)
+ Eventi [riprodotti da un archivio](eb-archive.md)
+ Eventi inviati al bus tramite [`PutEvents`](eb-putevents.md)
EventBridge non registra gli eventi che corrispondono solo alle [regole gestite](eb-rules.md#eb-rules-managed).
I dati di registro inviati a ciascuna destinazione di registro selezionata sono gli stessi.
È possibile personalizzare i log EventBridge inviati alle destinazioni selezionate nel modo seguente:
+ È possibile specificare il *livello di registro*, che determina i passaggi per i quali EventBridge invia i log alle destinazioni selezionate. Per ulteriori informazioni, consulta [Specificazione del livello di registro del bus degli eventi](#eb-event-bus-logs-level).
+ È possibile specificare se EventBridge includere informazioni più granulari se pertinenti, tra cui:
+ Dettagli dell’evento
+ Informazioni di input sull'obiettivo
+ Informazioni sulla richiesta Target
Per ulteriori informazioni, consulta [Inclusione di dati di dettaglio nei registri dei bus degli eventi](#eb-event-logs-data).
### Considerazioni sulla consegna dei log
Tieni a mente le seguenti considerazioni quando configuri la registrazione per i bus degli eventi:
+ I registri dei log degli Event Bus vengono forniti con la massima diligenza possibile. La maggior parte delle richieste relative a un bus di eventi correttamente configurato per la registrazione generano un record di registro fornito. La completezza e la tempestività della registrazione del bus degli eventi non sono garantite.
+ In alcune circostanze, la trasmissione stessa dei record dei log del bus degli eventi genera eventi a cui vengono poi inviati EventBridge, il che può causare interruzioni nella consegna dei record di log. Per questo motivo, EventBridge non registra i seguenti eventi:
+ AWS KMS`[Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html)`ed `[GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html)` eventi generati quando i record di registro crittografati utilizzando una chiave gestita dal cliente vengono consegnati a una destinazione di registro.
+ `[PutRecordBatch](https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html)`eventi in Firehose generati dalla consegna di registri del bus degli eventi.
+ Per le destinazioni con log S3, non è consigliabile specificare un bucket di destinazione con [la notifica degli eventi EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) abilitata, poiché ciò può comportare interruzioni nella consegna dei log.
### Crittografia della registrazione
Quando si inviano i log, EventBridge crittografa le `error` sezioni `detail` e di ogni record di registro con la chiave KMS specificata per il bus degli eventi. Una volta consegnato, il record viene decrittografato e quindi ricrittografato con la chiave KMS specificata per la destinazione del registro.
Per ulteriori informazioni, consulta [Crittografia dei log dei bus degli eventi](encryption-bus-logs.md).
### Specificazione delle autorizzazioni di registrazione del bus degli eventi
Per abilitare la registrazione da un bus di eventi, è necessario concedere le autorizzazioni per l'invio di registri EventBridge da quel bus. Aggiungi una politica che conceda **AllowVendedLogDeliveryForResource**all'event bus.
------
#### [ 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}}*"
}
]
}
```
------
Per ulteriori informazioni, consulta le [Service-specific autorizzazioni](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions) nella *CloudWatch Logs* User Guide.
## Specificazione del livello di registro del bus degli eventi
È possibile specificare i tipi di fasi di elaborazione degli eventi che EventBridge registrano le destinazioni di registro selezionate.
Scegliete tra i seguenti livelli di dettaglio da includere nei log. Il livello di registro si applica a tutte le destinazioni di registro specificate per il bus degli eventi. Ogni livello di registro include i passaggi dei livelli di registro precedenti.
+ **OFF**: EventBridge non invia alcun registro. Questa è l’impostazione predefinita.
+ **ERRORE**: EventBridge invia tutti i registri relativi agli errori generati durante l'elaborazione degli eventi e la consegna dell'oggetto.
+ **INFORMAZIONI**: EventBridge invia tutti i registri relativi agli errori, nonché i passaggi principali eseguiti durante l'elaborazione degli eventi.
+ **TRACE**: EventBridge invia tutti i log generati durante tutte le fasi dell'elaborazione degli eventi.
La tabella seguente elenca le fasi di elaborazione degli eventi incluse in ogni livello di registro.
| Fase | TRACE | INFO | ERRORE | OFF |
| --- | --- | --- | --- | --- |
| Evento ingerito | x | x | | |
| Inserimento dell'evento non riuscito | x | x | x | |
| Evento ricevuto | x | | | |
| Tentativo di invocazione iniziato | x | | | |
| Tentativo di invocazione fallito permanentemente | x | x | x | |
| Tentativo di invocazione fallito Retry-able | x | x | x | |
| Tentativo di invocazione riuscito | x | | | |
| Tentativo di invocazione limitato | x | x | x | |
| Invocazione DLQ | x | x | x | |
| Invocazione non riuscita | x | x | x | |
| Invocazione iniziata | x | x | | |
| Invocazione riuscita | x | x | | |
| Invocation Throttle è iniziata | x | x | x | |
| Nessuna regola corrispondente | x | x | | |
| Regola abbinata | x | x | | |
| La corrispondenza delle regole è iniziata | x | | | |
## Inclusione di dati di dettaglio nei registri dei bus degli eventi
È possibile specificare EventBridge di includere informazioni più granulari nei log generati. Questi dati possono essere utili per la risoluzione dei problemi e il debug. Se si seleziona questa opzione, EventBridge include questi dati nei record pertinenti per tutte le destinazioni di registro specificate.
Le informazioni dettagliate includono i seguenti campi:
+ `event_detail`: I dettagli dell'evento stesso.
+ `target_input`: La richiesta EventBridge viene inviata alla destinazione.
+ `target_properties`:
## Troncamento dei dati nei registri del bus degli eventi
A causa dei vincoli di destinazione dei log, EventBridge limita i record di log a 1 MB. Se un record di registro supera questo limite, EventBridge tronca il record rimuovendo i seguenti campi nell'ordine seguente:
+ `target_input`
+ `target_properties`
+ `target_response_body`
EventBridge rimuove il `event_detail` campo dai seguenti tipi di record di registro, se necessario:
+ `EVENT_RECEIVED`
+ `EVENT_INGESTED`
+ `EVENT_INGESTED_FAILED`
+ `RULE_MATCH_STARTED`
Se è necessario il troncamento, EventBridge rimuove l'intero campo.
Se EventBridge tronca i campi nell'evento, il `dropped_fields` campo include un elenco dei campi dati eliminati.
## Segnalazione degli errori nei registri dei bus degli eventi
EventBridge include anche i dati di errore, ove disponibili, nei passaggi che rappresentano gli stati di errore. Queste fasi includono:
+ `EVENT_INGEST_FAILURE`
+ `INVOCATION_THROTTLE_START`
+ `INVOCATION_ATTEMPT_THROTTLE`
+ `INVOCATION_ATTEMPT_RETRYABLE_FAILURE`
+ `INVOCATION_ATTEMPT_PERMANENT_FAILURE`
+ `INVOCATION_FAILURE`
+ `INVOCATION_DLQ`