Setelah men-deploy Google Cloud Managed Service for Prometheus, Anda dapat membuat kueri data yang dikirim ke layanan terkelola dan menampilkan hasilnya dalam diagram dan dasbor.
Dokumen ini menjelaskan cakupan metrik, yang menentukan data yang dapat Anda buat kuerinya, dan cara menggunakan Cloud Monitoring untuk mengambil dan menggunakan data yang telah Anda kumpulkan.
Semua antarmuka kueri untuk Managed Service for Prometheus dikonfigurasi untuk mengambil data dari Monarch menggunakan Cloud Monitoring API. Dengan mengkueri Monarch, bukan mengkueri data dari server Prometheus lokal, Anda mendapatkan pemantauan global dalam skala besar.
Sebelum memulai
Jika Anda belum men-deploy layanan terkelola, siapkan pengumpulan terkelola atau pengumpulan yang di-deploy sendiri. Anda dapat melewati langkah ini jika hanya tertarik untuk membuat kueri metrik Cloud Monitoring menggunakan PromQL.
Cakupan kueri dan metrik
Data yang dapat Anda buat kuerinya ditentukan oleh cakupan metrik konstruk Cloud Monitoring, terlepas dari metode yang Anda gunakan untuk membuat kueri data.
Cakupan metrik Monitoring adalah konstruksi hanya-waktu baca yang memungkinkan Anda membuat kueri data metrik milik beberapa project Google Cloud. Setiap cakupan metrik dihosting oleh project Google Cloud yang ditetapkan, yang disebut project cakupan.
Secara default, project adalah project pencakupan untuk cakupan metriknya sendiri, dan cakupan metrik berisi metrik dan konfigurasi untuk project tersebut. Project cakupan dapat memiliki lebih dari satu project yang dipantau dalam cakupan metriknya, dan metrik serta konfigurasi dari semua project yang dipantau dalam cakupan metrik dapat dilihat oleh project cakupan. Project yang dipantau juga dapat termasuk dalam lebih dari satu cakupan metrik.
Saat membuat kueri metrik dalam project cakupan, dan jika project cakupan tersebut menghosting cakupan metrik multi-project, Anda dapat mengambil data dari beberapa project. Jika cakupan metrik Anda berisi semua project, kueri dan aturan Anda akan dievaluasi secara global.
Untuk informasi selengkapnya tentang cakupan project dan cakupan metrik, lihat Cakupan metrik. Untuk informasi tentang cara mengonfigurasi cakupan metrik multi-project, lihat Melihat metrik untuk beberapa project.
Data Managed Service for Prometheus di Cloud Monitoring
Managed Service for Prometheus menggunakan backend penyimpanan data, Monarch, dengan Cloud Monitoring. Anda dapat menggunakan semua alat yang disediakan oleh Cloud Monitoring dengan data yang dikumpulkan oleh Managed Service for Prometheus. Misalnya, Anda dapat menggunakan Metrics Explorer, seperti yang dijelaskan di Konsol Google Cloud untuk Monitoring, dan Anda dapat menetapkan pemberitahuan berdasarkan metrik ini. Anda juga dapat mengimpor dasbor Grafana ke Cloud Monitoring.
Saat menggunakan data metrik, termasuk data dari Managed Service for Prometheus, di Cloud Monitoring, Anda dapat menggunakan alat kueri yang disediakan oleh Cloud Monitoring:
Membuat kueri menggunakan PromQL di Cloud Monitoring
Cara termudah untuk membuat kueri data Prometheus adalah dengan menggunakan halaman Metrics Explorer Cloud Monitoring di konsol Google Cloud. Untuk memverifikasi bahwa data Prometheus Anda dikumpulkan dengan benar, lakukan hal berikut:
-
Di konsol Google Cloud, buka halaman leaderboard Metrics explorer:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah code MQL atau code PromQL.
Pastikan PromQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.
Masukkan kueri berikut ke editor, lalu klik Run query:
up
Jika data Anda sedang ditransfer, Anda akan melihat diagram seperti berikut:
Untuk informasi tentang cara membuat kueri metrik sistem Cloud Monitoring menggunakan PromQL, lihat PromQL untuk metrik Cloud Monitoring.
Untuk mengetahui informasi selengkapnya tentang cara menggunakan PromQL di diagram Metrics Explorer dan Cloud Monitoring, lihat PromQL di Cloud Monitoring.
Opsi kueri lainnya di Cloud Monitoring
Untuk melihat data Prometheus sebagai deret waktu Cloud Monitoring dan membuat diagram serta dasbor, Anda juga dapat menggunakan antarmuka berbasis menu atau MQL. Berikut adalah kueri sederhana di Metrics Explorer:
-
Di konsol Google Cloud, buka halaman leaderboard Metrics explorer:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Tentukan data yang akan muncul pada diagram. Selain menggunakan tombol PromQL yang dijelaskan sebelumnya, Anda juga dapat menggunakan antarmuka berbasis menu. Untuk membuat kueri, lakukan hal berikut:
Di panel pembuat kueri, klik "Pilih metrik".
Di kolom penelusuran, ketik "up/" untuk memfilter daftar, lalu pilih Prometheus Target, lalu pilih Up, lalu pilih Prometheus/up/gauge.
Klik "Terapkan".
Diagram yang dihasilkan dari kueri ini menampilkan data yang sama dengan diagram yang ditampilkan dalam contoh PromQL.
Kueri yang dibuat menggunakan antarmuka berbasis menu dapat dikonversi ke PromQL dengan memilih tombol PromQL. Terjemahan ini mungkin tidak mengonversi fungsi histogram atau operator umum lainnya dengan benar.
Resource prometheus_target
Di Cloud Monitoring, data deret waktu ditulis berdasarkan jenis resource yang dimonitor. Untuk metrik Prometheus, jenis resource yang dimonitor adalah prometheus_target. Kueri pemantauan untuk metrik Prometheus yang tidak ditulis dalam PromQL harus menentukan jenis resource ini.
Resource prometheus_target memiliki label berikut, yang dapat Anda
gunakan untuk memfilter dan memanipulasi data yang dikueri:
project_id: ID project Google Cloud yang terkait dengan resource ini.location: Lokasi fisik (region Google Cloud) tempat data disimpan. Nilai ini biasanya adalah region cluster GKE atau instance Compute Engine Anda. Jika data dikumpulkan dari deployment AWS atau lokal, nilainya mungkin region Google Cloud terdekat.cluster: Cluster GKE atau konsep terkait; mungkin kosong.namespace: Namespace GKE atau konsep terkait; mungkin kosong.job: Label tugas target Prometheus, jika diketahui; mungkin kosong untuk hasil evaluasi aturan.instance: Label instance target Prometheus, jika diketahui; mungkin kosong untuk hasil evaluasi aturan.
Nilai untuk label ini ditetapkan selama pengumpulan.
Langkah selanjutnya
- Siapkan pemberitahuan PromQL menggunakan Cloud Monitoring.
- Impor dasbor Grafana ke Cloud Monitoring.