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 EventBridge recapitare i registri per il bus 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 [Autorizzazioni specifiche del servizio](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions) nella Logs User Guide. CloudWatch *
## 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 uno dei 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 | 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`