# 筛选处理器
<a name="filter-processors"></a>

筛选处理器让您可以根据自己定义的条件，有选择地从管道中删除日志条目。

## drop\$1events 处理器
<a name="drop-events-processor"></a>

根据条件表达式筛选掉不需要的日志条目。使用此处理器可减少来自第三方管道连接器的噪音，并可通过删除符合指定条件的日志事件来降低存储成本。

**配置**  
使用以下参数配置 drop\$1events 处理器：

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

`when`（必需）  
用于确定要删除哪些日志条目的条件表达式。与此表达式匹配的日志条目已从管道中删除。最大长度为 256 个字符。有关表达式语法，请参阅[条件处理的表达式语法](conditional-processing.md)。

`handle_expression_failure`（可选）  
`when` 表达式计算失败时的行为。允许的值：`"skip"`（默认），用于保留事件；或者 `"apply"`，无论是否失败都丢弃事件。

**Example 删除低严重性的日志条目**  
以下配置会删除所有 DEBUG 和 TRACE 日志条目，仅保留严重性较高的事件：  

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