Traces suchen und untersuchen

Auf der Seite Trace Explorer können Sie einzelne Traces im Detail ermitteln und untersuchen. Auf dieser Seite werden Traces angezeigt, für die in Ihrem Google Cloud-Projekt mindestens ein Span gespeichert ist. Die für jeden angezeigten Trace und Span angezeigten Daten enthalten zusammenfassende Informationen wie die Latenz und den Befehlstyp sowie detaillierte Informationen. Die detaillierten Informationen umfassen Logs, Ereignisse und andere Informationen.

Auf der Seite Trace-Explorer werden maximal 1.000 Traces angezeigt.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Trace User (roles/cloudtrace.user) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Aufrufen von Trace-Daten über die Google Cloud Console benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

Weitere Informationen zu Rollen finden Sie unter Zugriff mit Identity and Access Management steuern.

Letzte Traces anzeigen

So rufen Sie die neuesten Traces auf:

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.

   Wenn Sie Trace zum ersten Mal verwenden, kann es einige Minuten dauern, bis Traces angezeigt werden. Der folgende Screenshot zeigt ein Beispiel für die Seite Trace Explorer:

   

   Im Streudiagramm wird für jede Anfrage im ausgewählten Zeitintervall ein Punkt angezeigt:

   • Die (x,y)-Koordinaten für eine Anfrage entsprechen der Zeit und Latenz der Anfrage.

   • Fehlerinformationen sind in der Farbe eines Punkts codiert. Blau steht für Erfolg, Rot für Fehler. Im vorherigen Screenshot wurden die meisten Befehle erfolgreich ausgeführt.

   • Die Kurzinfo, die aktiviert wird, wenn Sie den Mauszeiger auf einen Punkt bewegen, enthält das Datum, die Uhrzeit, den URI und die Latenz:

     

2. Optional: Zum Filtern der angezeigten Traces und Spans haben Sie folgende Möglichkeiten:

   • Nach Zeit filtern. Standardmäßig wird die Daten der letzten Stunde angezeigt. So erstellen Sie ein benutzerdefiniertes Zeitintervall:

     1. Wählen Sie eine voreingestellte Option aus, die länger als das benutzerdefinierte Zeitintervall ist.
     2. Platzieren Sie den Zeiger im Diagramm Trace auswählen an einem Ende des Zeitintervalls und ziehen Sie den Zeiger horizontal zum anderen Ende des Intervalls.

     Wenn Sie das Diagramm im vordefinierten Zeitintervall wiederherstellen möchten, klicken Sie auf Zurücksetzen.

   • Nach Latenz filtern. Standardmäßig werden alle Traces im ausgewählten Zeitintervall angezeigt. Wenn Sie die Anzeige auf die Traces beschränken möchten, deren Latenz in einem Intervall liegt, platzieren Sie den Mauszeiger an einem Ende des Latenzwerts und ziehen Sie ihn vertikal zum anderen Ende.

     Wenn Sie das Diagramm im vordefinierten Zeitintervall wiederherstellen möchten, klicken Sie auf Zurücksetzen.

   • Klicken Sie auf Trace-Filter hinzufügen, wählen Sie eine Filteroption aus und geben Sie dann einen Filterwert an oder geben Sie ihn ein. Wenn Sie mehrere Filter hinzufügen, werden nur Traces angezeigt, die allen Filtern entsprechen. Wenn Sie beispielsweise alle Traces anzeigen lassen möchten, die einen HTTP-GET-Befehl enthalten und deren Latenz mindestens 2 Sekunden beträgt, fügen Sie die Filter Method: GET und MinLatenz: 2000 hinzu.

     Die folgenden Filteroptionen sind immer verfügbar:

     • RootSpan: Entspricht dem Namen des Haupt-Spans.
     • SpanName: Entspricht dem Namen des Spans.
     • Methode: Zeigt Traces an, deren Haupt-Spans mit dem Label /http/method gekennzeichnet sind, wobei der Wert des Labels mit dem Filterwert übereinstimmt.
     • Status: Zeigt Traces an, deren Haupt-Spans mit dem Label /http/status_code gekennzeichnet sind, wobei das Wertlabel dem Filterwert entspricht. Der Filterwert kann bestimmte Statuscodes wie 301 oder Bereiche von Statuswerten enthalten, z. B. 3xx.
     • MinLatency: Zeigt Traces an, deren Latenz mindestens so groß wie der Filterwert ist. Der Filterwert muss in Millisekunden angegeben werden.
     • HasLabel: Zeigt Traces an, in denen das durch den Filterwert angegebene Label in mindestens einem Span enthalten ist.

     • Dienst: Zeigt Traces an, die mindestens einen Span enthalten, dessen Dienstname mit dem Filterwert übereinstimmt.

       Der Dienstname für einen Span wird aus dem OpenTelemetry-Attribut service.name extrahiert, wenn dieses Attribut festgelegt ist. Wenn dieses Attribut nicht festgelegt ist und der Dienst in App Engine ausgeführt wird, wird der App Engine-Dienstname angezeigt. Andernfalls wird der Dienst nicht angegeben.

     • Version (nur App Engine): Zeigt Traces an, die mindestens einen Span enthalten, dessen Version der Anwendung dem Filterwert entspricht.

     Möglicherweise werden andere Filteroptionen wie URL oder HTTP-Labels angezeigt. Wenn Sie ein benutzerdefiniertes Label haben, das einem vordefinierten Filter entspricht, wird dem benutzerdefinierten Label LABEL vorangestellt, damit Sie zwischen den beiden unterscheiden können. Wenn Sie beispielsweise ein Service-Label erstellen, werden im Filtermenü sowohl Service als auch LABEL:Service angezeigt.

     Hinweis: Um eine genaue Übereinstimmung durchzuführen, stellen Sie dem Filterwert ein Pluszeichen (+) voran. Wenn Sie das Pluszeichen weglassen, wird eine Übereinstimmung durch einen Präfixtest mit dem Filterwert ermittelt. Weitere Informationen zu Filteroptionen finden Sie unter Trace-Filter.

