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

# Prosesor manipulasi string
<a name="string-processors"></a>

Prosesor string memodifikasi nilai teks dalam peristiwa log melalui operasi seperti konversi kasus, pemangkasan, dan pencocokan pola.

## prosesor lowercase\$1string
<a name="lowercase-string-processor"></a>

Mengkonversi bidang tertentu ke huruf kecil.

**Konfigurasi**  
Konfigurasikan prosesor lowercase\$1string dengan parameter berikut:

```
processor:
  - lowercase_string:
      with_keys: ["status", "method"]
```Parameter

`with_keys`(Diperlukan)  
Array nama bidang untuk dikonversi ke huruf kecil. Hanya memproses nilai string.

`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 uppercase\$1string
<a name="uppercase-string-processor"></a>

Mengkonversi bidang tertentu ke huruf besar.

**Konfigurasi**  
Konfigurasikan prosesor uppercase\$1string dengan parameter berikut:

```
processor:
  - uppercase_string:
      with_keys: ["status_code", "method"]
```Parameter

`with_keys`(Diperlukan)  
Array nama bidang untuk dikonversi ke huruf besar. Hanya memproses nilai string.

`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 trim\$1string
<a name="trim-string-processor"></a>

Menghapus spasi putih depan dan belakang dari bidang tertentu.

**Konfigurasi**  
Konfigurasikan prosesor trim\$1string dengan parameter berikut:

```
processor:
  - trim_string:
      with_keys: ["message", "user_input"]
```Parameter

`with_keys`(Diperlukan)  
Array nama bidang untuk memangkas spasi dari. Hanya memproses nilai string.

`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 substitute\$1string
<a name="substitute-string-processor"></a>

Melakukan substitusi string menggunakan ekspresi reguler.

**Konfigurasi**  
Konfigurasikan prosesor substitute\$1string dengan parameter berikut:

```
processor:
  - substitute_string:
      entries:
        - source: "message"
          from: "ERROR"
          to: "WARN"
```Parameter

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

`entries[].source`(diperlukan)  
Bidang untuk melakukan substitusi string pada.

`entries[].from`(diperlukan)  
Pola ekspresi reguler untuk mencocokkan dan mengganti.

`entries[].to`(diperlukan)  
String pengganti untuk pola yang cocok.

`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 truncate
<a name="truncate-processor"></a>

Memotong nilai bidang ke panjang yang ditentukan.

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

```
processor:
  - truncate:
      source_keys: ["message", "description"]
      length: 100
      start_at: 0
```Parameter

`source_keys`(diperlukan)  
Array nama bidang untuk dipotong. Setiap nama bidang maksimum 128 karakter.

`length` (opsional)  
Panjang maksimum setelah pemotongan. Rentang: 1-8192.

`start_at` (opsional)  
Posisi awal untuk pemotongan. Rentang: 0-8192. Default ke 0.

`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 extract\$1value
<a name="extract-value-processor"></a>

Mengekstrak nilai menggunakan ekspresi reguler.

**Konfigurasi**  
Konfigurasikan prosesor extract\$1value dengan parameter berikut:

```
processor:
  - extract_value:
      entries:
        - source: "message"
          target: "extracted_data"
          from: "user=(?<user>\\w+)"
          to: "${user}"
          target_type: "string"
```Parameter

`entries`(diperlukan)  
Array operasi ekstraksi. Maksimal 20 entri.

`entries[].source`(diperlukan)  
Bidang untuk mengekstrak dari. Maksimal 128 karakter.

`entries[].target`(diperlukan)  
Bidang target untuk nilai yang diekstraksi. Maksimal 128 karakter.

`entries[].from`(diperlukan)  
Pola ekspresi reguler. Maksimal 128 karakter.

`entries[].to`(diperlukan)  
Pola penggantian dengan grup penangkapan. Maksimal 128 karakter.

`entries[].target_type` (opsional)  
Jenis data target (“integer”, “double”, “string”, “boolean”).

`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 convert\$1entry\$1type
<a name="convert-entry-type-processor"></a>

Mengkonversi nilai bidang antara tipe data yang berbeda.

**Konfigurasi**  
Konfigurasikan prosesor convert\$1entry\$1type dengan parameter berikut:

```
processor:
  - convert_entry_type:
      key: "count"
      type: "integer"
```Parameter

`key`(diperlukan)  
Nama bidang tunggal untuk dikonversi.

`type`(diperlukan)  
Jenis data target. Opsi: “bilangan bulat”, “ganda”, “string”, “boolean”.

