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

# Filtra i processori
<a name="filter-processors"></a>

I processori di filtro consentono di rimuovere selettivamente le voci di registro dalla pipeline in base alle condizioni definite.

## processore drop\$1events
<a name="drop-events-processor"></a>

Filtra le voci di registro indesiderate in base a espressioni condizionali. Utilizzate questo processore per ridurre il rumore prodotto dai connettori di pipeline di terze parti e ridurre i costi di archiviazione rimuovendo gli eventi di registro che corrispondono a condizioni specificate.

**Configurazione**  
Configura il processore drop\$1events con i seguenti parametri:

```
processor:
  - drop_events:
      when: "log.level == 'DEBUG' or log.level == 'TRACE'"
```Parameters

`when`(richiesto)  
Espressione condizionale che determina quali voci di registro eliminare. Le voci di registro che corrispondono a questa espressione vengono rimosse dalla pipeline. La lunghezza massima è 256 caratteri. Vedi [Sintassi delle espressioni per l'elaborazione condizionale](conditional-processing.md) per la sintassi delle espressioni.

`handle_expression_failure` (facoltativo)  
Comportamento quando la valutazione dell'`when`espressione fallisce. Valori consentiti: `"skip"` (impostazione predefinita) mantiene l'evento o lo `"apply"` elimina indipendentemente dall'errore.

**Example Elimina le voci di registro a bassa gravità**  
La seguente configurazione elimina tutte le voci di registro DEBUG e TRACE, mantenendo solo gli eventi con gravità più elevata:  

```
processor:
  - drop_events:
      when: "log.level in {'DEBUG', 'TRACE'}"
      handle_expression_failure: "skip"
```