Cara memfilter dasbor dengan menambahkan filter dan grafik menggunakan penggantian variabel - Simple Log Service

Variabel memungkinkan Anda memfilter grafik individual atau seluruh dasbor tanpa mengubah pernyataan kueri yang mendasarinya. Variabel menggunakan sintaks ${{variable_name|default_value}} atau ${{variable_name|default_value|prefix}} untuk menyesuaikan placeholder secara dinamis dalam pernyataan kueri Anda. Anda dapat memfilter data di seluruh dasbor atau hanya dalam satu grafik.

Filter seluruh dasbor

Jenis filter

Setiap grafik didukung oleh pernyataan kueri. Filter memodifikasi kondisi kueri atau mengganti variabel placeholder untuk semua grafik pada dasbor. Simple Log Service (SLS) mendukung tiga jenis filter:

Filter: Menggunakan pasangan kunci-nilai dari field log untuk memfilter data. Filter ini mencari hasil kueri untuk log yang berisi atau tidak berisi pasangan Key:Value tertentu. Misalnya, saat melihat jumlah tampilan halaman (PV) untuk metode permintaan berbeda, Anda dapat menambahkan filter untuk beralih antar metode menggunakan item daftar dinamis.
Variable Replacement: Anda terlebih dahulu mendefinisikan variabel dalam pernyataan kueri grafik, lalu menambahkan filter untuk menggantinya secara dinamis dengan nilai yang dipilih. Misalnya, lihat PV per 10, 60, atau 600 detik.
Metric Filter: Mempersempit metrik yang diingest berdasarkan label dan nilai yang sesuai. Jika Anda menentukan beberapa kondisi filter, kondisi tersebut digabungkan dengan operator logika AND.

Jenis filter

Langkah 1: Tambahkan grafik ke dasbor

Buat dasbor.
Pada dasbor, masuk ke edit mode dan klik Add > Add Chart.
Di sebelah kiri, konfigurasikan rentang waktu kueri, Logstore, dan pernyataan kueri. Di sebelah kanan, pilih jenis grafik, seperti tabel. Klik Apply untuk melihat pratinjau grafik, lalu klik OK untuk menyimpannya.