Trace nach ID suchen

Wenn Sie einen Vorfall oder Fehler beheben, kennen Sie möglicherweise die Trace-ID. So untersuchen Sie diesen Trace:

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 ein Google Cloud-Projekt aus, aus dem Sie die Trace-Daten ansehen möchten.

   Sie müssen das Google Cloud-Projekt auswählen, in dem die Trace-Daten gespeichert werden, es sei denn, Ihr Projekt ist Teil einer Organisation. Wenn ein Projekt zu einer Organisation gehört, können Sie projektübergreifendes Tracing konfigurieren. Damit haben Sie die Möglichkeit, Trace-Daten aus jedem Projekt in der Organisation aufzurufen. Weitere Informationen finden Sie unter Traces projektübergreifend ansehen.

3. Geben Sie die ID in das Feld Trace-ID ein.

   Wenn Sie eine gültige ID eingeben, werden im Bereich Trace-Details Informationen zum Trace und zu seinen Spans angezeigt. Sie können die Optionen in diesem Bereich verwenden, um den Trace zu untersuchen.

Trace untersuchen

Klicken Sie auf einen Punkt im Streudiagramm, um einen Trace zu untersuchen. Wenn Sie auf einen Punkt im Streudiagramm klicken, werden auf der Seite Trace-Explorer die folgenden Änderungen vorgenommen:

• Das Streudiagramm wird aktualisiert und der ausgewählte Punkt wird mit einem Kreis um ihn herum hervorgehoben. Die Punkte, die alle anderen Traces darstellen, sind abgeblendet.

• Im Bereich Trace-Details wird Folgendes angezeigt:

  • Die Trace-ID. Diese global eindeutige Kennung für den Trace ist eine 128-Bit-Ganzzahl, die als 32-Byte-Hexadezimalstring dargestellt wird. Weitere Informationen finden Sie unter Resource: Trace.

  • Eine Zusammenfassungszeile, in der die Startzeit, die Dauer und die Anzahl der Spans aufgeführt sind.

  • Das Menü Protokolle und Ereignisse Über die Menüauswahl wird festgelegt, wie Logs und Ereignisse angezeigt werden. Wenn ein Log oder Ereignis vorhanden ist, wird dem Trace-Span standardmäßig ein Kreis hinzugefügt. Überlappende Kreise weisen darauf hin, dass der Span mehrere Logs oder Ereignisse enthält. Damit die einzelnen Logs oder Ereignisse als Zeile in der Tabelle angezeigt werden, maximieren Sie Logs und Ereignisse und wählen Sie Maximierte Anzeige aus.

  • Eine Tabelle. Die erste Zeile der Tabelle ist für den Trace. Für jeden Span im Trace wird eine Zeile hinzugefügt.

    Für Spans werden in der Tabelle der Span-Name und der mit dem Span verknüpfte Dienst aufgeführt. Der Dienstname wird aus dem OpenTelemetry-Attribut service.name extrahiert, wenn dieses Attribut festgelegt ist. Wenn dieses Attribut nicht festgelegt ist und der Dienst in App Engine ausgeführt wird, wird der App Engine-Dienstname angezeigt. Andernfalls wird der Dienst nicht angegeben.

    Die Spalte Latenz enthält eine visuelle Darstellung der Latenz, des Status und gegebenenfalls der Ereignisanmerkungen. Ein blauer Latenzbalken zeigt an, dass der Vorgang erfolgreich abgeschlossen wurde. Ein roter Latenzbalken zeigt an, dass ein Fehler aufgetreten ist. Jede Ereignisanmerkung im Bereich wird durch einen Kreis auf der Latenzleiste dargestellt.

Im Folgenden sehen Sie ein Beispiel für den Bereich Trace-Details:

Spans in einem Trace suchen

Sie können in den Spans und Attributen in einem Trace nach Schlüsselwörtern suchen. Im Screenshot oben sind beispielsweise einige Spans und ein Attributschlüssel hervorgehoben. Diese Felder sind hervorgehoben, da sie mit dem Suchbegriff net.sock.peer.port übereinstimmen.

