Membuat dan mengelola aturan peringatan Grafana - Amazon Managed Grafana
Membuat aturan peringatan terkelola Cortex atau LokiMembuat aturan perekaman terkelola Cortex atau LokiMembuat aturan peringatan terkelola GrafanaAnotasi dan label untuk aturan peringatanMengelola aturan peringatanGrup aturan dan ruang nama Cortex atau Loki

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

Membuat dan mengelola aturan peringatan Grafana

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

Aturan peringatan adalah seperangkat kriteria evaluasi yang menentukan apakah peringatan dimulai. Aturan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan opsional durasi di mana kondisi terpenuhi.

Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, kondisi menetapkan ambang batas yang harus dipenuhi peringatan, atau melebihi untuk membuat peringatan. Interval menentukan seberapa sering aturan peringatan dievaluasi. Durasi, ketika dikonfigurasi, menunjukkan berapa lama suatu kondisi harus dipenuhi. Aturan juga dapat menentukan perilaku peringatan tanpa adanya data.

Bagian berikut menjelaskan pembuatan dan pengelolaan berbagai jenis aturan peringatan Grafana.

Membuat aturan peringatan terkelola Cortex atau Loki

Menggunakan Grafana, Anda dapat membuat aturan peringatan untuk instance Cortex atau Loki eksternal.

catatan

Cortex adalah database deret waktu yang digunakan oleh Amazon Managed Service untuk sumber data Prometheus dan Prometheus.

Prasyarat

  • Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus. Jika tidak, Anda tidak dapat membuat atau memperbarui aturan peringatan terkelola Cortex.

  • Untuk sumber data Cortex dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.

    • Loki — Jenis penyimpanan local aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.

    • Cortex — Gunakan /api/prom awalan warisan, bukan. /prometheus Sumber data Prometheus mendukung Cortex dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

catatan

Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.

Untuk menambahkan aturan peringatan terkelola Cortex atau Loki

  1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan peringatan yang ada.

  2. Pilih Aturan peringatan baru.

  3. Pada Langkah 1, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut:

    • Dalam nama Aturan, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan alertname label untuk setiap instance peringatan yang dibuat dari aturan ini.

    • Dari tarik-turun tipe Aturan, pilih peringatan terkelola Cortex/Loki.

    • Dari menu tarik-turun Pilih sumber data, pilih Prometheus, atau sumber data Loki.

    • Dari dropdown Namespace, pilih namespace aturan yang ada. Jika tidak, pilih Tambahkan baru dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat Grup aturan dan ruang nama Cortex atau Loki.

    • Dari dropdown Grup, pilih grup yang ada dalam namespace yang dipilih. Jika tidak, pilih Tambahkan baru dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

  4. Pada Langkah 2, tambahkan kueri untuk mengevaluasi.

    Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

  5. Pada Langkah 3, tambahkan kondisi.

    Dalam Untuk kotak teks kondisi, tentukan durasi kondisinya harus benar sebelum peringatan dimulai. Jika Anda menentukan5m, kondisi harus benar selama lima menit sebelum peringatan dimulai.

    catatan

    Setelah suatu kondisi terpenuhi, peringatan masuk ke Pending negara. Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke Firing status. Jika tidak lagi terpenuhi, ia kembali ke Normal negara.

  6. Pada Langkah 4, tambahkan metadata tambahan yang terkait dengan aturan.

    • Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman diAnotasi dan label untuk aturan peringatan.

    • Tambahkan URL Runbook, panel, dasbor, dan ID peringatan.

    • Tambahkan label khusus.

  7. Pilih Pratinjau lansiran untuk mengevaluasi aturan dan melihat peringatan apa yang akan dihasilkannya. Ini menampilkan daftar peringatan dengan status dan nilai masing-masing.

  8. Pilih Simpan untuk menyimpan aturan atau Simpan dan keluar untuk menyimpan aturan dan kembali ke halaman Peringatan.

Membuat aturan perekaman terkelola Cortex atau Loki

Anda dapat membuat dan mengelola aturan perekaman untuk instance Cortex atau Loki eksternal. Aturan perekaman menghitung ekspresi yang sering dibutuhkan atau ekspresi mahal secara komputasi terlebih dahulu dan menyimpan hasilnya sebagai rangkaian waktu baru. Menanyakan deret waktu baru ini lebih cepat, terutama untuk dasbor karena mereka menanyakan ekspresi yang sama setiap kali dasbor disegarkan.

Prasyarat

Untuk sumber data Cortex dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.

  • Loki — Jenis penyimpanan local aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.

  • Korteks — Saat mengonfigurasi sumber data Grafana Prometheus untuk menunjuk ke Cortex, gunakan awalan lama, bukan. /api/prom /prometheus Sumber data Prometheus mendukung Cortex dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

catatan

Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.

Untuk menambahkan aturan perekaman terkelola Cortex atau Loki

  1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan peringatan yang ada.

  2. Pilih Aturan peringatan baru.

  3. Pada Langkah 1, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut.

    • Dalam nama Aturan, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan alertname label untuk setiap instance peringatan yang dibuat dari aturan ini.

    • Dari tarik-turun tipe Aturan, pilih peringatan terkelola Cortex/Loki.

    • Dari menu tarik-turun Pilih sumber data, pilih Prometheus, atau sumber data Loki.

    • Dari dropdown Namespace, pilih namespace aturan yang ada. Jika tidak, pilih Tambahkan baru dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat Grup aturan dan ruang nama Cortex atau Loki.

    • Dari dropdown Grup, pilih grup yang ada dalam namespace yang dipilih. Jika tidak, pilih Tambahkan baru dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

  4. Pada Langkah 2, tambahkan kueri untuk mengevaluasi.

    Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

  5. Pada Langkah 3, tambahkan metadata tambahan yang terkait dengan aturan.

    • Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman diAnotasi dan label untuk aturan peringatan.

    • Tambahkan URL Runbook, panel, dasbor, dan ID peringatan.

    • Tambahkan label khusus.

  6. Pilih Simpan untuk menyimpan aturan atau Simpan dan keluar untuk menyimpan aturan dan kembali ke halaman Peringatan.

Membuat aturan peringatan terkelola Grafana

Grafana memungkinkan Anda membuat aturan peringatan yang menanyakan satu atau lebih sumber data, mengurangi atau mengubah hasil dan membandingkannya satu sama lain atau untuk memperbaiki ambang batas. Ketika ini diproses, Grafana mengirimkan pemberitahuan ke titik kontak.

catatan

Membuat aturan peringatan terkelola Grafana saat menggunakan peringatan Grafana menyebabkan beberapa notifikasi dikirim saat aturan dicocokkan. Beberapa penyedia titik kontak mungkin memiliki opsi yang dapat dikonfigurasi untuk menghapus duplikat notifikasi.

Untuk menambahkan aturan terkelola Grafana

  1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan peringatan yang ada.

  2. Pilih Aturan peringatan baru.

  3. Pada Langkah 1, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut:

    • Dalam nama Aturan, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan alertname label untuk setiap instance peringatan yang dibuat dari aturan ini.

    • Dari tarik-turun Jenis aturan, pilih Grafana managed alert.

    • Dari dropdown Folder, pilih folder tempat Anda ingin menyimpan aturan. Jika Anda tidak memilih folder, aturan disimpan dalam General folder. Untuk membuat folder, pilih dropdown dan masukkan nama folder baru.

  4. Pada Langkah 2, tambahkan kueri dan ekspresi untuk mengevaluasi.

    • Simpan nama default atau arahkan kursor ke atas dan pilih ikon edit untuk mengubah nama.

    • Untuk kueri, pilih sumber data dari dropdown.

    • Tambahkan satu atau beberapa kueri atau ekspresi (untuk detail tentang ekspresi, lihat Ekspresi dalam dokumentasi Grafana).

    • Untuk setiap ekspresi, pilih salah satu kondisi Klasik untuk membuat aturan peringatan tunggal, atau pilih dari opsi Matematika, Kurangi, Sampel ulang untuk menghasilkan peringatan terpisah untuk setiap seri. Untuk detail tentang opsi ini, lihatAturan tunggal dan multidimensi.

    • Pilih Jalankan kueri untuk memverifikasi bahwa kueri berhasil.

  5. Pada Langkah 3, tambahkan kondisi.

    • Dari kondisi tarik-turun, pilih kueri atau ekspresi untuk memulai aturan peringatan.

    • Untuk Evaluasi setiap, tentukan frekuensi evaluasi. Harus kelipatan 10 detik. Misalnya,1m,30s.

    • Untuk Evaluasi untuk, tentukan durasi kondisinya harus benar sebelum peringatan dimulai.

      catatan

      Setelah suatu kondisi dilanggar, peringatan masuk ke Pending status. Jika kondisi tetap dilanggar selama durasi yang ditentukan, peringatan akan beralih ke status. Firing Jika tidak lagi terpenuhi, ia kembali ke Normal negara.

    • Di Konfigurasikan tidak ada data dan penanganan kesalahan, konfigurasikan perilaku peringatan jika tidak ada data. gunakan pedoman di. Tidak menangani data atau kasus kesalahan

    • Pilih Pratinjau lansiran untuk memeriksa hasil menjalankan kueri saat ini. Pratinjau mengecualikan tidak ada data dan kondisi penanganan kesalahan.

  6. Pada Langkah 4, tambahkan metadata tambahan yang terkait dengan aturan.

    • Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman diAnotasi dan label untuk aturan peringatan.

    • Tambahkan URL Runbook, panel, dasbor, dan ID peringatan.

    • Tambahkan label khusus.

  7. Pilih Simpan untuk menyimpan aturan atau Simpan dan keluar untuk menyimpan aturan dan kembali ke halaman Peringatan.

