Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Jenis variabel

Grafana menggunakan beberapa jenis variabel.

Menambahkan variabel kueri

Menggunakan variabel kueri, Anda dapat menulis kueri sumber data yang mengembalikan daftar nama metrik, nilai tag, atau kunci. Misalnya, variabel kueri mungkin menampilkan daftar nama server, ID sensor, atau pusat data. Nilai variabel berubah saat mereka secara dinamis mengambil opsi dengan kueri sumber data.

Ekspresi kueri dapat berisi referensi ke variabel lain dan, pada dasarnya, membuat variabel terkait. Grafana mendeteksi ini dan secara otomatis menyegarkan variabel ketika salah satu variabel tertaut berubah.

Ekspresi kueri

Ekspresi kueri berbeda untuk setiap sumber data. Untuk informasi selengkapnya, lihat dokumentasi untuk sumber data Anda diConnect ke sumber data.

Memasuki opsi umum

Memasukkan opsi kueri

Menambahkan variabel kustom

Gunakan variabel kustom untuk nilai yang tidak berubah. Ini mungkin angka, string, atau bahkan variabel lainnya.

Misalnya, jika Anda memiliki nama server atau nama wilayah yang tidak berubah, Anda dapat membuatnya sebagai variabel kustom daripada variabel kueri. Karena mereka tidak berubah, Anda dapat menggunakannya dalam variabel berantai daripada variabel kueri lainnya. Itu akan mengurangi jumlah kueri yang harus dikirim Grafana ketika variabel berantai diperbarui. Untuk informasi lebih lanjut tentang variabel berantai, lihatVariabel yang dirantai.

Memasuki opsi umum

Memasukkan opsi kustom

Menambahkan variabel kotak teks

Variabel kotak teks menampilkan bidang input teks dengan nilai default opsional. Ini adalah variabel yang paling fleksibel, karena Anda dapat memasukkan nilai apa pun. Gunakan jenis variabel ini jika Anda memiliki metrik dengan kardinalitas tinggi atau jika Anda ingin memperbarui beberapa panel di dasbor secara bersamaan.

Memasuki opsi umum

Memasukkan opsi teks

Menambahkan variabel konstan

Untuk menentukan konstanta tersembunyi, gunakan variabel konstan. Variabel konstan berguna untuk awalan jalur metrik untuk dasbor yang ingin Anda bagikan. Saat Anda mengekspor dasbor, variabel konstan dikonversi ke opsi impor.

Variabel konstan tidak fleksibel. Setiap variabel konstan hanya memiliki satu nilai. Untuk memperbaruinya, Anda harus memperbarui pengaturan variabel.

Variabel konstan berguna ketika Anda memiliki nilai kompleks yang harus Anda sertakan dalam kueri tetapi tidak ingin mengetik ulang di setiap kueri tunggal. Misalnya, jika Anda memiliki jalur server yang disebuti-0b6a61efe2ab843gg, Anda bisa menggantinya dengan variabel yang disebut$path_gg.

Memasuki opsi umum

Memasuki opsi konstan

Menambahkan variabel sumber data

Untuk mengubah sumber data untuk seluruh dasbor dengan cepat, Anda dapat menggunakan variabel sumber data. Mereka berguna jika Anda memiliki beberapa contoh sumber data, mungkin di lingkungan yang berbeda.

Memasuki opsi umum

Memasukkan opsi sumber data

Menambahkan variabel interval

Gunakan variabel interval untuk mewakili rentang waktu seperti1m,1h,1d. Anda dapat menganggapnya sebagai perintah di seluruh dasbor group-by-time . Variabel interval mengubah cara data dikelompokkan dalam visualisasi. Anda juga dapat menggunakan opsi Auto untuk mengembalikan sejumlah titik data per rentang waktu.

Anda dapat menggunakan variabel interval sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB), interval histogram tanggal (untuk OpenSearch), atau sebagai parameter fungsi ringkasan (untuk Grafit).

Memasuki opsi umum

Memasuki opsi interval

Contoh variabel interval

Contoh menggunakan variabel template myinterval dalam fungsi Graphite:

summarize($myinterval, sum, false)

Contoh grafit yang lebih kompleks:

groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')

Menambahkan filter ad hoc

Anda dapat menggunakan filter satu kali, atau ad hoc untuk menambahkan filter kunci/nilai yang secara otomatis ditambahkan ke semua kueri metrik yang menggunakan sumber data yang ditentukan. Tidak seperti variabel lain, Anda tidak menggunakan filter satu kali dalam kueri. Sebagai gantinya, Anda menggunakannya untuk menulis filter untuk kueri yang ada.

Memasuki opsi umum

Memasukkan opsi

Membuat filter ad hoc

Filter ad hoc adalah salah satu opsi variabel paling kompleks dan fleksibel yang tersedia. Alih-alih daftar opsi variabel reguler, variabel ini memungkinkan pembuatan kueri ad hoc di seluruh dasbor. Filter yang Anda terapkan dengan cara ini diterapkan ke semua panel di dasbor.

Variabel yang dirantai

Variabel berantai, juga disebut variabel terkait atau variabel bersarang, adalah variabel kueri dengan satu atau lebih variabel lain dalam kueri variabelnya. Bagian ini menjelaskan cara kerja variabel berantai, dan menyediakan tautan ke dasbor contoh yang menggunakan variabel berantai.

