Ablaufverfolgungen - Amazon Managed Grafana
Hinzufügen eines Panels mit Tracing-VisualisierungenHinzufügen von TraceQL mit Tabellenvisualisierungen

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 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

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:

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 erstellentraceID, um bestimmte Traces für eine bestimmte Trace-ID anzuzeigen. Weitere Informationen zu Dashboard-Variablen finden Sie in der Variablen-Dokumentation.

Voraussetzungen

Bevor Sie anfangen, benötigen Sie:

  • Ein Amazon Managed Grafana-Arbeitsbereich.

  • Eine Tempo-Datenquelle, 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.

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.

  2. Wähle „Visualisierung hinzufügen“ aus einem neuen Dashboard oder wähle „Bereich hinzufügen“ in einem vorhandenen Dashboard.

  3. Wählen Sie die entsprechende Tracing-Datenquelle aus.

  4. Wählen Sie oben rechts im Panel-Editor die Registerkarte Visualisierungen und dann Traces aus.

  5. Geben Sie unter den Panel-Optionen einen Titel für Ihr Trace-Panel ein. Weitere Informationen zum Panel-Editor finden Sie unterPanel-Optionen konfigurieren.

  6. Wählen Sie im Abfrage-Editor die Registerkarte TraceQL-Abfragetyp aus.

  7. Geben Sie ${traceId} in das TraceQL-Abfragefeld ein, um eine Dashboard-Variable zu erstellen. Diese Variable wird als Vorlagenabfrage verwendet.

  8. Wählen Sie im Panel-Editor „Anwenden“, um das Panel zum Dashboard hinzuzufügen.

  9. 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.

  10. 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.

  2. Wählen Sie dieselbe Trace-Datenquelle aus, die Sie im vorherigen Abschnitt verwendet haben.

  3. Wählen Sie oben rechts im Panel-Editor die Registerkarte Visualisierungen und dann Tabelle aus.

  4. Wählen Sie im Abfrage-Editor die Registerkarte TraceQL.

  5. Geben Sie unter den Panel-Optionen einen Titel für Ihr Trace-Panel ein.

  6. 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 von 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.

  2. Fügen Sie einen Titel für den Datenlink hinzu.

  3. 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

  4. 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. Beispielsweise:

    /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}

  5. Wählen Sie Speichern, um die Datenverknüpfung zu speichern.

  6. Wählen Sie im Panel-Editor „Anwenden“, um das Panel auf das Dashboard anzuwenden.

  7. 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 timeName, oderDuration) folgt automatisch dem Datenlink, füllt die traceId Dashboard-Variable aus und zeigt dann den entsprechenden Trace im Trace-Bereich an.