Server gRPC

Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine Anda, sehingga Anda dapat menggunakan Google Cloud Managed Service for Prometheus untuk mengumpulkan metrik dari permintaan gRPC yang dilayani oleh aplikasi Anda. Dokumen ini menjelaskan cara melakukan hal berikut:

• Menyiapkan middleware gRPC Prometheus untuk Go dan Java.
• Konfigurasikan resource PodMonitoring bagi Google Cloud Managed Service for Prometheus untuk mengumpulkan metrik yang diekspor.
• Lihat dasbor Application untuk Deployment GKE Anda.

Petunjuk ini hanya berlaku jika Anda menggunakan koleksi terkelola dengan Managed Service for Prometheus.

Untuk informasi selengkapnya tentang gRPC, lihat grpc.io.

Penyiapan

Untuk mengumpulkan metrik dari server gRPC, Anda harus mengonfigurasi middleware gRPC yang sesuai.

• Jika Anda menggunakan Go, lihat go-grpc-middleware.
• Jika Anda menggunakan Java, lihat java-grpc-prometheus.

Untuk memastikan bahwa server gRPC Anda memunculkan metrik pada endpoint yang diharapkan, lakukan hal berikut:

1. Siapkan penerusan port dengan menggunakan perintah berikut:

   kubectl -n NAMESPACE_NAME port-forward deploy/GRPC_SERVER_DEPLOYMENT_NAME PROMETHEUS_PORT_NUMBER
     

2. Akses localhost:PROMETHEUS_PORT_NUMBER dengan menggunakan browser atau utilitas curl dalam sesi terminal lainnya.

Menentukan resource PodMonitoring

Untuk penemuan target, Operator Layanan Terkelola untuk Prometheus memerlukan resource PodMonitoring yang sesuai dengan server gRPC dalam namespace yang sama.

Anda dapat menggunakan konfigurasi PodMonitoring berikut:

apiVersion: monitoring.googleapis.com/v1
kind: PodMonitoring
metadata:
  name: my-prometheus-grpc-app
  labels:
    app.kubernetes.io/name: my-prometheus-grpc-app
    app.kubernetes.io/part-of: google-cloud-managed-prometheus
spec:
  endpoints:
  - port: prometheus
    scheme: http
    interval: 30s
    path: /metrics
  selector:
    matchLabels:
      app.kubernetes.io/name: my-prometheus-grpc-app

Pastikan nilai kolom port dan MatchLabels cocok dengan nilai aplikasi gRPC 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.

Lihat metrik aplikasi

Untuk melihat metrik permintaan, tingkat error, dan latensi dari aplikasi gRPC Anda, lakukan hal berikut:

1. Pada panel navigasi Konsol Google Cloud, pilih Kubernetes Engine, lalu pilih Beban Kerja:

   Buka Beban Kerja Kubernetes

2. Klik Deployment dalam daftar beban kerja. Kolom Type dalam daftar menunjukkan jenis beban kerja.
3. Di halaman Detail deployment, klik tab Kemampuan observasi.
4. Pilih Aplikasi di pemilih dasbor.

Untuk mengetahui informasi selengkapnya, lihat Menggunakan metrik performa aplikasi.

Pemecahan masalah

Untuk mengetahui informasi tentang cara memecahkan masalah proses transfer metrik di Managed Service for Prometheus, lihat Masalah terkait pengumpulan dari pengekspor di Memecahkan masalah sisi penyerapan.