Pertanyaan dan kondisi

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

Di Grafana, kueri memainkan peran penting dalam mengambil dan mengubah data dari sumber data yang didukung, yang mencakup database seperti MySQL dan PostgreSQL, database deret waktu seperti Prometheus, InfluxDB dan Graphite, dan layanan seperti, Amazon, Azure Monitor dan Google Cloud Monitoring. OpenSearch CloudWatch

Untuk informasi selengkapnya tentang sumber data yang didukung, lihatSumber data dan peringatan Grafana.

Proses mengeksekusi query melibatkan mendefinisikan sumber data, menentukan data yang diinginkan untuk diambil, dan menerapkan filter atau transformasi yang relevan. Bahasa kueri atau sintaks khusus untuk sumber data yang dipilih digunakan untuk membangun kueri ini.

Dalam Peringatan, Anda menentukan kueri untuk mendapatkan data yang ingin Anda ukur dan kondisi yang perlu dipenuhi sebelum aturan peringatan diaktifkan.

Aturan peringatan terdiri dari satu atau beberapa kueri dan ekspresi yang memilih data yang ingin Anda ukur.

Untuk informasi selengkapnya tentang kueri dan ekspresi, lihatKueri dan transformasi data.

Kueri sumber data

Kueri di Grafana dapat diterapkan dengan berbagai cara, tergantung pada sumber data dan bahasa kueri yang digunakan. Setiap editor kueri sumber data menyediakan antarmuka pengguna yang disesuaikan yang membantu Anda menulis kueri yang memanfaatkan kemampuan uniknya.

Karena perbedaan antara bahasa kueri, setiap editor kueri sumber data terlihat dan berfungsi secara berbeda. Bergantung pada sumber data Anda, editor kueri mungkin menyediakan fitur pelengkapan otomatis, nama metrik, saran variabel, atau antarmuka pembuatan kueri visual.

Beberapa jenis komponen kueri yang umum meliputi:

Bidang metrik atau data — Tentukan metrik atau bidang data tertentu yang ingin Anda ambil, seperti penggunaan CPU, lalu lintas jaringan, atau pembacaan sensor.

Rentang waktu - Tentukan rentang waktu yang ingin Anda ambil data, seperti jam terakhir, hari tertentu, atau rentang waktu khusus.

Filter — Terapkan filter untuk mempersempit data berdasarkan kriteria tertentu, seperti memfilter data dengan tag, host, atau aplikasi tertentu.

Agregasi — Lakukan agregasi pada data untuk menghitung metrik seperti rata-rata, jumlah, atau hitungan selama periode waktu tertentu.

Pengelompokan — Kelompokkan data berdasarkan dimensi atau tag tertentu untuk membuat tampilan atau rincian gabungan.

catatan

Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia di sini di forum Grafana Labs.

Kueri ekspresi

Dalam Grafana, ekspresi digunakan untuk melakukan perhitungan, transformasi, atau agregasi pada data kueri sumber data. Ini memungkinkan Anda untuk membuat metrik khusus atau memodifikasi metrik yang ada berdasarkan operasi matematika, fungsi, atau ekspresi logis.

Dengan memanfaatkan kueri ekspresi, pengguna dapat melakukan tugas-tugas seperti menghitung persentase perubahan antara dua nilai, menerapkan fungsi seperti fungsi logaritmik atau trigonometri, menggabungkan data pada rentang waktu atau dimensi tertentu, dan menerapkan logika bersyarat untuk menangani skenario yang berbeda.

Di Peringatan, Anda hanya dapat menggunakan ekspresi untuk aturan peringatan yang dikelola Grafana. Untuk setiap ekspresi, Anda dapat memilih dari ekspresi matematika, kurangi, dan sampel ulang. Ini disebut aturan multi-dimensi, karena mereka menghasilkan peringatan terpisah untuk setiap seri.

Anda juga dapat menggunakan kondisi klasik, yang membuat aturan peringatan yang memicu peringatan tunggal ketika kondisinya terpenuhi. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.

catatan

Kondisi klasik ada terutama untuk alasan kompatibilitas dan harus dihindari jika memungkinkan.

Mengurangi

Mengagregat nilai deret waktu dalam rentang waktu yang dipilih menjadi satu nilai.

Matematika

Melakukan fungsi/operasi matematika bentuk bebas pada deret waktu dan data angka. Dapat digunakan untuk memproses data deret waktu atau untuk menentukan kondisi peringatan untuk data angka.

Sampel ulang

Menyelaraskan kembali rentang waktu ke set stempel waktu baru, ini berguna saat membandingkan data deret waktu dari sumber data yang berbeda di mana stempel waktu tidak akan sejajar.

Ambang

Memeriksa apakah ada data deret waktu yang cocok dengan kondisi ambang batas.

Ekspresi ambang memungkinkan Anda membandingkan dua nilai tunggal. Ia kembali 0 ketika kondisinya salah dan 1 jika kondisinya benar. Fungsi ambang berikut tersedia:

