Dokumen ini menjelaskan penggunaan Prometheus Query Language (PromQL) di Cloud Monitoring. PromQL menyediakan alternatif untuk antarmuka Metrics Explorer berbasis menu dan Monitoring Query Language (MQL) untuk membuat diagram dan dasbor.
Anda dapat menggunakan PromQL untuk membuat kueri dan diagram data Cloud Monitoring dari sumber berikut:
- Layanan Google Cloud, seperti Google Kubernetes Engine atau Compute Engine, yang menulis metrik yang dijelaskan dalam daftar metrik sistem Cloud Monitoring.
- Metrik yang ditentukan pengguna, seperti metrik berbasis log dan metrik yang ditentukan pengguna Cloud Monitoring.
- Google Cloud Managed Service for Prometheus, solusi multi-cloud yang terkelola sepenuhnya untuk Prometheus dari Google Cloud. Untuk informasi tentang layanan terkelola, termasuk dukungan dari PromQL, lihat Google Cloud Managed Service for Prometheus.
Anda juga dapat menggunakan alat seperti Grafana untuk memetakan data metrik yang diserap ke dalam Cloud Monitoring. Metrik yang tersedia mencakup metrik dari metrik Managed Service for Prometheus dan Cloud Monitoring yang didokumentasikan dalam daftar metrik. Untuk informasi tentang cara menyiapkan Grafana dan alat lainnya berdasarkan Prometheus API, lihat dokumentasi Managed Service for Prometheus tentang Grafana.
Anda juga dapat mengimpor dasbor Grafana ke Cloud Monitoring.
Konvensi penamaan
Model metrik dan konvensi penamaan Prometheus berbeda dengan yang digunakan oleh Cloud Monitoring. Untuk menggunakan PromQL guna membuat kueri data metrik Monitoring, Anda harus mengonversi nama Cloud Monitoring menjadi nama yang setara dan kompatibel dengan PromQL. Untuk informasi tentangkonvensi penamaan, lihat Memetakan metrik Cloud Monitoring ke PromQL.
Mengakses PromQL di Cloud Monitoring
Anda dapat menggunakan PromQL dari tab Code di halaman berikut di konsol Google Cloud:
- Metrics Explorer
- Tambahkan Diagram saat membuat dasbor kustom
Untuk informasi tentang cara mengakses dan menggunakan editor, lihat Menggunakan editor PromQL.
Aturan dan pemberitahuan Prometheus
Anda dapat menggunakan PromQL untuk membuat aturan perekaman dan pemberitahuan pada metrik apa pun di Cloud Monitoring dengan menggunakan pemberitahuan bergaya Prometheus di Managed Service for Prometheus. Untuk informasi selengkapnya, lihat Pemberitahuan dan evaluasi aturan terkelola atau Pemberitahuan dan evaluasi aturan yang di-deploy sendiri.
Mempelajari PromQL
Untuk mempelajari dasar-dasar penggunaan PromQL, sebaiknya baca dokumentasi open source. Referensi berikut dapat membantu Anda memulai:
Perbedaan PromQL
PromQL untuk Cloud Monitoring mungkin berfungsi sedikit berbeda dari PromQL upstream. Untuk mengetahui daftar perbedaan ini, lihat Perbedaan PromQL.