Configurazione dei log per i bus di eventi Amazon EventBridge - Amazon EventBridge
Funzionamento dei logSpecificare il livello di logInclusione di dettagli nei registriTroncare i logSegnalazione degli errori nei registri

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 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 nella Amazon Data Firehose User Guide.

  • 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 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:

EventBridge non registra gli eventi che corrispondono solo alle regole gestite.

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:

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 Decrypted GenerateDataKey eventi generati quando i record di registro crittografati utilizzando una chiave gestita dal cliente vengono consegnati a una destinazione di registro.

    • PutRecordBatcheventi 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 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.

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 AllowVendedLogDeliveryForResourceall'event bus.

Per ulteriori informazioni, consulta Autorizzazioni specifiche del servizio 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 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

 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