Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine Anda sehingga Anda dapat menggunakan Google Cloud Managed Service for Prometheus untuk mengumpulkan metrik dari GKE Inference Gateway. Dokumen ini menunjukkan cara melakukan hal berikut:
- Siapkan GKE Inference Gateway untuk melaporkan metrik.
- Konfigurasi resource ClusterPodMonitoring untuk Managed Service for Prometheus guna mengumpulkan metrik yang diekspor.
- Akses dasbor di Cloud Monitoring untuk melihat 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 GKE Inference Gateway untuk mengetahui 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 keamanan atau organisasi yang ketat, sebaiknya lihat dokumentasi open source untuk mendapatkan dukungan.
Untuk mengetahui informasi tentang GKE Inference Gateway, lihat GKE Inference Gateway.
Prasyarat
Untuk mengumpulkan metrik dari pengekspor GKE Inference Gateway dengan menggunakan Managed Service for Prometheus dan pengumpulan terkelola, deployment Anda harus memenuhi persyaratan berikut:
- Cluster Anda harus menjalankan Google Kubernetes Engine versi 1.28.15-gke.2475000 atau yang lebih baru.
- Anda harus menjalankan Managed Service for Prometheus dengan koleksi terkelola yang diaktifkan. Untuk mengetahui informasi selengkapnya, lihat Mulai menggunakan koleksi terkelola.
Untuk memverifikasi bahwa eksportir GKE Inference Gateway memancarkan metrik di endpoint yang diharapkan, lakukan hal berikut:
Tambahkan secret, ServiceAccount, ClusterRole, dan ClusterBinding. Endpoint kemampuan observasi eksportir GKE Inference Gateway dilindungi oleh token autentikasi. Untuk mendapatkan kredensial, klien memerlukan Secret yang dipetakan ke akun layanan dengan ClusterRole yang terhubung, untuk aturan
nonResourceURLs: "/metrics", verbs: get
. Untuk mengetahui informasi selengkapnya, lihat Membuat secret untuk akun layanan.Siapkan penerusan port menggunakan perintah berikut:
kubectl -n NAMESPACE_NAME port-forward POD_NAME 9090
Di jendela lain, lakukan tindakan berikut:
Ambil token dengan menjalankan perintah berikut:
TOKEN=$(kubectl -n default get secret inference-gateway-sa-metrics-reader-secret -o jsonpath='{.secrets[0].name}' -o jsonpath='{.data.token}' | base64 --decode)
Akses endpoint
localhost:9090/metrics
menggunakan utilitascurl
:curl -H "Authorization: Bearer $TOKEN" localhost:9090/metrics
Membuat rahasia untuk akun layanan
Untuk endpoint pengekspor GKE Inference Gateway yang dilindungi, Operator Managed Service for Prometheus memerlukan secret untuk pengumpulan metrik yang sah di namespace gmp-system
.
Jika cluster Anda menggunakan mode Autopilot, ganti
gmp-system
dengan gke-gmp-system
.
Anda dapat menggunakan konfigurasi Secret, ServiceAccount, ClusterRole, dan ClusterRoleBinding berikut:
Untuk mengetahui informasi selengkapnya, lihat Panduan Metrik & Kemampuan Observasipengekspor.
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.
Tentukan resource ClusterPodMonitoring
Untuk penemuan target, Managed Service for Prometheus Operator memerlukan resource ClusterPodMonitoring yang sesuai dengan eksportir GKE Inference Gateway di namespace yang sama.
Anda dapat menggunakan konfigurasi ClusterPodMonitoring berikut:
GKE Inference Gateway menggunakan resource ClusterPodMonitoring
, bukan resource
PodMonitoring
karena perlu mengakses secret dari namespace lain.
Di pemilih matchLabels
konfigurasi ClusterPodMonitoring
,
Anda dapat mengganti nilai app
dari inference-gateway-ext-proc
dengan label
dari deployment GKE Inference Gateway 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 Anda.
Memverifikasi konfigurasi
Anda dapat menggunakan Penjelajah Metrik untuk memverifikasi bahwa Anda telah mengonfigurasi pengekspor GKE Inference Gateway dengan benar. Mungkin perlu waktu satu atau dua menit agar Cloud Monitoring dapat memproses metrik Anda.
Untuk memverifikasi bahwa metrik telah di-ingest, lakukan hal 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 code MQL atau code PromQL.
- Pastikan PromQL dipilih di tombol Language. Tombol bahasa ada di toolbar yang sama yang memungkinkan Anda memformat kueri.
- Masukkan dan jalankan kueri berikut:
inference_model_request_total{cluster="CLUSTER_NAME", namespace="NAMESPACE_NAME"}
Melihat dasbor
Integrasi Cloud Monitoring mencakup dasbor GKE Inference Gateway Prometheus Overview. 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
Dashboards:
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, GKE Inference Gateway Prometheus Overview.
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 GKE Inference Gateway, lalu klik Lihat Detail.
- Pilih tab Dasbor.
Pemecahan masalah
Untuk mengetahui informasi tentang cara memecahkan masalah penyerapan metrik, lihat Masalah pengumpulan dari eksportir di Memecahkan masalah sisi penyerapan.