Registra Amazon EventBridge Pipes

EventBridge La registrazione di Pipes consente a EventBridge Pipes di inviare record che descrivono in dettaglio le prestazioni delle pipe ai servizi supportati. AWS Utilizza i log per ottenere informazioni dettagliate sulle prestazioni di esecuzione della tua pipe e per facilitare la risoluzione dei problemi e il debug.

È possibile selezionare i seguenti AWS servizi come destinazioni di registro a cui EventBridge Pipes invia i record:

• CloudWatch Registri

  EventBridge fornisce i record di registro 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.

• Stream log Firehose

  EventBridge invia i record di 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.

• Log Amazon S3

  EventBridge fornisce i record di 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 di Amazon EventBridge Pipes

Un'esecuzione è un evento o batch di eventi ricevuto da una pipe verso un arricchimento e/o una destinazione. Se abilitato, EventBridge genera un record di registro per ogni fase di esecuzione eseguita durante l'elaborazione del batch di eventi. Le informazioni contenute nel record si applicano al batch di eventi, che si tratti di un singolo evento o di un massimo di 10.000 eventi.

È possibile configurare la dimensione del batch di eventi nell'origine e nella destinazione della pipe. Per ulteriori informazioni, consulta Dosaggio e concorrenza di Amazon EventBridge Pipes.

I dati dei record inviati a ciascuna destinazione di log sono gli stessi.

Se è configurata una destinazione Amazon CloudWatch Logs, i record di log consegnati a tutte le destinazioni hanno un limite di 256 kb. I campi verranno troncati come necessario.

Puoi personalizzare i record EventBridge inviati alle destinazioni di log selezionate nel modo seguente:

• È possibile specificare il livello di registro, che determina i passaggi di esecuzione per i quali EventBridge invia i record alle destinazioni di registro selezionate. Per ulteriori informazioni, consulta Specificazione del livello di log di EventBridge Pipes.

• È possibile specificare se EventBridge Pipes include i dati di esecuzione nei record per le fasi di esecuzione, laddove pertinenti. Questi dati includono:

  • Il payload del batch di eventi

  • La richiesta inviata al servizio di AWS arricchimento o di destinazione

  • La risposta restituita dal servizio di AWS arricchimento o di destinazione

  Per ulteriori informazioni, consulta Inclusione dei dati di esecuzione nei log di EventBridge Pipes.

Specificazione del livello di log di EventBridge Pipes

È possibile specificare i tipi di passaggi di esecuzione per i quali EventBridge invia i record alle destinazioni di registro selezionate.

Scegli tra i seguenti livelli di dettaglio da includere nei record di log. Il livello di log si applica a tutte le destinazioni di log specificate per la pipe. Ogni livello di log include le fasi di esecuzione dei livelli di log precedenti.

• OFF: EventBridge non invia alcun record a nessuna destinazione di registro specificata. Si tratta dell'impostazione di default.

• ERRORE — EventBridge invia tutti i record relativi agli errori generati durante l'esecuzione della pipe alle destinazioni di log specificate.

• INFO: EventBridge invia tutti i record relativi agli errori, oltre a selezionare altri passaggi eseguiti durante l'esecuzione della pipe alle destinazioni di log specificate.

• TRACE: EventBridge invia tutti i record generati durante qualsiasi fase dell'esecuzione della pipe alle destinazioni di log specificate.

Nella EventBridge console, CloudWatch i log sono selezionati come destinazione di log per impostazione predefinita, così come il livello di ERROR registro. Quindi, per impostazione predefinita, EventBridge Pipes crea un nuovo gruppo di CloudWatch log a cui invia i record di registro contenenti il ERROR livello di dettaglio. Non viene selezionato alcun valore predefinito quando si configurano i log a livello di codice.

La tabella seguente elenca le fasi di esecuzione incluse in ogni livello di log.

Fase	TRACE	INFO	ERRORE	OFF
Esecuzione non riuscita	x	x	x
Esecuzione parzialmente non riuscita	x	x	x
Esecuzione avviata	x	x
Esecuzione riuscita	x	x
Esecuzione limitata	x	x	x
Timeout di esecuzione	x	x	x
Invocazione arricchimento non riuscita	x	x	x
Invocazione arricchimento ignorata	x	x
Invocazione arricchimento avviata	x
Invocazione arricchimento riuscita	x
Fase di arricchimento immessa	x	x
Fase di arricchimento non riuscita	x	x	x
Fase di arricchimento riuscita	x	x
Trasformazione arricchimento non riuscita	x	x	x
Trasformazione arricchimento avviata	x
Trasformazione arricchimento riuscita	x
Invocazione destinazione non riuscita	x	x	x
Invocazione destinazione parzialmente non riuscita	x	x	x
Invocazione destinazione ignorata	x
Invocazione destinazione avviata	x
Invocazione destinazione riuscita	x
Fase di destinazione immessa	x	x
Fase di destinazione non riuscita	x	x	x
Fase di destinazione parzialmente non riuscita	x	x	x
Fase di destinazione ignorata	x
Fase di destinazione riuscita	x	x
Trasformazione destinazione non riuscita	x	x	x
Trasformazione destinazione avviata	x
Trasformazione destinazione riuscita	x

