Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Erkunden
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 8.x unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 10
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 9
In einem Grafana-Arbeitsbereich bietet die Dashboard-Benutzeroberfläche Tools zum Erstellen von Dashboards zur Visualisierung. Explore entfernt alle Dashboard- und Panel-Optionen, sodass Sie sich auf die Abfrage konzentrieren können. Iterieren Sie, bis Sie eine funktionierende Abfrage haben, und planen und erstellen Sie dann ein Dashboard.
Für die Überwachung der Infrastruktur und die Reaktion auf Vorfälle müssen Sie nicht mehr zu anderen Tools wechseln, um Fehler zu debuggen. Sie können Explore verwenden, um Ihre Metriken und Protokolle genauer zu untersuchen und die Ursache zu finden.
Mit Explore können Sie Ihre Daten einfacher anzeigen, ohne ein Dashboard erstellen zu müssen. Wenn Ihre Datenquelle Diagramm- und Tabellendaten unterstützt, zeigt Explore die Ergebnisse sowohl als Grafik als auch als Tabelle an. Auf diese Weise können Sie Trends in den Daten und mehr Details gleichzeitig erkennen.
Beginne zu erkunden
Anmerkung
Standardmäßig können Benutzer mit der Viewer-Rolle keine Änderungen vornehmen und haben auch keinen Zugriff auf Explore.
Das Explore-Symbol im Menü auf der linken Seite öffnet eine leere Registerkarte „Erkunden“.
Um mit einer vorhandenen Abfrage in einem Panel zu beginnen, wählen Sie im Panel-Menü die Option Erkunden. Dadurch wird eine Registerkarte „Erkunden“ geöffnet, die die Abfrage aus dem Bedienfeld enthält. Anschließend können Sie die Abfrage außerhalb Ihres Dashboards optimieren oder iterieren.
Wählen Sie Ihre Datenquelle aus der Drop-down-Liste oben links aus. Prometheus hat eine benutzerdefinierte Explore-Implementierung. Die anderen Datenquellen verwenden ihren Standard-Abfrage-Editor.
Im Abfragefeld können Sie Ihre Abfrage schreiben und Ihre Daten untersuchen. Neben dem Abfragefeld befinden sich drei Schaltflächen: eine Schaltfläche zum Löschen (X), eine Schaltfläche zum Hinzufügen von Abfragen (+) und die Schaltfläche zum Entfernen von Abfragen (-). Wie im Panel-Abfrage-Editor können Sie mehrere Abfragen hinzufügen und entfernen.
Teilen und vergleichen
Die Funktion zur geteilten Ansicht ist eine Möglichkeit, Grafiken und Tabellen zu vergleichen side-by-side oder verwandte Daten zusammen auf einer Seite zu betrachten. Wählen Sie Teilen, um die aktuelle Abfrage zu duplizieren und die Seite in zwei side-by-side Abfragen aufzuteilen. Sie haben die Möglichkeit, eine andere Datenquelle für die neue Abfrage auszuwählen. Dies gibt Ihnen die Möglichkeit, dieselbe Abfrage für zwei verschiedene Server zu vergleichen oder die Staging-Umgebung mit der Produktionsumgebung zu vergleichen.
In der geteilten Ansicht können die Zeitwähler für beide Bereiche miteinander verknüpft werden (wenn Sie eines ändern, wird auch das andere geändert), indem Sie eine der Zeitsynchronisierungsschaltflächen auswählen, die an den Zeitwählern angebracht sind. Durch das Verknüpfen der Zeitauswahl werden Start- und Endzeiten der Abfragen in geteilter Ansicht synchronisiert, sodass Sie in beiden geteilten Bereichen dasselbe Zeitintervall verwenden.
Sie können die neu erstellte Abfrage schließen, indem Sie Split schließen wählen.
Einen verkürzten Link teilen
Verwenden Sie die Funktion Verkürzten Link teilen, um kleinere und einfachere URLs dieses Formats zu erstellen, /goto/:uid
anstatt längere URLs mit komplexen Abfrageparametern gemeinsam zu nutzen. Sie können einen verkürzten Link erstellen, indem Sie in der Explore-Symbolleiste die Option Teilen auswählen. Alle gekürzten Links, die nie verwendet werden, werden nach 7 Tagen automatisch gelöscht.
Verlauf abfragen
Der Abfrageverlauf ist eine Liste von Abfragen, die Sie in Explore verwendet haben. Der Verlauf ist lokal in Ihrem Browser und wird nicht geteilt. Um Ihren Verlauf zu öffnen und mit ihm zu interagieren, wählen Sie in Explore die Option Verlauf abfragen.
Den Abfrageverlauf anzeigen
Im Abfrageverlauf können Sie Folgendes tun:
-
Ausführen einer Abfrage
-
Erstellen oder bearbeiten Sie einen Kommentar.
-
Kopiert eine Abfrage in die Zwischenablage.
-
Kopiert einen verkürzten Link mit der Abfrage in die Zwischenablage.
-
Starten Sie eine Abfrage.
Bevorzugte Abfragen verwalten
Alle Abfragen, die auf der Registerkarte Abfrageverlauf mit einem Stern markiert wurden, werden auf der Registerkarte Mit Stern markiert angezeigt. Sie können schneller auf Ihre bevorzugten Abfragen zugreifen und diese Abfragen wiederverwenden, ohne sie erneut eingeben zu müssen.
Sortieren Sie den Abfrageverlauf
Standardmäßig zeigt Ihnen der Abfrageverlauf die neuesten Abfragen. Sie können Ihren Verlauf nach Datum oder nach dem Namen der Datenquelle in aufsteigender oder absteigender Reihenfolge sortieren.
Wählen Sie auf der rechten Seite des Abfrageverlaufs in der Dropdownliste eine der folgenden Optionen aus: Feld.
-
Die neueste zuerst
-
Älteste zuerst
-
Datenquelle A-Z
-
Datenquelle Z-A
Anmerkung
Wenn Sie sich in der geteilten Ansicht befinden, gilt der Sortiermodus nur für das aktive Bedienfeld.
Den Abfrageverlauf filtern
Auf den Registerkarten Abfrageverlauf und Als Favorit markiert können Sie den Abfrageverlauf nach dem Namen der Datenquelle filtern.
-
Wählen Sie Abfragen nach bestimmten Datenquellen filtern aus.
-
Wählen Sie die Datenquelle aus, die Sie zum Filtern Ihres Verlaufs verwenden möchten. Sie können mehrere Datenquellen auswählen.
Auf der Registerkarte Abfrageverlauf können Sie den vertikalen Schieberegler verwenden, um Abfragen nach Datum zu filtern:
-
Ziehen Sie den unteren Ziehpunkt, um das Startdatum anzupassen.
-
Ziehen Sie den oberen Griff, um das Enddatum anzupassen.
Anmerkung
Wenn Sie sich in der geteilten Ansicht befinden, werden Filter nur auf das aktive Bedienfeld angewendet.
Im Abfrageverlauf suchen
Sie können in Ihrem Verlauf nach Abfragen und Ihren Kommentaren suchen. Die Suche nach Abfragen ist in den Tabs Abfrageverlauf und Markiert möglich.
-
Wählen Sie das Feld Suchanfragen aus.
-
Geben Sie im Suchfeld Ihren Suchbegriff ein.
Verlaufseinstellungen abfragen
Sie können den Abfrageverlauf auf der Registerkarte Einstellungen anpassen. In der folgenden Tabelle sind die verfügbaren Optionen aufgeführt.
Einstellung | Standardwert |
---|---|
Geben Sie an, wie lange Grafana Ihren Abfrageverlauf speichern soll. | 1 Woche |
Ändern Sie die aktive Standardregisterkarte. | Registerkarte „Verlauf abfragen“ |
Zeigt nur Abfragen für die Datenquelle an, die derzeit in Explore aktiv ist. | True |
Löscht den Abfrageverlauf. | (Wählen Sie Abfrageverlauf löschen, um alle gespeicherten Abfragen dauerhaft zu löschen.) |
Anmerkung
Die Einstellungen für den Abfrageverlauf sind global und werden im geteilten Modus auf beide Bereiche angewendet.
Promethus-spezifische Funktionen
Die erste Version von Explore bietet ein benutzerdefiniertes Abfrageerlebnis für Prometheus. Wenn Sie eine Abfrage ausführen, führt Grafana tatsächlich zwei Abfragen aus: eine normale Prometheus-Abfrage für das Diagramm und eine Sofortabfrage für die Tabelle. Eine Sofortabfrage gibt den letzten Wert für jede Zeitreihe zurück, was eine gute Zusammenfassung der im Diagramm angezeigten Daten darstellt.
Metrik-Explorer
Wählen Sie auf der linken Seite des Abfragefelds Metrics aus, um den Metric Explorer zu öffnen. Daraufhin wird ein hierarchisches Menü mit Metriken angezeigt, die nach ihrem Präfix gruppiert sind. Beispielsweise sind alle Alertmanager-Metriken unter dem Präfix gruppiert. alertmanager
Dies ist ein guter Ausgangspunkt, um herauszufinden, welche Metriken verfügbar sind.
Abfragefeld
Das Abfragefeld unterstützt die automatische Vervollständigung von Metriknamen und Funktionen und funktioniert größtenteils genauso wie der standardmäßige Prometheus-Abfrageeditor. Drücken Sie die Eingabetaste, um eine Abfrage auszuführen.
Das Autocomplete-Menü kann durch Drücken von Strg+Leertaste aufgerufen werden. Das Autocomplete-Menü enthält einen neuen Abschnitt Verlauf mit einer Liste der zuletzt ausgeführten Abfragen.
Vorschläge können unter dem Abfragefeld angezeigt werden. Wählen Sie einen Vorschlag aus, um Ihre Abfrage mit der vorgeschlagenen Änderung zu aktualisieren.
-
Für Zähler (monoton steigende Messwerte) wird eine Ratenfunktion vorgeschlagen.
-
Für Buckets wird eine Histogrammfunktion vorgeschlagen.
-
Für die Aufzeichnung von Regeln ist es möglich, die Regeln zu erweitern.
Tabellenfilter
Wählen Sie die Schaltfläche Filter in der Labelspalte eines Tabellenfensters, um dem Abfrageausdruck Filter hinzuzufügen. Sie können auch Filter für mehrere Abfragen hinzufügen. Der Filter wird für alle Abfragen hinzugefügt.
Protokolliert die Integration
Sie können Explore auch verwenden, um Ihre Protokolle anhand der folgenden Datenquellen zu untersuchen:
-
InfluxDB
-
Elasticsearch
Visualisierung von Protokollen
Die Ergebnisse von Protokollabfragen werden in der Grafik als Histogramme angezeigt, und einzelne Protokolle werden unten angezeigt. Wenn die Datenquelle keine Histogrammdaten für den angeforderten Zeitraum sendet, berechnet das Protokollmodell eine Zeitreihe auf der Grundlage der Anzahl der Protokollzeilen, aufgeteilt in ein automatisch berechnetes Zeitintervall. Der Beginn des Histogramms wird dann durch den Zeitstempel der ersten Protokollzeile aus dem Ergebnis verankert. Das Ende der Zeitreihe ist im Zielbereich der Zeitauswahl verankert.
Protokollebene
Bei Protokollen, bei denen eine Ebenenbezeichnung angegeben ist, verwendet Grafana den Wert der Bezeichnung, um die Protokollebene zu bestimmen und die Farbe entsprechend zu aktualisieren. Wenn für das Protokoll keine Ebenenbezeichnung angegeben ist, analysiert Grafana das Protokoll, um herauszufinden, ob sein Inhalt mit einem der unterstützten Ausdrücke übereinstimmt. Die Protokollebene wird immer durch die erste Übereinstimmung bestimmt. Wenn Grafana keinen Log-Level ermitteln kann, wird dieser mit dem unbekannten Log-Level visualisiert. In der folgenden Tabelle sind die Protokollebenen und die Zuordnung von Abkürzungen und Ausdrücken auf Protokollebenen aufgeführt.
Unterstützte Ausdrücke | Protokollebene | Farbe |
---|---|---|
auftauchen | kritisch | lila |
tödlich | kritisch | lila |
Warnung | kritisch | lila |
kritisch | kritisch | lila |
kritisch | kritisch | lila |
irren | error | red |
Fehler | error | red |
error | error | red |
warnen | warning | Gelb |
warning | warning | Gelb |
info | info | Grün |
Informationen | info | Grün |
Notiz | info | Grün |
debuggen | debug | Blau |
debug | debug | Blau |
Spur | Spur | hellblau |
* | unbekannt | grau |
Visualisierungsoptionen
Sie können anpassen, wie Protokolle angezeigt werden, und auswählen, welche Spalten angezeigt werden.
Zeit
Mit dieser Option wird die Zeitspalte ein- oder ausgeblendet. Dies ist der Zeitstempel, der der von der Datenquelle gemeldeten Protokollzeile zugeordnet ist.
Einzigartige Beschriftungen
Mit dieser Option wird die Spalte für eindeutige Beschriftungen ein- oder ausgeblendet, die nur ungewöhnliche Beschriftungen enthält. Alle gängigen Beschriftungen werden oben angezeigt.
Linien umbrechen
Um den Zeilenumbruch in der Anzeige zu verwenden, setzen Sie diesen Wert auf True. Wenn Sie diese Option auf False setzen, erfolgt horizontales Scrollen.
Deduplizieren
Protokolldaten können sich sehr wiederholen. Explore kann helfen, indem doppelte Protokollzeilen ausgeblendet werden. Sie können aus verschiedenen Deduplizierungsalgorithmen wählen:
-
Exakt — Exakte Übereinstimmungen werden in der gesamten Zeile vorgenommen, mit Ausnahme von Datumsfeldern.
-
Zahlen — Übereinstimmungen werden in der Zeile vorgenommen, nachdem Zahlen wie Dauer, IP-Adressen usw. entfernt wurden.
-
Signatur — Die aggressivste Deduplizierung, bei der alle Buchstaben und Zahlen entfernt werden. Die verbleibenden Leerzeichen und Satzzeichen werden abgeglichen.
Reihenfolge der Ergebnisse umkehren
Sie können die Reihenfolge der empfangenen Protokolle von der standardmäßigen absteigenden Reihenfolge (neueste zuerst) in aufsteigender Reihenfolge (älteste zuerst) ändern.
Beschriftungen und erkannte Felder
Jede Protokollzeile verfügt über einen erweiterbaren Bereich mit ihren Beschriftungen und erkannten Feldern, um eine robustere Interaktion zu ermöglichen. Für alle Labels können Sie nach ausgewählten Labels filtern (positiver Filter) und herausfiltern (negativer Filter). Jedes Feld oder Label hat außerdem ein Statistiksymbol, um einmalige Statistiken in Bezug auf alle angezeigten Logs anzuzeigen.
Erkannte Felder umschalten
Wenn Ihre Logs in JSON oder logfmt strukturiert sind, können Sie erkannte Felder ein- oder ausblenden. Erweitern Sie eine Protokollzeile und wählen Sie dann das Augensymbol, um Felder ein- oder auszublenden.
{{< docs-imagebox img=“ /img/docs/explore/parsed-fields-7-2.gif "max-width="800px“ caption="Zwischen erkannten Feldern in Explore hin- und herschalten“ >}}
Integration der Rückverfolgung
Sie können Spuren aus Tracing-Datenquellen in Explore visualisieren. Derzeit unterstützte Datenquellen:
Informationen zur Verwendung des Abfrage-Editors finden Sie in der Dokumentation für die jeweilige Datenquelle.
Header
Die Kopfzeile enthält die folgenden Elemente:
-
Header-Titel, der den Namen des Root-Spans und die Trace-ID anzeigt
-
Suche: Dabei werden Bereiche hervorgehoben, die den gesuchten Text enthalten
-
Metadaten über den Trace
Minimap
Minimap zeigt eine komprimierte Ansicht oder die Trace-Timeline. Ziehen Sie die Maus über die Minimap, um in einen kleineren Zeitbereich zu zoomen. Durch das Zoomen wird auch die Hauptzeitleiste aktualisiert, sodass kürzere Zeiträume leichter zu erkennen sind. Wenn du auf der Minimap pausierst, siehst du beim Zoomen die Schaltfläche „Auswahl zurücksetzen“, mit der der Zoom zurückgesetzt wird.
Zeitplan
Die Zeitleiste zeigt eine Liste der Bereiche innerhalb des Traces. Jede Span-Zeile besteht aus den folgenden Komponenten:
-
Schaltfläche „Kinder erweitern“: Erweitert oder reduziert alle untergeordneten Bereiche des ausgewählten Bereichs
-
Dienstname: Name des Dienstes, der den Zeitraum protokolliert hat
-
Operationsname: Name des Vorgangs, für den dieser Span steht
-
Balken für die Dauer der Spanne: Visuelle Darstellung der Operationsdauer innerhalb der Ablaufverfolgung
Wenn Sie eine beliebige Stelle in der Span-Zeile auswählen, werden Details zur Spanne angezeigt.
Angaben zur Spannweite
Die Angaben zur Spanne umfassen die folgenden Elemente:
-
Vorgangsname
-
Span-Metadaten
-
Tags (alle Tags, die mit diesem Bereich verknüpft sind)
-
Prozessmetadaten (Metadaten über den Prozess, der diesen Zeitraum protokolliert hat)
-
Protokolle: Liste der in diesem Bereich protokollierten Protokolle und der zugehörigen Schlüsselwerte. Im Fall von Zipkin-Protokollen werden im Abschnitt Zipkin-Anmerkungen angezeigt.
Zwischen Explore und einem Dashboard navigieren
Um Arbeitsabläufe zu beschleunigen, bei denen regelmäßig von Explore zu einem Dashboard und umgekehrt gewechselt wird, haben wir die Möglichkeit hinzugefügt, zum Ursprungs-Dashboard zurückzukehren, nachdem Sie über das Drop-down-Menü des Panels zu Explore navigiert haben.
Nachdem Sie zu Explore navigiert sind, sollten Sie in der Explore-Symbolleiste eine Schaltfläche „Zurück“ sehen.
Wenn Sie einfach auf die Schaltfläche klicken, kehren Sie zum ursprünglichen Dashboard zurück. Wenn Sie in Explore vorgenommene Änderungen wieder in das Dashboard übernehmen möchten, klicken Sie einfach auf den Pfeil neben der Schaltfläche, um den Menüpunkt „Zurück zum Bereich mit Änderungen“ anzuzeigen.
Abfrageinspektor
Um Ihnen beim Debuggen von Abfragen zu helfen, ermöglicht Ihnen Explore, Abfrageanfragen und -antworten sowie Abfragestatistiken über den Abfrageinspektor zu untersuchen. Diese Funktion ähnelt den Registerkarten „Statistiken“ und „Abfrage“ des Bedienfeldinspektors. Weitere Informationen finden Sie unter Überprüfen Sie die Abfrageleistung und Rohanfrage und Antwort an die Datenquelle anzeigen.