Kueri Prometheus Query Language (PromQL) di Cloud Monitoring memungkinkan Anda membuat kebijakan pemberitahuan dengan kondisi yang kompleks seperti rasio metrik, nilai minimum dinamis berdasarkan metrik lain, dan metrik gabungan. Kebijakan ini dapat mengevaluasi data metrik hingga 2 tahun.
Jika Anda menggunakan Prometheus di lingkungan di luar Google Cloud atau menggunakan pemberitahuan di Google Cloud Managed Service for Prometheus, Anda dapat memigrasikan aturan pemberitahuan Prometheus ke kebijakan pemberitahuan berbasis PromQL. Dengan memigrasikan aturan, Anda dapat mengelola semua kebijakan pemberitahuan di Monitoring. Anda juga dapat mengimpor dasbor Grafana ke Cloud Monitoring. Untuk mengetahui informasi umum tentang penggunaan PromQL dan cara kebijakan pemberitahuan mengevaluasi data, lihat PromQL di Cloud Monitoring dan 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 akan muncul di konsol Google Cloud bersama pemberitahuan lainnya. Anda dapat berinteraksi dengan pemberitahuan ini di konsol Google Cloud .
Kondisi kebijakan pemberitahuan berbasis PromQL Anda dapat merujuk ke 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 data metrik selama lebih dari 2 tahun
Tidak seperti jenis kebijakan pemberitahuan lainnya yang hanya mendukung kueri data metrik selama 25 jam, Anda dapat menggunakan PromQL untuk memberikan pemberitahuan tentang data metrik hingga 2 tahun. 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 jam terbaru lebih dari 3 simpangan baku dari rata-rata tersebut.
- Menggunakan fungsi
predict_linearpada data minggu terakhir untuk melihat apakah Anda akan melampaui batas pada hari berikutnya.
Kebijakan pemberitahuan PromQL yang beroperasi selama 25 jam data terbaru, seperti yang ditentukan oleh jumlah periode penyelarasan dan 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 yang ditentukan oleh seberapa jauh kebijakan pemberitahuan Anda melihat ke belakang:
| Rentang lihat balik kueri | Interval evaluasi minimum (default) |
|---|---|
| Hingga 25 jam1 | 30 seconds |
| 25 jam hingga 8 hari | 5 menit |
| 8 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 dan 30 menit.
Pastikan untuk menetapkan durasi rate setidaknya selama interval evaluasi Anda agar 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 sesuai 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
pada data 25 jam terakhir. Untuk keandalan maksimum,
pastikan jumlah jendela pengujian ulang, periode penyelarasan, dan pergeseran waktu
yang disebabkan oleh penggunaan pengubah offset maksimal 25 jam.
Periode pengujian ulang dinonaktifkan untuk kueri pemberitahuan PromQL yang mengakses data yang lebih lama dari 25 jam.
Anda hanya dapat memberikan pemberitahuan pada data 25 jam terbaru 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 pengujian ulang, jumlah periode pengujian ulang,
periode penyelarasan, dan pergeseran waktu yang disebabkan oleh
penggunaan pengubah offset tidak boleh lebih dari 25 jam.
Jika aturan pemberitahuan Prometheus Anda merujuk ke 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 dengan 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 pemberitahuan palsu. Untuk mengetahui informasi selengkapnya, lihat Pemberitahuan palsu karena anomali penghitungan rasio.