`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 tanggal
<a name="date-processor"></a>

Parses dan format date/time bidang.

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

```
processor:
  - date:
      match:
        - key: "timestamp"
          patterns: ["yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'"]
      destination: "@timestamp"
      source_timezone: "UTC"
      destination_timezone: "America/New_York"
```Parameter

`match`(diperlukan)  
Array konfigurasi pencocokan tanggal. Maksimal 10 entri.

`match[].key`(diperlukan)  
Bidang yang berisi string tanggal. Maksimal 128 karakter.

`match[].patterns`(diperlukan)  
Array pola format tanggal untuk dicoba. Maksimal 5 pola, masing-masing hingga 256 karakter.

`destination` (opsional)  
Bidang target tunggal untuk semua tanggal yang diuraikan. Maksimal 128 karakter.

`source_timezone` (opsional)  
Zona waktu sumber untuk penguraian.

`destination_timezone` (opsional)  
Target zona waktu untuk output.

`output_format` (opsional)  
Format tanggal keluaran. Maksimal 64 karakter.

`destination_type` (opsional)  
Jenis keluaran - “timestampz”, “long”, atau “string”.

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

## membedah prosesor
<a name="dissect-processor"></a>

Mengekstrak data terstruktur menggunakan pencocokan pola.

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

```
processor:
  - dissect:
      map:
        message: "%{timestamp} %{level}"
```Parameter

`map`(diperlukan)  
Pemetaan lapangan dengan pola bedah.

`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 list\$1to\$1map
<a name="list-to-map-processor"></a>

Mengkonversi bidang array untuk memetakan struktur.

**Konfigurasi**  
Konfigurasikan prosesor list\$1to\$1map dengan parameter berikut:

```
processor:
  - list_to_map:
      source: "tags"
      key: "name"
      value_key: "value"
      target: "tag_map"
```Parameter

`source`(diperlukan)  
Bidang yang berisi data array. Maksimal 128 karakter.

`key`(diperlukan)  
Nama bidang untuk digunakan sebagai kunci peta. Maksimal 128 karakter.

`value_key` (opsional)  
Nama bidang untuk digunakan sebagai nilai peta. Maksimal 128 karakter.

`target` (opsional)  
Bidang target untuk struktur peta. Maksimal 128 karakter.

`flatten` (opsional)  
Apakah akan meratakan peta yang dihasilkan.

`flattened_element` (opsional)  
Elemen mana yang digunakan saat meratakan (“pertama” atau “terakhir”).

`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 rename\$1keys
<a name="rename-keys-processor"></a>

Mengganti nama bidang dalam peristiwa log.

**Konfigurasi**  
Konfigurasikan prosesor rename\$1keys dengan parameter berikut:

```
processor:
  - rename_keys:
      entries:
        - from_key: "old_name"
          to_key: "new_name"
          overwrite_if_to_key_exists: true
```Parameter

`entries`(diperlukan)  
Array operasi ganti nama. Maksimal 5 entri.

`entries[].from_key`(diperlukan)  
Nama bidang saat ini. Maksimal 128 karakter.

`entries[].to_key`(diperlukan)  
Nama bidang baru. 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 select\$1entries
<a name="select-entries-processor"></a>

Memilih hanya bidang tertentu dari peristiwa.

**Konfigurasi**  
Konfigurasikan prosesor select\$1entries dengan parameter berikut:

```
processor:
  - select_entries:
      include_keys: ["timestamp", "level", "message"]
```Parameter

`include_keys`(diperlukan)  
Array nama bidang yang harus disimpan. Maksimal 50 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).

## menerjemahkan prosesor
<a name="translate-processor"></a>

Menerjemahkan nilai bidang menggunakan tabel pencarian.

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

```
processor:
  - translate:
      mappings:
        - source: "status_code"
          targets:
            - target: "status_text"
              map:
                "200": "OK"
                "404": "Not Found"
```Parameter

`mappings`(diperlukan)  
Array konfigurasi terjemahan. Maksimal 10 pemetaan.

`mappings[].source`(diperlukan)  
Bidang untuk menerjemahkan. Maksimal 128 karakter.

`mappings[].targets`(diperlukan)  
Array konfigurasi target. Maksimal 10 target.

`mappings[].targets[].target`(diperlukan)  
Nama bidang target. Maksimal 128 karakter.

`mappings[].targets[].map`(diperlukan)  
Pemetaan terjemahan. Maksimum 100 entri, masing-masing bernilai hingga 512 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).