Variabel URL dasbor

Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.

Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. Bekerja di Grafana versi 9

Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. Bekerja di Grafana versi 8

Grafana dapat menerapkan nilai variabel yang diteruskan sebagai parameter kueri di URL dasbor. Untuk informasi selengkapnya, lihat Mengelola tautan dasbor serta Template dan variabel.

Melewati variabel sebagai parameter kueri

Grafana menafsirkan parameter string kueri yang diawali dengan variabel di var- dasbor yang diberikan.

Misalnya, di URL ini:

https://${your-domain}/path/to/your/dashboard?var-example=value

Parameter query var-example=value merupakan contoh variabel dashboard dengan nilaivalue.

Melewati beberapa nilai untuk variabel

Untuk melewatkan beberapa nilai, ulangi parameter variabel sekali untuk setiap nilai.

https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2

Grafana menafsirkan var-example=value1&var-example=value2 sebagai contoh variabel dasbor dengan dua nilai: dan. value1 value2

Menambahkan variabel ke tautan dasbor

Grafana dapat menambahkan variabel ke tautan dasbor saat Anda membuatnya dari pengaturan dasbor. Untuk informasi selengkapnya dan langkah-langkah untuk menambahkan variabel, lihat Mengelola tautan dasbor.

Melewati filter ad hoc

Filter ad hoc menerapkan filter kunci atau nilai ke semua kueri metrik yang menggunakan sumber data tertentu. Untuk informasi selengkapnya, lihat Filter ad hoc.

Untuk meneruskan filter ad hoc sebagai parameter kueri, gunakan sintaks variabel untuk meneruskan variabel filter ad hoc, dan juga berikan kunci, operator sebagai nilai, dan nilai sebagai daftar yang dipisahkan pipa.

Misalnya, di URL ini:

https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value

Parameter kueri var-adhoc=key|=|value menerapkan filter ad hoc yang dikonfigurasi sebagai variabel dasbor adhoc menggunakan example_key kunci, = operator, dan nilainya. example_value

catatan

Saat berbagi URL dengan filter ad hoc, ingatlah untuk menyandikan URL. Pada contoh di atas, ganti pipa (|) dengan %7C dan operator kesetaraan (=) dengan%3D.

Mengontrol rentang waktu menggunakan URL

Untuk mengatur rentang waktu dasbor, gunakan parameterfrom,to,time, dan time.window kueri. Karena ini bukan variabel, mereka tidak memerlukan var- awalan.