Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine sehingga Anda dapat menggunakan Layanan Terkelola Google Cloud untuk Prometheus guna mengumpulkan metrik dari permintaan HTTP yang ditayangkan oleh aplikasi Anda. Dokumen ini menjelaskan cara melakukan hal berikut:
- Siapkan aplikasi Anda untuk mengekspor metrik HTTP dalam format yang telah ditentukan.
- Konfigurasikan resource PodMonitoring untuk Managed Service for Prometheus guna mengumpulkan metrik yang diekspor.
- Lihat dasbor Aplikasi untuk Deployment GKE Anda.
Petunjuk ini hanya berlaku jika Anda menggunakan koleksi terkelola dengan Managed Service for Prometheus.
Siapkan
Untuk mengumpulkan metrik dari server HTTP yang dapat ditampilkan di dasbor Aplikasi, Anda harus mengekspor metrik berikut seperti yang dijelaskan:
http_requests_total
dari jeniscounter
, dengan labelcode
danmethod
.http_request_duration_seconds_bucket
dari jenishistogram
, dengan labelmethod
.
Untuk contoh yang mengumpulkan metrik ini menggunakan klien Prometheus Go, lihat prometheus-example-app.
Untuk memverifikasi bahwa server HTTP Anda memunculkan metrik di endpoint yang diharapkan, lakukan hal berikut:
- Siapkan penerusan port menggunakan perintah berikut:
kubectl -n NAMESPACE_NAME port-forward deploy/HTTP_SERVER_DEPLOYMENT_NAME PROMETHEUS_PORT_NUMBER
- Akses
localhost:PROMETHEUS_PORT_NUMBER
dengan 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 server HTTP di namespace yang sama.
Anda dapat menggunakan konfigurasi PodMonitoring berikut:
apiVersion: monitoring.googleapis.com/v1 kind: PodMonitoring metadata: name: my-prometheus-http-app labels: app.kubernetes.io/name: my-prometheus-http-app app.kubernetes.io/part-of: google-cloud-managed-prometheus spec: endpoints: - port: web scheme: http interval: 30s path: /metrics selector: matchLabels: app.kubernetes.io/name: prometheus-example-app
Pastikan nilai kolom port
dan MatchLabels
cocok dengan nilai aplikasi HTTP yang ingin Anda pantau.
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.
Melihat metrik aplikasi
Untuk melihat metrik permintaan, rasio error, dan latensi dari aplikasi HTTP Anda, lakukan hal berikut:
-
Di konsol Google Cloud, buka halaman Workloads:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Kubernetes Engine.
- Klik Deployment dalam daftar workload. Kolom Jenis dalam daftar menunjukkan jenis beban kerja.
- Di halaman Deployment details, klik tab Observability.
- Pilih Aplikasi di pemilih dasbor.
Untuk informasi selengkapnya, lihat Menggunakan metrik performa aplikasi.
Pemecahan masalah
Untuk informasi tentang cara memecahkan masalah penyerapan metrik di Managed Service for Prometheus, lihat Masalah terkait pengumpulan dari eksportir di Memecahkan masalah sisi penyerapan.