• Di atas (x> y)

• Di bawah ini (x < y)

• Berada dalam jangkauan (x> y1 DAN x < y2)

• Berada di luar jangkauan (x < y1 AND x > y2)

Kondisi klasik

Memeriksa apakah ada data deret waktu yang cocok dengan kondisi peringatan.

catatan

Kueri ekspresi kondisi klasik selalu menghasilkan satu instance peringatan saja, tidak peduli berapa banyak deret waktu yang memenuhi kondisi tersebut. Kondisi klasik ada terutama untuk alasan kompatibilitas dan harus dihindari jika memungkinkan.

Agregasi

Grafana Alerting menyediakan fungsi agregasi berikut untuk memungkinkan Anda menyempurnakan kueri lebih lanjut.

Fungsi-fungsi ini hanya tersedia untuk ekspresi kondisi Reduce dan Classic.

Fungsi	Ekspresi	Apa yang dilakukannya
rata-rata	Kurangi/Klasik	Menampilkan rata-rata nilai
min	Kurangi/Klasik	Menampilkan nilai terendah
max	Kurangi/Klasik	Menampilkan nilai tertinggi
sum	Kurangi/Klasik	Menampilkan jumlah semua nilai
count	Kurangi/Klasik	Menghitung jumlah nilai dalam hasil
last	Kurangi/Klasik	Menampilkan nilai terakhir
median	Kurangi/Klasik	Menampilkan nilai median
diff	Klasik	Menampilkan perbedaan antara nilai terbaru dan terlama
diff_abs	Klasik	Menampilkan nilai absolut diff
percent_diff	Klasik	Menampilkan nilai persentase perbedaan antara nilai terbaru dan tertua
percent_diff_abs	Klasik	Menampilkan nilai absolut dari percent_diff
count_non_null	Klasik	Menampilkan hitungan nilai dalam kumpulan hasil yang tidak null

Kondisi peringatan

Kondisi peringatan adalah kueri atau ekspresi yang menentukan apakah peringatan akan diaktifkan atau tidak tergantung pada nilai yang dihasilkannya. Hanya ada satu kondisi yang akan menentukan pemicu peringatan.

Setelah Anda menentukan kueri dan/atau ekspresi Anda, pilih salah satunya sebagai kondisi aturan peringatan.

Ketika data kueri memenuhi kondisi yang ditentukan, Grafana memicu peringatan terkait, yang dapat dikonfigurasi untuk mengirim pemberitahuan melalui berbagai saluran seperti email, Slack, atau. PagerDuty Pemberitahuan memberi tahu Anda tentang kondisi yang dipenuhi, memungkinkan Anda untuk mengambil tindakan yang sesuai atau menyelidiki masalah yang mendasarinya.

Secara default, ekspresi terakhir yang ditambahkan digunakan sebagai kondisi peringatan.

Ambang pemulihan

Untuk mengurangi kebisingan peringatan mengepak, Anda dapat mengatur ambang pemulihan yang berbeda dengan ambang peringatan.

Peringatan mengepak terjadi ketika metrik melayang di sekitar kondisi ambang peringatan dan dapat menyebabkan perubahan status yang sering, mengakibatkan terlalu banyak notifikasi yang dihasilkan.

Aturan peringatan yang dikelola Grafana dievaluasi untuk interval waktu tertentu. Selama setiap evaluasi, hasil kueri diperiksa terhadap ambang batas yang ditetapkan dalam aturan peringatan. Jika nilai metrik berada di atas ambang batas, aturan peringatan akan diaktifkan dan pemberitahuan dikirim. Ketika nilai berada di bawah ambang batas dan ada peringatan aktif untuk metrik ini, peringatan diselesaikan, dan pemberitahuan lain dikirim.

Mungkin sulit untuk membuat aturan peringatan untuk metrik yang bising. Yaitu, ketika nilai metrik terus berjalan di atas dan di bawah ambang batas. Ini disebut mengepak dan menghasilkan serangkaian pemberitahuan penembakan - diselesaikan - penembakan dan riwayat status peringatan yang bising.

Misalnya, jika Anda memiliki peringatan untuk latensi dengan ambang 1000ms dan jumlahnya berfluktuasi sekitar 1000 (katakanlah 980 -> 1010 -> 990 -> 1020, dan seterusnya) maka masing-masing akan memicu pemberitahuan.

Untuk mengatasi masalah ini, Anda dapat menetapkan ambang pemulihan (kustom), yang pada dasarnya berarti memiliki dua ambang, bukan satu. Peringatan dipicu ketika ambang pertama dilintasi dan diselesaikan hanya ketika ambang kedua dilintasi.

Misalnya, Anda dapat menetapkan ambang 1000ms dan ambang pemulihan 900 ms. Dengan cara ini, aturan peringatan hanya akan berhenti menembak ketika berada di bawah 900 ms dan kepakan berkurang.