Pernyataan kueri berikut mengambil jumlah PV per menit:
```
* | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

Langkah 2: Tambahkan filter jenis Filter

Pada dasbor, masuk ke edit mode dan klik ikon di pojok kanan atas.

Pada panel Filter, konfigurasikan pengaturan dan klik OK.

Berikut adalah contoh pernyataan kueri yang digunakan untuk pratinjau item daftar dinamis:

*|select distinct request_method

Dalam contoh ini, atur Key menjadi request_method, pilih website_log sebagai Logstore, dan atur rentang waktu ke 15min (Last 15 minutes). Pratinjau item daftar dinamis menampilkan GET, POST, DELETE, dan PUT.

Parameter untuk Filter Jenis Filter

Parameter	Deskripsi
Name	Nama filter.
Type	Filter: Menggunakan field dan nilainya untuk memfilter data. Kondisi ini ditambahkan di awal pernyataan kueri menggunakan operator AND atau NOT. Operator default adalah AND. AND: `Value AND [search query] \| [sql query]` NOT: `Value NOT [search query] \| [sql query]` Anda dapat menambahkan beberapa nilai di bagian Static List Items.
Global Filtering	Jika Anda mengaktifkan Global Filtering, filter akan mencari nilai yang ditentukan di semua field tanpa memerlukan kunci. Jika Anda menonaktifkan Global Filtering, filter hanya mencari nilai yang ditentukan di kunci yang ditentukan.
Key Value	Pada Key Value, konfigurasikan nama field target.
Alias	Alias untuk filter.
Automatic Filtering	Jika Anda mengaktifkan Automatic Filtering, filter secara otomatis menyembunyikan nilai yang tidak ada dalam sumber data dari daftar pilihannya.
Display Configuration	Konfigurasikan tampilan filter. Aktifkan Display Title untuk menambahkan judul ke filter. Aktifkan Display Border untuk menambahkan batas ke filter. Aktifkan Display Background untuk menambahkan latar belakang putih ke filter.
Query Method	Operator yang digunakan untuk menggabungkan kondisi filter. Anda dapat menggunakan AND Operator atau NOT Operator.
Static List Items	Menentukan nilai statis untuk Key Value yang ditentukan. Klik + untuk menambahkan beberapa nilai. Jika Anda mengaktifkan Select by Default untuk suatu nilai, nilai tersebut digunakan untuk pemfilteran secara default setiap kali Anda membuka dasbor.
Add Dynamic List Item	Aktifkan Add Dynamic List Item untuk mengisi filter secara dinamis dengan nilai untuk Key Value yang ditentukan. Item-item ini merupakan hasil dari pernyataan kueri, yang dapat berubah berdasarkan rentang waktu yang dipilih. Setelah Anda mengaktifkan Add Dynamic List Item, Anda harus mengonfigurasi parameter berikut. Select Project: Pilih Project yang ingin Anda kueri. Select Logstore: Pilih Logstore yang ingin Anda kueri. Inherit Filter Condition: Saat Anda mengaktifkan sakelar Inherit Filter Condition, pemfilteran mewarisi kondisi filter yang sudah ada di dasbor. Query and Analysis: Masukkan pernyataan kueri dan atur rentang waktu untuk mengambil nilai dinamis. Dynamic List Item Preview: Pratinjau hasil kueri.

Sesuaikan tata letak halaman, klik Save, dan pada kotak dialog Save Dashboard, klik Confirm.

Langkah 3: Verifikasi hasil

Pada dasbor, pilih GET dan PUT dari daftar drop-down request_method untuk mengkueri PV untuk metode GET dan PUT. Tindakan ini menjalankan pernyataan kueri berikut:

(*)and (request_method: GET OR request_method: PUT)| SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time

Jenis penggantian variabel

Langkah 1: Definisikan variabel dalam kueri grafik

Buat dasbor.
Pada dasbor, masuk ke edit mode dan klik Add > Add Chart.
Di sebelah kiri, konfigurasikan rentang waktu kueri, Logstore, dan pernyataan kueri yang mencakup variabel. Di sebelah kanan, pilih jenis grafik. Klik Apply untuk melihat pratinjau grafik, lalu klik OK untuk menyimpannya.

Pernyataan kueri berikut mengambil jumlah PV dalam interval waktu berbeda. Sintaks ${{interval|60}} mendefinisikan variabel bernama interval dengan nilai default 60.
```
* | SELECT date_format(__time__ - __time__ % ${{interval|60}}, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

Langkah 2: Tambahkan filter penggantian variabel

Pada dasbor, masuk ke edit mode dan klik ikon di pojok kanan atas.

Pada panel Filter, konfigurasikan pengaturan dan klik OK.

Catatan

Key Value harus sesuai dengan nama variabel yang Anda definisikan dalam pernyataan kueri. Dalam contoh ini, nilainya adalah interval.
Gunakan Static List Items untuk mengonfigurasi nilai-nilai untuk variabel tersebut.

Dalam contoh ini, atur Name menjadi PV Filter. Untuk Static list item, tambahkan nilai variabel 10, 60, dan 600, yang merepresentasikan detik. Lalu, klik OK.

Parameter untuk Filter Jenis Variable Replacement

Parameter	Deskripsi
Name	Nama filter.
Type	Variable Replacement: Mendefinisikan variabel dan nilai-nilai yang mungkin untuk filter. Jika grafik pada dasbor berisi placeholder untuk variabel ini, filter secara otomatis mengganti placeholder dengan nilai yang dipilih. Anda dapat mengonfigurasi beberapa nilai di bagian Static List Items.
Key Value	Konfigurasikan variabel di Key Value. Catatan Nama variabel harus sesuai dengan placeholder dalam pernyataan kueri grafik.
Alias	Alias untuk filter.
Display Configuration	Konfigurasikan tampilan filter. Aktifkan Display Title untuk menambahkan judul ke filter. Aktifkan Display Border untuk menambahkan batas ke filter. Aktifkan Display Background untuk menambahkan latar belakang putih ke filter.
Show Component Types	Jenis kontrol input untuk filter: Enter a value: Kotak teks yang memungkinkan pengguna memasukkan nilai apa pun. Drop-down List: Daftar opsi yang telah ditentukan sebelumnya.
Static List Items	Menentukan nilai statis untuk Key Value yang ditentukan. Klik + untuk menambahkan beberapa nilai. Jika Anda mengaktifkan Select by Default untuk suatu nilai, nilai tersebut digunakan untuk pemfilteran secara default setiap kali Anda membuka dasbor.
Add Dynamic List Item	Aktifkan Add Dynamic List Item untuk mengisi filter secara dinamis dengan nilai untuk Key Value yang ditentukan. Item-item ini merupakan hasil dari pernyataan kueri, yang dapat berubah berdasarkan rentang waktu yang dipilih. Setelah Anda mengaktifkan Add Dynamic List Item, Anda harus mengonfigurasi parameter berikut. Select Project: Pilih Project yang ingin Anda kueri. Select Logstore: Pilih Logstore yang ingin Anda kueri. Inherit Filter Condition: Saat Anda mengaktifkan sakelar Inherit Filter Condition, pemfilteran mewarisi kondisi filter yang sudah ada di dasbor. Query and Analysis: Masukkan pernyataan kueri dan atur rentang waktu untuk mengambil nilai dinamis. Dynamic List Item Preview: Pratinjau hasil kueri.

Sesuaikan tata letak halaman, klik Save, dan pada kotak dialog Save Dashboard, klik Confirm.

Langkah 3: Verifikasi hasil

Pada dasbor, di PV Filter, atur interval menjadi 10 untuk mengkueri PV per 10 detik.
Tindakan ini menjalankan pernyataan kueri berikut:
```
* | SELECT date_format(__time__ - __time__ % 10, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```
Pada dasbor, di PV Filter, atur interval menjadi 60 untuk mengkueri PV per 60 detik.
Tindakan ini menjalankan pernyataan kueri berikut:
```
* | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

Metric filter

Ingest metrik. Misalnya, kumpulkan data pemantauan host.

Tambahkan filter. Setelah Anda mengingest data host, SLS secara otomatis membuat dasbor bernama Host Monitoring. Pada dasbor Host Monitoring, masuk ke edit mode dan klik ikon 仪表盘过滤器-过滤器图标 di pojok kanan atas. Pada panel Filter, konfigurasikan pengaturan dan klik OK.

Untuk Key, pilih Host.

Parameter untuk Metric Filter

Parameter	Deskripsi
Name	Nama filter.
Type	Metric Filter: Menambahkan label dan nilai secara dinamis untuk pemfilteran. Setelah Anda menambahkan Metric Filter, Anda dapat memfilter metrik secara manual dalam Metricstore berdasarkan label dan nilai.
Key Value	Pengidentifikasi unik untuk filter.
Alias	Alias untuk filter.
Display Configuration	Konfigurasikan tampilan filter. Aktifkan Display Title untuk menambahkan judul ke filter. Aktifkan Display Border untuk menambahkan batas ke filter. Aktifkan Display Background untuk menambahkan latar belakang putih ke filter.
Select Project	Pilih Project yang ingin Anda kueri.
Select Metricstore	Pilih Metricstore yang ingin Anda kueri.

Filter dasbor. Di bagian atas halaman dasbor, pilih label dan nilai dari daftar drop-down.

Filter satu grafik dengan penggantian variabel

Anda dapat mengonfigurasi Variable Replacement untuk satu grafik. SLS menambahkan filter di pojok kiri atas grafik tersebut, yang memungkinkan Anda mempersempit datanya secara independen. Contoh berikut mengonfigurasi tabel untuk melihat PV dalam interval waktu berbeda.

Langkah 1: Konfigurasikan penggantian variabel

Di sisi kiri halaman pengeditan grafik, konfigurasikan rentang waktu kueri, Logstore, dan pernyataan kueri yang mencakup variabel.

Pernyataan kueri berikut mengambil PV untuk interval waktu berbeda. Sintaks ${{date|60}} mendefinisikan variabel bernama date dengan nilai default 60.
```
* | select __time__ - __time__ % ${{date | 60}} as time, COUNT(*) as pv, avg(request_time) as duration, request_method GROUP BY time, request_method order by time limit 1000
```
Setelah menjalankan kueri, atur Logstore menjadi website_log dan rentang waktu menjadi 15 Minutes(Relative). Hasil kueri menampilkan PV dan waktu permintaan rata-rata yang dikelompokkan berdasarkan waktu dan metode permintaan dalam bentuk tabel.
Konfigurasikan penggantian variabel.
1. Di sisi kanan halaman pengeditan grafik, pilih Table sebagai jenis grafik, lalu klik Variable Replacement > Add Variable Replacement.
2. Pada kotak dialog Variable Replacement, atur Variable Key menjadi date dan Display Name menjadi time. Untuk nilai variabel, atur Display Name menjadi min dan hour, dengan nilai pengganti masing-masing 60 dan 3600.
Di pojok kanan atas halaman, klik OK. Lalu, klik Save. Pada kotak dialog Save Dashboard, klik Confirm.

Langkah 2: Filter grafik

Setelah Anda menyimpan pengaturan, filter muncul di pojok kiri atas grafik. Saat Anda memilih nilai dari filter, SLS menjalankan ulang kueri dengan nilai baru tersebut. Misalnya, jika Anda memilih hour, SLS menjalankan pernyataan kueri berikut:

(*)| select __time__ - __time__ % 3600 as time, COUNT(*) as pv, avg(request_time) as duration, request_method GROUP BY time, request_method order by time limit 1000

Gunakan variabel dengan kejadian interaksi

Saat Anda mengonfigurasi Interaction Occurrences untuk grafik, Anda juga dapat mendefinisikan variabel. Saat Anda memicu interaksi, sistem secara otomatis memperbarui variabel dengan nilai dari interaksi tersebut. Hal ini menghubungkan grafik secara dinamis untuk analisis drill-down. Untuk contoh terperinci, lihat Configuration examples.

Pada jendela konfigurasi Open Logstore, pilih Logstore target, seperti website_log. Pada kotak input Filter query, klik Add Variable untuk mereferensikan variabel. Misalnya, dalam kueri * | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as "${time}", ${time} adalah variabel yang didefinisikan dalam kejadian interaksi.

Penggunaan lanjutan: Gunakan variabel dengan awalan

Penting

Anda dapat meningkatkan pemfilteran dengan menyertakan awalan dalam variabel Anda, menggunakan sintaks ${{variable_name|default_value|prefix}}.

Jika tidak ada nilai yang dipilih untuk variabel, kueri dijalankan menggunakan nilai default.
Jika nilai dipilih, kueri menggabungkan awalan dan nilai yang dipilih.

Filter dasbor: Pemfilteran metode HTTP

Variabel

Format variabel: ${{method_filter|http_method in ('GET','POST')|http_method =}}
Pernyataan kueri: (*)|select status, count(1) as err_count where ${{method_filter|request_method in ('GET','POST')|request_method =}} and status>=400 group by status
- Jika tidak ada nilai yang dipilih: Kueri secara default menganalisis distribusi error (kode status 400 atau lebih tinggi) untuk permintaan GET dan POST. Kueri efektifnya adalah:
  
  (*)|select status, count(1) as err_count where request_method in ('GET','POST') and status>=400 group by status
- Jika 'DELETE' dipilih: Kueri beralih untuk menganalisis error untuk metode DELETE. Kueri efektifnya adalah:
  
  (*)| select status, count(1) as err_count where request_method ='DELETE' and status>=400 group by status

Prosedur

Konfigurasikan grafik. Pada halaman pengeditan grafik, konfigurasikan rentang waktu, Logstore, dan pernyataan kueri yang mencakup variabel. Pilih Table sebagai jenis grafik. Klik Apply untuk melihat pratinjau, lalu klik OK untuk menyimpan.

Pernyataan kueri contoh adalah * | select status, count(1) as err_count where ${{method_filter|request_method in ('GET','POST')|request_method =}} and status>=400 group by status, di mana ${{method_filter|...|...}} adalah sintaks variabel. Atur sumber data menjadi website_log.
Konfigurasikan filter variabel. Pada panel Filter, tambahkan nilai ke daftar drop-down untuk variabel method_filter.

Atur Type menjadi Variable Replacement. Di bagian static list items, tambahkan 'GET', 'POST', 'PUT', dan 'DELETE'. Lalu, klik OK.
Filter dasbor. Klik filter dan pilih 'DELETE'. Dasbor diperbarui dan menampilkan statistik berdasarkan pernyataan kueri (*)| select status, count(1) as err_count where request_method ='DELETE' and status>=400 group by status.

Filter grafik: Pemfilteran ambang batas waktu permintaan

Variabel

Format variabel: ${{slow_query|request_time>50|request_time>}}
Pernyataan kueri: (*)| select request_uri, avg(request_time) as avg_time where ${{slow_query|request_time>50|request_time>}} group by request_uri order by avg_time desc
- Jika tidak ada nilai yang dipilih: Kueri secara default mencari API dengan waktu permintaan lebih dari 50 ms, diurutkan berdasarkan waktu rata-rata. Kueri efektifnya adalah:
  
  (*)| select request_uri, avg(request_time) as avg_time where request_time>50 group by request_uri order by avg_time desc
- Jika 1000 dipilih: Kueri disesuaikan untuk menganalisis API lambat yang membutuhkan waktu lebih dari 1.000 ms. Kueri efektifnya adalah: (*)| select request_uri, avg(request_time) as avg_time where request_time>1000 group by request_uri order by avg_time desc

Prosedur

Konfigurasikan grafik. Pada halaman pengeditan grafik, konfigurasikan rentang waktu, Logstore, dan pernyataan kueri yang mencakup variabel.

Di sebelah kanan, pilih Table sebagai jenis grafik. Di panel kiri bawah, edit pernyataan kueri untuk menyertakan variabel. Di bagian Variable Replacement di sebelah kanan, konfigurasikan kunci variabel dan nama tampilan. Setelah selesai, klik OK.
Konfigurasikan penggantian variabel. Di sisi kanan halaman pengeditan grafik, klik Variable Replacement. Pada kotak dialog Variable Replacement, tambahkan nilai untuk variabel slow_query.

Dalam daftar nilai variabel, tambahkan item berikut: nama tampilan 50ms (nilai pengganti 50, diatur sebagai default), 100ms (nilai pengganti 100), 200ms (nilai pengganti 200), 300ms (nilai pengganti 300), 400ms (nilai pengganti 400), 500ms (nilai pengganti 500), dan 1000ms (nilai pengganti 1000). Lalu, klik OK.
Filter grafik. Klik filter di pojok kiri atas grafik. Saat Anda memilih 1000ms, grafik diperbarui dan menampilkan statistik berdasarkan pernyataan kueri (*)| select request_uri, avg(request_time) as avg_time where request_time>1000 group by request_uri order by avg_time desc.