Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine sehingga Anda dapat menggunakan Google Cloud Managed Service for Prometheus untuk mengumpulkan metrik dari Kube State Metrics. Dokumen ini menunjukkan cara melakukan hal berikut:
- Siapkan Metrik Status Kube untuk melaporkan metrik.
- Konfigurasi resource PodMonitoring untuk Google Cloud Managed Service for Prometheus guna mengumpulkan metrik yang diekspor.
- Akses dasbor di Cloud Monitoring untuk melihat metrik.
- Konfigurasi aturan pemberitahuan untuk memantau metrik.
Petunjuk ini hanya berlaku jika Anda menggunakan koleksi terkelola dengan Managed Service for Prometheus. Jika Anda menggunakan koleksi yang di-deploy sendiri, lihat repositori sumber untuk Metrik Status Kube guna mengetahui informasi penginstalan.
Petunjuk ini diberikan sebagai contoh dan diharapkan dapat berfungsi di sebagian besar lingkungan Kubernetes. Jika Anda mengalami masalah saat menginstal aplikasi atau pengekspor karena kebijakan organisasi atau keamanan yang ketat, sebaiknya baca dokumentasi open source untuk mendapatkan dukungan.Prasyarat
Untuk mengumpulkan metrik dari Kube State Metrics 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 Google Cloud Managed Service for Prometheus dengan mengaktifkan koleksi terkelola. Untuk informasi selengkapnya, lihat Mulai menggunakan koleksi terkelola.
- Agar dapat menggunakan dasbor yang tersedia di Cloud Monitoring untuk integrasi, Anda harus menggunakan
kube-state-metrics
versi 2.4.2 atau yang lebih baru.Untuk informasi selengkapnya tentang dasbor yang tersedia, lihat Menginstal dasbor.
Metrik Status Kube Terkelola
GKE menawarkan deployment metrik status kube yang terkelola sepenuhnya sebagai alternatif untuk mengonfigurasi integrasi ini. Paket yang dapat diinstal ini menyediakan kumpulan metrik status kube yang tidak dapat berubah dan diseleksi, yang tidak memerlukan banyak upaya penyiapan. Untuk mengetahui informasi selengkapnya, lihat Paket: Metrik status Kube.
Menginstal Metrik Status Kube
Anda dapat menggunakan konfigurasi berikut untuk menginstal Kube State Metrics:
Untuk menerapkan perubahan konfigurasi dari file lokal, jalankan perintah berikut:
kubectl apply -f FILE_NAME
Anda juga dapat menggunakan Terraform untuk mengelola konfigurasi Anda.
Menentukan aturan dan pemberitahuan
Anda dapat menggunakan konfigurasi Rules
berikut untuk menentukan pemberitahuan pada metrik:
Untuk menerapkan perubahan konfigurasi dari file lokal, jalankan perintah berikut:
kubectl apply -f FILE_NAME
Anda juga dapat menggunakan Terraform untuk mengelola konfigurasi Anda.
Untuk mengetahui informasi selengkapnya tentang cara menerapkan aturan ke cluster Anda, lihat Evaluasi dan pemberitahuan aturan terkelola.
KonfigurasiRules
ini diadaptasi dari aturan dan pemberitahuan yang dikontribusikan ke repositori kube-state-metrics.
Memverifikasi konfigurasi
Anda dapat menggunakan Metrics Explorer untuk memverifikasi bahwa Anda telah mengonfigurasi pengekspor dengan benar. Cloud Monitoring mungkin memerlukan waktu satu atau dua menit untuk menyerap metrik Anda.
Untuk memastikan metrik diserap, lakukan tindakan berikut:
-
Di panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih leaderboard Metrics Explorer:
- Di toolbar panel pembuat kueri, pilih tombol dengan nama 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="kube-state-metrics", cluster="CLUSTER_NAME", namespace="gmp-public"}
Menginstal dasbor
Cloud Monitoring menyediakan library contoh dasbor untuk integrasi. Library contoh mencakup dasbor "Prometheus", yang dapat Anda instal untuk melihat data di konsol Google Cloud.
Perhatikan bahwa dasbor Ringkasan Cluster Kubernetes Prometheus mengharuskan penginstalan Node Exporter. Dasbor Kubernetes Pod Prometheus Overview memerlukan penginstalan Node Exporter dan cAdvisor/Kubelet.
Untuk menginstal dasbor dari library contoh, lakukan hal berikut:
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih Dashboards:
- Pilih tab Sample Library.
- Pilih kategori Lainnya.
- (Opsional) Untuk melihat pratinjau statis dasbor tanpa menginstalnya, klik Preview.
- Pilih dasbor yang ingin Anda instal, lalu klik Impor.
Untuk informasi selengkapnya tentang cara menginstal dasbor, lihat Menginstal contoh dasbor.
Pemecahan masalah
Untuk mengetahui informasi tentang cara memecahkan masalah penyerapan metrik, lihat Masalah terkait pengumpulan dari pengekspor dalam Memecahkan masalah sisi penyerapan.