Jenis variabel - Amazon Managed Grafana

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

Jenis variabel

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

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

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

Grafana menggunakan beberapa jenis variabel.

Jenis variabel Deskripsi
Kueri Daftar nilai yang dihasilkan kueri seperti nama metrik, nama server, ID sensor, pusat data, dan sebagainya. Untuk informasi selengkapnya, lihat Menambahkan variabel kueri.
Kustom Tentukan opsi variabel secara manual menggunakan daftar yang dipisahkan koma. Untuk informasi selengkapnya, lihat Menambahkan variabel kustom.
Kotak teks Menampilkan bidang input teks dengan nilai default opsional. Untuk informasi selengkapnya, lihat Menambahkan variabel kotak teks.
Konstan Tentukan konstanta tersembunyi. Untuk informasi selengkapnya, lihat Menambahkan variabel konstan.
Sumber data Ubah sumber data dengan cepat untuk seluruh dasbor. Untuk informasi selengkapnya, lihat Menambahkan variabel sumber data.
Interval Variabel interval mewakili rentang waktu. Untuk informasi selengkapnya, lihat Menambahkan variabel interval.
Filter ad hoc Filter kunci/nilai yang secara otomatis ditambahkan ke semua kueri metrik untuk sumber data (InfluxDB, Prometheus, dan hanya). OpenSearch Untuk informasi selengkapnya, lihat Menambahkan filter ad hoc.
Variabel global Variabel bawaan yang dapat digunakan dalam ekspresi di editor kueri. Untuk informasi selengkapnya, lihat Variabel global.
Variabel yang dirantai Kueri variabel dapat berisi variabel lain. Untuk informasi selengkapnya, lihat Variabel yang dirantai.

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

Untuk memasukkan opsi umum untuk variabel kueri
  1. Arahkan ke dasbor yang ingin Anda buat variabel, lalu pilih ikon Pengaturan Dasbor (roda gigi) di bagian atas halaman.

  2. Pada tab Variables, pilih New.

  3. Masukkan Nama untuk variabel Anda.

  4. Dalam daftar Type, pilih Query.

  5. (Opsional) Untuk Label, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel.

  6. Pilih opsi Sembunyikan:

    • Tidak ada pilihan (kosong) - Daftar dropdown variabel menampilkan variabel Nama atau nilai Label. Ini adalah opsi default.

    • Label - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah.

    • Variabel - Tidak ada daftar dropdown variabel ditampilkan di dasbor.

Memasukkan opsi kueri

Untuk memasukkan opsi kueri untuk variabel kueri
  1. Dalam daftar Sumber data, pilih sumber data target untuk kueri. Untuk informasi selengkapnya tentang sumber data, lihatConnect ke sumber data.

  2. Dalam daftar Refresh, pilih kapan variabel harus memperbarui opsi.

    • Tidak pernah - Cache kueri variabel, dan nilai tidak diperbarui. Ini bagus jika nilainya tidak pernah berubah, tetapi bermasalah jika dinamis dan banyak berubah.

    • On Dashboard Load - Query sumber data setiap kali dashboard dimuat. Ini memperlambat pemuatan dasbor, karena kueri variabel harus diselesaikan sebelum dasbor dapat diinisialisasi.

    • Pada Perubahan Rentang Waktu - Menanyakan sumber data saat rentang waktu dasbor berubah. Gunakan opsi ini hanya jika kueri opsi variabel Anda berisi filter rentang waktu atau bergantung pada rentang waktu dasbor.

  3. Di bidang Query, masukkan kueri.

    • Bidang kueri bervariasi sesuai dengan sumber data Anda. Beberapa sumber data memiliki editor kueri khusus.

    • Jika Anda membutuhkan lebih banyak ruang dalam editor kueri bidang input tunggal, jeda pada baris di sudut kanan bawah bidang dan seret ke bawah untuk memperluas.

  4. (Opsional) Di bidang Regex, ketik ekspresi regex untuk memfilter atau menangkap bagian tertentu dari nama yang dikembalikan oleh kueri sumber data Anda. Sebagai contoh, lihat Memfilter variabel dengan regex.

  5. Dalam daftar Urutkan, pilih urutan pengurutan untuk nilai yang akan ditampilkan dalam daftar dropdown. Opsi default, Dinonaktifkan, berarti urutan opsi yang dikembalikan oleh kueri sumber data Anda akan digunakan.

  6. (Opsional) Masukkan Pilihan Pilihan. Untuk informasi selengkapnya, lihat Memasukkan opsi pemilihan variabel.

  7. Di Pratinjau nilai, ruang kerja Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

  8. Pilih Tambah untuk menambahkan variabel ke dasbor.

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

