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.
Nachverfolgung in Explore
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 10.x unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 9
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8
Sie können Explore verwenden, um Spuren aus Tracing-Datenquellen zu visualisieren.
Die folgenden Datenquellen werden unterstützt.
Informationen zur Konfiguration von Abfragen für die oben aufgeführten Datenquellen finden Sie in der Dokumentation für die jeweilige Datenquelle.
Abfrage-Editor
Sie können Ablaufverfolgungsdaten mit dem Abfrage-Editor einer Datenquelle abfragen und suchen.
Jede Datenquelle kann über einen eigenen Abfrage-Editor verfügen. Der Abfrage-Editor für die Tempo-Datenquelle unterscheidet sich geringfügig vom Abfrage-Editor für die Jaeger-Datenquelle.
Informationen zum Abfragen der einzelnen Datenquellen finden Sie in der jeweiligen Dokumentation.
Erklärung von Trace View
In diesem Abschnitt werden die Elemente des Trace View-Dashboards erklärt.
Kopfzeile
Der Header der Trace-Ansicht enthält die folgenden Elemente:
-
Header-Titel — Zeigt den Namen des Root-Spans und die Trace-ID an.
-
Suche — Hebt Bereiche hervor, die den gesuchten Text enthalten.
-
Metadaten — Verschiedene Metadaten zum Trace.
Minimap
Zeigt eine komprimierte Ansicht oder die Trace-Timeline an. Ziehen Sie den Mauszeiger ü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 Sie beim Zoomen mit der Maus über die Minikarte fahren, wird die Schaltfläche „Auswahl zurücksetzen“ angezeigt, mit der der Zoom zurückgesetzt wird.
Filter ausdehnen
Mithilfe von Spanfiltern können Sie Ihre Spans im Trace-Timeline-Viewer filtern. Je mehr Filter Sie hinzufügen, desto spezifischer sind die gefilterten Bereiche.
Sie können einen oder mehrere der folgenden Filter hinzufügen:
-
Name des Ressourcendienstes
-
Spanischer Name
-
Dauer
-
Tags (dazu gehören Tags, Prozess-Tags und Protokollfelder)
Um nur die Bereiche anzuzeigen, die Sie gefunden haben, aktivieren Sie die Option Nur Treffer anzeigen.
Zeitplan
Zeigt eine Liste der Spans innerhalb des Traces an. 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.
Angaben zur Spanne
Wenn Sie die Span-Zeile auswählen, werden Span-Details angezeigt, darunter die folgenden.
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.
Zu Protokollen zurückverfolgen
Sie können in einer Trace-Ansicht von einem Bereich direkt zu den für diesen Bereich relevanten Protokollen navigieren. Dies ist für Tempo-, Jaeger- und Zipkin-Datenquellen verfügbar. Anweisungen zur Konfiguration der einzelnen Datenquellen finden Sie in der entsprechenden Dokumentation.
Wählen Sie das Dokumentsymbol, um in Explore eine geteilte Ansicht mit der konfigurierten Datenquelle zu öffnen und die entsprechenden Protokolle für den Zeitraum abzufragen.
Zu Metriken zurückverfolgen
Anmerkung
Diese Funktion befindet sich derzeit in der Beta-Phase
Sie können von einer Spanne in einer Trace-Ansicht direkt zu den für diese Spanne relevanten Metriken navigieren. Diese Funktion ist für Tempo-, Jaeger- und Zipkin-Datenquellen verfügbar. Einzelheiten zur Konfiguration finden Sie in der entsprechenden Dokumentation.
Zu Profilen zurückverfolgen
Mithilfe von Trace to Profiles können Sie die Fähigkeit von Grafana nutzen, verschiedene Signale zu korrelieren, indem Sie die Funktionalität zur Verknüpfung zwischen Traces und Profilen hinzufügen.
Knotendiagramm
Sie können das Knotendiagramm für die angezeigte Spur optional erweitern. Je nach Datenquelle können dadurch die Bereiche der Ablaufverfolgung als Knoten im Diagramm angezeigt oder zusätzlicher Kontext hinzugefügt werden, einschließlich des auf dem aktuellen Trace basierenden Service-Graphen.
Ansicht „Service Graph“
In der Service Graph-Ansicht werden die Span-Metriken (zeichnet Daten für Raten, Fehlerraten und Dauer (RED) auf) und die Service-Diagramme visualisiert. Sobald die Anforderungen eingerichtet sind, ist diese vorkonfigurierte Ansicht sofort verfügbar.
Weitere Informationen finden Sie auf der Tempo-Datenquellenseite. Sie können die Seite mit der Ansicht des Service-Diagramms
Daten-API
Für diese Visualisierung ist eine bestimmte Form der Daten erforderlich, die von der Datenquelle zurückgegeben werden müssen, damit sie korrekt angezeigt werden können.
Die Datenquelle muss den Datenrahmen und das Datenset zurückgebenframe.meta.preferredVisualisationType = 'trace'.
Struktur des Datenrahmens
Erforderliche Felder;
| Feldname | Typ | Beschreibung |
|---|---|---|
| TraceID | Zeichenfolge | Bezeichner für den gesamten Trace. Der Datenrahmen sollte nur eine Spur enthalten. |
| spanische ID | Zeichenfolge | Bezeichner für die aktuelle Spanne. SpanIDs sollten pro Trace eindeutig sein. |
| SpanID der Eltern | Zeichenfolge | spanID des übergeordneten Bereichs, um die Beziehung zwischen untergeordnetem Elternteil in der Trace-Ansicht zu erstellen. Kann undefined für den Stammbereich ohne übergeordnetes Element verwendet werden. |
| serviceName | Zeichenfolge | Name des Dienstes, zu dem dieser Span gehört. |
| ServiceTags | TraceKeyValuePair[] | Liste der für den Dienst relevanten Tags. |
| startTime | Zahl | Startzeit der Spanne in Millisekunden Epochenzeit. |
| duration | Zahl | Dauer der Spanne in Millisekunden. |
Optionale Felder:
| Feldname | Typ | Beschreibung |
|---|---|---|
| Protokolle | TraceLog[] | Liste der Protokolle, die dem aktuellen Zeitraum zugeordnet sind. |
| tags | TraceKeyValuePair[] | Liste der Tags, die dem aktuellen Zeitraum zugeordnet sind. |
| Warnungen | Zeichenfolge [] | Liste der Warnungen, die mit der aktuellen Spanne verknüpft sind. |
| StackTraces | Zeichenfolge [] | Liste der Stack-Traces, die dem aktuellen Span zugeordnet sind. |
| errorIconColor | Zeichenfolge | Farbe des Fehlersymbols, falls Span mit markiert isterror:
true. |
Einzelheiten zu den Typen finden Sie TraceSpanRow
