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 kueri, 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 mengirim kueri ke Monarch, bukan mengirim kueri data dari server Prometheus lokal, Anda akan mendapatkan pemantauan global dalam skala besar.

Sebelum memulai

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

Cakupan kueri dan metrik

Data yang dapat Anda kueri ditentukan oleh konstruksi Cloud Monitoring, yaitu cakupan metrik, 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 pencakupan dapat memiliki lebih dari satu project yang dipantau dalam cakupan metriknya, dan metrik serta konfigurasi dari semua project yang dipantau dalam cakupan metrik terlihat oleh project pencakupan. Project yang dipantau juga dapat menjadi bagian dari lebih dari satu cakupan metrik.

Saat 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 Anda berisi semua project, kueri dan aturan Anda akan dievaluasi secara global.

Untuk mengetahui informasi selengkapnya tentang project cakupan dan cakupan metrik, lihat Cakupan metrik. Untuk mengetahui 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 berbagi 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 konsolGoogle Cloud untuk Monitoring, dan Anda dapat menyetel pemberitahuan berdasarkan metrik ini. Anda juga dapat mengimpor dasbor Grafana ke Cloud Monitoring.

Saat bekerja dengan 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 paling sederhana 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 Metrics explorer:
Buka 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 MQL atau PromQL.
Pastikan PromQL dipilih di tombol Language. Tombol bahasa ada di toolbar yang sama yang memungkinkan Anda memformat kueri.
Masukkan kueri berikut ke editor, lalu klik Run query:
```
up
```

Jika data Anda sedang di-ingest, Anda akan melihat diagram seperti berikut:

Diagram Metrics Explorer untuk metrik aktif Managed Service for Prometheus.

Untuk mengetahui 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 Metrics Explorer dan diagram Cloud Monitoring, lihat PromQL di Cloud Monitoring.

Opsi kueri lainnya di Cloud Monitoring

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

Di konsol Google Cloud , buka halaman Metrics explorer:
Buka Metrics explorer

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Tentukan data yang akan dimunculkan pada diagram. Selain menggunakan tombol PromQL yang dijelaskan sebelumnya, Anda juga dapat menggunakan antarmuka berbasis menu. Untuk membuat kueri, lakukan hal berikut:
1. Di dalam panel pembuat kueri, klik "Pilih metrik".
2. Di kolom penelusuran, ketik "up/" untuk memfilter daftar, lalu pilih Prometheus Target, lalu pilih Up, lalu pilih Prometheus/up/gauge.
3. 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 tidak umum lainnya dengan benar.

Resource `prometheus_target`

Di Cloud Monitoring, data deret waktu ditulis terhadap jenis resource yang dimonitor. Untuk metrik Prometheus, jenis resource yang dimonitor adalah prometheus_target. Kueri Monitoring 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 (regionGoogle Cloud ) tempat data disimpan. Nilai ini biasanya adalah region cluster GKE atau instance Compute Engine Anda. Jika data dikumpulkan dari deployment AWS atau lokal, nilai tersebut 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.