

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

# Membuat aturan Contributor Insights di CloudWatch
<a name="ContributorInsights-CreateRule"></a>

Anda dapat membuat aturan untuk menganalisis data log. Setiap log dalam JSON atau Format Catatan Umum (CLF) dapat dievaluasi. Ini termasuk log kustom Anda yang mengikuti salah satu format dan log ini dari AWS layanan seperti log aliran VPC Amazon, log kueri DNS Amazon Route 53, log kontainer Amazon ECS, dan log dari, AWS CloudTrail Amazon AI, Amazon RDS SageMaker , dan API Gateway. AWS AppSync 

Pada aturan, ketika Anda menentukan nama atau nilai bidang, semua pencocokan peka huruf besar dan kecil.

Anda dapat menggunakan aturan sampel bawaan ketika membuat aturan atau Anda dapat membuat aturan sendiri dari awal. Wawasan Kontributor mencakup aturan sampel untuk jenis log berikut:
+ Log Amazon API Gateway
+ Log kueri DNS publik Amazon Route 53
+ Log kueri Amazon Route 53 Resolver
+ CloudWatch Log Wawasan Kontainer
+ Log alur VPC

Jika Anda masuk ke akun yang disiapkan sebagai akun pemantauan dalam pengamatan CloudWatch lintas akun, Anda dapat membuat aturan Wawasan Kontributor untuk grup log di akun sumber yang ditautkan ke akun pemantauan ini, selain membuat aturan untuk grup log di akun pemantauan. Anda juga dapat membuat aturan tunggal yang memantau grup log di akun yang berbeda. Untuk informasi selengkapnya, lihat [CloudWatch observabilitas lintas akun](CloudWatch-Unified-Cross-Account.md).

**penting**  
Saat Anda memberikan `cloudwatch:PutInsightRule` izin kepada pengguna, secara default pengguna tersebut dapat membuat aturan yang mengevaluasi grup log apa pun di CloudWatch Log. Anda dapat menambahkan ketentuan kebijakan IAM yang membatasi izin ini agar pengguna dapat menyertakan dan mengecualikan grup log tertentu. Untuk informasi selengkapnya, lihat [Menggunakan kunci syarat untuk membatasi akses pengguna Wawasan Kontributor ke grup log](iam-cw-condition-keys-contributor.md).

**Untuk membuat aturan menggunakan aturan sampel bawaan**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Di panel navigasi, pilih **Log**, Wawasan **Kontributor**.

1. Pilih **Buat aturan**.

   

1.  Untuk **Pilih grup log**, pilih satu grup log (atau beberapa grup log) yang Anda ingin pantau aturannya. Anda dapat memilih sebanyak 20 grup log. Jika Anda masuk ke akun pemantauan yang disiapkan untuk pengamatan CloudWatch lintas akun, Anda dapat memilih grup log di akun sumber, dan Anda juga dapat mengatur satu aturan untuk menganalisis grup log di akun yang berbeda. 

   1.  (Opsional) Untuk memilih semua grup log yang memiliki nama yang dimulai dengan string tertentu, pilih **Pilih berdasarkan kecocokan awalan**, lalu masukkan awalan. Jika ini adalah akun pemantauan, Anda dapat memilih akun yang akan dicari secara opsional, jika tidak semua akun dipilih. 
**catatan**  
 Anda akan dikenakan biaya untuk setiap peristiwa log yang sesuai dengan aturan Anda. Jika Anda memilih menu geser-turun **Pilih berdasarkan kecocokan awalan**, maka Anda harus mengetahui seberapa banyak grup log yang dapat dicocokkan oleh awalan tersebut. Jika Anda mencari lebih banyak grup log dari yang Anda inginkan, maka Anda mungkin akan dikenakan biaya tak terduga. Untuk informasi selengkapnya, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing). 

1. Untuk **jenis Aturan**, pilih **Aturan sampel**. Kemudian pilih **Pilih aturan sampel** dan pilih aturan.

1. Untuk **format Log**, pilih format log yang akan dievaluasi aturan.

1. [Untuk **Transformers**, pilih **Aktifkan wawasan kontributor pada transformator** agar aturan mengevaluasi peristiwa log setelah diubah oleh transformasi log Log. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html.html) Jika Anda memilih untuk mengaktifkan ini:
   + Jika aturan mengevaluasi setiap grup log yang memiliki transformer, aturan diterapkan pada versi log yang diubah.
   + Jika aturan mengevaluasi grup log yang tidak memiliki transformer, aturan diterapkan ke versi asli log.

   Jika Anda tidak memilih ini, evaluasi akan terjadi pada peristiwa log asli di semua grup log, bahkan yang menggunakan transformasi log. 
**catatan**  
Jika grup log memiliki transformator, dan transformasi gagal untuk beberapa peristiwa log, peristiwa log tersebut tidak akan dievaluasi oleh Contributor Insights. Untuk informasi tentang menyelidiki kegagalan transformasi log, lihat [Metrik dan kesalahan transformasi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Transformation-Errors-Metrics.html).

1.  Aturan sampel yang Anda pilih telah mengisi bidang **format Log**, **Kontribusi**, **Filter**, dan **Agregasi**. Anda dapat menyesuaikan nilai tersebut, jika Anda mau. 

1. Pilih **Berikutnya**.

1. Untuk **Nama aturan**, masukkan nama. Karakter yang valid adalah A-Z, a-z, 0-9, (tanda hubung), (garis bawah), dan (titik).

1. Pilih apakah membuat aturan dalam status dinonaktifkan atau diaktifkan. Jika Anda memilih untuk mengaktifkannya, aturan segera mulai menganalisis data Anda. Anda mengeluarkan biaya ketika menjalankan aturan yang diaktifkan. Untuk informasi selengkapnya, lihat [Penentuan Harga CloudWatch Amazon](https://aws.amazon.com/cloudwatch/pricing/).

   Wawasan Kontributor hanya menganalisis peristiwa log baru setelah aturan dibuat. Aturan tidak dapat memproses peristiwa log yang sebelumnya diproses oleh CloudWatch Log.

1. (Opsional) Untuk **Tag**, tambahkan satu atau beberapa pasangan nilai kunci sebagai tag untuk aturan ini. Tag dapat membantu Anda mengidentifikasi dan mengatur AWS sumber daya Anda dan melacak AWS biaya Anda. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon CloudWatch Anda](CloudWatch-Tagging.md).

1. Pilih **Buat**.

**Untuk membuat aturan dari awal**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Di panel navigasi, pilih **Log**, Wawasan **Kontributor**.

1. Pilih **Buat aturan**.

   

1.  Untuk **Pilih grup log**, pilih satu grup log (atau beberapa grup log) yang Anda ingin pantau aturannya. Anda dapat memilih sebanyak 20 grup log. Jika Anda masuk ke akun pemantauan yang disiapkan untuk pengamatan CloudWatch lintas akun, Anda dapat memilih grup log di akun sumber, dan Anda juga dapat mengatur satu aturan untuk menganalisis grup log di akun yang berbeda. 

   1.  (Opsional) Untuk memilih semua grup log yang memiliki nama yang dimulai dengan string tertentu, pilih **Pilih berdasarkan kecocokan awalan**, lalu masukkan awalan. 
**catatan**  
 Anda akan dikenakan biaya untuk setiap peristiwa log yang sesuai dengan aturan Anda. Jika Anda memilih menu geser-turun **Pilih berdasarkan kecocokan awalan**, maka Anda harus mengetahui seberapa banyak grup log yang dapat dicocokkan oleh awalan tersebut. Jika Anda mencari lebih banyak grup log dari yang Anda inginkan, maka Anda mungkin akan dikenakan biaya tak terduga. Untuk informasi selengkapnya, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing). 

1. Untuk **Jenis aturan**, pilih **Aturan kustom**.

1. Untuk **Format log**, pilih **JSON** atau **CLF**.

1. [Untuk **Transformers**, pilih **Aktifkan wawasan kontributor pada transformator** agar aturan mengevaluasi peristiwa log setelah diubah oleh transformasi log Log. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html.html) Jika Anda memilih untuk mengaktifkan ini:
   + Jika aturan mengevaluasi setiap grup log yang memiliki transformer, aturan diterapkan pada versi log yang diubah.
   + Jika aturan mengevaluasi grup log yang tidak memiliki transformer, aturan diterapkan ke versi asli log.

   Jika Anda tidak memilih ini, evaluasi akan terjadi pada peristiwa log asli di semua grup log, bahkan yang menggunakan transformasi log. 
**catatan**  
Jika grup log memiliki transformator, dan transformasi gagal untuk beberapa peristiwa log, peristiwa log tersebut tidak akan dievaluasi oleh Contributor Insights. Untuk informasi tentang menyelidiki kegagalan transformasi log, lihat [Metrik dan kesalahan transformasi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Transformation-Errors-Metrics.html).