Kueri variabel berantai berbeda untuk setiap sumber data, tetapi premisnya sama untuk semua. Anda dapat menggunakan kueri variabel berantai di sumber data apa pun yang mendukungnya.

Anda dapat membangun dasbor yang ditautkan dan templat yang kompleks, kedalaman 5 atau 10 level. Secara teknis, tidak ada batasan seberapa dalam atau kompleks Anda dapat pergi, tetapi semakin banyak tautan yang Anda miliki, semakin besar beban kueri.

Praktik dan kiat terbaik

Praktik berikut akan membuat dasbor dan variabel Anda lebih mudah digunakan.

Membuat variabel berantai baru

Urutan variabel

Untuk mengubah urutan variabel dalam daftar variabel dasbor, pilih panah atas dan bawah di sisi kanan setiap entri. Ruang kerja Grafana mencantumkan daftar dropdown variabel dari kiri ke kanan sesuai dengan daftar ini, menampilkan variabel di bagian atas daftar di paling kiri.

Pertimbangan kompleksitas

Semakin banyak lapisan ketergantungan yang Anda miliki dalam variabel, semakin lama waktu yang dibutuhkan untuk memperbarui dasbor setelah Anda mengubah variabel.

Misalnya, jika Anda memiliki serangkaian empat variabel tertaut (negara, wilayah, server, metrik) dan Anda mengubah nilai variabel root (negara), ruang kerja Grafana harus menjalankan kueri untuk semua variabel dependen sebelum memperbarui visualisasi di dasbor.

Variabel global

Grafana memiliki variabel bawaan global yang dapat digunakan dalam ekspresi di editor kueri. Topik ini mencantumkannya dalam urutan abjad dan mendefinisikannya. Variabel ini berguna dalam kueri, tautan dasbor, tautan panel, dan tautan data.

$ __dasbor

Variabel ini adalah nama dasbor saat ini.

$__from dan $__to

Grafana memiliki dua variabel rentang waktu bawaan: $__from dan. $__to Mereka saat ini selalu diinterpolasi sebagai milidetik epoch secara default tetapi Anda dapat mengontrol pemformatan tanggal.

Sintaks di atas ${__to} juga berfungsi dengan.

Anda dapat menggunakan variabel ini di URL juga. Misalnya, untuk mengirim pengguna akhir ke dasbor yang menunjukkan rentang waktu dari enam jam yang lalu hingga sekarang, gunakan URL berikut: https://play.grafana.org/d/000000012/grafana-play-home? ViewPanel=2&orgid=1? dari=sekarang-6h&ke=sekarang

$ __interval

Anda dapat menggunakan $__interval variabel sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB, Myself, Postgres, MSSQL), interval histogram tanggal (untuk), atau sebagai parameter fungsi ringkasan (untuk Grafit OpenSearch).

Ruang kerja Grafana secara otomatis menghitung interval yang dapat digunakan untuk mengelompokkan berdasarkan waktu dalam kueri. Ketika ada lebih banyak titik data daripada yang dapat ditampilkan pada grafik, kueri dapat dibuat lebih efisien dengan mengelompokkan dengan interval yang lebih besar. Misalnya, lebih efisien untuk mengelompokkan 1 hari daripada 10 detik ketika melihat data 3 bulan. Grafik akan terlihat sama, dan kueri akan lebih cepat. $__intervalIni dihitung dengan menggunakan rentang waktu dan lebar grafik (jumlah piksel).

Perhitungan Perkiraan: (from - to) / resolution

Misalnya, ketika rentang waktu adalah 1 jam dan grafik layar penuh, interval dapat dihitung2m; poin dikelompokkan dalam interval 2 menit. Jika rentang waktu 6 bulan dan grafiknya layar penuh, intervalnya mungkin 1d (1 hari); poin dikelompokkan berdasarkan hari.

Dalam sumber data InfluxDB, variabel warisan $interval adalah variabel yang sama. Gunakan $__interval sebagai gantinya.

InfluxDB dan sumber OpenSearch data memiliki Group by time interval bidang yang digunakan untuk hardcode interval atau untuk menetapkan batas minimum untuk $__interval variabel dengan menggunakan sintaks ->. > >10m

$ __interval_ms

Variabel ini adalah $__interval variabel dalam milidetik, bukan string yang diformat interval waktu. Misalnya, jika $__interval adalah 20m maka $__interval_ms adalah1200000.

$ __nama

Variabel ini hanya tersedia di panel Singlestat dan dapat digunakan di bidang awalan atau akhiran pada tab Opsi. Variabel akan diganti dengan nama seri atau alias.

$__org

Variabel ini adalah ID dari organisasi saat ini. Variabel ${__org.name} adalah nama organisasi saat ini.

$ __pengguna

Variabel ${__user.id} adalah ID dari pengguna saat ini. Variabel ${__user.login} adalah pegangan login dari pengguna saat ini. Variabel ${__user.email} adalah email untuk pengguna saat ini.

$ __kisaran

Variabel ini saat ini hanya didukung untuk sumber data Prometheus. Variabel ini mewakili rentang untuk dasbor saat ini. Itu dihitung olehto - from. Ini memiliki representasi milidetik dan kedua yang disebut $__range_ms dan. $__range_s

$ TimeFilter atau $ __TimeFilter

$timeFilterVariabel mengembalikan rentang waktu yang dipilih saat ini sebagai ekspresi. Misalnya, Last 7 days ekspresi interval rentang waktu adalahtime > now() - 7d.

Variabel ini digunakan di beberapa tempat, termasuk: