Halaman ini menjelaskan cara membuat kebijakan pemberitahuan berbasis PromQL di Cloud Monitoring. Anda dapat menggunakan kueri PromQL untuk membuat kondisi kompleks dengan fitur seperti rasio, nilai minimum dinamis berdasarkan metrik yang berbeda, dan metrik gabungan. Anda juga dapat mengonfigurasi kebijakan pemberitahuan berbasis PromQL untuk beroperasi selama lebih dari 2 tahun data.
Jika Anda menggunakan Prometheus di lingkungan luar Google Cloud, atau jika Anda menggunakan pemberitahuan di Managed Service for Prometheus, Anda dapat memigrasikan aturan pemberitahuan Prometheus ke kebijakan pemberitahuan berbasis PromQL. Dengan begitu, Anda dapat mengelola semua kebijakan pemberitahuan di Cloud Monitoring.
Anda juga dapat mengimpor dasbor Grafana ke Cloud Monitoring.
- Untuk mengetahui informasi umum tentang penggunaan PromQL di Monitoring, lihat PromQL di Cloud Monitoring.
- Untuk mengetahui informasi umum tentang kebijakan pemberitahuan, lihat Perilaku kebijakan pemberitahuan berbasis metrik.
Menggunakan PromQL dalam kebijakan pemberitahuan Cloud Monitoring
Anda dapat membuat kebijakan pemberitahuan berbasis PromQL dengan cara berikut:
Untuk membuat kebijakan pemberitahuan di Google Cloud konsol dan menentukan kueri PromQL di editor kode, lihat Membuat kebijakan pemberitahuan berbasis PromQL (Konsol).
Untuk membuat kebijakan pemberitahuan berbasis PromQL menggunakan gcloud CLI atau
AlertPolicykonstruksi di Monitoring API, lihat Membuat kebijakan pemberitahuan berbasis PromQL (API).Untuk memigrasikan aturan pemberitahuan dan saluran notifikasi Prometheus ke Cloud Monitoring menggunakan Google Cloud CLI, lihat Memigrasikan aturan pemberitahuan dan penerima dari Prometheus.
Insiden yang dibuat oleh kebijakan pemberitahuan berbasis PromQL akan muncul di Google Cloud konsol bersama insiden lainnya. Anda dapat berinteraksi dengan insiden ini di Google Cloud konsol.
Kondisi kebijakan pemberitahuan berbasis PromQL dapat mereferensikan metrik apa pun di Cloud Monitoring, termasuk Google Cloud metrik sistem, metrik kustom dan metrik berbasis log, serta metrik Prometheus. Anda harus menerjemahkan nama metrik non-Prometheus ke sintaksis metrik PromQL. Untuk mengetahui informasi selengkapnya, lihat Memetakan metrik Monitoring ke PromQL.
Membuat kueri lebih dari 2 tahun data metrik
Tidak seperti jenis kebijakan pemberitahuan lainnya yang hanya mendukung kueri lebih dari 25 jam data metrik, Anda dapat menggunakan PromQL untuk membuat pemberitahuan hingga 2 tahun data metrik. Hal ini mendukung kasus penggunaan seperti:
- Mendeteksi anomali dengan membandingkan 5 menit terakhir dengan periode 5 menit yang sama 1 minggu yang lalu.
- Menjalankan kebijakan pemberitahuan slow burn selama 7 hari.
- Mendapatkan nilai rata-rata selama sebulan terakhir dan membuat pemberitahuan jika data jam terbaru lebih dari 3 standar deviasi dari rata-rata tersebut.
- Menggunakan fungsi
predict_linearselama seminggu terakhir data untuk melihat apakah Anda akan melebihi nilai minimum pada hari berikutnya.
Kebijakan pemberitahuan PromQL yang beroperasi selama 25 jam data terbaru, seperti yang ditentukan oleh jumlah periode perataan dan setiap perubahan waktu yang disebabkan oleh penggunaan pengubah offset, dapat dievaluasi sesering setiap 30 detik.
Kebijakan yang beroperasi pada data yang lebih lama dievaluasi lebih jarang, dengan periode minimum ditentukan oleh seberapa jauh kebijakan pemberitahuan Anda melihat ke belakang:
| Rentang lihat kembali kueri | Interval evaluasi minimum (default) |
|---|---|
| Hingga 25 jam1 | 30 detik |
| 25 jam hingga 8 hari | 5 menit |
| 8 hari hingga 16 hari | 1 jam |
| 16 hari hingga 32 hari | 2 jam |
| 32 hari hingga 93 hari | 6 jam |
| 93 hari hingga 2 tahun | 12 jam |
1 Beberapa metrik dari Google Cloud layanan hanya mendukung interval evaluasi 30 detik hingga 23 jam 30 menit.
Pastikan untuk menetapkan durasi rate setidaknya selama interval evaluasi Anda sehingga kebijakan pemberitahuan tidak melewatkan data apa pun. Misalnya, jika interval evaluasi Anda adalah 1 jam, kueri Anda akan terlihat seperti rate(metric[1h]).
Kondisi yang beroperasi selama lebih dari 25 jam data memiliki batas waktu kueri 2 menit, yang cocok dengan batas waktu di Metrics Explorer. Jika kueri PromQL Anda tidak mencapai waktu tunggu di Metrics Explorer, kueri tersebut tidak akan mencapai waktu tunggu di pemberitahuan Anda.
Kebijakan pemberitahuan PromQL jauh lebih andal saat beroperasi selama 25 jam data terbaru. Untuk keandalan maksimum, pastikan jumlah jendela pengujian ulang, periode perataan, dan setiap perubahan waktu yang disebabkan oleh penggunaan pengubah offset paling banyak 25 jam.
Jendela pengujian ulang dinonaktifkan untuk kueri pemberitahuan PromQL yang mengakses data yang lebih lama dari 25 jam.
Anda hanya dapat membuat pemberitahuan pada 25 jam data terbaru untuk metrik kustom (awalan custom.googleapis.com) dan metrik Berbasis Log yang ditentukan pengguna (awalan logging.googleapis.com/user/).
Pembatasan
Jangan tambahkan filter yang menggunakan label metadata sistem ke kebijakan pemberitahuan berbasis PromQL.
Kebijakan pemberitahuan berbasis PromQL dapat memiliki jendela pengujian ulang maksimal 24 jam. Jika Anda menggunakan jendela pengujian ulang, jumlah jendela pengujian ulang, periode perataan, dan setiap perubahan waktu yang disebabkan oleh penggunaan pengubah offset harus maksimal 25 jam.
Jika aturan pemberitahuan Prometheus Anda mereferensikan metrik, Anda harus memiliki deskriptor metrik yang setara di Cloud Monitoring sebelum membuat kebijakan pemberitahuan berbasis PromQL. Namun, Anda dapat mengganti validasi ini dengan mengonfigurasi kebijakan pemberitahuan berbasis PromQL menggunakan Cloud Monitoring API. Untuk mengetahui informasi selengkapnya, lihat Menonaktifkan pemeriksaan keberadaan metrik.
Jika kebijakan pemberitahuan Anda memantau rasio metrik, tetapkan durasi setidaknya dua kali interval evaluasinya. Durasi yang lebih singkat dapat menyebabkan insiden palsu. Untuk mengetahui informasi selengkapnya, lihat Pemberitahuan palsu karena anomali perhitungan rasio.
Harga
Untuk mempelajari harga Cloud Monitoring, lihat halaman harga Google Cloud Observability.