Traces suchen und untersuchen

Auf der Seite Trace Explorer können Sie einzelne Traces suchen 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 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-Nutzer (roles/cloudtrace.user) für Ihr Projekt zu gewähren, damit Sie die erforderlichen Berechtigungen erhalten, um Trace-Daten mithilfe der Google Cloud Console anzusehen. 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:

Wählen Sie im Navigationsbereich der Google Cloud Console Trace und dann Trace Explorer aus:
Zum Trace Explorer

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 bedeutet, dass der Vorgang erfolgreich war, und rot, dass ein Fehler aufgetreten ist. Im vorherigen Screenshot wurden die meisten Befehle erfolgreich ausgeführt.
- Die Kurzinfo, die aktiviert wird, wenn Sie den Mauszeiger auf einen Punkt bewegen, zeigt das Datum, die Uhrzeit, den URI und die Latenz an:
Optional: Führen Sie einen der folgenden Schritte aus, um die angezeigten Traces und Spans zu filtern:
- Nach Zeit filtern. Standardmäßig wird die letzte Stunde mit Daten 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 Mauszeiger an einem Ende des Zeitintervalls im Diagramm Trace auswählen und ziehen Sie ihn 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 Traces beschränken möchten, deren Latenz innerhalb eines Intervalls liegt, setzen Sie den Mauszeiger an ein Ende des Latenzwerts und ziehen Sie den Mauszeiger 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 einen Wert 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 annotiert sind, wobei der Wert des Labels dem Filterwert entspricht.
  - Status: Hiermit werden Traces angezeigt, deren Haupt-Spans mit dem Label /http/status_code gekennzeichnet sind. Das Wertlabel entspricht dabei dem Filterwert. Der Filterwert kann bestimmte Statuscodes wie 301 oder Statuswertebereiche wie 3xx enthalten.
  - MinLatency: Zeigt Traces an, deren Latenz mindestens so groß wie der Filterwert ist. Der Filterwert muss in Millisekunden angegeben werden.
  - HasLabel: Traces anzeigen, bei denen das durch den Filterwert angegebene Label in mindestens einem Span vorhanden 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 Anwendungsversion mit dem Filterwert übereinstimmt.
  Möglicherweise werden weitere Filteroptionen wie URL oder HTTP-Labels angezeigt. Wenn Sie ein benutzerdefiniertes Label haben, das einem vordefinierten Filter entspricht, wird dem benutzerdefinierten Label das Präfix LABEL vorangestellt, damit Sie die beiden Labels unterscheiden können. Wenn Sie beispielsweise ein Service-Label erstellen, sehen Sie im Filtermenü sowohl Service als auch LABEL:Service.
  
  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 anhand der ID suchen

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

Wählen Sie im Navigationsbereich der Google Cloud Console Trace und dann Trace Explorer aus:
Zum Trace Explorer
Wählen Sie ein Google Cloud-Projekt aus, aus dem die Trace-Daten angezeigt werden sollen.

Sie müssen das Google Cloud-Projekt auswählen, in dem die Trace-Daten gespeichert werden, sofern Ihr Projekt nicht Teil einer Organisation ist. Wenn ein Projekt Teil einer Organisation ist, können Sie projektübergreifendes Tracing konfigurieren. Dadurch können Sie Trace-Daten aus jedem Projekt in der Organisation abrufen. 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, wird der Bereich Trace-Details mit Informationen zum Trace und seinen Spans gefüllt. Sie können die Optionen in diesem Bereich verwenden, um zum Trace zu navigieren.

Trace untersuchen

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

Das Streudiagramm wird aktualisiert und der ausgewählte Punkt wird mit einem Kreis um ihn herum hervorgehoben. Die Punkte für alle anderen Traces 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ü Logs 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. Sich überschneidende Kreise weisen darauf hin, dass der Span mehrere Logs oder Ereignisse enthält. Wenn jedes Log oder Ereignis als Zeile in der Tabelle angezeigt werden soll, maximieren Sie Logs und Ereignisse und wählen Sie Maximiert anzeigen aus.
- Eine Tabelle. Die erste Zeile der Tabelle ist für das 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, falls vorhanden, der Ereignisanmerkungen. Ein blauer Latenzbalken bedeutet, dass der Vorgang erfolgreich abgeschlossen wurde, und ein roter Balken, dass ein Fehler aufgetreten ist. Jede Ereignisanmerkung im Bereich wird auf dem Latenzbalken durch einen Kreis dargestellt.

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

Beispiele für den Cloud Trace-Detailbereich.

Span-Details ansehen

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

Wenn Sie in der ersten Zeile der Tabelle die Latenzleiste auswählen, die den Namen Trace-ID hat, enthält die Tabelle zwei Tabs: Zusammenfassung und Logs. Der Tab Zusammenfassung enthält allgemeine Informationen zum Trace. Bei HTTP-Befehlen werden auf diesem Tab beispielsweise der Typ des HTTP-Befehls, der Dienst und 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 Events, Stacktraces, Metadata und Links:

Die Labels eines Spans finden Sie auf dem Tab Attribute. Informationen zu Labels finden Sie unter Trace-Labels. Der folgende Screenshot zeigt diese Registerkarte:

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 aufgelistet, bei denen der Labelschlüssel g.co enthält.
Informationen zu zugehörigen Logeinträgen und Ereignissen finden Sie auf dem Tab Logs und Ereignisse. Informationen zu Ereignisanmerkungen finden Sie unter Trace-Spans annotieren. Der folgende Screenshot zeigt diese Registerkarte:

Wenn Logdaten verfügbar sind, klicken Sie auf Mehr anzeigen, um Details zu einem Logeintrag aufzurufen:
Informationen zur Anzahl der verfügbaren Stacktraces und ausführliche Informationen zu einem erfassten Stacktrace finden Sie auf dem Tab Stacktraces.
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 findest du unter TraceSpan.
- Übergeordnete Span-ID
- Projekt-ID
- Beginn und Ende
- Tabelle mit Links zu anderen Spans
  
  Jede Zeile in der Tabelle mit dem Namen Links enthält eine Verknüpfung zwischen dem aktuellen Span und einem anderen Span. Im Feld Attributes (Attribute) werden die Schlüssel/Wert-Paare für den verknüpften Span aufgeführt. 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 Span verknüpfte Span im selben Trace wie der aktuelle Span. Andernfalls enthält das Feld eine Trace-ID. Informationen zu Links finden Sie auf der Links API-Referenzseite.
Der folgende Screenshot zeigt diese Registerkarte: