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` # Cosa EventBridge registra Amazon per gli event bus La comprensione del modo in cui EventBridge elabora gli eventi può aiutarti a utilizzare i log per risolvere o eseguire il debug dei problemi relativi al bus degli eventi. Se la registrazione è abilitata, EventBridge genera più record di registro durante l'elaborazione di un evento. Ecco i passaggi principali eseguiti durante EventBridge l'elaborazione di un evento: + Un evento viene inviato a un bus di eventi EventBridge genera registri per gli eventi inviati da fonti partner, riprodotti dagli archivi o inviati utilizzando`PutEvents`, indipendentemente dal fatto che soddisfino o meno le regole. + EventBridge determina se l'evento corrisponde a qualche regola del bus. Se l'evento corrisponde a una o più regole, EventBridge passa al passaggio successivo. Se un AWS evento non corrisponde a nessuna regola, EventBridge lo scarta e non genera alcun registro. + EventBridge richiama il bersaglio. EventBridge riprova a richiamare il target se necessario fino a quando: + L'evento è stato consegnato con successo. + La consegna dell'evento non riesce, ad esempio se la politica sui nuovi tentativi scade o si verifica un errore permanente. Se il recapito non riesce, EventBridge invia l'evento a una coda di lettere morte (DLQ), se specificata, oppure elimina l'evento se non viene specificato alcun DLQ. Il diagramma seguente presenta una visualizzazione dettagliata del flusso di elaborazione degli eventi, con tutti i passaggi possibili rappresentati, insieme al livello di registro di ogni passaggio. Per un elenco completo dei passaggi, vedere[Specificare il livello di log](eb-event-bus-logs.md#eb-event-bus-logs-level). ![\[EventBridge procede attraverso i passaggi per elaborare ogni evento inviato al bus.\]](http://docs.aws.amazon.com/it_it/eventbridge/latest/userguide/images/bus_logging_eventbridge_conceptual.svg) # Schema di registro del bus degli EventBridge eventi di Amazon Il riferimento seguente descrive in dettaglio lo schema per i record del registro del bus degli EventBridge eventi. Ogni record rappresenta una fase dell' EventBridge elaborazione di un evento specifico. Per ulteriori informazioni, consulta [Registrazione dei bus degli eventi ](eb-event-bus-logs.md). ``` { "resource\$1arn": "arn:aws:events:region:account:event-bus/bus-name", "request\$1id": "guid", "event\$1id": "guid", "invocation\$1id": "guid", "message\$1timestamp\$1ms": "date_time", "message\$1type": "step", "log\$1level": "TRACE | INFO | ERROR", "details": { }, "error": { "http\$1status\$1code": code, "error\$1message": "error_message", "aws\$1service": "service_name", "request\$1id": "service_request_id" } } ``` **resource\$1arn** L'Amazon Resource Name (ARN) per il bus degli eventi. **request\$1id** ID della richiesta. **event\$1id** L'ID dell'evento in fase di elaborazione. **invocation\$1id** L'ID della chiamata per l'evento. **message\$1timestamp\$1ms** La data e l'ora in cui il log eventi è stato emesso. Unità: millisecondi **message\$1type** La fase di elaborazione dell'evento per la quale è stato generato il record di registro. Per ulteriori informazioni sui passaggi eseguiti EventBridge durante l'elaborazione di un evento, vedere[Cosa EventBridge registra Amazon per gli event bus](eb-event-logs-execution-steps.md). *Valori validi*: + `EVENT_INGEST_FAILURE` + `EVENT_INGEST_SUCCESS` + `EVENT_RECEIPT` + `INVOCATION_ATTEMPT_PERMANENT_FAILURE` + `INVOCATION_ATTEMPT_RETRYABLE_FAILURE` + `INVOCATION_ATTEMPT_START` + `INVOCATION_ATTEMPT_SUCCESS` + `INVOCATION_ATTEMPT_THROTTLE` + `INVOCATION_DLQ` + `INVOCATION_FAILURE` + `INVOCATION_START` + `INVOCATION_SUCCESS` + `INVOCATION_THROTTLE_START` + `NO_STANDARD_RULES_MATCHED` + `RULE_MATCH` + `RULE_MATCH_START` **log\$1level** Il livello di dettaglio specificato per il registro del bus degli eventi. *Valori validi*: `ERROR` \$1 `INFO` \$1 `TRACE` Per ulteriori informazioni, consulta [Specificazione del livello di registro del bus degli eventi](eb-event-bus-logs.md#eb-event-bus-logs-level). **details** Contiene i dettagli della fase, in base al tipo di dettaglio della fase. I campi elencati di seguito vengono restituiti per i seguenti tipi di messaggi: + `EVENT_INGEST_SUCCESS` + `EVENT_INGEST_FAILURE` + `EVENT_RECEIPT` + `RULE_MATCH_START` ``` { "caller_account_id": "account_id", "source_time_ms": date_time, "source": "source", "detail_type": " type", "resources": [], "event_detail": "{}" } ``` I campi elencati di seguito vengono restituiti per il seguente tipo di messaggio: + `RULE_MATCH` ``` { "rule_arn": "ARN", "target_arns": [ "ARN" ], "invocation_ids": [ "guid" ] } ``` I campi elencati di seguito vengono restituiti per i seguenti tipi di messaggio: + `INVOCATION_ATTEMPT_START` + `INVOCATION_START` + `INVOCATION_THROTTLE_START` ``` { "rule_arn": "ARN", "role_arn": "ARN", "target_arn": "ARN", "attempt_count": Integer, "target_input": "string", "target_properties": "string" } ``` I campi elencati di seguito vengono restituiti per i seguenti tipi di messaggi: + `INVOCATION_DLQ` + `INVOCATION_FAILURE` + `INVOCATION_SUCCESS` ``` { "rule_arn": "ARN", "role_arn": "ARN", "target_arn": "ARN", "target_input": "string", "target_properties": "string", "total_attempts": Integer, "final_invocation_status": "status", "ingestion_to_start_latency_ms": Integer, "ingestion_to_complete_latency_ms": Integer, "ingestion_to_success_latency_ms": Integer, "target_duration_ms": Integer, "target_response_body": "string" } ``` I `ingestion_to_start_latency_ms` e `ingestion_to_complete_latency_ms` sono inclusi solo nel primo tentativo di invocazione. Il `ingestion_to_success_latency_ms` campo è incluso solo per le chiamate riuscite. I campi elencati di seguito vengono restituiti per i seguenti tipi di messaggi: + `INVOCATION_ATTEMPT_PERMANENT_FAILURE` + `INVOCATION_ATTEMPT_RETRYABLE_FAILURE` + `INVOCATION_ATTEMPT_SUCCESS` + `INVOCATION_ATTEMPT_THROTTLE` ``` { "rule_arn": "ARN", "role_arn": "ARN", "target_arn": "ARN", "attempt_type": "FIRST | THROTTLE | RETRY", "attempt_count": Integer, "invocation_status": "status", "target_duration_ms": Integer, "target_response_body": "string" } ``` **dropped\$1fields** Un elenco di tutti i campi di dati EventBridge è stato troncato per mantenere il record al di sotto del limite di 1 MB. EventBridge non include questo campo se ha troncato alcuni campi di dettaglio. Per ulteriori informazioni, consulta [Troncamento dei dati nei registri del bus degli eventi](eb-event-bus-logs.md#eb-event-logs-data-truncation). **error** Contiene informazioni per eventuali errori generati durante questo passaggio. Per quanto riguarda gli errori, EV include sempre i seguenti campi: + `error_message` + `aws_service` E i seguenti campi, se disponibili: + `request_id` + `http_status_code` Se non è stato generato alcun errore durante questo passaggio, EventBridge non include questo campo nel record di registro. **http\$1status\$1code** Il codice di stato HTTP restituito dal servizio chiamato. **messaggio\$1errore** Il messaggio di errore restituito dal servizio chiamato. **aws\$1service** Il nome del servizio chiamato. **id\$1richiesta** L'ID richiesta per questa richiesta dal servizio chiamato.