Aturan tunggal dan multidimensi

Untuk aturan peringatan terkelola Grafana, Anda dapat membuat aturan dengan kondisi klasik atau Anda dapat membuat aturan multidimensi.

Aturan dimensi tunggal (kondisi klasik)

Gunakan ekspresi kondisi klasik untuk membuat aturan yang memulai peringatan tunggal ketika kondisinya terpenuhi. Untuk kueri yang mengembalikan beberapa seri, Grafana tidak melacak status peringatan setiap seri. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.

Untuk informasi selengkapnya tentang cara memformat ekspresi, lihat Ekspresi dalam dokumentasi Grafana.

Aturan multidimensi

Untuk menghasilkan instance peringatan terpisah untuk setiap seri yang dikembalikan dalam kueri, buat aturan multidimensi.

catatan

Setiap instance peringatan yang dihasilkan oleh aturan multi-dimensi diperhitungkan dalam total kuota peringatan Anda. Aturan tidak dievaluasi ketika Anda mencapai kuota peringatan Anda. Untuk informasi selengkapnya tentang kuota untuk aturan multi-dimensi, lihat. Kuota mencapai kesalahan

Untuk membuat beberapa instance dari satu aturan, gunakan MathReduce, atau Resample ekspresi untuk membuat aturan multidimensi. Sebagai contoh, Anda dapat:

  • Tambahkan Reduce ekspresi untuk setiap kueri ke nilai agregat dalam rentang waktu yang dipilih menjadi satu nilai. (Tidak diperlukan untuk aturan menggunakan data numerik).

  • Tambahkan Math ekspresi dengan kondisi untuk aturan. Ini tidak diperlukan jika kueri atau ekspresi pengurangan sudah mengembalikan 0 jika aturan tidak harus memulai peringatan, atau angka positif jika harus memulai peringatan.

    Beberapa contoh:

    • $B > 70jika harus memulai peringatan jika nilai kueri/ekspresi B lebih dari 70.

    • $B < $C * 100dalam hal itu harus memulai peringatan jika nilai B kurang dari nilai C dikalikan dengan 100. Jika kueri yang dibandingkan memiliki beberapa seri dalam hasilnya, seri dari kueri yang berbeda dicocokkan jika mereka memiliki label yang sama, atau satu adalah bagian dari yang lain.

catatan

Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia di halaman komunitas Variabel Template tidak didukung dalam kueri peringatan saat menyiapkan Peringatan.

Pertimbangan kinerja untuk aturan multidimensi

Setiap instance peringatan dihitung terhadap kuota peringatan. Aturan multidimensi yang membuat lebih banyak instance daripada yang dapat diakomodasi dalam kuota peringatan tidak dievaluasi dan mengembalikan kesalahan kuota. Untuk informasi selengkapnya, lihat Kuota mencapai kesalahan.

