Utilisation de Grafana pour analyser les métriques OpenTelemetry

Prerequisites

Les métriques OpenTelemetry doivent être activées sur l’instance. Pour obtenir des instructions de configuration, consultez Configuration d’OpenTelemetry pour votre instance.

Navigation dans les tableaux de bord de surveillance

1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
3. Dans la barre latérale « Site admin », cliquez sur Management Console.
4. Si vous avez créé plusieurs comptes d’utilisateur de Management Console, sélectionnez Administrateur de site racine ou Utilisateur de la Management Console . Pour plus d’informations sur la Management Console que les comptes d’utilisateur voient, consultez Gestion de l’accès à la console de gestion.
5. Tapez vos informations d’identification pour accéder à la Management Console. Puis, cliquez sur Continuer.
6. Cliquez sur l’onglet Moniteur .

Étiquettes de métriques

Les exportateurs de la stack OpenTelemetry attachent automatiquement des étiquettes aux métriques. Les étiquettes courantes sont les suivantes :

•         `job` — nom de l’exportateur qui a produit la métrique
  

•         `instance` — nom de l’instance à partir duquel la métrique provient
  

Pour certains exportateurs (comme node_exporter ou haproxy_exporter), la documentation open source peut être disponible en recherchant la valeur de l’étiquette job .

La disponibilité des étiquettes varie selon l’exportateur et la métrique. Certaines métriques GitHub au niveau de l’application peuvent fournir moins d’étiquettes que les métriques d’infrastructure/exportation, et les étiquettes peuvent changer d'une version à l'autre.

Inspection des requêtes du panneau

Pour comprendre quelles métriques et requêtes alimentent un panneau donné, utilisez le menu du panneau graphique (3 points verticaux) lors de l’affichage d’un tableau de bord Grafana :

•         **Modifier** : ouvre l’éditeur du panneau. Il s’agit du moyen le plus direct d’examiner et d’ajuster les requêtes qui alimentent la visualisation.  
  

•         **Explorer** : ouvre Grafana Explorer avec les requêtes du panneau préremplies, ce qui permet une analyse interactive.  
  

•         **Exploration des métriques** : ouvre un panneau latéral pour découvrir les métriques associées et décomposer la métrique par valeurs d’étiquette.
  

Analyse des métriques dans Grafana

Grafana fournit plusieurs façons de découvrir et d’analyser les métriques disponibles sur votre instance.

Exploration Grafana

Grafana Drilldown fournit un flux de travail guidé pour découvrir les métriques en filtrant les préfixes, les étiquettes et les valeurs d’étiquette des métriques. Après avoir sélectionné une métrique, Grafana peut décomposer la série en fonction des valeurs d’étiquette disponibles. Par exemple, haproxy_backend_response_errors_total peut être regroupé par les valeurs d’étiquette de proxy ou de back-end.

Grafana Explorer

Grafana Explore permet une analyse interactive à l’aide du langage de requête PromQL (Prometheus Query Language), y compris un générateur de requêtes qui peut aider les utilisateurs à découvrir les métriques et étiquettes disponibles.

Conseils pour travailler dans Grafana Explorer :

• Utilisez le navigateur métrique du mode Code pour découvrir les métriques et les étiquettes. La sélection d’étiquettes et de valeurs d’étiquette peut révéler les métriques associées, et la sélection d’une métrique peut révéler les étiquettes et les valeurs d’étiquette associées.
• Après avoir sélectionné une métrique, basculez vers le mode Générateur pour obtenir des suggestions pour affiner la requête.
• Accédez aux opérations supplémentaires via le bouton + Opérations .
• Personnalisez les étiquettes de légende dans le panneau Options à l’aide du paramètre Légende , par exemple false. Par défaut, Grafana attribue des libellés de légende basés sur des ensembles d'étiquettes uniques.

Lectures complémentaires

•         [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards)
  

•         [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards#creating-new-dashboards)
  

•         [Bien démarrer avec Explorer](https://grafana.com/docs/grafana/latest/visualizations/explore/get-started-with-explore/) dans la documentation Grafana 
  

•         [Promql - Notions de base de l'interrogation](https://prometheus.io/docs/prometheus/latest/querying/basics/) dans la documentation Prometheus