Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Prosesor filter
<a name="filter-processors"></a>

Prosesor filter memungkinkan Anda menghapus entri log secara selektif dari pipeline berdasarkan kondisi yang Anda tentukan.

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

Memfilter entri log yang tidak diinginkan berdasarkan ekspresi bersyarat. Gunakan prosesor ini untuk mengurangi kebisingan dari konektor pipa pihak ketiga dan menurunkan biaya penyimpanan dengan menghapus peristiwa log yang sesuai dengan kondisi tertentu.

**Konfigurasi**  
Konfigurasikan prosesor drop\$1events dengan parameter berikut:

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

`when`(diperlukan)  
Ekspresi bersyarat yang menentukan entri log mana yang akan dijatuhkan. Entri log yang cocok dengan ekspresi ini dihapus dari pipeline. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md) sintaks ekspresi.

`handle_expression_failure` (opsional)  
Perilaku ketika evaluasi `when` ekspresi gagal. Nilai yang diizinkan: `"skip"` (default) menyimpan acara, atau `"apply"` menjatuhkan acara terlepas dari kegagalannya.

**Example Jatuhkan entri log tingkat keparahan rendah**  
Konfigurasi berikut menghapus semua entri log DEBUG dan TRACE, hanya menyimpan peristiwa dengan tingkat keparahan yang lebih tinggi:  

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