# Processadores de filtros


Os processadores de filtros permitem que você remova seletivamente as entradas de logs do pipeline com base nas condições definidas por você.

## processador drop\$1events


Filtra entradas de logs indesejadas com base em expressões condicionais. Use esse processador para reduzir o ruído de conectores de pipeline de terceiros e os custos de armazenamento removendo eventos de logs que correspondam às condições especificadas.

**Configuração**  
Configure o processador drop\$1events com os seguintes parâmetros:

```
processor:
  - drop_events:
      when: "log.level == 'DEBUG' or log.level == 'TRACE'"
```Parâmetros

`when` (obrigatório)  
Expressão condicional que determina quais entradas de logs devem ser descartadas. As entradas de logs correspondentes a essa expressão são removidas do pipeline. O tamanho máximo é de 256 caracteres. Consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md) para obter a sintaxe da expressão.

`handle_expression_failure` (opcional)  
Comportamento quando a avaliação da expressão `when` falha. Valores permitidos: `"skip"` (padrão) mantém o evento ou `"apply"` descarta o evento, independentemente da falha.

**Example Descartar entradas de logs de baixa gravidade**  
A seguinte configuração descarta todas as entradas de logs DEBUG e TRACE, mantendo somente eventos de maior gravidade:  

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