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\$1entries
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\$1entries 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](conditional-processing.md).
`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](conditional-processing.md).
`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](conditional-processing.md).
## processore copy\$1values
Copia i valori da un campo all'altro. È possibile aggiungere al massimo 1 `copy_values` processore a una pipeline.
**Configurazione**
Configura il processore copy\$1values 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](conditional-processing.md).
`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](conditional-processing.md).
`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](conditional-processing.md).
## processore delete\$1entries
Rimuove i campi specificati dagli eventi di registro.
**Configurazione**
Configura il processore delete\$1entries 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](conditional-processing.md).
## processore move\$1keys
Sposta i campi da una posizione all'altra.
**Configurazione**
Configura il processore move\$1keys 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](conditional-processing.md).
`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](conditional-processing.md).
`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](conditional-processing.md).
## 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](conditional-processing.md).