Peringatan multidimensi dapat berdampak tinggi pada kinerja ruang kerja Grafana Anda, serta kinerja sumber data Anda saat Grafana menanyakannya untuk mengevaluasi aturan peringatan Anda. Pertimbangan berikut dapat membantu saat Anda mencoba mengoptimalkan kinerja sistem pemantauan Anda.

  • Frekuensi evaluasi aturan — Evaluasi Setiap properti dari aturan peringatan mengontrol frekuensi evaluasi aturan. Kami merekomendasikan menggunakan frekuensi evaluasi terendah yang dapat diterima.

  • Hasil set kardinalitas — Jumlah instance peringatan yang Anda buat dengan aturan memengaruhi kinerjanya. Misalkan Anda memantau kesalahan respons API untuk setiap jalur API, di setiap VM di armada Anda. Set ini memiliki kardinalitas jumlah jalur dikalikan dengan jumlah VM. Anda dapat mengurangi kardinalitas set hasil, misalnya, dengan memantau kesalahan total per VM, bukan per jalur per VM.

  • Kompleksitas kueri — Kueri yang sumber data dapat memproses dan merespons dengan cepat mengkonsumsi lebih sedikit sumber daya. Meskipun pertimbangan ini kurang penting daripada pertimbangan lain yang tercantum di atas, jika Anda telah menguranginya sebanyak mungkin, melihat kinerja kueri individu dapat membuat perbedaan. Anda juga harus menyadari dampak kinerja yang mengevaluasi aturan ini terhadap sumber data Anda. Kueri peringatan seringkali merupakan sebagian besar kueri yang ditangani oleh database pemantauan, jadi faktor beban yang sama yang memengaruhi instance Grafana juga memengaruhi mereka.

Kuota mencapai kesalahan

Ada kuota untuk jumlah instance peringatan yang dapat Anda miliki dalam satu ruang kerja. Ketika Anda mencapai nomor itu, Anda tidak dapat lagi membuat aturan peringatan baru di ruang kerja itu. Dengan peringatan multidimensi, jumlah instance peringatan dapat bervariasi dari waktu ke waktu.

Berikut ini penting untuk diingat saat bekerja dengan instance peringatan.

  • Jika Anda hanya membuat aturan satu dimensi, setiap aturan adalah contoh peringatan tunggal. Anda dapat membuat jumlah aturan yang sama dalam satu ruang kerja dengan kuota instans peringatan, dan tidak lebih.

  • Aturan multidimensi membuat beberapa contoh peringatan, namun jumlahnya tidak diketahui sampai dievaluasi. Misalnya, jika Anda membuat aturan peringatan yang melacak penggunaan CPU instans Amazon EC2 Anda, mungkin ada 50 instans EC2 saat Anda membuatnya (dan karenanya 50 instans peringatan), tetapi jika Anda menambahkan 10 instans EC2 lagi seminggu kemudian, evaluasi berikutnya memiliki 60 instance peringatan.

    Jumlah instans peringatan dievaluasi ketika Anda membuat peringatan multidimensi, dan Anda tidak dapat membuat satu yang segera menempatkan Anda di atas kuota instance peringatan Anda. Karena jumlah instans peringatan dapat berubah, kuota Anda akan diperiksa setiap kali aturan Anda dievaluasi.

  • Pada waktu evaluasi aturan, jika aturan menyebabkan Anda melampaui kuota untuk instance peringatan, aturan tersebut tidak dievaluasi hingga pembaruan dibuat pada aturan peringatan yang membawa jumlah total instance peringatan di bawah kuota layanan. Ketika ini terjadi, Anda menerima pemberitahuan peringatan yang memberi tahu Anda bahwa kuota Anda telah tercapai (notifikasi menggunakan kebijakan notifikasi untuk aturan yang sedang dievaluasi). Pemberitahuan mencakup Error anotasi dengan nilaiQuotaReachedError.

  • Aturan yang menyebabkan QuotaReachedError berhenti dievaluasi. Evaluasi hanya dilanjutkan ketika pembaruan dilakukan dan evaluasi setelah pembaruan tidak sendiri menyebabkan a. QuotaReachedError Aturan yang tidak dievaluasi menunjukkan kesalahan Kuota yang dicapai di konsol Grafana.

  • Anda dapat menurunkan jumlah instance peringatan dengan menghapus aturan peringatan, atau dengan mengedit peringatan multidimensi agar lebih sedikit instance peringatan (misalnya, dengan memiliki satu peringatan tentang kesalahan per VM, daripada satu peringatan tentang kesalahan per API di VM).

  • Untuk melanjutkan evaluasi, perbarui peringatan dan simpan. Anda dapat memperbaruinya untuk menurunkan jumlah instance peringatan, atau jika Anda telah membuat perubahan lain untuk menurunkan jumlah instance peringatan, Anda dapat menyimpannya tanpa perubahan. Jika bisa dilanjutkan, memang begitu. Jika itu menyebabkan yang lainQuotaReachedError, Anda tidak dapat menyimpannya.

  • Ketika peringatan disimpan dan melanjutkan evaluasi tanpa melewati kuota peringatan, kesalahan Kuota tercapai dapat terus ditampilkan di konsol Grafana untuk beberapa waktu (hingga interval evaluasinya), namun, evaluasi aturan peringatan akan dimulai dan peringatan dikirim jika ambang batas aturan terpenuhi.

  • Untuk detail tentang kuota peringatan, serta kuota lainnya, lihat. Kuota layanan Grafana yang Dikelola Amazon

