Server gRPC

Questo documento descrive come configurare il tuo deployment Google Kubernetes Engine in modo da poter utilizzare Google Cloud Managed Service per Prometheus per raccogliere le metriche Richieste gRPC gestite dalla tua applicazione. Questo documento descrive come procedere:

Queste istruzioni sono valide solo se utilizzi raccolta gestita con Managed Service per Prometheus.

Per ulteriori informazioni su gRPC, consulta grpc.io.

Configura

Per raccogliere le metriche dal server gRPC, devi configurare il middleware gRPC appropriato.

Per verificare che il server gRPC emetta metriche nella risposta prevista endpoint, procedi nel seguente modo:

  1. Configura il port forwarding utilizzando il seguente comando: 
    kubectl -n NAMESPACE_NAME port-forward deploy/GRPC_SERVER_DEPLOYMENT_NAME PROMETHEUS_PORT_NUMBER
  2. Accedi a localhost:PROMETHEUS_PORT_NUMBER utilizzando il browser o l'utilità curl in un'altra sessione del terminale.

Definisci una risorsa PodMonitoring

Per il rilevamento del target, l'operatore Managed Service per Prometheus richiede una risorsa PodMonitoring che corrisponda gRPC nello stesso spazio dei nomi.

Puoi utilizzare la seguente configurazione di PodMonitoring:

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

Assicurati che i valori dei campi port e MatchLabels corrispondano a quelli dell'applicazione gRPC che vuoi monitorare.

Per applicare le modifiche alla configurazione da un file locale, esegui questo comando: 

kubectl apply -n NAMESPACE_NAME -f FILE_NAME

Puoi anche utilizza Terraform per gestire le configurazioni.

Visualizza metriche dell'applicazione

Per visualizzare le metriche relative a richieste, percentuale di errori e latenza della tua applicazione gRPC:

  1. Nella console Google Cloud, vai alla pagina Carichi di lavoro:

    Vai a Carichi di lavoro

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Kubernetes Engine.

  2. Fai clic su un deployment nell'elenco dei carichi di lavoro. La colonna Tipo nell'elenco indica il tipo di carico di lavoro.
  3. Nella pagina Dettagli deployment, fai clic sul Scheda Osservabilità.
  4. Seleziona Applicazione nel selettore della dashboard.

Per ulteriori informazioni, consulta Utilizzare le metriche sul rendimento delle applicazioni.

Risoluzione dei problemi

Per informazioni sulla risoluzione dei problemi di importazione delle metriche in Managed Service per Prometheus, vedi Problemi con la raccolta dagli esportatori in Risoluzione dei problemi lato importazione.