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.
# Ablaufverfolgungen
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 12.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 10](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Mithilfe von Traces-Visualisierungen können Sie einer Anfrage folgen, während sie die Dienste in Ihrer Infrastruktur durchläuft. Die Traces-Visualisierung zeigt Trace-Daten in einem Diagramm an, sodass Sie sie einfach interpretieren können.
Weitere Informationen zu Traces und deren Verwendung finden Sie in der folgenden Dokumentation:
+ [Ablaufverfolgung in Explore](v12-explore-tracing.md)
+ [Tempo-Datenquelle](tempo-data-source.md)
+ [Erste Schritte mit Tempo](https://grafana.com/docs/tempo/latest/getting-started/) in der *Tempo-Dokumentation von Grafana Labs*.
## Hinzufügen eines Panels mit Tracing-Visualisierungen
Sobald Sie Tracing-Daten in Ihrem Grafana-Stack verfügbar haben, können Sie Ihren Grafana-Dashboards Tracing-Panels hinzufügen.
Mithilfe einer Dashboard-Variablen können Sie eine Abfrage erstellen`traceID`, um bestimmte Traces für eine bestimmte Trace-ID anzuzeigen. Weitere Informationen zu Dashboard-Variablen finden Sie in der [Variablen-Dokumentation](v12-dash-variables.md).
**Voraussetzungen**
Bevor Sie anfangen, benötigen Sie:
+ Ein Amazon Managed Grafana-Arbeitsbereich.
+ Eine [Tempo-Datenquelle](tempo-data-source.md), die mit Ihrem Workspace verbunden ist.
Um Traces-Daten in einem Dashboard anzuzeigen und zu analysieren, müssen Sie die Traces-Visualisierung zu Ihrem Dashboard hinzufügen und mit dem Panel-Editor eine Abfrage definieren. Die Abfrage bestimmt die Daten, die in der Visualisierung angezeigt werden. Weitere Informationen zum Panel-Editor finden Sie in der [Dokumentation zum Panel-Editor](v12-panels-editor-overview.md).
Bei diesem Verfahren können Sie mithilfe von Dashboard-Variablen und Vorlagen Trace-IDs eingeben, die anschließend visualisiert werden können. Sie verwenden eine Variable namens `traceId` und fügen sie als Vorlagenabfrage hinzu.
**Um eine Abfrage zur Visualisierung von Traces hinzuzufügen**
1. Erstelle in deinem Workspace ein neues Dashboard oder gehe zu einem vorhandenen Dashboard, in dem du Traces-Visualisierungen hinzufügen möchtest.
1. Wähle „**Visualisierung hinzufügen**“ aus einem neuen Dashboard oder wähle „**Bereich hinzufügen“** in einem vorhandenen Dashboard.
1. Wählen Sie die entsprechende Tracing-Datenquelle aus.
1. **Wählen Sie oben rechts im Panel-Editor die Registerkarte **Visualisierungen** und dann Traces aus.**
1. Geben Sie unter den **Panel-Optionen** einen **Titel** für Ihr Trace-Panel ein. Weitere Informationen zum Panel-Editor finden Sie unter[Panel-Optionen konfigurieren](v12-panels-configure-panel-options.md).
1. Wählen Sie im Abfrage-Editor die Registerkarte **TraceQL-Abfragetyp** aus.
1. Geben Sie `${traceId}` in das TraceQL-Abfragefeld ein, um eine Dashboard-Variable zu erstellen. Diese Variable wird als Vorlagenabfrage verwendet.
1. Wählen Sie im Panel-Editor „**Anwenden**“, um das Panel zum Dashboard hinzuzufügen.
1. Gehen Sie zu den **Dashboard-Einstellungen** und fügen Sie eine neue Variable mit dem Namen `traceId` **Benutzerdefiniert** hinzu und geben Sie ihr bei Bedarf eine Bezeichnung. Wählen Sie **Anwenden**, um die Variable zum Dashboard hinzuzufügen.
1. Stellen Sie sicher, dass das Panel funktioniert, indem Sie eine gültige Trace-ID für die für das Trace-Panel verwendete Datenquelle verwenden und die ID in der Dashboard-Variablen bearbeiten.
## Hinzufügen von TraceQL mit Tabellenvisualisierungen
Sie können einem Dashboard zwar eine Trace-Visualisierung hinzufügen, aber das manuelle Hinzufügen von Trace-IDs als Dashboard-Variable ist umständlich. Es ist sinnvoller, stattdessen TraceQL-Abfragen verwenden zu können, um nach bestimmten Arten von Traces zu suchen und dann die entsprechenden Traces aus den passenden Ergebnissen auszuwählen.
**Voraussetzungen**
Bei diesem Verfahren wird davon ausgegangen, dass Sie das vorherige Verfahren abgeschlossen haben.
**Um TraceQL mit Tabellenvisualisierungen hinzuzufügen**
1. Wählen Sie in demselben Dashboard, in dem Sie die Trace-Visualisierung hinzugefügt haben, **Panel hinzufügen**, um ein neues Visualisierungsfenster hinzuzufügen.
1. Wählen Sie dieselbe Trace-Datenquelle aus, die Sie im vorherigen Abschnitt verwendet haben.
1. **Wählen Sie oben rechts im Panel-Editor die Registerkarte **Visualisierungen und** dann Tabelle aus.**
1. **Wählen Sie im Abfrage-Editor die Registerkarte TraceQL.**
1. Geben Sie unter den **Panel-Optionen** einen **Titel** für Ihr Trace-Panel ein.
1. Fügen Sie eine entsprechende TraceQL-Abfrage hinzu, um nach Spuren zu suchen, die Sie im Dashboard visualisieren möchten. Hier ist zum Beispiel eine einfache, statische Abfrage von einem Server namens{{my-server}}.
```
{ .service.name = "{{my-server}}" && .http.status_code=500 }
```
Sie können die TraceQL-Abfrage als Vorlagenabfrage schreiben, um andere Dashboard-Variablen zu nutzen, sofern sie existieren. Auf diese Weise können Sie dynamische Abfragen auf der Grundlage dieser Variablen erstellen.
Wenn Ergebnisse einer Abfrage zurückgegeben werden, werden die Ergebnisse in der Tabelle des Panels gerendert.
**Die Ergebnisse in der Traces-Visualisierung enthalten Links zur Explore-Seite, auf der der Trace gerendert wird.** Sie können weitere Links zu Traces in der Tabelle hinzufügen, die die `traceId` Dashboard-Variable ausfüllen, wenn sie ausgewählt ist, sodass die Ablaufverfolgung im selben Dashboard visualisiert wird.
Gehen Sie wie folgt vor, um eine Reihe von Datenlinks im Panel zu erstellen.
**Um eine Variable zu verwenden, um weitere Links zu Traces hinzuzufügen**
1. Wählen Sie im Menü auf der rechten Seite unter **Datenverknüpfungen** die Option **Link hinzufügen** aus.
1. Fügen Sie einen **Titel** für den Datenlink hinzu.
1. Finden Sie den Pfad zum Dashboard, indem Sie in der Adressleiste Ihres Browsers nachschauen, wenn das vollständige Dashboard gerendert wird. Da es sich um einen Link zu einem Dashboard im selben Grafana-Stack handelt, ist nur der Pfad des Dashboards erforderlich.
Zum Beispiel, wenn Ihr Pfad wie folgt lautet:
```
https://g-example.grafana-workspace.us-east-1.amazonaws.com{{/d/1234abcd5/my-dashboard?orgId=1}}
```
Dann lautet der Pfad zum Dashboard:
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. Stellen Sie im **URL-Feld** einen Selbstreferenz auf das Dashboard her, das beide Bereiche enthält. Diese Selbstreferenz verwendet den Wert der ausgewählten Spur in der Tabelle, um die Dashboard-Variable auszufüllen. Verwenden Sie den Pfad für das Dashboard aus dem vorherigen Schritt und geben Sie dann den Wert für die `traceId` Verwendung der ausgewählten Ergebnisse aus der TraceQL-Tabelle ein. Die Trace-ID wird mithilfe des `traceID` Datenfeldes in den zurückgegebenen Ergebnissen angezeigt. Verwenden Sie diesen Wert also als Wert für die Dashboard-Variable. Beispiel:
```
/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
```
1. Wählen Sie **Speichern**, um die Datenverknüpfung zu speichern.
1. **Wählen Sie im Panel-Editor „Anwenden“, um das Panel auf das Dashboard anzuwenden.**
1. Speichern Sie das Dashboard.
In der Tabellenvisualisierung sollte nun eine Liste der passenden Traces angezeigt werden. Wenn Sie die Felder **TraceID** oder **SpanID** auswählen, haben Sie die Möglichkeit, entweder die **Explore-Seite** zu öffnen, um den Trace zu visualisieren, oder dem Datenlink zu folgen. Die Auswahl eines anderen Felds (wie `Start time``Name`, oder`Duration`) folgt automatisch dem Datenlink, füllt die `traceId` Dashboard-Variable aus und zeigt dann den entsprechenden Trace im Trace-Bereich an.