View a markdown version of this page

filter - Amazon CloudWatch Log

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

filter

Gunakan filter untuk mendapatkan peristiwa log yang cocok dengan satu atau lebih kondisi.

Contoh: Memfilter peristiwa log menggunakan satu kondisi

Cuplikan kode menunjukkan contoh kueri yang mengembalikan semua peristiwa log di mana nilai untuk range lebih besar dari 3000. Kueri membatasi hasil untuk 20 peristiwa log dan mengurutkan peristiwa log berdasarkan @timestamp dan dalam urutan menurun.

fields @timestamp, @message | filter (range>3000) | sort @timestamp desc | limit 20

Contoh: Memfilter peristiwa log menggunakan lebih dari satu kondisi

Anda dapat menggunakan kata kunci and dan or untuk menggabungkan lebih dari satu kondisi.

Cuplikan kode menunjukkan contoh kueri yang mengembalikan peristiwa log di mana nilai untuk range lebih besar dari 3000 dan nilai untuk accountId sama dengan 123456789012. Kueri membatasi hasil untuk 20 peristiwa log dan mengurutkan peristiwa log berdasarkan @timestamp dan dalam urutan menurun.

fields @timestamp, @message | filter (range>3000 and accountId=123456789012) | sort @timestamp desc | limit 20

Bidang yang diindeks dan perintah filter

Jika Anda telah membuat indeks bidang untuk grup log, Anda dapat menggunakan indeks bidang tersebut untuk membuat filter kueri lebih efisien dan mengurangi volume yang dipindai. Misalnya, Anda telah membuat indeks bidang untuk requestId. Kemudian, apa saja CloudWatch Logs Kueri wawasan tentang grup log yang mencakup filter requestId = value atau filter requestId IN [value, value, ...] akan mencoba untuk melewatkan peristiwa log pemrosesan yang diketahui tidak menyertakan bidang yang diindeks. Dengan mencoba memindai hanya peristiwa log yang diketahui berisi bidang yang diindeks, volume pemindaian dapat dikurangi dan kueri lebih cepat.

Untuk informasi selengkapnya tentang indeks bidang dan cara membuatnya, lihat Buat indeks bidang untuk meningkatkan kinerja kueri dan mengurangi volume pemindaian.

penting

Hanya pertanyaan dengan filter fieldName =... dan filter fieldName IN... akan mendapat manfaat dari peningkatan indeks lapangan. Kueri dengan filter fieldName like jangan gunakan indeks dan selalu memindai semua peristiwa log di grup log yang dipilih.

Contoh: Menemukan peristiwa log yang terkait dengan ID permintaan tertentu, menggunakan indeks

Contoh ini mengasumsikan bahwa Anda telah membuat indeks bidang pada requestId. Untuk grup log yang menggunakan indeks bidang ini, kueri akan menggunakan indeks bidang untuk mencoba memindai jumlah kejadian log paling sedikit untuk menemukan peristiwa dengan requestId dengan nilai 123456

fields @timestamp, @message | filter requestId = "1234656" | limit 20

Cocokkan dan ekspresi reguler dalam perintah filter

Perintah filter mendukung penggunaan ekspresi reguler. Anda dapat menggunakan operator perbandingan berikut (=, !=, <, <=, >, >=) dan operator Boolean (and, or, dan not).

Anda dapat menggunakan kata kunci in untuk menguji keanggotaan yang ditetapkan dan memeriksa elemen dalam array. Untuk memeriksa elemen dalam array, letakkan array setelahnya in. Anda dapat menggunakan operator Boolean not bersama in. Anda dapat membuat kueri yang menggunakan in untuk mengembalikan peristiwa log di mana bidang cocok string. Bidang harus berupa string lengkap. Misalnya, cuplikan kode berikut menunjukkan kueri yang menggunakan in untuk mengembalikan peristiwa log di mana bidang logGroup adalah string lengkap example_group.

fields @timestamp, @message | filter logGroup in ["example_group"]

Anda dapat menggunakan frasa kata kunci like dan not like untuk mencocokkan substring. Anda dapat menggunakan operator ekspresi reguler =~ untuk mencocokkan substring. Untuk mencocokkan substring dengan like dan not like, lampirkan substring yang ingin Anda cocokkan dalam tanda kutip tunggal atau ganda. Anda dapat menggunakan pola ekspresi reguler dengan like dan not like. Untuk mencocokkan substring dengan operator ekspresi reguler, lampirkan substring yang ingin Anda cocokkan dalam garis miring ke depan. Contoh berikut berisi cuplikan kode yang menunjukkan bagaimana Anda dapat mencocokkan substring menggunakan filter perintah.

Contoh: Cocokkan substring

Contoh berikut mengembalikan peristiwa log di mana f1 berisi kata Pengecualian. Ketiga contoh tersebut peka terhadap huruf besar dan kecil.

Contoh pertama cocok dengan substring dengan like.

fields f1, f2, f3 | filter f1 like "Exception"

Contoh kedua cocok dengan substring dengan like dan pola ekspresi reguler.

fields f1, f2, f3 | filter f1 like /Exception/

Contoh ketiga cocok dengan substring dengan ekspresi reguler.

fields f1, f2, f3 | filter f1 =~ /Exception/

Contoh: Cocokkan substring dengan wildcard

Anda dapat menggunakan simbol periode (.) sebagai wildcard dalam ekspresi reguler untuk mencocokkan substring. Dalam contoh berikut, kueri mengembalikan kecocokan di mana nilai untuk f1 dimulai dengan string ServiceLog.

fields f1, f2, f3 | filter f1 like /ServiceLog./

Anda dapat menempatkan simbol tanda bintang setelah simbol periode (.*) untuk membuat kuantifier serakah yang mengembalikan kecocokan sebanyak mungkin. Misalnya, kueri berikut mengembalikan kecocokan di mana nilai untuk f1 tidak hanya dimulai dengan string ServiceLog, tetapi juga termasuk string ServiceLog.

fields f1, f2, f3 | filter f1 like /ServiceLog.*/

Kemungkinan kecocokan dapat diformat seperti berikut:

  • ServiceLogSampleApiLogGroup

  • SampleApiLogGroupServiceLog

Contoh: Kecualikan substring dari kecocokan

Contoh berikut menunjukkan kueri yang mengembalikan peristiwa log di mana f1 tidak mengandung kata Pengecualian. Contohnya adalah case senstive.

fields f1, f2, f3 | filter f1 not like "Exception"

Contoh: Cocokkan substring dengan pola yang tidak peka huruf besar/kecil

Anda dapat mencocokkan substring yang tidak peka huruf besar/kecil dengan like dan ekspresi reguler. Tempatkan parameter berikut (? aku) sebelum substring yang ingin Anda cocokkan. Contoh berikut menunjukkan kueri yang mengembalikan peristiwa log di mana f1 berisi kata Pengecualian atau pengecualian.

fields f1, f2, f3 | filter f1 like /(?i)Exception/