Traces suchen und untersuchen

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 für jeden angezeigten Trace und Span gezeigten 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 höchstens 1.000 Einträge angezeigt. Spuren.

Hinweise

So erhalten Sie die erforderlichen Berechtigungen zum Ansehen von Trace-Daten mithilfe der Google Cloud Console: bitten Sie Ihren Administrator, Ihnen Die IAM-Rolle Cloud Trace-Nutzer (roles/cloudtrace.user) für Ihr Projekt. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff 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:

    Bereich aktueller Traces von Cloud Trace.

    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:

      Es wird eine Trace-Kurzinfo angezeigt, die Latenzinformationen anzeigt.

  2. Optional: So filtern Sie die angezeigten Traces und Spans: 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 Zeiger an einem Ende des Zeitpunkts im Diagramm Trace auswählen Ziehen Sie den Zeiger horizontal zum anderen Ende des Intervall.

      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 werden. 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 und wählen Sie einen Filterwert aus oder geben Sie einen Wert ein. Wenn Sie mehrere Filter hinzufügen, Es werden nur Traces angezeigt, die allen Filtern entsprechen. Um beispielsweise alle Traces anzuzeigen, die einen HTTP-GET-Befehl enthalten und deren Latenz mindestens 2 Sekunden beträgt, fügen Sie die Filter Method: GET und MinLatenz: 2000.

      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 /http/status_code-Label, wobei das Wertlabel mit dem den Filterwert. 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: Traces anzeigen, in denen das durch den Filter angegebene Label angegeben ist. -Wert in mindestens einem Span vorhanden ist.

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

        Der Dienstname für einen Span wird aus OpenTelemetry extrahiert. Attribut service.name, wenn 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.

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

      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 das Präfix LABEL vorangestellt, damit Sie das Label zwischen den beiden. Wenn Sie beispielsweise ein Service-Label erstellen, geben Sie finden Sie im Filtermenü sowohl Service als auch LABEL:Service.

Trace nach ID suchen

Wenn Sie einen Vorfall oder Fehler beheben, 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, dass Ihr Projekt Teil eines Unternehmens ist. 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 ausgewählte Punkt wird hervorgehoben mit einem Kreis um den Punkt. Die Punkte, die alle anderen Traces abgeblendet.

  • Im Bereich Trace-Details wird Folgendes angezeigt:

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

    • Eine Zusammenfassungszeile, in der die Startzeit, die Dauer und die Anzahl der Spans.

    • A Protokolle und Ereignisse. Über die Menüauswahl wird gesteuert, wie Logs 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 Logs oder Ereignisse erstellen. 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. Eine Zeile wird hinzugefügt für jeden Span im Trace.

      Für Spans werden in der Tabelle die Namen der Spans und der zugehörige Dienst aufgeführt. mit der Spanne. Der Dienstname wird aus der OpenTelemetry-Attribut service.name, wenn 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 zeigt, erfolgreicher Abschluss, zeigt eine rote Latenzleiste 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:

Beispiele des Cloud Trace-Detailbereichs.

Spans in einem Trace suchen

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

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 weder reguläre Ausdrücke noch Protokolle durchsuchen, Ereignisse oder Metadaten.

Span-Details ansehen

So rufen Sie detaillierte Informationen zum Trace oder zu einem bestimmten Span auf: Klicken Sie im Bereich Trace-Details auf die Latenzleiste des Eintrags. 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 der Typ des HTTP-Befehls, der Dienst und Informationen zur Latenz angezeigt. für jeden Span im Trace.

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 für einen Span finden Sie auf dem Tab Attribute. Für Informationen zu Labels finden Sie unter Trace-Labels. Der folgende Screenshot zeigt diesen Tab:

    Beispiel für die Cloud Trace-Attributtabelle

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

  • So rufen Sie Informationen zu zugehörigen Logeinträgen und Ereignissen auf, sofern vorhanden: die Protokolle und Ereignisse. Informationen zu Ereignisanmerkungen Siehe Trace-Spans annotieren. Der folgende Screenshot zeigt diesen Tab:

    Beispiel für den Tab mit den Cloud Trace-Logs und -Ereignissen

    Wenn Logdaten verfügbar sind, können Sie Details zu einem Logeintrag abrufen, Klicken Sie auf Mehr anzeigen:

    Beispiel für ein erweitertes Log.

  • Informationen zur Anzahl der verfügbaren Stacktraces detaillierte Informationen zu einem erfassten Stacktrace erhalten, verwenden Sie die Stacktraces .

  • Allgemeine Informationen zum Span und eine Tabelle mit Links zu anderen sehen Sie sich die Metadaten- und „Links“. Zu diesen Informationen gehören die Folgendes:

    • 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 einen Link zwischen dem aktuellen Span und eine weitere Spanne. Im Feld Attribute werden die Schlüssel/Wert-Paare für des verknüpften Spans. Das Feld Trace ist mit dem Trace für die mit einem Span verknüpft ist. Wenn dieses Feld den aktuellen Trace enthält, gibt der Parameter Der verknüpfte Span befindet sich im selben Trace wie der 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:

    Beispiel für die Cloud Trace-Metadatenliste und die Tabelle mit Links

Nächste Schritte