Inclusione dei dati di esecuzione nei log di EventBridge Pipes

È possibile specificare EventBridge di includere i dati di esecuzione nei record generati. I dati di esecuzione includono i campi che rappresentano il payload dei batch di eventi, nonché la richiesta inviata e la risposta dell'arricchimento e della destinazione.

I dati di esecuzione sono utili per la risoluzione dei problemi e il debug. Il campo payload contiene il contenuto effettivo di ogni evento incluso nel batch e consente di correlare singoli eventi a un'esecuzione di pipe specifica.

Se scegli di includere i dati di esecuzione, questi vengono inclusi per tutte le destinazioni di log specificate per la pipe.

Importante

Questi campi possono contenere informazioni riservate. EventBridge non tenta di oscurare il contenuto di questi campi durante la registrazione.

Quando include i dati di esecuzione, EventBridge aggiunge i seguenti campi ai record pertinenti:

• payload

  Rappresenta il contenuto del batch di eventi elaborato dalla pipe.

  EventBridge include il payload campo nei record generati nelle fasi in cui il contenuto del batch di eventi potrebbe essere stato aggiornato. Ciò include le seguenti fasi:

  • EXECUTION_STARTED

  • ENRICHMENT_TRANSFORMATION_SUCCEEDED

  • ENRICHMENT_STAGE_SUCCEEDED

  • TARGET_TRANSFORMATION_SUCCEEDED

  • TARGET_STAGE_SUCCEEDED

• awsRequest

  Rappresenta la richiesta inviata all'arricchimento o alla destinazione come stringa JSON. Per le richieste inviate a una destinazione API, rappresenta la richiesta HTTP inviata a quell'endpoint.

  EventBridge include il awsRequest campo nei record generati nelle fasi finali di arricchimento e targeting, ovvero dopo aver EventBridge eseguito o tentato di eseguire la richiesta relativa al servizio di arricchimento o di destinazione specificato. Ciò include le seguenti fasi:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

• awsResponse

  Rappresenta la risposta restituita dall'arricchimento o dalla destinazione, in formato JSON. Per le richieste inviate a una destinazione API, rappresenta la risposta HTTP restituita da quell'endpoint.

  Ad esempioawsRequest, EventBridge include il awsResponse campo nei record generati nelle fasi finali di arricchimento e targeting, ovvero dopo aver EventBridge eseguito o tentato di eseguire una richiesta relativa al servizio di arricchimento o di destinazione specificato e aver ricevuto una risposta. Ciò include le seguenti fasi:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

Per una descrizione delle fasi di esecuzione delle pipe, consulta EventBridge Fasi di esecuzione delle pipe.

Troncare i dati di esecuzione nei record di log di Pipes EventBridge

Se si sceglie di EventBridge includere i dati di esecuzione nei record di registro di una pipe, esiste la possibilità che un record superi il limite di dimensione di 256 KB. Per evitare ciò, tronca EventBridge automaticamente i campi dei dati di esecuzione, nell'ordine seguente. EventBridge tronca completamente ogni campo prima di passare al tronco del campo successivo. EventBridge tronca i dati del campo semplicemente rimuovendo i caratteri dalla fine della stringa di dati; non viene effettuato alcun tentativo di troncare in base all'importanza dei dati e il troncamento invaliderà la formattazione JSON.

• payload

• awsRequest

• awsResponse

Se tronca i campi nell'evento, il campo EventBridge include un elenco dei campi dati troncati. truncatedFields

Segnalazione degli errori nei registri di Pipes EventBridge

EventBridge include anche i dati di errore, ove disponibili, nelle fasi di esecuzione delle pipe che rappresentano gli stati di errore. Queste fasi includono:

• ExecutionThrottled

• ExecutionTimeout

• ExecutionFailed

• ExecutionPartiallyFailed

• EnrichmentTransformationFailed

• EnrichmentInvocationFailed

• EnrichmentStageFailed

• TargetTransformationFailed

• TargetInvocationFailed

• TargetInvocationPartiallyFailed

• TargetStageFailed

• TargetStagePartiallyFailed