Jika Anda sering menjalankan pernyataan kueri dan analisis yang sama, Anda dapat menyimpannya sebagai pencarian tersimpan. Fitur ini memungkinkan Anda menjalankan ulang pernyataan tersebut dengan cepat.
Prasyarat
Indeks telah dibuat. Untuk informasi selengkapnya, lihat Buat indeks.
Buat pencarian tersimpan
Masuk ke Konsol Simple Log Service.
Pada bagian Projects, klik proyek yang diinginkan.

Pada tab , klik logstore yang diinginkan.

Masukkan pernyataan kueri di kotak pencarian dan klik Last 15 Minutes untuk menentukan rentang waktu kueri.
Untuk informasi selengkapnya, lihat Langkah 1: Konfigurasikan indeks.
-
Di pojok kanan atas halaman, klik ikon
.Ikon ini adalah ikon Add to Saved Search (bintang), yang terletak di bilah alat di pojok kanan atas halaman Search & Analysis.
-
Pada panel Saved Query Details, atur Saved Query Name.
-
Klik OK.
Setelah membuat pencarian tersimpan, Anda dapat menjalankannya dari halaman Search & Analysis untuk Logstore tersebut. Klik ikon
di sebelah kiri kotak input, lalu klik nama pencarian tersimpan yang dituju.
Ubah pencarian tersimpan
-
Di panel navigasi sebelah kiri, pilih .
Pada daftar Saved Search, klik pencarian tersimpan yang dituju.
Masukkan pernyataan kueri dan analisis baru, lalu klik ikon
.Di pojok kanan atas halaman, klik ikon
.-
Pada panel Saved Query Details, ubah informasi pencarian tersimpan, lalu klik OK.
Dapatkan ID pencarian tersimpan
Setelah membuat pencarian tersimpan, Anda dapat menggunakan ID pencarian tersimpan tersebut untuk menyematkan halaman pencarian tersimpan ke dalam halaman web kustom. Untuk informasi selengkapnya, lihat Konfigurasikan parameter penyematan konsol.
-
Di panel navigasi sebelah kiri, pilih .
Pada daftar Saved Search, klik pencarian tersimpan yang dituju.
-
Dapatkan ID pencarian tersimpan dari URL di bilah alamat browser Anda.
URL di bilah alamat Konsol Log Service memiliki format
https://sls.console.alibabacloud.com/lognext/project/{ProjectName}/savedsearch/{savedSearchID}?slsRegion={region}. Bidang antara/savedsearch/dan?slsRegion=adalah ID pencarian tersimpan.
Melewatkan variabel dengan parameter URL
Saat menyematkan Konsol Log Service dalam iframe atau menautkan ke halaman pencarian tersimpan dari sistem eksternal, Anda dapat menambahkan parameter URL untuk mengganti placeholder variabel dalam pernyataan kueri pencarian tersimpan secara dinamis.
Prasyarat
-
Anda memiliki pencarian tersimpan yang pernyataan kuerinya berisi placeholder variabel, seperti
${variable_name}. -
Fitur token (mode tokenQuery) harus diaktifkan untuk pencarian tersimpan tersebut.
Untuk menentukan variabel, gunakan format ${variable_name} dalam pernyataan kueri Anda untuk nilai yang ingin diganti secara dinamis. Contoh: * | WHERE status = ${testParam}.
URL standar untuk halaman pencarian tersimpan adalah sebagai berikut:
/lognext/project/{ProjectName}/savedsearch/{savedSearchName}
Anda dapat menambahkan parameter kueri ke URL ini untuk mengirim nilai variabel atau menambahkan kondisi filter. Tabel berikut menjelaskan parameter yang tersedia.
Encode parameter kueri yang mengandung karakter khusus menggunakan URL encoding.
|
Parameter |
Tipe |
Wajib |
Deskripsi |
|
|
String array JSON |
Tidak |
Mengirim nilai variabel secara langsung untuk mengganti placeholder |
|
|
String array JSON |
Tidak |
Mewarisi nilai variabel dari sumber hulu, seperti drill-down dari dashboard. Formatnya sama dengan parameter |
|
|
String |
Tidak |
Menambahkan kondisi filter di awal pernyataan kueri menggunakan Operator AND. |
parameter token
Parameter token adalah array JSON di mana setiap elemennya berupa objek dengan format {"key": "variable_name", "value": "replacement_value"}.
[{"key": "variable_name1", "value": "value1"}, {"key": "variable_name2", "value": "value2"}]
Contoh: Misalkan pernyataan kueri untuk pencarian tersimpan my-search adalah * | WHERE status = ${testParam}. Setelah Anda mengirim parameter melalui URL berikut, pernyataan kueri akan diganti menjadi * | WHERE status = '200':
/lognext/project/my-project/savedsearch/my-search?token=[{"key":"testParam","value":"200"}]
Parameter tokenInherit
tokenInherit memiliki format yang sama dengan token. Parameter ini biasanya dikirim secara otomatis saat melakukan drill-down dari dashboard agar pencarian tersimpan dapat mewarisi nilai variabel yang dipilih dari dashboard. Jika kedua parameter token dan tokenInherit ada, variabel dalam token memiliki prioritas lebih tinggi. Untuk variabel dengan kunci yang sama, nilai dari token yang digunakan.
parameter filters
Parameter filters menambahkan kondisi filter di awal pernyataan kueri dengan Operator AND. Contoh:
/lognext/project/my-project/savedsearch/my-search?filters=level%3D"ERROR"
Pernyataan kueri hasilnya adalah:
(level="ERROR") AND <Original query statement>
Prioritas dan urutan penerapan parameter
Jika beberapa parameter ada, Log Service menyusun pernyataan kueri akhir dalam urutan berikut:
-
Sistem memulai dari pernyataan asli pencarian tersimpan.
-
Jika parameter
tokenatautokenInheritada, Log Service mengganti placeholder${variable_name}dalam pernyataan tersebut. -
Jika parameter
filtersada, Log Service menambahkan kondisi filter di awal pernyataan menggunakan Operator AND.
Contoh lengkap
Nama Project adalah my-project, Nama Pencarian Tersimpan adalah error-query, dan pernyataan kuerinya adalah * | WHERE status = ${statusCode} AND host = ${hostName}. Anda harus mengirim parameter statusCode=500 dan hostName=web-server-01 serta menambahkan kondisi filter level="ERROR". URL-nya disusun sebagai berikut:
/lognext/project/my-project/savedsearch/error-query?token=[{"key":"statusCode","value":"500"},{"key":"hostName","value":"web-server-01"}]&filters=level%3D"ERROR"
Pernyataan kueri hasilnya adalah:
(level="ERROR") AND * | WHERE status = '500' AND host = 'web-server-01'
Menggunakan parameter dalam iframe
Jika Anda menyematkan halaman pencarian tersimpan dalam halaman web kustom menggunakan iframe, Anda dapat menggabungkan parameter secara dinamis saat menyusun URL src iframe:
<iframe
src="/lognext/project/my-project/savedsearch/error-query?token=[{"key":"statusCode","value":"500"}]"
width="100%"
height="800px"
frameborder="0"
/>
Atau, Anda dapat menyusun URL secara dinamis dalam JavaScript:
const params = encodeURIComponent(JSON.stringify([
{ key: 'statusCode', value: '500' },
{ key: 'hostName', value: 'web-server-01' }
]))
const iframeSrc = `/lognext/project/my-project/savedsearch/error-query?token=${params}`
document.getElementById('sls-iframe').src = iframeSrc
Catatan penggunaan
-
Nilai parameter
tokenberupa array JSON dan harus di-URL-encode (encodeURIComponent) dalam URL. -
Nama variabel (kunci) harus persis sama dengan nama variabel token yang didefinisikan dalam pernyataan pencarian tersimpan. Nama ini bersifat case-sensitive.
-
Jika fitur Token tidak diaktifkan untuk pencarian tersimpan (parameter
tokenQuerykosong), parametertokendantokenInherittidak akan berlaku, dan pernyataan kueri tidak akan diganti. -
filtersberfungsi terlepas dari apakah fitur Token diaktifkan untuk pencarian tersimpan atau tidak.
Hapus pencarian tersimpan
Di panel navigasi sebelah kiri, pilih . Pada daftar pencarian tersimpan, arahkan kursor ke pencarian tersimpan yang dituju, klik ikon
, lalu klik Delete.