View a markdown version of this page

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

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 EventBridge eventi Amazon

È possibile configurare l'invio EventBridge di log 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 log per il EventBridge bus di eventi specificato:

  • Amazon CloudWatch Logs

    EventBridge invia i log al gruppo di CloudWatch log Logs specificato.

    Utilizza CloudWatch Logs per centralizzare i log di tutti i sistemi, le applicazioni e AWS i 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 in streaming in tempo reale verso destinazioni come determinati AWS servizi, nonché qualsiasi endpoint HTTP personalizzato o endpoint HTTP di proprietà di fornitori di servizi di terze parti supportati. Per ulteriori informazioni, consulta Creating an Amazon Data Firehose delivery stream nella Amazon Data Firehose User Guide.

  • Simple Storage Service (Amazon S3)

    EventBridge invia 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 i bus di eventi

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

Quando configuri la registrazione per i bus di eventi, tieni presente le seguenti considerazioni:

  • I registri dei bus di eventi vengono consegnati nel migliore dei modi. La maggior parte delle richieste relative a un bus di eventi configurato correttamente per la registrazione genera un record di registro consegnato. La completezza e la tempestività della registrazione del bus di eventi non sono garantite.

  • In alcune circostanze, la fornitura stessa dei record del registro degli eventi genera eventi a cui vengono poi inviati EventBridge, il che può portare a interruzioni nella consegna dei registri. 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 inviati a una destinazione di registro.

    • PutRecordBatcheventi in Firehose generati dalla consegna dei registri del bus di eventi.

  • Per le destinazioni dei log S3, non è consigliabile specificare un bucket di destinazione con la notifica degli eventi EventBridge abilitata, in quanto ciò può causare interruzioni nella consegna dei log.

Crittografia dei log

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 nuovamente crittografato 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 di eventi

Per abilitare la registrazione da un bus di eventi, allega la seguente policy basata sull'identità (utente o ruolo) alla tua identità (utente o ruolo) di AWS Identity and Access Management (IAM). Questa policy concede l'events:AllowVendedLogDeliveryForResourceazione per il bus di eventi.

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 nella CloudWatch Logs User Guide.

Specificazione del livello di registro del bus di eventi

È possibile specificare i tipi di fasi di elaborazione degli eventi che EventBridge registrano le destinazioni del registro selezionate.

Scegliete tra i seguenti livelli di dettaglio da includere nei registri. 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.

  • ERROR: EventBridge invia tutti i log relativi agli errori generati durante l'elaborazione degli eventi e la consegna degli obiettivi.

  • INFO: EventBridge invia tutti i log 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 dell'evento.

La tabella seguente elenca le fasi di elaborazione degli eventi incluse in ogni livello di registro.

Fase TRACE INFO ERRORE OFF

Evento inserito

 x x

Inserimento dell'evento non riuscito

 x x x

Evento ricevuto

 x

Tentativo di richiamo iniziato

 x

Tentativo di richiamo Fallimento permanente

 x x x

Tentativo di richiamo fallito Retry-able

x x x

Tentativo di richiamo riuscito

 x

Tentativo di richiamo limitato

 x x x

DLQ di richiamo

 x x x

Richiamata non riuscita

 x x x

Richiamata iniziata

 x x

Richiamo riuscito

 x x

L'acceleratore di richiamo è stato avviato

 x x x

Nessuna regola corrispondente

 x x

Regola corrispondente

x x

La corrispondenza delle regole è iniziata

x

Inclusione di dati dettagliati nei registri del bus di 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 log 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:

Troncatura dei dati nei registri del bus di eventi

A causa dei vincoli relativi alla 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 nel seguente ordine:

  • 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 di dati eliminati.

Segnalazione degli errori nei registri del bus di eventi

EventBridge include anche i dati sugli errori, laddove disponibili, in 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