Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine, sehingga Anda dapat menggunakan Google Cloud Managed Service for Prometheus untuk mengumpulkan metrik dari Istio. Dokumen ini menunjukkan cara melakukan hal berikut:
- Siapkan Istio 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 pengumpulan yang di-deploy sendiri, baca repositori sumber untuk Istio guna mengetahui informasi penginstalannya.
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.Untuk mengetahui informasi tentang Istio, lihat Istio.
Prasyarat
Untuk mengumpulkan metrik dari Istio 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.
Istio mengekspos metrik format Prometheus secara otomatis; Anda tidak perlu menginstalnya secara terpisah. Anda dapat menjalankan pemeriksaan berikut untuk memverifikasi bahwa Proxy Istio telah dimasukkan sebagai file bantuan dan Istiod, bidang kontrol Istio, serta Proxy Istio memberikan metrik tentang endpoint yang diharapkan.
Untuk menentukan apakah Proxy Istio dimasukkan sebagai file bantuan, jalankan perintah berikut, yang menghitung container yang berjalan di pod aplikasi:
kubectl get pod -l app=APPLICATION_NAME -n NAMESPACE_NAME -o jsonpath='{.items[0].spec.containers[*].name}'
Jika Anda melihat bahwa pod berisi container file bantuan
istio
, berarti pengekspor telah dimasukkan. Jika file bantuan tidak dimasukkan, ikuti petunjuk di Istio: Menginstal sespan.Untuk memverifikasi bahwa metrik dikeluarkan oleh Proxy Istio, jalankan perintah berikut, yang memeriksa endpoint
/stats/prometheus
dariistio
pada pod yang ditentukan:kubectl exec POD_NAME -n NAMESPACE_NAME -c istio-proxy -- curl -sS 'localhost:15090/stats/prometheus'
Jika Anda melihat metrik Prometheus
istio_*
danenvoy_*
mentah, berarti metrik ditampilkan dengan benar.Untuk memastikan bahwa metrik dimunculkan dengan cara yang sama di Istiod, jalankan perintah berikut, yang memeriksa endpoint
/metrics
dari Istiod di salah satu pod dalam deploymentistiod
:kubectl exec -n istio-system deployment/istiod -- curl -sS 'localhost:15014/metrics'
Menentukan resource PodMonitoring
Untuk penemuan target, Layanan Terkelola untuk Operator Prometheus memerlukan resource PodMonitoring yang sesuai dengan pengekspor Istio di namespace yang sama.
Anda dapat menggunakan konfigurasi PodMonitoring berikut:
Istio memerlukan dua resource PodMonitoring terpisah: Satu yang memantau Istiod dan satu lagi yang memantau file bantuan Proxy Istio serta gateway masuk dan keluar. Untuk memantau metrik Istio Proxy di seluruh namespace dalam cluster sekaligus, terapkan PodMonitoringistio-proxy
ke setiap namespace atau siapkan resource ClusterPodMonitoring, bukan resource PodMonitoring per namespace.
Jika Anda berencana menggunakan dasbor Grafana yang disediakan Istio, selain resource PodMonitoring yang dijelaskan dalam dokumen ini, pastikan Anda juga mengonfigurasi scraping cAdvisor dan Kubelet.
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 Anda.
Menentukan aturan dan pemberitahuan
Anda dapat menggunakan konfigurasi Rules
berikut untuk menentukan pemberitahuan di metrik Istio:
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 Anda.
Untuk mengetahui informasi selengkapnya tentang cara menerapkan aturan ke cluster Anda, lihat Evaluasi dan pemberitahuan aturan terkelola.
KonfigurasiRules
ini diadaptasi dari aturan Istio yang disediakan oleh Awesome Prometheus Alerts.
Anda dapat menyesuaikan nilai minimum pemberitahuan agar sesuai dengan aplikasi Anda.
Memverifikasi konfigurasi
Anda dapat menggunakan Metrics Explorer untuk memverifikasi bahwa Anda telah mengonfigurasi pengekspor Istio 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:
sum(istio_build{cluster="CLUSTER_NAME"}) by (component)
Lihat dasbor
Integrasi Cloud Monitoring meliputi dasbor Istio Envoy Prometheus Overview. Dasbor diinstal secara otomatis saat Anda mengonfigurasi integrasi. Anda juga dapat melihat pratinjau statis dasbor tanpa menginstal integrasi.
Untuk melihat dasbor yang terinstal, lakukan hal berikut:
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih
Dashboards:
- Pilih tab Daftar Dasbor.
- Pilih kategori Integrations.
- Klik nama dasbor, misalnya, Istio Envoy Prometheus Overview.
Untuk melihat pratinjau statis dasbor, lakukan hal berikut:
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih
Integrations:
- Klik filter platform deployment Kubernetes Engine.
- Temukan integrasi Istio, lalu klik View Details.
- Pilih tab Dasbor.
Pemecahan masalah
Untuk mengetahui informasi tentang cara memecahkan masalah penyerapan metrik, lihat Masalah terkait pengumpulan dari pengekspor dalam Memecahkan masalah sisi penyerapan.