1. Anda dapat menyelesaikan pembuatan aturan dengan menggunakan pemandu atau dengan memilih tab **Sintaks** dan menentukan sintaksis aturan secara manual.

   Untuk melanjutkan menggunakan pemandu, lakukan hal berikut:

   1. Untuk **Kontribusi**, **Kunci**, masukkan jenis kontributor yang ingin Anda laporkan. Laporan menampilkan nilai N teratas untuk jenis kontributor ini.

      Catatan yang benar adalah setiap bidang log yang memiliki nilai. Contohnya termasuk **requestId**, **sourceIPaddress**, dan **containerID**.

      Untuk informasi tentang temuan nama bidang log untuk log di grup log tertentu, silakan lihat [Kolom log temuan](#finding_log_fields).

      Kunci yang lebih besar dari 1 KB dipotong menjadi 1KB.

   1. (Opsional) Pilih **Tambahkan tombol baru** untuk menambahkan lebih banyak tombol. Anda dapat memasukkan sebanyak mungkin empat kunci dalam aturan. Jika Anda memasukkan lebih dari satu kunci, kontributor dalam laporan ditentukan oleh kombinasi nilai unik kunci. Sebagai contoh, jika Anda menentukan tiga kunci, setiap kombinasi nilai unik untuk tiga kunci tersebut dihitung sebagai kontributor unik.

   1. (Opsional) Jika Anda ingin menambahkan filter yang mempersempit cakupan hasil Anda, pilih **Tambahkan filter**. Untuk **Kecocokan**, masukkan nama bidang log yang ingin Anda saring. Untuk **Kondisi**, pilih operator perbandingan, dan masukkan nilai yang ingin Anda saring. 

      Anda dapat menambahkan sebanyak mungkin empat filter dalam aturan. Beberapa penyaring digabungkan oleh logika DAN, sehingga hanya peristiwa log yang cocok dengan semua penyaring yang dievaluasi.
**catatan**  
Array yang mengikuti operator perbandingan, seperti`In`, `NotIn`, atau`StartsWith`, dapat mencakup sebanyak 10 nilai string. Untuk informasi selengkapnya tentang sintaks aturan Wawasan Kontributor, silakan lihat [Sintaks aturan Contributor Insights di CloudWatch](ContributorInsights-RuleSyntax.md).

   1. Untuk **melakukan Agregat**, pilih **Hitung** atau **Jumlah**. Memilih **Hitung** menyebabkan peringkat kontributor didasarkan pada jumlah kejadian. Memilih **Jumlah** menyebabkan peringkat didasarkan pada jumlah agregat dari nilai bidang yang Anda tentukan untuk **Kontribusi**, **Nilai**.

1. Untuk memasukkan aturan Anda sebagai objek JSON alih-alih menggunakan pemandu, lakukan hal berikut:

   1. Pilih tab **Sintaks**.

   1. Di **Badan aturan**, masukkan objek JSON untuk aturan Anda. Untuk informasi tentang sintaks aturan, silakan lihat [Sintaks aturan Contributor Insights di CloudWatch](ContributorInsights-RuleSyntax.md). 

1. Pilih **Berikutnya**.

1. Untuk **Nama aturan**, masukkan nama. Karakter yang benar adalah A-Z, a-z, 0-9, "-", "\_', dan ".".

1. Pilih apakah membuat aturan dalam status dinonaktifkan atau diaktifkan. Jika Anda memilih untuk mengaktifkannya, aturan segera mulai menganalisis data Anda. Anda mengeluarkan biaya ketika menjalankan aturan yang diaktifkan. Untuk informasi selengkapnya, lihat [Penentuan Harga CloudWatch Amazon](https://aws.amazon.com/cloudwatch/pricing/).

   Wawasan Kontributor hanya menganalisis peristiwa log baru setelah aturan dibuat. Aturan tidak dapat memproses peristiwa log yang sebelumnya diproses oleh CloudWatch Log.

1. (Opsional) Untuk **Tag**, tambahkan satu atau beberapa pasangan nilai kunci sebagai tag untuk aturan ini. Tag dapat membantu Anda mengidentifikasi dan mengatur AWS sumber daya Anda dan melacak AWS biaya Anda. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon CloudWatch Anda](CloudWatch-Tagging.md).

1. Pilih **Berikutnya**.

1. Konfirmasikan pengaturan yang Anda masukkan, dan pilih **Buat aturan**.

Anda dapat menonaktifkan, mengaktifkan, atau menghapus aturan yang telah Anda buat.

**Untuk mengaktifkan, menonaktifkan, atau menghapus aturan di Wawasan Kontributor**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Di panel navigasi, pilih **Log**, Wawasan **Kontributor**.

1. Dalam daftar aturan, pilih kotak centang di samping aturan tunggal.

   Aturan bawaan dibuat oleh AWS layanan dan tidak dapat diedit, dinonaktifkan, atau dihapus.

1. Pilih **Tindakan**, dan kemudian pilih pilihan yang Anda inginkan.<a name="finding_log_fields"></a>

**Menemukan bidang log**

Ketika membuat aturan, Anda perlu mengetahui nama bidang pada pencatatan log dalam grup log.

**Cara menemukan bidang log di sebuah grup log**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dalam panel navigasi, di bawah **Log**, pilih **Wawasan**.

1. Di atas penyunting pencarian, pilih satu atau beberapa grup log untuk bertanya.

   **Saat Anda memilih grup CloudWatch log, Wawasan Log secara otomatis mendeteksi bidang dalam data dalam grup log dan menampilkannya di panel kanan di bidang Ditemukan.** 