Tidak menangani data atau kasus kesalahan

Pilih opsi untuk cara menangani perilaku peringatan jika tidak ada data atau ketika ada kesalahan.

Opsi untuk menangani tidak ada data tercantum dalam tabel berikut.

Tidak ada opsi Data Perilaku

Tidak ada Data

Buat peringatan DatasourceNoData dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label.

Peringatan

Tetapkan status aturan peringatan keAlerting.

OK

Tetapkan status aturan peringatan keNormal.

Opsi untuk menangani kasus kesalahan tercantum dalam tabel berikut.

Opsi kesalahan atau batas waktu Perilaku

Peringatan

Tetapkan status aturan peringatan ke Alerting

OK

Tetapkan status aturan peringatan ke Normal

Kesalahan

Buat peringatan DatasourceError dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label.

Anotasi dan label untuk aturan peringatan

Anotasi dan label adalah pasangan nilai kunci yang terkait dengan peringatan yang berasal dari aturan peringatan, respons sumber data, dan sebagai hasil dari evaluasi aturan peringatan. Mereka dapat digunakan dalam pemberitahuan peringatan secara langsung atau dalam template dan fungsi template untuk membuat kontak notifikasi secara dinamis.

Anotasi

Anotasi adalah pasangan nilai kunci yang memberikan informasi tambahan tentang peringatan. Anda dapat menggunakan anotasi berikut:description,,summary,runbook_url, alertIddashboardUid, danpanelId. Ini ditampilkan dalam detail aturan dan peringatan di UI dan dapat digunakan dalam templat pesan titik kontak.

Label

Label adalah pasangan nilai kunci yang berisi informasi tentang peringatan. Label yang ditetapkan untuk peringatan dibuat dan ditambahkan ke seluruh evaluasi peringatan dan proses notifikasi. Mereka digunakan dengan cara-cara berikut.

  • Kumpulan label lengkap untuk peringatan secara unik mengidentifikasi peringatan itu dalam Peringatan Grafana.

  • Alertmanager menggunakan label untuk mencocokkan peringatan untuk keheningan dan grup peringatan dalam kebijakan notifikasi.

  • UI peringatan menampilkan label untuk setiap instance peringatan yang dihasilkan oleh evaluasi aturan tersebut.

  • Titik kontak dapat mengakses label untuk menghasilkan notifikasi secara dinamis yang berisi informasi khusus untuk peringatan yang menghasilkan pemberitahuan.

  • Label dapat ditambahkan ke aturan peringatan. Label yang dikonfigurasi secara manual ini dapat menggunakan fungsi templat dan referensi label lain. Label yang ditambahkan ke aturan peringatan di sini diutamakan jika terjadi tabrakan antar label.

Variabel template berikut tersedia saat memperluas anotasi dan label.

Nama Penjelasan

$labels

Label dari kueri atau kondisi. Misalnya, {{ $labels.instance }} dan {{ $labels.job }}. Ini tidak tersedia ketika aturan menggunakan kondisi klasik.

$values

Nilai dari semua ekspresi reduce dan matematika yang dievaluasi untuk aturan peringatan ini. Misalnya,{{ $values.A }}, {{ $values.A.Labels }} dan {{ $values.A.Value }} di A mana refID ekspresinya. Ini tidak tersedia ketika aturan menggunakan kondisi klasik

$value

String nilai dari instance peringatan. Misalnya, [ var='A' labels={instance=foo} value=10 ].

Mengelola aturan peringatan

Halaman Peringatan mencantumkan aturan peringatan. Secara default, aturan dikelompokkan berdasarkan jenis sumber data. Bagian Grafana mencantumkan aturan yang dikelola oleh Grafana, dan bagian Cortex/Loki mencantumkan aturan untuk sumber data yang kompatibel dengan Prometheus. Anda dapat melihat aturan peringatan untuk sumber data yang kompatibel dengan Prometheus tetapi Anda tidak dapat mengeditnya.

Lihat aturan peringatan

Menggunakan peringatan Grafana, Anda dapat melihat semua peringatan Anda dalam satu halaman.

