Simple Log Service:Pencarian tersimpan

Buat pencarian tersimpan

1. Masuk ke Konsol Simple Log Service.

2. Di bagian Projects, klik Proyek yang diinginkan.

   

3. Di tab Log Storage > Logstores, klik logstore yang diinginkan.

   

4. Masukkan pernyataan kueri di kotak pencarian dan klik Last 15 Minutes untuk menentukan rentang waktu kueri.

   Untuk informasi selengkapnya, lihat Langkah 1: Konfigurasikan indeks.

5. Di pojok kanan atas halaman, klik ikon .

   

6. Di panel Saved Search Details, atur Saved Search Name.

7. Klik OK.

   Setelah membuat pencarian tersimpan, Anda dapat menggunakannya di halaman Search & Analysis Logstore. Klik ikon di sebelah kiri kotak pencarian, lalu klik nama pencarian tersimpan Anda.

Modifikasi pencarian tersimpan

1. Di panel navigasi sebelah kiri, pilih Resources > Saved Search.

2. Di daftar Saved Search, klik pencarian tersimpan yang dituju.

3. Masukkan pernyataan kueri dan analisis baru, lalu klik ikon .

4. Di pojok kanan atas halaman, klik ikon .

5. Di panel Saved Search Details, ubah informasi yang diperlukan, 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.

1. Di panel navigasi sebelah kiri, pilih Resources > Saved Search.

2. Di daftar Saved Search, klik pencarian tersimpan yang dituju.

3. Dapatkan ID pencarian tersimpan dari URL di bilah alamat browser Anda.

   

Teruskan variabel melalui parameter URL

Anda dapat mengganti placeholder variabel dalam pernyataan kueri dan analisis secara dinamis dengan menambahkan parameter ke URL. Metode ini memungkinkan Anda menyisipkan konten kueri saat menyematkan halaman pencarian tersimpan dalam iframe atau menautkannya dari sistem eksternal.

Prasyarat

• Anda memiliki pencarian tersimpan yang menggunakan variabel token (placeholder dalam format ${variableName}).

• Fitur token (mode tokenQuery) diaktifkan untuk pencarian tersimpan tersebut.

Format URL standar untuk halaman pencarian tersimpan adalah sebagai berikut:

/lognext/project/{ProjectName}/savedsearch/{SavedSearchName}

Anda dapat menambahkan parameter kueri ke URL ini untuk menyisipkan variabel dan menambahkan filter secara dinamis. Tabel berikut menjelaskan parameter URL tersebut.

Parameter token

Parameter token merupakan array JSON di mana setiap elemennya berupa objek dengan format { "key": "variableName", "value": "replacementValue" }:

[{"key": "variableName1", "value": "value1"}, {"key": "variableName2", "value": "value2"}]

Sebagai contoh, asumsikan pernyataan kueri untuk pencarian tersimpan my-search adalah * | WHERE status = ${testParam}. Dengan menggunakan URL berikut, pernyataan kueri akan diperbarui menjadi * | WHERE status = '200':

/lognext/project/my-project/savedsearch/my-search?token=[{"key":"testParam","value":"200"}]

Parameter tokenInherit

Parameter tokenInherit memiliki format yang sama dengan parameter token. Parameter ini biasanya digunakan untuk meneruskan variabel secara otomatis saat Anda menavigasi dari drill-down Dasbor, sehingga mewarisi nilai variabel yang dipilih ke dalam pencarian tersimpan. Jika parameter token dan tokenInherit keduanya ada, variabel dalam token akan memiliki prioritas lebih tinggi untuk key yang sama.

Parameter filters

Parameter filters merupakan string filter yang ditambahkan di awal pernyataan kueri dengan Operator AND. Contoh:

/lognext/project/my-project/savedsearch/my-search?filters=level%3D"ERROR"

Pernyataan kueri yang dieksekusi akhirnya adalah:

(level="ERROR") AND <original query statement>

Prioritas dan urutan pemrosesan parameter

Jika beberapa parameter ada, pernyataan kueri dibentuk dalam urutan berikut:

1. Dimulai dari pernyataan kueri asli pencarian tersimpan.

2. Jika parameter token atau tokenInherit ada, placeholder ${variableName} dalam pernyataan akan diganti.

3. Jika parameter filters ada, filter tersebut ditambahkan di awal pernyataan menggunakan Operator AND.

Contoh lengkap

Asumsikan Proyek bernama my-project dan pencarian tersimpan bernama error-query. Pernyataan kuerinya adalah * | WHERE status = ${statusCode} AND host = ${hostName}. Anda perlu meneruskan statusCode=500 dan hostName=web-server-01, serta menambahkan filter level="ERROR". Susun URL 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 yang dieksekusi akhirnya adalah:

(level="ERROR") AND * | WHERE status = 500 AND host = web-server-01

Penggunaan dalam iframe

Saat menyematkan halaman pencarian tersimpan dalam iframe, Anda dapat menyusun URL src secara dinamis dengan parameter yang diperlukan:

<iframe
  src="/lognext/project/my-project/savedsearch/error-query?token=[{&quot;key&quot;:&quot;statusCode&quot;,&quot;value&quot;:&quot;500&quot;}]"
  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 token berupa array JSON dan harus di-URL-encode menggunakan encodeURIComponent.

• Nama variabel (key) harus persis sesuai dengan nama variabel token yang didefinisikan dalam pernyataan kueri pencarian tersimpan (case-sensitive).

• Jika fitur token tidak diaktifkan untuk pencarian tersimpan (tokenQuery kosong), parameter token dan tokenInherit tidak berpengaruh, dan pernyataan kueri tidak diperbarui.

• Parameter filters tetap berfungsi terlepas dari apakah fitur token diaktifkan untuk pencarian tersimpan atau tidak.

Hapus pencarian tersimpan

Di panel navigasi sebelah kiri, pilih Resources > Saved Search. Di daftar Saved Search, arahkan kursor ke pencarian tersimpan yang ingin dihapus, klik ikon , lalu klik Delete.