Untuk memasukkan opsi kueri untuk variabel kustom
  1. Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon Pengaturan Dasbor (roda gigi) di bagian atas halaman.

  2. Pada tab Variables, pilih New.

  3. Masukkan Nama untuk variabel Anda.

  4. Dalam daftar Jenis, pilih Kustom.

  5. (Opsional) Untuk Label, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel.

  6. Pilih opsi Sembunyikan:

    • Tidak ada pilihan (kosong) - Daftar dropdown variabel menampilkan variabel Nama atau nilai Label. Ini adalah opsi default.

    • Label - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah.

    • Variabel - Tidak ada daftar dropdown variabel ditampilkan di dasbor.

Memasukkan opsi kustom

Untuk memasukkan opsi kustom untuk variabel kustom
  1. Dalam daftar Nilai dipisahkan oleh koma, masukkan nilai untuk variabel ini dalam daftar yang dipisahkan koma. Anda dapat menyertakan angka, string, variabel lain, atau pasangan kunci-nilai yang dipisahkan oleh titik dua.

  2. (Opsional) Masukkan Pilihan Pilihan. Untuk informasi selengkapnya, lihat Memasukkan opsi pemilihan variabel.

  3. Di Pratinjau nilai, ruang kerja Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

  4. Pilih Tambah untuk menambahkan variabel ke dasbor.

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

Untuk memasukkan opsi umum untuk variabel kotak teks
  1. Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon Pengaturan Dasbor (roda gigi) di bagian atas halaman.

  2. Pada tab Variables, pilih New.

  3. Masukkan Nama untuk variabel Anda.

  4. Dalam daftar Jenis, pilih kotak Teks.

  5. (Opsional) Untuk Label, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, maka label dropdown akan menjadi nama variabel.

  6. Pilih opsi Sembunyikan:

    • Tidak ada pilihan (kosong) - Daftar dropdown variabel menampilkan variabel Nama atau nilai Label. Ini adalah opsi default.

    • Label - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah.

    • Variabel - Tidak ada daftar dropdown variabel ditampilkan di dasbor.

Memasukkan opsi teks

Untuk memasukkan opsi teks untuk variabel kotak teks
  1. (Opsional) Di bidang Nilai default, pilih nilai default untuk variabel. Jika Anda tidak memasukkan apa pun di bidang ini, maka Grafana menampilkan kotak teks kosong tempat Anda dapat mengetik teks.

  2. Di Pratinjau nilai, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

  3. Pilih Tambah untuk menambahkan variabel ke dasbor.

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

Untuk memasukkan opsi umum untuk variabel konstan
  1. Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon Dashboard settings (gear) di bagian atas halaman.

  2. Pada tab Variables, pilih New.

  3. Masukkan Nama untuk variabel Anda.

  4. Dalam daftar Type, pilih Constant.

  5. (Opsional) Untuk Label, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, maka label dropdown akan menjadi nama variabel.

  6. Pilih opsi Sembunyikan:

    • Variabel - Tidak ada daftar dropdown variabel ditampilkan di dasbor. Ini adalah opsi default.

    • Tidak ada pilihan (kosong) - Daftar dropdown variabel menampilkan variabel Nama atau nilai Label.

    • Label - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah.

