Servidor gRPC

Neste documento, descrevemos como configurar sua implantação do Google Kubernetes Engine para que você possa usar o Google Cloud Managed Service para Prometheus e coletar métricas das solicitações gRPC exibidas pelo aplicativo. Este documento explica como fazer o seguinte:

Estas instruções se aplicam somente ao usar a coleção gerenciada com o serviço gerenciado para Prometheus.

Para saber mais informações sobre o gRPC, consulte grpc.io.

Configurar

Para coletar métricas do servidor gRPC, é necessário configurar o middleware gRPC apropriado.

Para verificar se o servidor gRPC está emitindo métricas nos endpoints esperados, faça o seguinte:

  1. Configure o encaminhamento de portas usando o seguinte comando: 
    kubectl -n NAMESPACE_NAME port-forward deploy/GRPC_SERVER_DEPLOYMENT_NAME PROMETHEUS_PORT_NUMBER
  2. Acesse localhost:PROMETHEUS_PORT_NUMBER usando o navegador ou o utilitário curl em outra sessão do terminal.

Definir um recurso do PodMonitoring

Para descobrir o destino, o operador do Managed Service para Prometheus, é necessário um recurso PodMonitoring que corresponde ao servidor do gRPC no mesmo namespace.

É possível usar a seguinte configuração do 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

Verifique se os valores dos campos port e MatchLabels correspondem aos do aplicativo gRPC que você quer monitorar.

Para aplicar as alterações de configuração de um arquivo local, execute o seguinte comando: 

kubectl apply -n NAMESPACE_NAME -f FILE_NAME

Também é possível usar o Terraform para gerenciar as configurações.

Ver métricas do aplicativo

Para visualizar as métricas de solicitação, taxa de erro e latência do aplicativo gRPC, faça o seguinte:

  1. No Console do Google Cloud, acesse a página Cargas de trabalho:

    Acesse Cargas de trabalho

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Kubernetes Engine.

  2. Clique em uma implantação na lista de cargas de trabalho. A coluna Tipo na lista indica o tipo de carga de trabalho.
  3. Na página Detalhes da implantação, clique na guia Observabilidade.
  4. Selecione Aplicativo no seletor do painel.

Para mais informações, consulte Usar métricas de desempenho do aplicativo.

Solução de problemas

Para informações sobre solução de problemas de ingestão de métricas no Managed Service para Prometheus, consulte Problemas com a coleta dos exportadores em Solução de problemas de ingestão.