Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine agar Anda dapat menggunakan Google Cloud Managed Service for Prometheus untuk mengumpulkan metrik dari layanan PROMEX untuk HAProxy. Dokumen ini menunjukkan cara melakukan hal berikut:
- Siapkan layanan PROMEX untuk HAProxy guna melaporkan metrik.
- Konfigurasikan resource PodMonitoring untuk Managed Service for Prometheus guna mengumpulkan metrik yang diekspor.
- Akses dasbor di Cloud Monitoring untuk melihat metrik.
- Konfigurasikan aturan pemberitahuan untuk memantau metrik.
Petunjuk ini hanya berlaku jika Anda menggunakan koleksi terkelola dengan Managed Service for Prometheus. Jika Anda menggunakan pengumpulan yang di-deploy sendiri, lihat dokumentasi HAProxy untuk informasi penginstalan.
Petunjuk ini diberikan sebagai contoh dan diharapkan berfungsi di sebagian besar lingkungan Kubernetes. Jika Anda mengalami masalah saat menginstal aplikasi atau eksportir karena kebijakan organisasi atau keamanan yang membatasi, sebaiknya konsultasikan dokumentasi open source untuk mendapatkan dukungan.
Untuk mengetahui informasi tentang HAProxy, lihat HAProxy.
Prasyarat
Untuk mengumpulkan metrik dari layanan PROMEX untuk HAProxy menggunakan Managed Service for Prometheus dan pengumpulan terkelola, deployment Anda harus memenuhi persyaratan berikut:
- Cluster Anda harus menjalankan Google Kubernetes Engine versi 1.21.4-gke.300 atau yang lebih baru.
- Anda harus menjalankan Managed Service for Prometheus dengan pengumpulan terkelola diaktifkan. Untuk informasi selengkapnya, lihat Mulai menggunakan koleksi terkelola.
- Untuk menggunakan dasbor yang tersedia di Cloud Monitoring untuk integrasi HAProxy, Anda harus menggunakan
haproxy_promex
versi 2.4 atau yang lebih baru.Untuk mengetahui informasi selengkapnya tentang dasbor yang tersedia, lihat Melihat dasbor.
frontend
yang sesuai disertakan dalam konfigurasi.
Sebagian besar image Docker resmi untuk versi yang lebih besar dari atau sama dengan 2.4 dibuat dengan mengaktifkan layanan ini.
Contoh konfigurasi berikut dibuat dengan mereferensikan dokumentasi HAProxy Enterprise. Fitur ini berfungsi dengan edisi komunitas dan dapat dimodifikasi agar sesuai dengan kebutuhan tertentu:
Mengubah konfigurasi HAProxy
Ubah konfigurasi HAProxy seperti yang ditunjukkan dalam contoh berikut:
Anda harus menambahkan baris yang diawali dengan simbol +
ke konfigurasi Anda.
Untuk menerapkan perubahan konfigurasi dari file lokal, jalankan perintah berikut:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
Anda juga dapat menggunakan Terraform untuk mengelola konfigurasi.
Untuk memverifikasi bahwa layanan PROMEX untuk HAProxy memunculkan metrik di endpoint yang diharapkan,lakukan hal berikut:
- Siapkan penerusan port menggunakan perintah berikut:
kubectl -n NAMESPACE_NAME port-forward POD_NAME 8404
- Akses endpoint
localhost:8404/metrics
menggunakan browser atau utilitascurl
di sesi terminal lain.
Menentukan resource PodMonitoring
Untuk penemuan target, Operator Managed Service for Prometheus memerlukan resource PodMonitoring yang sesuai dengan eksportir HAProxy di namespace yang sama.
Anda dapat menggunakan konfigurasi PodMonitoring berikut:
Pastikan nilai kolomport
dan matchLabels
cocok dengan nilai pod HAProxy yang ingin Anda pantau.
HAProxy mengekspos metrik dari target yang ditentukan dalam opsi konfigurasi bind
. Opsi ini mengharuskan pengguna menentukan alamat IP
dan port yang akan didengarkan untuk metrik scraping.
Untuk menerapkan perubahan konfigurasi dari file lokal, jalankan perintah berikut:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
Anda juga dapat menggunakan Terraform untuk mengelola konfigurasi.
Menentukan aturan dan pemberitahuan
Anda dapat menggunakan konfigurasi Rules
berikut untuk menentukan pemberitahuan pada metrik HAProxy:
Untuk menerapkan perubahan konfigurasi dari file lokal, jalankan perintah berikut:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
Anda juga dapat menggunakan Terraform untuk mengelola konfigurasi.
Untuk informasi selengkapnya tentang cara menerapkan aturan ke cluster, lihat Evaluasi dan pemberitahuan aturan terkelola.
Memverifikasi konfigurasi
Anda dapat menggunakan Metrics Explorer untuk memverifikasi bahwa Anda telah mengonfigurasi eksportir HAProxy dengan benar. Mungkin perlu waktu satu atau dua menit agar Cloud Monitoring menyerap metrik Anda.
Untuk memverifikasi bahwa metrik telah diserap, lakukan tindakan 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 dan jalankan kueri berikut:
up{job="haproxy", cluster="CLUSTER_NAME", namespace="NAMESPACE_NAME"}
Melihat dasbor
Integrasi Cloud Monitoring mencakup dasbor Ringkasan Prometheus HAProxy. Dasbor akan otomatis diinstal saat Anda mengonfigurasi integrasi. Anda juga dapat melihat pratinjau statis dasbor tanpa menginstal integrasi.
Untuk melihat dasbor yang terinstal, lakukan tindakan berikut:
-
Di konsol Google Cloud, buka halaman Dasbor:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Pilih tab Daftar Dasbor.
- Pilih kategori Integrasi.
- Klik nama dasbor, misalnya, Ringkasan Prometheus HAProxy.
Untuk melihat pratinjau statis dasbor, lakukan tindakan berikut:
-
Di konsol Google Cloud, buka halaman Integrations:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Klik filter platform deployment Kubernetes Engine.
- Temukan integrasi HAProxy, lalu klik Lihat Detail.
- Pilih tab Dasbor.
Pemecahan masalah
Untuk informasi tentang cara memecahkan masalah penyerapan metrik, lihat Masalah terkait pengumpulan dari eksportir di Memecahkan masalah sisi penyerapan.