Untuk melihat detail peringatan

  1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan. Secara default, aturan ditampilkan dalam grup berdasarkan tipe sumber data. Anda juga dapat melihat berdasarkan status saat ini dari setiap peringatan (ini dijelaskan secara lebih rinci dalam teks berikut).

  2. Di View as, Anda dapat beralih antara tampilan grup dan status dengan memilih opsi yang Anda inginkan.

  3. Pilih panah di sebelah baris untuk melihat detail lebih lanjut untuk baris itu. Detail untuk aturan mencakup label aturan, anotasi, sumber data, dan kueri, serta daftar instance peringatan yang dihasilkan dari aturan.

Tampilan grup

Tampilan grup menunjukkan aturan peringatan Grafana yang dikelompokkan berdasarkan folder dan aturan peringatan Loki atau Prometheus yang dikelompokkan berdasarkan +. namespace group Ini adalah tampilan daftar aturan default, yang ditujukan untuk mengelola aturan. Anda dapat memperluas setiap grup untuk melihat daftar aturan dalam grup ini. Perluas aturan lebih lanjut untuk melihat detailnya. Anda juga dapat memperluas tombol tindakan dan peringatan yang dihasilkan dari aturan untuk melihat detailnya.

Tampilan negara

Tampilan status menunjukkan aturan peringatan yang dikelompokkan berdasarkan negara bagian. Gunakan tampilan ini untuk mendapatkan gambaran umum tentang aturan mana yang berada dalam keadaan apa. Setiap aturan dapat diperluas untuk melihat detailnya. Tombol tindakan dan peringatan apa pun yang dihasilkan oleh aturan ini, dan setiap peringatan dapat diperluas lebih lanjut untuk melihat detailnya.

Filter aturan peringatan

Anda dapat memfilter aturan peringatan yang muncul di halaman Peringatan dengan beberapa cara.

  • Anda dapat memfilter untuk menampilkan aturan yang menanyakan sumber data tertentu dengan memilih Pilih sumber data, lalu memilih sumber data yang akan difilter.

  • Anda dapat memfilter berdasarkan label dengan memilih kriteria pencarian di Cari berdasarkan label. Beberapa kriteria sampel meliputienvironment=production,region=~US|EU,severity!=warning.

  • Anda dapat memfilter untuk menampilkan aturan dalam keadaan tertentu dengan memilih Menyaring peringatan menurut negara, lalu memilih status yang ingin Anda lihat.

Mengedit atau menghapus aturan peringatan

Aturan peringatan terkelola Grafana hanya dapat diedit atau dihapus oleh pengguna dengan izin Edit untuk folder yang menyimpan aturan. Aturan peringatan untuk instance Cortex atau Loki eksternal dapat diedit atau dihapus oleh pengguna dengan peran Editor atau Admin.

Untuk mengedit atau menghapus aturan

  1. Perluas aturan hingga Anda dapat melihat kontrol aturan untuk Lihat, Edit, dan Hapus.

  2. Pilih Edit untuk membuka halaman aturan buat. Buat pembaruan dengan cara yang sama seperti Anda membuat aturan. Untuk detailnya, lihat instruksi di Membuat aturan peringatan terkelola Grafana atauMembuat aturan peringatan terkelola Cortex atau Loki.

  3. Secara opsional, pilih Hapus untuk menghapus aturan.

Grup aturan dan ruang nama Cortex atau Loki

Anda dapat mengatur aturan Anda. Aturan dibuat dalam grup aturan, dan grup aturan diatur ke dalam ruang nama. Aturan dalam kelompok aturan dijalankan secara berurutan pada interval reguler. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama Cortex atau Loki dan grup aturan, dan mengedit interval evaluasi grup aturan.

Untuk mengedit grup aturan atau namespace

  1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon Peringatan (bel) untuk membuka halaman Peringatan.

  2. Arahkan ke aturan dalam grup aturan atau namespace yang ingin Anda edit.

  3. Pilih ikon Edit (pena).

  4. Buat perubahan pada grup aturan atau namespace.

    catatan

    Untuk ruang nama, Anda hanya dapat mengedit nama. Untuk grup aturan, Anda mengubah nama, atau interval evaluasi untuk aturan dalam grup. Misalnya, Anda dapat memilih 1m agar aturan dievaluasi sekali per menit, atau 30s mengevaluasi setiap 30 detik sekali.

  5. Pilih Simpan perubahan.