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 2 tahun data.
Jika Anda menggunakan Prometheus di lingkungan di 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 konsol Google Cloud dan menentukan kueri PromQL di editor kode, lihat Membuat kebijakan pemberitahuan berbasis PromQL (Konsol).
Untuk membuat kebijakan pemberitahuan berbasis PromQL menggunakan gcloud CLI atau konstruksi
AlertPolicydi 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.
Pemberitahuan yang dibuat oleh kebijakan pemberitahuan berbasis PromQL muncul di konsol Google Cloud bersama pemberitahuan lainnya. Anda dapat berinteraksi dengan pemberitahuan ini di konsol Google Cloud .
Kondisi kebijakan pemberitahuan berbasis PromQL dapat mereferensikan metrik apa pun di Cloud Monitoring, termasuk Google Cloud metrik sistem, metrik kustom dan 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 data metrik selama lebih dari 2 tahun
Tidak seperti jenis kebijakan pemberitahuan lainnya yang hanya mendukung pembuatan kueri selama lebih dari 25 jam data metrik, Anda dapat menggunakan PromQL untuk memberikan 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 7 hari.
- Mendapatkan nilai rata-rata selama sebulan terakhir dan memberikan pemberitahuan jika data per jam terbaru lebih dari 3 simpangan baku dari rata-rata tersebut.
- Menggunakan fungsi
predict_linearselama seminggu terakhir untuk melihat apakah Anda akan melampaui nilai minimum pada hari berikutnya.
Kebijakan pemberitahuan PromQL yang beroperasi selama 25 jam data terbaru,
seperti yang ditentukan oleh jumlah periode perataan dan setiap pergeseran waktu yang disebabkan oleh
penggunaan pengubah offset, dapat dievaluasi sesering setiap 30 detik.
Kebijakan yang beroperasi pada data 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 seconds |
| 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 layanan Google Cloud hanya mendukung interval evaluasi 30 detik hingga 23 jam 30 menit.
Pastikan untuk menetapkan durasi rate setidaknya selama interval evaluasi agar kebijakan pemberitahuan tidak kehilangan data. 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 mengalami waktu tunggu habis di Metrics Explorer, kueri tersebut tidak akan mengalami waktu tunggu habis 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 penyelarasan, dan setiap pergeseran waktu yang disebabkan oleh penggunaan pengubah offset paling banyak 25 jam.
Periode pengujian ulang dinonaktifkan untuk kueri pemberitahuan PromQL yang mengakses data yang lebih lama dari 25 jam.
Anda hanya dapat membuat notifikasi untuk data 25 jam terakhir untuk metrik
kustom (awalan custom.googleapis.com) dan metrik Berbasis Log yang ditentukan pengguna
(awalan logging.googleapis.com/user/).
Pembatasan
Jangan menambahkan filter yang menggunakan label metadata sistem ke kebijakan pemberitahuan berbasis PromQL.
Kebijakan pemberitahuan berbasis PromQL dapat memiliki periode pengujian ulang maksimal 24 jam. Jika Anda menggunakan periode tes ulang, jumlah periode tes ulang, periode penyesuaian, dan setiap pergeseran 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 terlebih dahulu 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 notifikasi palsu. Untuk mengetahui informasi selengkapnya, lihat Peringatan palsu karena anomali penghitungan rasio.
Harga
Untuk mempelajari harga Cloud Monitoring, lihat halaman Harga Google Cloud Observability.