Traces suchen und analysieren

Um einzelne Traces im Detail zu finden und zu untersuchen, verwenden Sie die Trace-Explorer Seite. Auf dieser Seite werden Traces angezeigt, für die Ihr Google Cloud-Projekt speichert mindestens eine Spanne. Die Daten, die für jeden angezeigten Trace und Span angezeigt werden, enthalten zusammenfassende Informationen wie die Latenz und den Befehlstyp sowie detaillierte Informationen. Die detaillierten Informationen umfassen Protokolle, 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 zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Trace-Daten in der Google Cloud Console 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.

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 den Trace Explorer Seite:

   

   Im Streudiagramm wird für jede Anfrage in der ausgewählten Zeitintervall:

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

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

   • Die Kurzinfo wird aktiviert, wenn Sie den Mauszeiger auf einen Punkt bewegen. zeigt Datum, Uhrzeit, URI und Latenz an:

     

2. Optional: Um die angezeigten Traces und Spans zu filtern, eine der folgenden Aktionen ausführen:

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

     1. Wählen Sie eine voreingestellte Option aus, die länger ist als Ihre benutzerdefinierte Zeitintervall.
     2. Platzieren Sie den Mauszeiger auf dem Diagramm Trace auswählen an einem Ende des Zeitintervalls und ziehen Sie ihn dann horizontal zum anderen Ende des Intervalls.

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

   • Filtern Sie nach Latenz. Standardmäßig werden alle Traces im ausgewählten Zeitraum angezeigt. Um die Anzeige auf die Traces zu beschränken, deren Latenz Platzieren Sie den Zeiger an einem Ende des Latenzwerts, und ziehen Sie den Zeiger 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 wählen Sie dann einen Filterwert aus oder geben Sie ihn ein. Wenn Sie mehrere Filter hinzufügen, Es werden nur Traces angezeigt, die allen Filtern entsprechen. Wenn Sie beispielsweise alle Traces anzeigen möchten, die einen HTTP-GET-Befehl enthalten und deren Latenz mindestens 2 Sekunden beträgt, fügen Sie die Filter Methode: GET und MinLatency: 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 Attribut /http/method, wobei der Wert des Labels mit dem den Filterwert.
     • Status: Zeigt Traces an, deren Haupt-Spans mit dem Label /http/status_code annotiert sind, wobei das Wertlabel mit dem Filterwert übereinstimmt. Der Filterwert kann bestimmte Statuscodes enthalten, wie z. B. 301 oder Bereiche von Statuswerten, z. B. 3xx.
     • MinLatency: Zeigt Traces an, deren Latenz mindestens so groß ist wie als Filterwert hinzu. Der Filterwert muss in Millisekunden angegeben werden.
     • HasLabel: Zeigt Traces an, wenn das mit dem Filterwert angegebene Label in mindestens einem Span enthalten ist.

     • Dienst: Traces anzeigen, die mindestens enthalten Ein Span, dessen Dienstname dem Filterwert entspricht.

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

     • Version (nur App Engine): Traces anzeigen, die unter Mindestens einen Span, dessen Version der Anwendung mit dem Filterwert übereinstimmt.

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

     Hinweis: Wenn Sie eine genaue Übereinstimmung durchführen möchten, setzen Sie vor den Filterwert ein Pluszeichen (+). Wenn Sie das Pluszeichen weglassen, wird eine Übereinstimmung durch einen Präfixtest mit dem Filterwert ermittelt. Weitere Informationen zu den Filteroptionen Siehe 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, für das Sie die Trace-Daten aufrufen 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 gehört zu einer Organisation, in der Sie projektübergreifendes Tracing konfigurieren können können Sie Trace-Daten von jedem Projekt in Ihrer Organisation abrufen. 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 seinen Spans. Sie können die Optionen in dieser um zum Trace zu gelangen.

Trace untersuchen

Klicken Sie auf einen Punkt im Streudiagramm, um einen Trace zu untersuchen. Wenn Sie auf einen Punkt im Streudiagramm klicken, ändert sich der Seite Trace Explorer:

