Server gRPC

Dokumen ini menjelaskan cara mengonfigurasi deployment Google Kubernetes Engine sehingga Anda dapat menggunakan Layanan Terkelola Google Cloud untuk Prometheus guna mengumpulkan metrik dari permintaan gRPC yang ditayangkan oleh aplikasi Anda. Dokumen ini menjelaskan cara melakukan hal berikut:

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

Untuk informasi selengkapnya tentang gRPC, lihat grpc.io.

Siapkan

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

Untuk memverifikasi bahwa server gRPC Anda memunculkan metrik di endpoint yang diharapkan, lakukan hal berikut:

  1. Siapkan penerusan port 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 di sesi terminal lain.

Menentukan resource PodMonitoring

Untuk penemuan target, Operator Managed Service for Prometheus memerlukan resource PodMonitoring yang sesuai dengan server gRPC di 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.

Melihat metrik aplikasi

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

  1. Di konsol Google Cloud, buka halaman Workloads:

    Buka Workloads

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Kubernetes Engine.

  2. Klik Deployment dalam daftar workload. Kolom Jenis dalam daftar menunjukkan jenis beban kerja.
  3. Di halaman Deployment details, klik tab Observability.
  4. 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.