Menggunakan contoh Prometheus

Dokumen ini menjelaskan cara menggunakan Google Cloud Managed Service for Prometheus untuk menyerap contoh Prometheus pada metrik histogram. Anda harus menggunakan salah satu dari yang berikut:

  • Koleksi terkelola Google Cloud Managed Service for Prometheus versi 0.7.0 atau yang lebih tinggi
  • Layanan Terkelola untuk Prometheus yang di-deploy mandiri versi 2.35.0-gmp.5-gke.0 atau yang lebih tinggi
  • OpenTelemetry Collector

Contoh biasanya digunakan untuk mengaitkan ID trace dengan data metrik yang dikumpulkan dalam interval waktu, tetapi dapat digunakan untuk mengaitkan data non-metrik apa pun dengan metrik yang dikumpulkan. Dengan menyimpan informasi rekaman aktivitas dengan data metrik, Anda dapat dengan cepat mengidentifikasi trace yang terkait dengan perubahan nilai metrik yang tiba-tiba. Anda tidak perlu mereferensikan silang informasi rekaman aktivitas dan data metrik secara manual dengan menggunakan stempel waktu untuk mengidentifikasi apa yang terjadi dalam aplikasi saat data metrik direkam.

Contoh Google Cloud Managed Service for Prometheus kompatibel dengan Cloud Trace dan juga alat trace pihak ketiga seperti Grafana Tempo.

Screenshot berikut menunjukkan diagram Grafana yang berisi set bucket histogram dan contoh terkait, dengan satu contoh diperluas:

Diagram Grafana yang menampilkan bucket histogram dan contoh.

Contoh Prometheus dalam Google Cloud Managed Service for Prometheus

Contoh didukung di Prometheus dengan menggunakan format eksposisi OpenMetrics. Contoh OpenMetrics memiliki struktur berikut:

  • Nilai contoh: harus berupa bilangan bulat atau float 64-bit.
  • (Opsional) Stempel waktu: harus berupa Unix Epoch seconds, boleh negatif.
  • Sejumlah label untuk contoh, biasanya mencakup nilai trace_id dan span_id; panjang total semua nama dan nilai label tidak boleh melebihi 128 karakter UTF-8, atau 128 run di aplikasi Go.

Google Cloud Managed Service for Prometheus hanya dapat menyerap contoh yang dilampirkan ke metrik histogram. Contoh yang disertakan ke metrik penghitung tidak dapat diserap. Metrik histogram Prometheus dikonversi ke jenis Cloud Monitoring Distribution analog, yang mendukung contoh. Metrik non-distribusi di Cloud Monitoring tidak mendukung contoh.

Contoh tetap tersedia untuk pembuatan kueri selama 24 bulan. Bandingkan periode retensi data ini dengan Prometheus upstream, di mana contoh hanya disimpan saat data berada dalam memori, biasanya kurang dari 14 hari. Google Cloud Managed Service for Prometheus menyimpan contoh beserta deret waktu, sehingga contoh akan dipertahankan sesuai dengan kebijakan retensi untuk deret waktu tersebut. Untuk mengetahui informasi selengkapnya tentang retensi data di Cloud Monitoring, lihat Retensi data.

Mengaktifkan penyerapan contoh

Jika Anda menggunakan Managed Service for Prometheus dengan koleksi terkelola versi 0.7.0 atau yang lebih tinggi, penyerapan contoh akan otomatis diaktifkan.

Jika menggunakan Google Cloud Managed Service for Prometheus dengan koleksi yang di-deploy sendiri, Anda harus mengaktifkan penyerapan contoh saat memulai server dengan menentukan tanda fitur berikut:

--enable-feature=exemplar-storage

Menulis metrik dengan contoh

Setiap klien Prometheus memiliki petunjuk sendiri untuk menggunakan contoh dengan benar di klien tersebut. Ikuti petunjuk berikut agar aplikasi Anda menampilkan metrik dalam format OpenMetrics agar Prometheus dapat menyalin dari endpoint /metrics aplikasi. Misalnya, lihat referensi berikut:

Berintegrasi dengan Cloud Trace

Anda dapat menulis histogram Prometheus dengan contoh yang kompatibel dengan Cloud Trace. Anda dapat menampilkan data, termasuk contohnya, di diagram peta panas Cloud Monitoring, tempat Anda dapat menggunakan contoh untuk melihat detail tentang span rekaman aktivitas terkait. Anda juga dapat menganalisis data rekaman aktivitas di Trace. Untuk mengetahui informasi selengkapnya, lihat Menampilkan contoh di diagram peta panas dan Melihat detail rekaman aktivitas.

Untuk membuat contoh yang kompatibel dengan Trace, contoh Prometheus harus berisi label berikut:

  • project_id
  • trace_id
  • span_id

Jika contoh Anda menyertakan tiga label ini, label akan digunakan untuk membuat objek SpanContext yang kompatibel dengan Trace yang dilampirkan ke contoh yang dibuat untuk bucket Cloud Monitoring Distribution.

Semua label selain yang membentuk SpanContext lengkap ditambahkan ke objek DroppedLabels yang dilampirkan ke contoh untuk bucket Distribution.

Metrik kueri dengan contoh

Prometheus API mengekspos endpoint api/v1/query_exemplars untuk membuat kueri contoh.

Antarmuka kueri yang disiapkan untuk berinteraksi dengan Google Cloud Managed Service for Prometheus secara otomatis menyertakan contoh pembuatan kueri. Untuk mengetahui informasi tentang cara menyiapkan antarmuka kueri, lihat Kueri menggunakan Grafana atau Kueri menggunakan API atau UI Prometheus.