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

Menambahkan dan mengelola variabel

Tabel berikut mencantumkan jenis variabel yang dikirimkan bersama Grafana.

Memasuki opsi Umum

Anda harus memasukkan opsi umum untuk semua jenis variabel yang Anda buat.

Menambahkan variabel kueri

Variabel kueri memungkinkan Anda menulis kueri sumber data yang dapat 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.

Variabel kueri umumnya hanya didukung untuk string. Jika kueri Anda mengembalikan angka atau tipe data lainnya, Anda mungkin perlu mengonversinya menjadi string untuk menggunakannya sebagai variabel. Untuk sumber data Azure, misalnya, Anda dapat menggunakan fungsi tostring untuk tujuan ini.

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.

Menambahkan variabel khusus

Gunakan variabel kustom untuk nilai yang tidak berubah, seperti angka atau string.

Misalnya, jika Anda memiliki nama server atau nama Wilayah yang tidak pernah berubah, Anda mungkin ingin 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.

Menambahkan variabel kotak teks

Variabel kotak teks menampilkan bidang input teks gratis 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.

Menambahkan variabel konstan

Variabel konstan memungkinkan Anda untuk menentukan konstanta tersembunyi. Ini 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, dan tidak dapat diperbarui kecuali Anda memperbarui pengaturan variabel.

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

Menambahkan variabel sumber data

Variabel sumber data memungkinkan Anda mengubah sumber data dengan cepat untuk seluruh dasbor. Mereka berguna jika Anda memiliki beberapa contoh sumber data, mungkin di lingkungan yang berbeda.

Menambahkan variabel interval

Gunakan variabel interval untuk mewakili rentang waktu seperti1m,1h, atau1d. Anda dapat menganggapnya sebagai grup di seluruh dasbor berdasarkan perintah waktu. Variabel interval mengubah cara data dikelompokkan dalam visualisasi. Anda juga dapat menggunakan Opsi Otomatis 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 Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Grafit).

Contoh variabel interval

Contoh berikut menunjukkan variabel template myinterval dalam fungsi Graphite:

summarize($myinterval, sum, false)

Menambahkan filter ad hoc

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

Buat 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 Anda membuat kueri ad hoc di seluruh dasbor. Filter yang Anda terapkan dengan cara ini diterapkan ke semua panel di dasbor.

Konfigurasikan opsi pemilihan variabel

Pilihan Pilihan adalah fitur yang dapat Anda gunakan untuk mengelola pilihan opsi variabel. Semua opsi pilihan adalah opsional, dan mereka mati secara default.

Variabel multi-nilai

Menginterpolasi variabel dengan beberapa nilai yang dipilih rumit karena tidak langsung bagaimana memformat beberapa nilai menjadi string yang valid dalam konteks tertentu di mana variabel digunakan. Grafana mencoba menyelesaikan ini dengan mengizinkan setiap plugin sumber data untuk memberi tahu mesin interpolasi template format apa yang akan digunakan untuk beberapa nilai.

Variabel multi-nilai dengan sumber data Grafit

Grafit menggunakan ekspresi glob. Variabel dengan beberapa nilai akan, dalam hal ini, diinterpolasi {host1,host2,host3} seolah-olah nilai variabel saat ini adalah host1, host2, dan host3.

Variabel multi-nilai dengan sumber data Prometheus atau InfluxDB

InfluxDB dan Prometheus menggunakan ekspresi regex, sehingga variabel yang sama akan diinterpolasi sebagai. (host1|host2|host3) Setiap nilai juga akan lolos dari regex. Jika tidak, nilai dengan karakter kontrol regex akan merusak ekspresi regex.

Variabel multi-nilai dengan sumber data Elastis

Elasticsearch menggunakan sintaks kueri lucene, sehingga variabel yang sama akan diformat sebagai. ("host1" OR "host2" OR "host3") Dalam hal ini, setiap nilai harus diloloskan sehingga nilainya hanya berisi kata-kata kontrol lucene dan tanda kutip.

Memecahkan masalah variabel multi-nilai

Pelarian dan pemformatan otomatis dapat menyebabkan masalah dan sulit untuk memahami logika di baliknya. Khusus untuk InfluxDB dan Prometheus di mana penggunaan sintaks regex mengharuskan variabel digunakan dalam konteks operator regex.

Jika Anda tidak ingin Grafana melakukan pelolosan dan pemformatan regex otomatis ini, maka Anda harus melakukan salah satu hal berikut:

Sertakan Semua opsi

Grafana menambahkan All opsi ke daftar dropdown variabel. Jika pengguna memilih opsi ini, maka semua opsi variabel dipilih.

Kustom semua nilai

Opsi ini hanya terlihat jika opsi Sertakan Semua dipilih.

Masukkan sintaks regex, gumpalan, atau lucene di bidang Kustom semua nilai untuk menentukan nilai opsi. All

Secara default All nilai mencakup semua opsi dalam ekspresi gabungan. Ini bisa menjadi sangat panjang dan dapat memiliki masalah kinerja. Terkadang lebih baik untuk menentukan nilai semua kustom, seperti regex wildcard.

Untuk memiliki sintaks regex, gumpalan, atau lucene khusus di opsi Kustom semua nilai, itu tidak pernah lolos sehingga Anda harus memikirkan nilai yang valid untuk sumber data Anda.

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 juga berfungsi dengan${__to}.

$ __interval