Memasuki opsi konstan

Untuk memasukkan opsi konstan untuk variabel konstan
  1. Di bidang Nilai, masukkan nilai variabel. Anda dapat memasukkan huruf, angka, dan simbol. Jika Anda menggunakan opsi format variabel lanjutan, Anda bahkan dapat menggunakan kartu liar. Untuk informasi selengkapnya, lihat Opsi format variabel lanjutan.

  2. Di Pratinjau nilai, ruang kerja Grafana menampilkan nilai variabel saat ini. Tinjau untuk memastikannya sesuai dengan apa yang Anda harapkan.

  3. Pilih Tambah untuk menambahkan variabel ke dasbor.

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

Untuk memasukkan opsi umum untuk variabel sumber data
  1. Arahkan ke dasbor yang ingin Anda buat variabel, lalu pilih ikon Pengaturan Dasbor (roda gigi) di bagian atas halaman.

  2. Pada tab Variables, pilih New.

  3. Masukkan Nama untuk variabel Anda.

  4. Dalam daftar Type, pilih Datasource.

  5. (Opsional) Untuk Label, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel.

  6. Pilih opsi Sembunyikan:

    • Tidak ada pilihan (kosong) - Daftar dropdown variabel menampilkan variabel Nama atau nilai Label. Ini adalah opsi default.

    • Label - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah.

    • Variabel - Tidak ada daftar dropdown variabel ditampilkan di dasbor.

Memasukkan opsi sumber data

Untuk memasukkan opsi sumber data untuk variabel sumber data
  1. Dalam daftar Jenis, pilih sumber data target untuk variabel. Untuk informasi selengkapnya tentang sumber data, lihatConnect ke sumber data.

  2. (Opsional) Untuk filter nama Instance, masukkan filter regex yang instance sumber datanya dapat dipilih dalam daftar drop-down nilai variabel. Biarkan bidang ini kosong untuk menampilkan semua instance.

  3. (Opsional) Masukkan Pilihan Pilihan. Untuk informasi selengkapnya, lihat Memasukkan opsi pemilihan variabel.

  4. Di Pratinjau nilai, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

  5. Pilih Tambah untuk menambahkan variabel ke dasbor.

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

Untuk memasukkan opsi umum untuk variabel interval
  1. Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon Pengaturan Dasbor (roda gigi) di bagian atas halaman.

  2. Pada tab Variables, pilih New.

  3. Masukkan Nama untuk variabel Anda.

  4. Dalam daftar Jenis, pilih Interval.

  5. (Opsional) Untuk Label, masukkan nama tampilan dropdownlist variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel.

  6. Pilih opsi Sembunyikan:

    • Tidak ada pilihan (kosong) - Daftar dropdown variabel menampilkan variabel Nama atau nilai Label. Ini adalah opsi default.

    • Label - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah.

    • Variabel - Tidak ada daftar dropdown variabel ditampilkan di dasbor.

Memasuki opsi interval

Untuk memasukkan opsi interval untuk variabel interval
  1. Di bidang Nilai, masukkan interval rentang waktu yang ingin Anda tampilkan di daftar drop-down variabel. Unit waktu berikut didukung:s (seconds),,m (minutes),h (hours), d (days)w (weeks),M (months), dany (years). Anda juga dapat menerima atau mengedit nilai default:1m,10m,30m,1h,6h,12h,1d,7d,14d,30d.

  2. (Opsional) Aktifkan Opsi Otomatis jika Anda ingin menambahkan auto opsi ke daftar. Gunakan opsi ini untuk menentukan berapa kali rentang waktu saat ini harus dibagi untuk menghitung rentang auto waktu saat ini. Jika Anda menyalakannya, maka dua opsi lagi muncul:

    • Jumlah langkah - Pilih berapa kali rentang waktu saat ini akan dibagi untuk menghitung nilainya, mirip dengan opsi kueri poin data Maks. Misalnya, jika rentang waktu yang terlihat saat ini adalah 30 menit, maka auto interval mengelompokkan data menjadi 30 peningkatan satu menit. Nilai default adalah 30 langkah.

    • Interval Min — Ambang minimum di bawah mana interval hitungan langkah tidak akan membagi waktu. Untuk melanjutkan contoh 30 menit, jika interval minimum diatur ke2m, Grafana mengelompokkan data menjadi 15 kenaikan 2 menit.

  3. Di Pratinjau nilai, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

  4. Pilih Tambah untuk menambahkan variabel ke dasbor.

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.

