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 = atau valuefilter requestId IN [ 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.value,
value, ...]
Untuk informasi selengkapnya tentang indeks bidang dan cara membuatnya, lihat Buat indeks bidang untuk meningkatkan kinerja kueri dan mengurangi volume pemindaian.
Hanya pertanyaan dengan filter
dan fieldName =...filter akan mendapat manfaat dari peningkatan indeks lapangan. Kueri dengan fieldName IN...filter jangan gunakan indeks dan selalu memindai semua peristiwa log di grup log yang dipilih.fieldName like
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/