本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 篩選處理器
<a name="filter-processors"></a>

篩選處理器可讓您根據您定義的條件，從管道選擇性地移除日誌項目。

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

根據條件式表達式篩選掉不需要的日誌項目。使用此處理器可移除符合指定條件的日誌事件，以減少第三方管道連接器的雜訊並降低儲存成本。

**Configuration**  
使用下列參數設定 drop\$1events 處理器：

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

`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"
```