catatan

Catatan: Variabel filter satu kali, atau ad hoc, hanya berfungsi dengan InfluxDB, Prometheus, dan sumber data. OpenSearch

Memasuki opsi umum

Untuk memasukkan opsi umum untuk filter ad hoc
  1. Arahkan ke dasbor yang ingin Anda buat variabel, lalu pilih ikon Pengaturan Dasbor (roda gigi) di bagian atas halaman.

  2. Pada tab Variables, pilih New.

  3. Masukkan Nama untuk variabel Anda.

  4. Dalam daftar Jenis, pilih Filter ad hoc.

  5. (Opsional) Untuk Label, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel.

  6. Pilih opsi Sembunyikan:

    • Tidak ada pilihan (kosong) - Daftar dropdown variabel menampilkan variabel Nama atau nilai Label. Ini adalah opsi default.

    • Label - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah.

    • Variabel - Tidak ada daftar dropdown variabel ditampilkan di dasbor.

Memasukkan opsi

Untuk memasukkan opsi untuk filter ad hoc
  1. Dalam daftar Sumber data, pilih sumber data target. Untuk informasi selengkapnya tentang sumber data, lihatConnect ke sumber data.

  2. Pilih Tambah untuk menambahkan variabel ke dasbor.

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

  • Variabel rantai menciptakan dependensi induk-anak. Anda dapat membayangkan mereka sebagai tangga atau pohon.

  • Cara tercepat untuk membuat variabel berantai baru adalah dengan menyalin variabel yang ingin Anda dasarkan pada yang baru. Dalam daftar variabel, pilih ikon variabel Duplikat di sebelah kanan entri variabel untuk membuat salinan. Anda kemudian dapat menambahkan ke kueri untuk variabel induk.

  • Variabel berantai baru yang Anda buat dengan cara ini muncul di bagian bawah daftar. Untuk memberikan daftar urutan logis, seret variabel ke posisi yang berbeda dalam daftar.

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.

  • Daftar variabel yang tidak memiliki dependensi di bagian atas, sebelum variabel anak mereka.

  • Setiap variabel harus mengikuti salah satu yang bergantung padanya.

  • UI tidak menunjukkan variabel mana yang memiliki hubungan ketergantungan. Buat daftar variabel dalam urutan logis untuk membuatnya lebih jelas bagi pengguna akhir (dan diri Anda sendiri).

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 Contoh hasil Deskripsi
${__from} 1594671549254 Epoch unix milidetik
${__from:date} 2020-07-13T 20:19:09.254 Z Tidak ada argumen, default ke ISO 8601/RFC 3339
${__from:date:iso} 2020-07-13T 20:19:09.254 Z ISO 8601/RFC 3339
${__from:date:seconds} 1594671549 Epoch detik Unix
${__from:date:YYYY-MM} 2020-07 Setiap format data kustom. Untuk informasi selengkapnya, lihat Tampilan.

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:

  • Klausul WHERE untuk sumber data InfluxDB. Grafana menambahkannya secara otomatis ke kueri InfluxDB saat dalam mode Query Editor. Anda dapat menambahkannya secara manual dalam mode Editor Teks:WHERE $timeFilter.

  • Kueri log Analytics di sumber data Azure Monitor.

  • Kueri SQL di MySQL, Postgres, dan MSSQL.

  • $__timeFilterVariabel ini digunakan dalam sumber data MySQL.