Anda dapat menggunakan $__interval variabel sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB, MySQL, Postgres, MSSQL), interval histogram Tanggal (untuk Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Graphite).

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, jika Anda melihat grafik data senilai 3 bulan, Anda mungkin tidak dapat melihat detail pada tingkat menit. Pengelompokan berdasarkan jam atau hari membuat kueri lebih efisien tanpa mempengaruhi apa yang ditunjukkan grafik. $__intervalItu dihitung menggunakan rentang waktu dan lebar grafik (jumlah piksel).

Perhitungan Perkiraan: (to - from) / resolution

Misalnya, ketika rentang waktu adalah 1 jam dan grafik layar penuh, maka interval dapat dihitung menjadi 2m - titik dikelompokkan dalam interval 2 menit. Jika rentang waktu 6 bulan dan grafiknya layar penuh, maka intervalnya mungkin 1d (1 hari) - poin dikelompokkan berdasarkan hari.

Dalam sumber data InfluxDB, variabel warisan $interval adalah variabel yang sama. $__intervalharus digunakan sebagai gantinya.

Sumber data InfluxDB dan Elasticsearch memiliki Group by time interval bidang yang digunakan untuk membuat kode keras 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.

$__org

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

$ __pengguna

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

$ __kisaran

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

$ __rate_interval

Saat ini hanya didukung untuk sumber data Prometheus. $__rate_intervalVariabel dimaksudkan untuk digunakan dalam fungsi laju.

$ TimeFilter atau $ __TimeFilter

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

Ini digunakan di beberapa tempat, termasuk:

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 memungkinkan mereka.

Dasbor templat tertaut yang sangat kompleks dimungkinkan, kedalaman 5 atau 10 tingkat. 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 terkait baru

Urutan variabel

Anda dapat mengubah urutan variabel dalam daftar variabel dasbor dengan mengklik panah atas dan bawah di sisi kanan setiap entri. Grafana mencantumkan dropdown variabel dari kiri ke kanan sesuai dengan daftar ini, dengan variabel di bagian atas 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), maka Grafana harus menjalankan kueri untuk semua variabel dependen sebelum memperbarui visualisasi di dasbor.

Kelola variabel

Halaman variabel memungkinkan Anda menambahkan variabel dan mengelola variabel yang ada. Hal ini juga memungkinkan Anda untuk memeriksa variabel dan mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel lain atau dashboard.

Pindah: Anda dapat memindahkan variabel ke atas atau ke bawah daftar menggunakan drag and drop.

Clone: Untuk mengkloning variabel, klik ikon klon dari kumpulan ikon di sebelah kanan. Ini menciptakan salinan variabel dengan nama variabel asli diawali dengancopy_of_.

Hapus: Untuk menghapus variabel, klik ikon sampah dari kumpulan ikon di sebelah kanan.

Filter variabel dengan regex

Menggunakan opsi Regex Query, Anda memfilter daftar opsi yang dikembalikan oleh kueri variabel atau memodifikasi opsi yang dikembalikan.

Halaman ini menunjukkan cara menggunakan regex untuk memfilter/memodifikasi nilai dalam dropdown variabel.

Menggunakan Opsi Kueri Regex, Anda memfilter daftar opsi yang dikembalikan oleh kueri Variabel atau memodifikasi opsi yang dikembalikan. Untuk informasi selengkapnya, lihat panduan Mozilla tentang ekspresi Reguler.

Contoh berikut menunjukkan pemfilteran pada daftar opsi berikut

backend_01
backend_02
backend_03
backend_04

Filter sehingga hanya opsi yang diakhiri dengan 01 atau 02 dikembalikan

Regex:

/
(
01|02 
) 
$/

Hasil:

backend_01
backend_02

Filter dan ubah opsi menggunakan grup tangkapan regex untuk mengembalikan bagian teks

Regex:

/.* 
(
01|02 
)
/

Hasil:

01
02

Filter dan modifikasi - Contoh Prometheus

Daftar opsi:

up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000

Regex:

/. *instance="
(
[^"]*
)
.*/

Hasil:

demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100

Filter dan modifikasi menggunakan teks bernama dan grup penangkap nilai

Menggunakan grup tangkapan bernama, Anda dapat menangkap bagian 'teks' dan 'nilai' terpisah dari opsi yang dikembalikan oleh kueri variabel. Hal ini memungkinkan daftar dropdown variabel berisi nama ramah untuk setiap nilai yang dapat dipilih.

Misalnya, saat menanyakan metrik node_hwmon_chip_names Prometheus, nilainya jauh lebih ramah chip_name daripada nilainya. chip Jadi hasil query variabel berikut:

node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1

Melewati Regex berikut:

/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g

Akan menghasilkan daftar dropdown berikut:

Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3

Hanya text dan value menangkap nama grup yang didukung.

Halaman variabel memungkinkan Anda dengan mudah mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel atau dasbor lain.

Setiap variabel yang direferensikan atau digunakan memiliki tanda centang hijau di sebelahnya, sementara variabel yang tidak direferensikan memiliki ikon peringatan oranye di sebelahnya. Selain itu, semua variabel yang direferensikan memiliki ikon ketergantungan di sebelah tanda centang hijau. Anda dapat memilih ikon untuk melihat peta ketergantungan. Peta ketergantungan dapat dipindahkan. Anda dapat memperbesar atau memperkecil dengan roda mouse atau yang setara.