• Das Streudiagramm wird aktualisiert und der von Ihnen ausgewählte Punkt wird mit einem Kreis um den Punkt hervorgehoben. Die Punkte, die alle anderen Spuren darstellen, sind ausgegraut.

• Im Bereich Trace-Details werden die folgenden Informationen angezeigt:

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

  • Eine Zusammenfassungszeile mit Startzeit, Dauer und Anzahl der Zeiträume.

  • A Protokolle und Ereignisse. Mit der Menüauswahl wird festgelegt, wie Protokolle und Ereignisse angezeigt werden. Wenn ein Protokoll oder ein Ereignis vorhanden ist, wird standardmäßig ein Kreis zum den Trace-Span. Überlappende Kreise weisen darauf hin, dass die Spanne mehrere Logs oder Ereignisse enthält. Um jedes Protokoll oder Ereignis als Zeile im in der Tabelle, maximieren Protokolle und Ereignisse und wählen Sie Maximierte Ansicht anzeigen 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 sind 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, sofern dieses Attribut festgelegt ist. Wenn das Attribut nicht festgelegt ist und der Dienst App Engine ist der App Engine-Dienstname angezeigt. Andernfalls wird der Dienst nicht angegeben.

    Die Spalte Latenz enthält eine visuelle Darstellung der Latenz, Status- und, falls vorhanden, Ereignishinweise. Ein blauer Latenzbalken gibt an, dass der Vorgang erfolgreich abgeschlossen wurde. Ein roter Latenzbalken gibt an, dass ein Fehler aufgetreten ist. Jede Ereignisanmerkung im Gruppenbereich wird durch einen Kreis im Latenzleiste.

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

Spans in einem Trace suchen

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

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

Trace durchsucht dann ausgewählte Felder jedes Spans im angezeigter Trace. Eine Übereinstimmung liegt vor, enthält den Suchbegriff ohne Groß- und Kleinschreibung. 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 werden übereinstimmende Felder hervorgehoben.

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

Sie können nicht mit einem regulären Ausdruck suchen und auch keine Protokolle, Ereignisse oder Metadaten durchsuchen.

Span-Details ansehen

Hinweis: Wenn Sie den Bereich Trace-Details maximieren möchten, Seite Trace Explorer, öffnen Sie die Symbolleiste im Bereich Trace-Details und Klicken Sie auf Trace-Details maximieren.

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

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

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

• Die Labels, die an einen Span angehängt sind, finden Sie auf dem Tab Attribute. Weitere Informationen zu Labels finden Sie unter Trace-Labels. Der folgende Screenshot veranschaulicht diesen Tab:

  

  Wenn Sie ein bestimmtes Label oder eine Gruppe von Labels suchen möchten, fügen Sie einen Filter hinzu. Wenn Sie beispielsweise den Filter Schlüssel: g.co hinzufügen, werden in der Tabelle alle Labels aufgeführt, deren Labelschlüssel g.co enthält.

• Informationen zu zugehörigen Logeinträgen und Ereignissen (falls vorhanden) finden Sie auf dem Tab Protokolle und Ereignisse. Informationen zu Ereignisanmerkungen finden Sie unter Trace-Spans mit Anmerkungen versehen. Der folgende Screenshot veranschaulicht diesen Tab:

  

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

  

• Informationen zur Anzahl der verfügbaren Stacktraces detaillierte Informationen zu einem erfassten Stacktrace abrufen können, verwenden Sie die Stacktraces .

• Allgemeine Informationen zur Spanne und eine Tabelle mit Links zu anderen Spannen finden Sie auf dem Tab Metadaten und Links. Dazu 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 Bereichen

    Jede Zeile in der Tabelle Links enthält einen Link zwischen dem aktuellen und einem anderen Span. Im Feld Attribute sind die Schlüssel/Wert-Paare für den verknüpften Bereich aufgeführt. Das Feld Trace verweist auf den Trace für den verknüpften Abschnitt. Wenn dieses Feld Aktueller Trace enthält, befindet sich die verknüpfte Span im selben Trace wie die aktuelle Span. Andernfalls enthält das Feld eine Trace-ID. Informationen zu Links finden Sie in der Links API-Referenzseite

  Der folgende Screenshot zeigt diesen Tab:

  

Nächste Schritte

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