Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat dan kelola trafo log
Trafo log mencakup satu atau lebih *prosesor* yang berada dalam pipa logis bersama-sama. Setiap prosesor diterapkan ke peristiwa log, satu demi satu dalam urutan yang tercantum dalam konfigurasi transformator.
Beberapa prosesor adalah tipe *parser*. Setiap transformator harus memiliki setidaknya satu parser, dan prosesor pertama dalam transformator harus berupa parser.
Beberapa parser adalah parser bawaan yang dikonfigurasi untuk jenis log AWS vended tertentu.
Jenis prosesor lainnya adalah mutator string, mutator JSON, dan prosesor data.
Anda dapat membuat transformer untuk grup log individual, dan Anda juga dapat membuat transformator tingkat akun yang berlaku untuk semua atau banyak grup log di akun Anda. Jika grup log memiliki transformator tingkat grup log, transformator tersebut akan mengganti transformator tingkat akun apa pun yang akan berlaku untuk grup log tersebut. Anda dapat memiliki sebanyak 20 trafo tingkat akun di Wilayah di akun Anda.
Anda harus mengikuti panduan ini saat membuat transformator:
+ Jika Anda menyertakan parser pra-konfigurasi untuk jenis log AWS vended, itu harus menjadi prosesor pertama yang tercantum dalam transformator. Anda hanya dapat memasukkan satu prosesor seperti itu ke dalam transformator.
+ Anda hanya dapat memasukkan satu `grok` prosesor dalam transformator.
+ Anda harus memiliki setidaknya satu prosesor tipe parser dalam transformator. Anda dapat menyertakan sebanyak lima prosesor tipe parser. Batas lima ini mencakup parser bawaan dan parser yang dapat dikonfigurasi.
+ Anda dapat memiliki sebanyak 20 prosesor dalam transformator.
+ Anda hanya dapat menyertakan satu prosesor **AddKeys** dalam transformator.
+ Anda hanya dapat menyertakan satu prosesor **CopyValue** dalam transformator.
+ Setiap transformator dapat mengekstrak hingga 200 bidang dari peristiwa log.
+ Setiap peristiwa log **HARUS** di bawah 512KB. Ukuran total peristiwa log masih bisa melebihi 512KB.
**Topics**
+ [Buat kebijakan transformator tingkat akun](CloudWatchLogs-Transformer-CreateAccountLevel.md)
+ [Mengedit atau menghapus kebijakan transformator tingkat akun](CloudWatchLogs-Transformer-EditAccountLevel.md)
+ [Buat transformator log-group-level log dari awal](CloudWatch-Logs-Transformation-CreateNew.md)
+ [Buat log-group-level transformator dengan menyalin yang sudah ada](CloudWatch-Logs-Transformation-Copy.md)
+ [Edit log-group-level transformator](CloudWatch-Logs-Transformation-Edit.md)
+ [Hapus log-group-level transformator](CloudWatch-Logs-Transformation-Delete.md)
# Buat kebijakan transformator tingkat akun
Gunakan langkah-langkah di bagian ini untuk membuat kebijakan transformator yang berlaku untuk semua grup log di akun, atau ke beberapa grup log yang memiliki nama grup log yang dimulai dengan string (awalan) yang sama. Anda dapat memiliki sebanyak 20 kebijakan transformator tingkat akun di suatu Wilayah.
Anda tidak dapat membuat dua kebijakan transformator di Wilayah yang sama yang menggunakan awalan yang sama atau memiliki satu awalan di dalam yang lain. Misalnya, jika Anda membuat satu kebijakan transformator untuk awalan string`/aws/lambda`, Anda tidak dapat membuat yang lain dengan awalan`/aws`. Tapi Anda bisa memiliki satu transformator untuk `/aws/lambda` dan satu lagi untuk `/aws/waf`
**Untuk membuat kebijakan transformator tingkat akun**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi kiri, pilih **Pengaturan** dan kemudian pilih tab **Log**.
1. Di bagian **Kebijakan Transformer untuk akun**, pilih **Buat kebijakan transformator**.
1. Untuk **nama kebijakan Transformer**, masukkan nama untuk poiicy baru Anda.
1. Untuk **Pilih grup log**, lakukan salah satu hal berikut:
+ Pilih **Semua grup log standar** agar kebijakan transformator berlaku untuk semua grup log Kelas Standar di akun.
+ pilih **Grup log menurut awalan yang cocok** untuk menerapkan kebijakan ke subset grup log yang semuanya memiliki nama yang dimulai dengan string yang sama. Kemudian, masukkan awalan untuk grup log ini di **Kriteria pemilihan**.
1. Di area **Select parsers**, gunakan **Parser untuk memilih parser** yang akan disertakan dalam transformator Anda.
Jika ini adalah parser pra-konfigurasi untuk jenis log AWS vended, Anda tidak perlu menentukan konfigurasi apa pun untuknya.
Jika itu adalah parser yang berbeda, Anda perlu menentukan konfigurasinya. Untuk informasi selengkapnya, lihat informasi untuk prosesor tersebut di[Prosesor tipe parser yang dapat dikonfigurasi](CloudWatch-Logs-Transformation-Configurable.md).
1. Untuk menambahkan prosesor lain, pilih **Pilih prosesor**. Kemudian pilih prosesor yang Anda inginkan di kotak **Prosesor**, dan isi parameter konfigurasi.
Ingat bahwa prosesor beroperasi pada peristiwa log dalam urutan yang Anda tambahkan ke transformator.
1. (Opsional) Untuk menambahkan prosesor tambahan, pilih **\$1 Prosesor** dan ulangi langkah sebelumnya.
1. (Opsional) Kapan saja, Anda dapat menguji transformator yang telah Anda buat sejauh ini pada peristiwa log sampel. Untuk melakukannya, lakukan salah satu hal berikut di bagian **pratinjau Transformer**:
+ Pilih sebanyak lima grup log di **Pilih grup log** dan kemudian pilih **Muat peristiwa log terbaru**. Kemudian pilih **Test transformator**.
+ Salin peristiwa log langsung ke **peristiwa log Contoh** dan kemudian pilih **Transformator uji**.
Versi log yang diubah kemudian muncul.
1. Setelah selesai menambahkan prosesor dan puas dengan pengujian pada log sampel, pilih **Simpan**.
1. Setelah selesai, pilih **Buat**.
# Mengedit atau menghapus kebijakan transformator tingkat akun
Gunakan langkah-langkah di bagian ini untuk mengedit atau menghapus kebijakan transformator tingkat akun.
**Untuk mengedit atau menghapus kebijakan transformator tingkat akun**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi kiri, pilih **Pengaturan** dan kemudian pilih tab **Log**.
1. Di bagian **Kebijakan akun Transformer**, pilih **Kelola**.
1. Pilih tombol berdasarkan kebijakan transformator yang ingin Anda kelola, lalu pilih **Edit** atau **Hapus**.
Jika Anda mengedit kebijakan, lihat langkah 5-11 [Prosesor tipe parser yang dapat dikonfigurasi](CloudWatch-Logs-Transformation-Configurable.md) untuk melihat opsi Anda.
# Buat transformator log-group-level log dari awal
Gunakan langkah-langkah ini untuk membuat log-group-level transformator dari awal.
**Untuk menggunakan konsol untuk membuat transformator log untuk grup log**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih **Log**, **Grup log**.
1. Pilih grup log yang ingin Anda buat transformator.
1. Pilih tab **Transformer**. Anda mungkin harus menggulir daftar tab ke kanan untuk melihatnya.
1. Pilih **Buat transformator**.
1. Dalam kotak **Pilih parser**, pilih parser untuk disertakan dalam transformator Anda.
Jika ini adalah parser pra-konfigurasi untuk jenis log AWS vended, Anda tidak perlu menentukan konfigurasi apa pun untuknya.
Jika itu adalah parser yang berbeda, Anda perlu menentukan konfigurasinya. Untuk informasi selengkapnya, lihat informasi untuk prosesor tersebut di[Prosesor tipe parser yang dapat dikonfigurasi](CloudWatch-Logs-Transformation-Configurable.md).
1. Untuk menambahkan prosesor lain, pilih **\$1 Tambahkan prosesor**. Kemudian pilih prosesor yang Anda inginkan di kotak **Pilih prosesor**, dan isi parameter konfigurasi.
Ingat bahwa prosesor beroperasi pada peristiwa log dalam urutan yang Anda tambahkan ke transformator.
1. (Opsional) Kapan saja, Anda dapat menguji transformator yang telah Anda buat sejauh ini pada peristiwa log sampel. Untuk melakukan hal itu, lakukan hal berikut:
1. Di bagian **pratinjau Transformasi**, pilih **Muat log sampel** untuk memuat peristiwa log sampel dari grup log tempat transformator ini digunakan, atau tempelkan peristiwa log ke dalam kotak teks.
Pilih **Trafo uji**. Versi log yang diubah muncul
1. Setelah selesai menambahkan prosesor dan puas dengan pengujian pada log sampel, pilih **Simpan**.
**Untuk menggunakan AWS CLI untuk membuat transformator log dari awal**
+ Gunakan perintah `aws logs put-transformer`. Saat menggunakan `parseJSON` sebagai prosesor pertama, Anda harus mengurai seluruh peristiwa log menggunakan `@message` sebagai bidang sumber. Setelah penguraian JSON awal, Anda kemudian dapat memanipulasi bidang tertentu di prosesor berikutnya. Berikut ini adalah contoh yang menciptakan transformator yang mencakup `parseJSON` dan `addKeys` prosesor:
```
aws logs put-transformer \
--transformer-config '[{"parseJSON":{"source":"@message"}},{"addKeys":{"entries":[{"key":"metadata.transformed_in","value":"CloudWatchLogs"},{"key":"feature","value":"Transformation"}]}},{"trimString":{"withKeys":["status"]}}]' \
--log-group-identifier my-log-group-name
```
# Buat log-group-level transformator dengan menyalin yang sudah ada
Anda dapat menggunakan konsol untuk menyalin konfigurasi JSON dari transformator yang ada. Anda kemudian dapat menggunakan kode itu untuk membuat transformator identik dengan menggunakan AWS CLI, atau Anda dapat memodifikasi konfigurasi terlebih dahulu.
**Untuk membuat transformator log dengan menyalin yang sudah ada**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih **Log**, **Grup log**.
1. Pilih grup log yang memiliki transformator yang ingin Anda salin.
1. Pilih tab **Transformasi**. Anda mungkin harus menggulir daftar tab ke kanan untuk melihatnya.
1. Pilih **Kelola transformator**.
1. Pilih **Salin transformator**. Ini menyalin transformator JSON ke clipboard Anda.
1. Buat file dan tempel dalam konfigurasi transformator. Dalam contoh ini kita akan memanggil file `CopiedTransformer.json`
1. Gunakan AWS CLI untuk membuat transformator baru dengan konfigurasi itu.
```
aws logs put-transformer --log-group-identifier my-log-group-name \
--transformer-config file://CopiedTransformer.json
```
# Edit log-group-level transformator
Gunakan langkah-langkah ini untuk mengedit transformator log yang ada.
**Untuk mengedit transformator log**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih **Log**, **Grup log**.
1. Pilih grup log yang memiliki transformator yang ingin Anda edit.
1. Pilih tab **Transformasi**. Anda mungkin harus menggulir daftar tab ke kanan untuk melihatnya.
1. Pilih **Kelola transformator**.
1. Di bagian **Parser** dan **Prosesor**, buat perubahan Anda.
1. Untuk menambahkan prosesor lain, pilih **\$1 Tambah Prosesor**. Kemudian pilih prosesor yang Anda inginkan di kotak **Prosesor**, dan isi parameter konfigurasi.
Ingat bahwa prosesor beroperasi pada peristiwa log dalam urutan yang Anda tambahkan ke transformator.
1. (Opsional) Kapan saja, Anda dapat menguji transformator yang telah Anda buat sejauh ini pada peristiwa log sampel. Untuk melakukan hal itu, lakukan hal berikut:
1. Di bagian **Pratinjau Transformasi**, pilih **Muat Log Sampel** untuk memuat peristiwa log sampel dari grup log tempat transformator ini digunakan, atau tempelkan peristiwa log ke dalam kotak teks.
Pilih **Test Transformation**. Versi log yang diubah muncul
1. Setelah selesai menambahkan prosesor dan puas dengan pengujian pada log sampel, pilih **Simpan**.
# Hapus log-group-level transformator
Gunakan langkah-langkah ini untuk menghapus transformator log.
**Untuk menghapus transformator log**
1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih **Log**, **Grup log**.
1. Pilih grup log yang memiliki transformator yang ingin Anda edit.
1. Pilih tab **Transformasi**. Anda mungkin harus menggulir daftar tab ke kanan untuk melihatnya.
1. Pilih **Hapus**.
1. Di kotak konfirmasi, pilih **Hapus Kebijakan**.