Enterprise Server 3.20 ist derzeit als Release Candidate verfügbar.

Verwenden von Grafana zum Analysieren von OpenTelemetry-Metriken

Überwachen Sie die Integrität und Leistung Ihrer Instanz mithilfe von Dashboards und Metriken, die vom OpenTelemetry-Metrikenstapel bereitgestellt werden.

In diesem Artikel

Voraussetzungen

OpenTelemetry-Metriken müssen für die Instanz aktiviert werden. Konfigurationsanweisungen finden Sie unter Konfigurieren von OpenTelemetry für Ihre Instanz.

  1. Klicke in einem Verwaltungskonto für GitHub Enterprise Server in der rechten oberen Ecke einer beliebigen Seite auf .
  2. Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
  3. Klicke in der Randleiste „ Site admin“ auf Verwaltungskonsole.
  4. Wenn du mehrere Verwaltungskonsole-Benutzerkonten erstellt hast, wähle Websitedministrator mit Root-Berechtigungen oder Verwaltungskonsole-Benutzer aus. Weitere Informationen zu Verwaltungskonsole-Benutzerkonten findest du unter Verwalten des Zugriffs auf die Verwaltungskonsole.
  5. Gib deine Anmeldeinformationen für die Verwaltungskonsole ein. Klicke anschließend auf Weiter.
  6. Klicken Sie auf die Registerkarte "Monitor ".

Metrikbeschriftungen

Die OpenTelemetry-Stapelexporteure fügen automatisch Bezeichnungen an Metriken an. Allgemeine Bezeichnungen sind:

  •         `job` — der Name des Exporteurs, der die Metrik erzeugt hat

  •         `instance` — der Instanzname, aus dem die Metrik stammt

Für einige Exporteure (z. B. node_exporter oder haproxy_exporter) können Open-Source-Dokumentationen möglicherweise verfügbar sein, indem Sie nach dem job Labelwert suchen.

Die Verfügbarkeit von Etiketten variiert je nach Exporteur und Metrik. Einige GitHub Metriken auf Anwendungsebene bieten möglicherweise weniger Bezeichnungen als Infrastruktur-/Exportermetriken, und Bezeichnungen können von Version zu Version geändert werden.

Überprüfen von Panelabfragen

Wichtig

Vordefinierte Dashboards können zur Überprüfung geöffnet und bearbeitet werden, änderungen können jedoch nicht gespeichert werden. Erstellen Sie eine Kopie eines Dashboards, um Anpassungen anzuwenden und beizubehalten.

Um zu verstehen, welche Metriken und Abfragen ein bestimmtes Panel nutzen, verwenden Sie das Diagrammpanelmenü (3 vertikale Punkte) beim Anzeigen eines Grafana-Dashboards:

  •         **Bearbeiten**: Öffnet den Panel-Editor. Dies ist die unmittelbarste Möglichkeit zum Überprüfen und Anpassen der Abfragen, die die Visualisierung antreiben.  

  •         **Erkunden**: Öffnet Grafana Explore mit den vorab ausgefüllten Abfragen des Panels, wodurch interaktive Analysen ermöglicht werden.  

  •         **Metrik-Drilldown**: Öffnet eine Seitenleiste zur Entdeckung verwandter Metriken und zur Aufschlüsselung der Metrik nach Labelwerten.

Erkunden von Metriken in Grafana

Grafana bietet mehrere Möglichkeiten, die in Ihrer Instanz verfügbaren Metriken zu ermitteln und zu analysieren.

Grafana-Drilldown

Grafana Drilldown bietet einen geführten Workflow zum Ermitteln von Metriken durch Filtern nach Metrikpräfixen, Bezeichnungen und Bezeichnungswerten. Nachdem Sie eine Metrik ausgewählt haben, kann Grafana die Datenreihe nach verfügbaren Bezeichnungswerten aufteilen. Beispielsweise kann haproxy_backend_response_errors_total nach Proxy-/Back-End-Bezeichnungswerten gruppiert werden.

Grafana Erkunden

Grafana Explore ermöglicht interaktive Analysen mithilfe von PromQL (Prometheus Query Language), einschließlich eines Abfrage-Generators, mit dem Benutzer verfügbare Metriken und Bezeichnungen ermitteln können.

Tipps zum Arbeiten in Grafana Erkunden:

  • Verwenden Sie den metrischen Browser des Codemodus , um Metriken und Bezeichnungen zu ermitteln. Durch das Auswählen von Bezeichnungen und Bezeichnungswerten können zugeordnete Metriken angezeigt werden, und die Auswahl einer Metrik kann zugeordnete Bezeichnungen und Beschriftungswerte anzeigen.
  • Wechseln Sie nach dem Auswählen einer Metrik in den Abfragemodus, um die Abfrage zu verfeinern.
  • Greifen Sie über die Schaltfläche "+Vorgänge " auf weitere Vorgänge zu.
  • Passen Sie Legendenbeschriftungen im Bereich "Optionen " mithilfe der Einstellung " Legende " an, z. B false. . Standardmäßig weist Grafana Legendenbeschriftungen basierend auf eindeutigen Bezeichnungssätzen zu.

Weiterführende Lektüre

  •         [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)

  •         [Erste Schritte mit "Erkunden"](https://grafana.com/docs/grafana/latest/visualizations/explore/get-started-with-explore/) in der Grafana-Dokumentation 

  •         [Promql – Grundlagen des Abfragens](https://prometheus.io/docs/prometheus/latest/querying/basics/) in der Prometheus-Dokumentation