Usando o Grafana para analisar as métricas do OpenTelemetry

Monitore a integridade e o desempenho de sua instância usando dashboards e métricas fornecidos pela pilha de métricas OpenTelemetry.

Neste artigo

Pré-requisitos

As métricas openTelemetry devem ser habilitadas na instância. Para obter instruções de configuração, consulte Configurando o OpenTelemetry para sua instância.

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .
  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.
  3. Na barra lateral " Site admin", clique em Console de Gerenciamento.
  4. Se você tiver criado várias contas de usuário do Console de Gerenciamento, selecione Administrador do site raiz ou usuário do Console de Gerenciamento . Para obter mais informações sobre as contas de usuário do Console de Gerenciamento, confira Como gerenciar o acesso ao Console de Gerenciamento.
  5. Digite suas credenciais do Console de Gerenciamento. Em seguida, clique em Continuar.
  6. Clique na guia Monitor.

Rótulos de métrica

Os exportadores da pilha de OpenTelemetry adicionam automaticamente rótulos às métricas. Rótulos comuns são:

  • job — o nome do exportador que produziu a métrica
  • instance — o nome da instância da qual a métrica se originou

Para alguns exportadores (como node_exporter ou haproxy_exporter), a documentação de software livre pode estar disponível pesquisando o valor do job rótulo.

A disponibilidade do rótulo varia de acordo com o exportador e a métrica. Algumas métricas no nível do aplicativo do GitHub podem fornecer menos rótulos do que as métricas de infraestrutura/exportador, e os rótulos estão sujeitos a alterações de uma versão para outra.

Inspecionar consultas de painel

Importante

Os painéis pré-criados podem ser abertos e editados para inspeção, mas as alterações não podem ser salvas. Crie uma cópia de um painel para aplicar e reter as personalizações.

Para entender quais métricas e consultas alimentam um determinado painel, use o menu do painel de grafo (3 pontos verticais) ao exibir um painel do Grafana:

  • Editar: abre o editor do painel. Essa é a maneira mais direta de examinar e ajustar as consultas que alimentam a visualização.
  • Explore: Abre o Grafana Explore com as consultas pré-preenchidas do painel, permitindo a análise interativa.
  • Drilldown de métricas: abre um painel lateral para descobrir métricas relacionadas e dividir a métrica por valores de rótulo.

Explorando métricas no Grafana

O Grafana fornece várias maneiras de descobrir e analisar as métricas disponíveis em sua instância.

Visão detalhada do Grafana

O Grafana Drilldown fornece um fluxo de trabalho guiado para descobrir métricas filtrando prefixos de métrica, rótulos e valores de rótulo. Depois de selecionar uma métrica, o Grafana pode dividir a série por valores de rótulo disponíveis. Por exemplo, haproxy_backend_response_errors_total pode ser agrupado por valores de rótulo de proxy/back-end.

Explorar Grafana

O Grafana Explore habilita a análise interativa usando PromQL (Linguagem de Consulta Prometheus), incluindo um construtor de consultas que pode ajudar os usuários a descobrir métricas e rótulos disponíveis.

Dicas para trabalhar no Grafana Explore:

  • Use o navegador de métricas do modo de código para descobrir métricas e rótulos. Selecionar rótulos e valores de rótulo pode revelar métricas associadas e selecionar uma métrica pode revelar rótulos e valores de rótulo associados.
  • Depois de selecionar uma métrica, alterne para o modo Construtor para obter sugestões para refinar a consulta.
  • Acesse operações adicionais por meio do botão + Operações .
  • Personalize rótulos de legenda no painel Opções usando a configuração Legenda , por exemplo false. Por padrão, o Grafana atribui rótulos de legenda com base em conjuntos de rótulos exclusivos.

Leitura adicional