Membuat kueri menggunakan Cloud Monitoring

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 kueri, dan cara menggunakan Cloud Monitoring untuk mengambil dan menggunakan data yang telah Anda kumpulkan.

Semua antarmuka kueri untuk Google Cloud Managed Service for Prometheus dikonfigurasi untuk mengambil data dari Monarch menggunakan Cloud Monitoring API. Dengan membuat kueri Monarch, bukan membuat kueri data dari server Prometheus lokal, Anda mendapatkan pemantauan global dalam skala besar.

Sebelum memulai

Jika Anda belum men-deploy layanan terkelola, siapkan koleksi terkelola atau koleksi yang di-deploy mandiri. Anda dapat melewati langkah ini jika hanya tertarik pada membuat kueri metrik Cloud Monitoring menggunakan PromQL.

Cakupan kueri dan metrik

Data yang dapat dibuat kueri ditentukan oleh cakupan metrik pembuatan Cloud Monitoring, terlepas dari metode yang Anda gunakan untuk membuat kueri data.

Cakupan metrik Monitoring adalah konstruksi hanya-baca yang memungkinkan Anda membuat kueri data metrik yang termasuk dalam 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 pencakupan 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 pencakupan. Project yang dipantau juga dapat termasuk dalam lebih dari satu cakupan metrik.

Saat Anda membuat kueri metrik dalam project pencakupan, dan jika project pencakupan tersebut menghosting cakupan metrik multi-project, Anda dapat mengambil data dari beberapa project. Jika cakupan metrik berisi semua project Anda, kueri dan aturan Anda akan dievaluasi secara global.

Untuk informasi selengkapnya tentang pencakupan project dan cakupan metrik, lihat Cakupan metrik. Untuk informasi tentang cara mengonfigurasi cakupan metrik multi-project, baca Melihat metrik untuk beberapa project.

Data Google Cloud Managed Service for Prometheus di Cloud Monitoring

Managed Service for Prometheus berbagi backend penyimpanan data, Monarch, dengan Cloud Monitoring. Anda dapat menggunakan semua alat yang disediakan Cloud Monitoring dengan data yang dikumpulkan oleh Google Cloud Managed Service for Prometheus. Misalnya, Anda dapat menggunakan Metrics Explorer, seperti dijelaskan dalam Konsol Google Cloud untuk Monitoring, dan Anda dapat menyetel pemberitahuan berdasarkan metrik ini. Anda juga dapat mengimpor dasbor Grafana ke Cloud Monitoring.

Saat menangani 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 Cloud Monitoring Metrics Explorer di Konsol Google Cloud. Untuk memverifikasi bahwa data Prometheus Anda dikumpulkan dengan benar, lakukan hal berikut:

Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih Metrics Explorer:
Buka Metrics Explorer
Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah MQL atau PromQL.
Pastikan PromQL dipilih pada tombol Language. Tombol bahasa berada di toolbar yang sama dengan yang memungkinkan Anda memformat kueri.
Masukkan kueri berikut ke editor, lalu klik Run query:
```
up
```

Jika data Anda diserap, Anda akan melihat diagram seperti berikut:

Diagram Metrics Explorer untuk metrik atas Layanan Terkelola untuk Prometheus.

Untuk mengetahui informasi tentang cara membuat kueri metrik sistem Cloud Monitoring menggunakan PromQL, baca artikel PromQL untuk metrik Cloud Monitoring.

Untuk mengetahui informasi selengkapnya tentang penggunaan PromQL dalam diagram Metrics Explorer dan Cloud Monitoring, lihat PromQL di Cloud Monitoring.

Opsi kueri lain di Cloud Monitoring

Untuk melihat data Prometheus sebagai deret waktu Cloud Monitoring dan untuk membuat diagram dan dasbor, Anda juga dapat menggunakan antarmuka berbasis menu atau MQL. Berikut adalah kueri sederhana di Metrics Explorer:

Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih Metrics Explorer:
Buka Metrics Explorer
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:
1. Dalam panel pembuat kueri, klik "Pilih metrik".
2. Di kolom penelusuran, ketik "up/" untuk memfilter daftar, lalu pilih Target Prometheus, lalu pilih Up, lalu pilih Prometheus/up/gauge.
3. Klik "Terapkan".

Diagram yang dihasilkan dari kueri ini menampilkan data yang sama seperti diagram yang ditampilkan pada contoh PromQL.

Kueri yang dibuat menggunakan antarmuka berdasarkan menu dapat dikonversi ke PromQL dengan memilih tombol PromQL. Terjemahan ini mungkin tidak mengonversi fungsi histogram atau operator tidak umum lainnya dengan benar.

Resource `prometheus_target`

Dalam Cloud Monitoring, data deret waktu ditulis berdasarkan jenis resource yang dimonitor. Untuk metrik Prometheus, jenis resource yang dipantau 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 merupakan region cluster GKE atau instance Compute Engine. Jika data dikumpulkan dari AWS atau deployment lokal, maka nilainya mungkin merupakan 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.