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

# Prosesor transformasi
<a name="transformation-processors"></a>

Prosesor transformasi memodifikasi struktur peristiwa log dengan menambahkan, menyalin, memindahkan, atau menghapus bidang.

## prosesor add\_entries
<a name="add-entries-processor"></a>

Menambahkan pasangan kunci-nilai statis untuk mencatat peristiwa. Paling banyak 1 `add_entries` prosesor dapat ditambahkan ke pipa.

**Konfigurasi**  
Konfigurasikan prosesor add\_entries dengan parameter berikut:

```
processor:
  - add_entries:
      entries:
        - key: "environment"
          value: "production"
          overwrite_if_key_exists: false
```Parameter

`entries`(Diperlukan)  
Array pasangan kunci-nilai untuk ditambahkan ke setiap peristiwa log.

`entries[].key`(Diperlukan)  
Nama bidang untuk ditambahkan ke peristiwa log. Mendukung bidang bersarang menggunakan notasi titik.

`entries[].value`(Diperlukan)  
Nilai statis untuk menetapkan ke kunci.

`entries[].overwrite_if_key_exists` (opsional)  
Bendera Boolean yang menentukan perilaku ketika kunci sudah ada. Default ke false.

`when` (opsional)  
Ekspresi kondisional tingkat prosesor. Ketika ditentukan, seluruh prosesor dilewati jika ekspresi dievaluasi menjadi false. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

`entries[].when` (opsional)  
Ekspresi kondisional entry-level. Ketika ditentukan, hanya entri ini yang dilewati jika ekspresi dievaluasi menjadi false. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

`entries[].when_else` (opsional)  
Entri fallback yang dijalankan hanya ketika tidak ada `when` kondisi lain dalam prosesor yang sama yang cocok. Nilai ekspresi mengidentifikasi `when` kondisi mana yang harus dipertimbangkan. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

## prosesor copy\_values
<a name="copy-values-processor"></a>

Menyalin nilai dari satu bidang ke bidang lainnya. Paling banyak 1 `copy_values` prosesor dapat ditambahkan ke pipa.

**Konfigurasi**  
Konfigurasikan prosesor copy\_values dengan parameter berikut:

```
processor:
  - copy_values:
      entries:
        - from_key: "user_id"
          to_key: "backup_user"
          overwrite_if_to_key_exists: false
```Parameter

`entries`(Diperlukan)  
Array operasi salinan untuk dilakukan pada setiap peristiwa log.

`entries[].from_key`(Diperlukan)  
Nama bidang untuk menyalin nilai dari. Menggunakan notasi titik untuk bidang bersarang.

`entries[].to_key`(Diperlukan)  
Nama bidang untuk menyalin nilai ke. Akan membuat struktur bersarang jika menggunakan notasi titik.

`entries[].overwrite_if_to_key_exists` (opsional)  
Boolean flag mengendalikan perilaku saat bidang target sudah ada. Default ke false.

`when` (opsional)  
Ekspresi kondisional tingkat prosesor. Ketika ditentukan, seluruh prosesor dilewati jika ekspresi dievaluasi menjadi false. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

`entries[].when` (opsional)  
Ekspresi kondisional entry-level. Ketika ditentukan, hanya entri ini yang dilewati jika ekspresi dievaluasi menjadi false. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

`entries[].when_else` (opsional)  
Entri fallback yang dijalankan hanya ketika tidak ada `when` kondisi lain dalam prosesor yang sama yang cocok. Nilai ekspresi mengidentifikasi `when` kondisi mana yang harus dipertimbangkan. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

## prosesor delete\_entries
<a name="delete-entries-processor"></a>

Menghapus bidang tertentu dari peristiwa log.

**Konfigurasi**  
Konfigurasikan prosesor delete\_entries dengan parameter berikut:

```
processor:
  - delete_entries:
      with_keys: ["temp_field", "debug_info"]
```Parameter

`with_keys`(Diperlukan)  
Array nama bidang untuk dihapus dari setiap peristiwa log. Mendukung penghapusan bidang bersarang menggunakan notasi titik.

`when` (opsional)  
Ekspresi bersyarat yang menentukan apakah prosesor ini mengeksekusi. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

## prosesor move\_keys
<a name="move-keys-processor"></a>

Memindahkan bidang dari satu lokasi ke lokasi lain.

**Konfigurasi**  
Konfigurasikan prosesor move\_keys dengan parameter berikut:

```
processor:
  - move_keys:
      entries:
        - from_key: "old_field"
          to_key: "new_field"
          overwrite_if_to_key_exists: true
```Parameter

`entries`(Diperlukan)  
Array operasi pemindahan. Maksimal 5 entri.

`entries[].from_key`(Diperlukan)  
Nama bidang sumber. Maksimal 128 karakter.

`entries[].to_key`(Diperlukan)  
Nama bidang target. Maksimal 128 karakter.

`entries[].overwrite_if_to_key_exists` (opsional)  
Apakah akan menimpa bidang target yang ada.

`when` (opsional)  
Ekspresi kondisional tingkat prosesor. Ketika ditentukan, seluruh prosesor dilewati jika ekspresi dievaluasi menjadi false. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

`entries[].when` (opsional)  
Ekspresi kondisional entry-level. Ketika ditentukan, hanya entri ini yang dilewati jika ekspresi dievaluasi menjadi false. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

`entries[].when_else` (opsional)  
Entri fallback yang dijalankan hanya ketika tidak ada `when` kondisi lain dalam prosesor yang sama yang cocok. Nilai ekspresi mengidentifikasi `when` kondisi mana yang harus dipertimbangkan. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).

## prosesor ratakan
<a name="flatten-processor"></a>

Meratakan struktur objek bersarang.

**Konfigurasi**  
Konfigurasikan prosesor ratakan dengan parameter berikut:

```
processor:
  - flatten:
      source: "metadata"
      target: "flattened"
      remove_processed_fields: true
      exclude_keys: ["sensitive_data"]
```Parameter

`source`(Diperlukan)  
Bidang berisi objek bersarang untuk diratakan.

`target`(Diperlukan)  
Awalan bidang target untuk kunci yang diratakan.

`remove_processed_fields` (opsional)  
Apakah akan menghapus bidang bersarang asli setelah diratakan.

`exclude_keys` (opsional)  
Array kunci untuk dikecualikan dari perataan. Maksimal 20 tombol, masing-masing hingga 128 karakter.

`when` (opsional)  
Ekspresi bersyarat yang menentukan apakah prosesor ini mengeksekusi. Panjang maksimum adalah 256 karakter. Lihat [Sintaks ekspresi untuk pemrosesan bersyarat](conditional-processing.md).