View a markdown version of this page

Processori di trasformazione - Amazon CloudWatch

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à.

Processori di trasformazione

I processori di trasformazione modificano la struttura degli eventi di registro aggiungendo, copiando, spostando o rimuovendo campi.

processore add_entries

Aggiunge coppie chiave-valore statiche per registrare gli eventi. È possibile aggiungere al massimo 1 add_entries processore a una pipeline.

Configurazione

Configura il processore add_entries con i seguenti parametri:

processor: - add_entries: entries: - key: "environment" value: "production" overwrite_if_key_exists: false
Parameters
entries(richiesto)

Matrice di coppie chiave-valore da aggiungere a ogni evento di registro.

entries[].key(richiesto)

Il nome del campo da aggiungere all'evento di registro. Supporta campi annidati utilizzando la notazione a punti.

entries[].value(obbligatorio)

Il valore statico da assegnare alla chiave.

entries[].overwrite_if_key_exists (facoltativo)

Bandiera booleana che determina il comportamento quando la chiave esiste già. Il valore predefinito è false (falso).

when (facoltativo)

Espressione condizionale a livello di processore. Quando specificato, l'intero processore viene ignorato se l'espressione restituisce false. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

entries[].when (facoltativo)

Espressione condizionale di livello base. Quando specificata, solo questa voce viene ignorata se l'espressione restituisce false. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

entries[].when_else (facoltativo)

Voce di fallback che viene eseguita solo quando nessuna delle altre when condizioni nello stesso processore soddisfa. Il valore dell'espressione identifica le condizioni da considerare. when La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

processore copy_values

Copia i valori da un campo all'altro. È possibile aggiungere al massimo 1 copy_values processore a una pipeline.

Configurazione

Configura il processore copy_values con i seguenti parametri:

processor: - copy_values: entries: - from_key: "user_id" to_key: "backup_user" overwrite_if_to_key_exists: false
Parameters
entries(richiesto)

Serie di operazioni di copia da eseguire su ogni evento di registro.

entries[].from_key(richiesto)

Il nome del campo da cui copiare il valore. Utilizza la notazione a punti per i campi annidati.

entries[].to_key(obbligatorio)

Il nome del campo in cui copiare il valore. Creerà strutture annidate se si utilizza la notazione a punti.

entries[].overwrite_if_to_key_exists (facoltativo)

La bandiera booleana controlla il comportamento quando il campo di destinazione esiste già. Il valore predefinito è false (falso).

when (facoltativo)

Espressione condizionale a livello di processore. Quando specificato, l'intero processore viene ignorato se l'espressione restituisce false. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

entries[].when (facoltativo)

Espressione condizionale di livello base. Quando specificata, solo questa voce viene ignorata se l'espressione restituisce false. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

entries[].when_else (facoltativo)

Voce di fallback che viene eseguita solo quando nessuna delle altre when condizioni nello stesso processore soddisfa. Il valore dell'espressione identifica le condizioni da considerare. when La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

processore delete_entries

Rimuove i campi specificati dagli eventi di registro.

Configurazione

Configura il processore delete_entries con i seguenti parametri:

processor: - delete_entries: with_keys: ["temp_field", "debug_info"]
Parameters
with_keys(richiesto)

Matrice di nomi di campo da rimuovere da ogni evento di registro. Supporta l'eliminazione di campi annidati utilizzando la notazione a punti.

when (facoltativo)

Espressione condizionale che determina se questo processore viene eseguito. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

processore move_keys

Sposta i campi da una posizione all'altra.

Configurazione

Configura il processore move_keys con i seguenti parametri:

processor: - move_keys: entries: - from_key: "old_field" to_key: "new_field" overwrite_if_to_key_exists: true
Parameters
entries(richiesto)

Una serie di operazioni di spostamento. Massimo 5 iscrizioni.

entries[].from_key(richiesto)

Nome del campo sorgente. Massimo 128 caratteri.

entries[].to_key(richiesto)

Nome del campo di destinazione. Massimo 128 caratteri.

entries[].overwrite_if_to_key_exists (facoltativo)

Se sovrascrivere il campo di destinazione esistente.

when (facoltativo)

Espressione condizionale a livello di processore. Quando specificato, l'intero processore viene ignorato se l'espressione restituisce false. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

entries[].when (facoltativo)

Espressione condizionale di livello base. Quando specificata, solo questa voce viene ignorata se l'espressione restituisce false. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

entries[].when_else (facoltativo)

Voce di fallback che viene eseguita solo quando nessuna delle altre when condizioni nello stesso processore soddisfa. Il valore dell'espressione identifica le condizioni da considerare. when La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.

appiattisci il processore

Appiattisce le strutture degli oggetti annidati.

Configurazione

Configura il processore flatten con i seguenti parametri:

processor: - flatten: source: "metadata" target: "flattened" remove_processed_fields: true exclude_keys: ["sensitive_data"]
Parameters
source(richiesto)

Campo contenente l'oggetto annidato da appiattire.

target(obbligatorio)

Prefisso del campo di destinazione per chiavi appiattite.

remove_processed_fields (facoltativo)

Se rimuovere il campo nidificato originale dopo l'appiattimento.

exclude_keys (facoltativo)

Matrice di chiavi da escludere dall'appiattimento. Massimo 20 tasti, ciascuno con un massimo di 128 caratteri.

when (facoltativo)

Espressione condizionale che determina se questo processore viene eseguito. La lunghezza massima è 256 caratteri. Per informazioni, consulta Sintassi delle espressioni per l'elaborazione condizionale.