Diese Seite wurde von der Cloud Translation API übersetzt.

Traces suchen und analysieren

Auf der Seite Trace Explorer können Sie einzelne Traces im Detail suchen und untersuchen. Auf dieser Seite werden Traces angezeigt, für die in Ihrem Google Cloud-Projekt mindestens eine Span gespeichert ist. 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:

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 Koordinaten(x,y) einer Anfrage entsprechen der Zeit und der Latenz der Anfrage.
- Fehlerinformationen sind in der Farbe eines Punkts codiert. Blau steht für Erfolg und Rot für Fehler. Im vorherigen Screenshot wurden die meisten Befehle erfolgreich ausgeführt.
- In der Kurzinfo, die aktiviert wird, wenn Sie den Mauszeiger auf einen Punkt bewegen, werden Datum, Uhrzeit, URI und Latenz angezeigt:
Optional: Sie können die angezeigten Traces und SPANs filtern. Gehen Sie dazu so vor:
- Filtern Sie nach Zeitraum. Standardmäßig werden die Daten der letzten Stunde angezeigt. So erstellen Sie ein benutzerdefiniertes Zeitintervall:
  1. Wählen Sie eine voreingestellte Option aus, die länger ist als das 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. 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 wählen Sie dann einen Filterwert aus oder geben Sie ihn ein. Wenn Sie mehrere Filter hinzufügen, werden nur Traces angezeigt, die alle Filter erfüllen. 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 Label /http/method annotiert sind, wobei der Wert des Labels mit dem Filterwert übereinstimmt.
  - 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 wie 301 oder Statuswertbereiche wie 3xx enthalten.
  - MinLatency: Zeigt Traces an, deren Latenz mindestens so groß wie der Filterwert ist. 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: Zeigt Traces an, die mindestens einen Span enthalten, dessen Dienstname mit dem Filterwert übereinstimmt.
    
    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) Zeigt Traces an, die mindestens einen Span enthalten, dessen Anwendungsversion 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, sehen Sie im Filtermenü sowohl Dienst als auch LABEL:Dienst.
  
  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 Filteroptionen finden Sie unter Trace-Filter.

Traces nach ID suchen

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

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.
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 zu einer Organisation gehört, können Sie die projektübergreifende Aufrufabfolge konfigurieren. So können Sie sich Trace-Daten aus allen Projekten in der Organisation ansehen. Weitere Informationen finden Sie unter Traces projektübergreifend ansehen.
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 angezeigt. Mit den Optionen in diesem Bereich können Sie den Trace untersuchen.

Trace analysieren

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 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 eine 128-Bit-Ganzzahl, die als 32-Byte-Hexadezimalstring dargestellt wird. Weitere Informationen finden Sie unter Resource: Trace.
- Eine Zusammenfassungszeile mit Startzeit, Dauer und Anzahl der Zeiträume.
- Das Menü Protokolle und Ereignisse. Mit der Menüauswahl wird festgelegt, wie Protokolle und Ereignisse angezeigt werden. Wenn ein Protokoll oder Ereignis vorhanden ist, wird der Trace-Spanne standardmäßig ein Kreis hinzugefügt. Überlappende Kreise weisen darauf hin, dass die Spanne mehrere Protokolle oder Ereignisse enthält. Wenn Sie jedes Protokoll oder Ereignis als Zeile in der Tabelle anzeigen möchten, maximieren Sie Protokolle und Ereignisse und wählen Sie Maximiert anzeigen aus.
- Eine Tabelle. Die erste Zeile der Tabelle ist für die Spur. Für jeden Span im Trace wird eine Zeile hinzugefügt.
  
  Für Spans sind in der Tabelle der Span-Name und der zugehörige Dienst aufgeführt. Der Dienstname 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.
  
  In der Spalte Latenz werden die Latenz, der Status und gegebenenfalls Ereignisanmerkungen visuell dargestellt. 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 auf der Latenzbalken dargestellt.

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

Beispiele für den Cloud Trace-Bereich „Details“.

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

Wenn Sie in den Spans eines Tracings suchen möchten, geben Sie in der Symbolleiste des Bereichs Trace-Details den Suchbegriff in das Feld Im Trace suchen ein und drücken Sie die Eingabetaste.

In Trace wird dann in ausgewählten Feldern jeder Span im angezeigten Trace gesucht. Eine Übereinstimmung liegt vor, wenn ein Suchfeld den Suchbegriff enthält, wobei die Groß- und Kleinschreibung nicht berücksichtigt wird. Es wird in den folgenden Feldern 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 Bereiche mit Namen wie CurrencyService/GetSupportedCurrencies hervorgehoben.

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

Span-Details ansehen

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 Latenzbalken auswählen, wird der Bereich Trace-Details neu gezeichnet und eine Tabelle mit Tabs mit zusätzlichen Informationen zum Eintrag angezeigt.

Wenn Sie die Latenzleiste für die erste Zeile in der Tabelle auswählen, also die Zeile mit dem Namen Trace-ID, enthält die Tabelle zwei Tabs: Zusammenfassung und Protokolle. 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 jede Spanne im Trace angezeigt.

Wenn Sie die Latenzbalken für andere Zeilen in der Tabelle auswählen, also eine Zeile für eine Spanne, enthält die Tabelle vier Tabs: Attribute, Protokolle und Ereignisse, Stack-Traces und 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 zeigt 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 Ereignis-Spans mit Anmerkungen versehen. Der folgende Screenshot zeigt diesen Tab:

Wenn Logdaten verfügbar sind, klicken Sie auf Mehr anzeigen, um Details zu einem Logeintrag aufzurufen:
Auf dem Tab Stack-Traces finden Sie Informationen zur Anzahl der verfügbaren Stack-Traces und detaillierte Informationen zu einem erfassten Stack-Trace.
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
- Start- und Endzeit
- Tabelle mit Links zu anderen Spannen
  
  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 Bereich. Wenn dieses Feld Aktuelle Trace enthält, befindet sich die verknüpfte Span in derselben Trace wie die aktuelle Span. Andernfalls enthält das Feld eine Trace-ID. Informationen zu Links findest du auf der API-Referenzseite für Links.
Der folgende Screenshot zeigt diesen Tab: