Traces in einem benutzerdefinierten Dashboard anzeigen

In diesem Dokument wird beschrieben, wie Sie Tracedaten in benutzerdefinierten Dashboards anzeigen. Wenn Sie Ihren Dashboards Trace-Widgets hinzufügen, können Sie eine einheitliche Ansicht für die Fehlerbehebung erstellen, in der Span-Latenzen mit Systemmesswerten und Anwendungsprotokollen korreliert werden.

Wenn Sie Tracedaten in einem Dashboard anzeigen möchten, können Sie ein tracespezifisches Widget hinzufügen, eine Speicheroption auf der Seite Trace Explorer verwenden oder die Cloud Monitoring API nutzen.

Tracedaten visualisieren

Die Seite Trace Explorer bietet eine vorkonfigurierte Suite von Visualisierungen für die Fehlerbehebung. Standardmäßig wird eine Heatmap der Span-Latenzen und Listen einzelner oder gruppierter Spans angezeigt. Weitere Informationen finden Sie unter Traces suchen und untersuchen.

Da benutzerdefinierte Dashboards modular sind, können Sie eine dauerhafte Version dieser umfassenden Ansicht erstellen, indem Sie einzelne Trace-Widgets kombinieren. Sie können beispielsweise ein Heatmap-Widget neben separaten Tabellen für gruppierte und einzelne Spans hinzufügen. Wenn Sie dieses Layout in einem Dashboard nachbilden, können Sie alle Aspekte Ihrer Tracedaten in einer einzigen, freigegebenen Ansicht mit Ihren anderen Telemetriedaten beobachten:

Dashboard mit Trace-Daten.

Standardmäßig werden in Trace-Widgets Daten aus den Ressourcen in Ihrem Standard-Tracebereich angezeigt. Sie können jedoch den Bereich einzelner Widgets ändern, um in anderen Projekten zu suchen oder sich auf bestimmte Ressourcengruppen zu konzentrieren.

Wenn Sie ein Trace-Widget bearbeiten, wird eine integrierte Version des Trace Explorer geöffnet. In diesem Editor können Sie Filter hinzufügen und Konfigurationsoptionen ändern, genau wie bei der Durchführung von Untersuchungen, bevor Sie die dauerhaften Änderungen auf Ihre Dashboard-Kacheln anwenden.

Hinweis

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Anzeigen von Tracedaten in einem benutzerdefinierten Dashboard benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Ein Dashboard kann maximal 100 Widgets enthalten.

Speicheroption auf der Seite Trace Explorer verwenden

Der Trace Explorer bietet verschiedene Visualisierungen Ihrer Tracedaten. Sie können diese Visualisierungen einem Dashboard hinzufügen, um eine ähnliche Ansicht zu erstellen.

So speichern Sie Daten aus dem Trace Explorer in einem benutzerdefinierten Dashboard:

  1. Rufen Sie in der Google Cloud Console die Seite Trace Explorer auf:

    Zum Trace Explorer

    Sie können diese Seite auch über die Suchleiste finden.

  2. Wählen Sie in der Symbolleiste Im Dashboard speichern aus.

  3. Wählen Sie den Anzeigestil aus. Dafür gibt es zwei Möglichkeiten:

    • Visualizer: Fügen Sie Ihrem Dashboard eine Heatmap hinzu.
    • Span table: Fügen Sie Ihrem Dashboard eine Tabelle mit einzelnen Spans hinzu.
    • Gruppierte Spantabelle: Fügen Sie Ihrem Dashboard eine Tabelle mit gruppierten Spans hinzu.

  4. Wählen Sie ein Dashboard aus oder erstellen Sie eines.

  5. Klicken Sie auf Im Dashboard speichern.

Benutzerdefiniertem Dashboard ein Trace-Widget hinzufügen

In diesem Abschnitt wird beschrieben, wie Sie Tracedaten in einem benutzerdefinierten Dashboard anzeigen. Diese Anleitung bezieht sich auf die Google Cloud Console und geht davon aus, dass Sie ein Dashboard bearbeiten. Informationen zur Verwendung der Cloud Monitoring API finden Sie unter Dashboard mit Tracedaten.

So zeigen Sie Tracedaten in einem benutzerdefinierten Dashboard an:

  1. Öffnen Sie ein benutzerdefiniertes Dashboard:

    1. Öffnen Sie in der Google Cloud Console die  Dashboards Seite:

      Zu Dashboards

      Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

    2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

    3. Wählen Sie ein Dashboard aus oder klicken Sie auf Dashboard erstellen.

      Wenn Sie ein Dashboard erstellen, konfigurieren Sie im Menü Bereich , in welchen Ressourcen nach Tracedaten gesucht werden soll. Standardmäßig durchsucht das System die Ressourcen im Standard-Tracebereich nach Tracedaten.

  2. Klicken Sie in der Symbolleiste auf  Widget hinzufügen.

  3. Wählen Sie im Dialogfeld Widget hinzufügen im Bereich Daten die Option Trace aus.

  4. Konfigurieren Sie das Widget Trace. Sie können die Standardansicht und den Titel ändern und Filter hinzufügen.

    • Wenn Sie die Ansicht ändern möchten, maximieren Sie in der Symbolleiste das Menü Diagrammansicht und wählen Sie eine Ansicht aus:

      • Wenn Sie eine Heatmap hinzufügen möchten (Standard), wählen Sie Span-Dauer (Heatmap) aus.
      • Wenn Sie die Rate der Spans anzeigen möchten, wählen Sie Span-Rate (Liniendiagramm) aus.
      • Wenn Sie Latenzdaten anzeigen möchten, wählen Sie Span-Dauer (Perzentil) aus.
      • Wenn Sie Spans in Tabellenform auflisten möchten, wählen Sie Span-Rate (Liniendiagramm) oder Span-Dauer (Perzentil) aus und verwenden Sie das Menü Widget-Typ um eine Tabelle anzuzeigen. Mit Selektoren können Sie gruppierte oder nicht gruppierte Daten anzeigen.

    • Fügen Sie Filter hinzu, um die angezeigten Traces einzuschränken.

    • Wenn Sie den Titel aktualisieren möchten, geben Sie den neuen Titel in das Feld Widget-Titel ein.

  5. Wenn Sie die Änderungen auf das Dashboard anwenden möchten, klicken Sie in der Symbolleiste auf Anwenden. Wenn Sie die Änderungen verwerfen möchten, klicken Sie auf Abbrechen.

  6. Klicken Sie zum Speichern des geänderten Dashboards in der Symbolleiste auf Speichern.

Widget ändern oder bearbeiten, in dem Tracedaten angezeigt werden

Wenn Sie ein Widget ändern möchten, halten Sie den Mauszeiger darüber, um die Symbolleiste zu aktivieren, und klicken Sie dann auf  Widget bearbeiten.

Ein Trace Explorer-Editor wird geöffnet. In dieser Ansicht können Sie Filter hinzufügen oder entfernen und alle Konfigurationsoptionen ändern. Anschließend können Sie die Änderungen auf Ihr Dashboard anwenden oder verwerfen.

Beschränkungen

  • Filter auf Dashboard-Ebene werden nicht auf Trace-Widgets angewendet.
  • Sie können keine Variable auf die Abfrage für ein Trace-Widget anwenden.

Nächste Schritte