Geben Sie in der Symbolleiste im Bereich Trace-Details den Suchbegriff in das Feld In Trace suchen ein und drücken Sie die Eingabetaste, um die Spans in einem Trace zu suchen.

Trace durchsucht dann ausgewählte Felder jedes Spans im angezeigten Trace. Eine Übereinstimmung liegt vor, wenn ein Suchfeld den Suchbegriff enthält. Die Groß- und Kleinschreibung wird dabei nicht berücksichtigt. In den folgenden Feldern wird gesucht:

• Span-Name.
• Dienstname.
• Schlüssel und Werte von Attributen.

Nach Abschluss der Suche wird der Bereich Trace-Details aktualisiert und übereinstimmende Felder werden hervorgehoben.

Wenn Sie beispielsweise den Begriff get eingeben, wird ein Span mit einem Attribut hervorgehoben, dessen Schlüssel /http/method und dessen Wert GET ist. Außerdem werden Spans mit Namen wie CurrencyService/GetSupportedCurrencies hervorgehoben.

Es ist nicht möglich, anhand eines regulären Ausdrucks oder in Logs, Ereignissen oder Metadaten zu suchen.

Span-Details ansehen

Hinweis: Wenn Sie den Bereich Trace-Details maximieren möchten, um die Seite Trace-Explorer auszufüllen, rufen Sie die Symbolleiste im Bereich Trace-Details auf und klicken Sie dann auf Trace-Details maximieren.

Wenn Sie detaillierte Informationen zum Trace oder zu einem bestimmten Span aufrufen möchten, klicken Sie im Bereich Trace-Details auf die Latenzleiste für den Eintrag. Wenn Sie die Latenzleiste auswählen, wird der Bereich Trace-Details neu gezeichnet und enthält eine Tabelle mit Tabs mit zusätzlichen Informationen zum Eintrag.

Wenn Sie die Latenzleiste für die erste Zeile der Tabelle auswählen, enthält die Zeile mit dem Namen Trace-ID zwei Tabs: Zusammenfassung und Logs. Auf dem Tab Zusammenfassung finden Sie allgemeine Informationen zum Trace. Bei HTTP-Befehlen werden auf diesem Tab beispielsweise der Typ des HTTP-Befehls, der Dienst und die Latenzinformationen für jeden Span im Trace angezeigt.

Wenn Sie die Latenzleiste für andere Zeilen in der Tabelle auswählen, also eine Zeile für einen Span, enthält die Tabelle vier Tabs: Attribute, Logs und Ereignisse, Stacktraces, Metadaten und Links:

• Die Labels für einen Span finden Sie auf dem Tab Attribute. Informationen zu Labels finden Sie unter Trace-Labels. Der folgende Screenshot zeigt diesen Tab:

  

  Fügen Sie einen Filter hinzu, um ein bestimmtes Label oder eine Gruppe von Labels zu finden. Wenn Sie beispielsweise den Filter Key: g.co hinzufügen, werden in der Tabelle alle Labels aufgeführt, bei denen der Labelschlüssel g.co enthält.

• Informationen zu zugehörigen Logeinträgen und Ereignissen, sofern vorhanden, finden Sie auf dem Tab Logs und Ereignisse. Informationen zu Ereignisanmerkungen finden Sie unter Trace-Spans annotieren. Der folgende Screenshot zeigt diesen Tab:

  

  Wenn Logdaten verfügbar sind, klicken Sie auf Show more (Mehr anzeigen), um Details zu einem Logeintrag aufzurufen:

  

• Auf dem Tab Stacktraces finden Sie Informationen zur Anzahl der verfügbaren Stacktraces und ausführliche Informationen zu einem erfassten Stacktrace.

• Allgemeine Informationen zum Span und eine Tabelle mit Links zu anderen Spans finden Sie auf dem Tab Metadaten und Links. Zu diesen Informationen gehören:

  • Span-ID

    Die Span-ID ist eine 64-Bit-Ganzzahl, die nicht 0 ist. Weitere Informationen finden Sie unter TraceSpan.

  • Übergeordnete Span-ID

  • Projekt-ID

  • Beginn und Ende

  • Tabelle mit Links zu anderen Spans

    Jede Zeile in der Tabelle Links enthält eine Verknüpfung zwischen dem aktuellen Span und einem anderen Span. Im Feld Attributes werden die Schlüssel/Wert-Paare für den verknüpften Span aufgelistet. Das Feld Trace ist mit dem Trace für den verknüpften Span verknüpft. Wenn dieses Feld Aktueller Trace enthält, befindet sich der mit dem verknüpften Span im selben Trace wie der aktuelle Span. Andernfalls enthält das Feld eine Trace-ID. Informationen zu Links finden Sie auf der Referenzseite der Links API.

  Der folgende Screenshot zeigt diesen Tab:

  

Nächste Schritte

• Ereignisanmerkungen zu Trace-Spans hinzufügen
• Traces projektübergreifend ansehen
• Berichte erstellen und abrufen