Trace-Details ansehen

Wenn Sie einen Trace auswählen, zeigt Cloud Trace die Details für einen Trace auf der Seite Trace-Liste an. Diese Ansicht beinhaltet eine Übersicht der Details zu der Anfrage, eine grafische Zeitachse mit der Darstellung der Haupt-Spans für die Anfrage und der Teil-Spans für RPC-Aufrufe sowie eine ausführliche Ansicht der für die Spans erfassten Latenzdaten.

Trace-Details ansehen

  1. Rufen Sie in der Google Cloud Console die Seite Trace-Liste auf:

    Zur Trace-Liste

  2. Es gibt mehrere Möglichkeiten, detaillierte Informationen zu einem Trace anzuzeigen:

    • Klicken Sie auf den in der Tabelle aufgeführten URI.
    • Klicken Sie im Diagramm auf den entsprechenden Punkt.
    • Geben Sie in der Ansicht Ausgewählte Trace-Details die Trace-ID im Hexadezimalformat ein. Wenn Sie eine Trace-ID eingeben, wird möglicherweise die Meldung Selected trace may not match current filters oder Selected trace is outside the current time range angezeigt. Diese Informationsmeldungen geben an, dass der angezeigte Trace nicht mit Ihren Filtern oder den Zeitraumeinstellungen übereinstimmt.

Ausgewählter Trace-Detailbereich

Wenn Sie einen Trace zur Untersuchung auswählen, werden Details zum ausgewählten Trace angezeigt:

  • Im Textfeld Ausgewählte Trace-Details wird die ID dieses Trace angezeigt.

  • Ein Fenster zeigt eine grafische Darstellung der Latenzdaten für die Anfrage mithilfe eines Wasserfalldiagramms an. Standardmäßig ist der Haupt-Span des ausgewählten Trace hervorgehoben.

  • In einem Bereich mit Tabellen werden detaillierte Informationen zum im Wasserfalldiagramm hervorgehobenen Span angezeigt.

Diese Felder werden jedes Mal mit neuen Daten aktualisiert, wenn Sie einen Trace zur Prüfung auswählen: Der folgende Screenshot veranschaulicht diese Bereiche:

Bereich Cloud Trace-Details.

Wasserfalldiagramm

Jede Zeile im Wasserfalldiagramm entspricht einem Span im Trace:

  • Wenn das Symbol angezeigt wird, hat Cloud Trace einen Span erkannt, dessen Startzeit vor der Startzeit des übergeordneten Spans liegt. Cloud Trace kompensiert automatisch diese Inkonsistenz, wenn der Span angezeigt wird. Die Span-Daten werden jedoch nicht geändert.

    Die Zeitstempelinkonsistenz kann auftreten, wenn ein Dienst mehrere Uhrenquellen oder unterschiedliche Sprachbibliotheken nutzt.

  • Wenn das Symbol angezeigt wird, bedeutet das, dass der Span einen HTTP-Fehler enthält.

  • Der Name des RPC-Aufrufs im Format service_name.call_name. Beispiel: datastore_v3.RunQuery

    In der App Engine-Standardumgebung stimmt der hier angegebene interne Name möglicherweise nicht mit dem Namen einer sprachspezifischen Dienst-API überein.

  • Die für die Durchführung des Umlauf-RPC-Aufrufs benötigte Zeit.

Kästchen Ereignisse ansehen

Wenn Sie das Kästchen Ereignisse ansehen anklicken, wird das Wasserfalldiagramm neu gezeichnet und die Ereignisannotationen werden als Zeilen in die Grafik eingefügt. Weitere Informationen zu Annotationen finden Sie unter Spans mit Annotationen versehen.

Zum Kopieren klicken

Sie können die URL der Detailansicht für einen bestimmten Trace in die Zwischenablage kopieren. Klicken Sie dazu auf Kopieren .

Tabellen mit Span-Details

Diese Tabellen enthalten detaillierte Informationen zu der Zeile, die derzeit im Wasserfalldiagramm hervorgehoben ist. Jede Zeile im Wasserfalldiagramm entspricht einem Trace-Span.

Wenn Sie eine Zeile markieren, enthalten die Details für diesen Span den URI-Namen, die relative Startzeit und den Namen des RPC-Aufrufs.

Welche Daten in den Tabellen angezeigt werden, hängt vom markierten Element ab. Die in der folgenden Tabelle aufgeführten Daten werden jedoch immer angezeigt:

Attribut Beschreibung
Relativer Beginn Der erste Eintrag ist die relative Startzeit für den Span.

Bei Root-Spans beträgt dieser Wert immer @0 ms.

Dies ist die Zeit, in der der Teilzeitraum relativ zum Beginn der Anfrage gestartet wurde. Dieser Wert gibt an, wie lange es vom Beginn der Gesamtanfrage dauert, bis dieser RPC-Aufruf beginnt.
Name Der nächste Eintrag ist der Name des RPC-Aufrufs. Namen haben das Format service_name.call_name. Beispiel: datastore_v3.RunQuery

Für die App Engine-Standardumgebung stimmt der hier angegebene interne Name möglicherweise nicht mit dem Namen einer sprachspezifischen Dienst-API überein.

Wenn ein Haupt-Span hervorgehoben wird und die Anfrage eine HTTP-Anfrage ist, wird eine Tabelle mit dem Namen Übersicht angezeigt. Die Tabelle enthält eine Zeile für den Haupt-Span und eine Zeile für jeden RPC:

Übersichtstabelle
Spalte
Beschreibung
Name Name des RPC-Aufrufs im Format service_name.call_name. Er wird im Label des Spans angezeigt.
RPCs Gibt an, wie oft das Verfahren aufgerufen wurde.
Gesamtdauer Die Gesamtzeit, die für das Ausführen der RPCs aufgewendet wurde.

In der Tabelle Detail werden Metadaten zum Span aufgeführt. Die folgenden Attribute werden immer angezeigt:

Detailtabelle
Attribut
Beschreibung
Timestamp Der Zeitpunkt, an dem die Anwendung die eingehende Anfrage empfing.
Log Link zu einem Logeintrag, falls Logdaten verfügbar sind Wenn keine Logdaten verfügbar sind, wird diese Zeile weggelassen.
Bericht Ein Link zum neuesten Analysebericht, der diesen Trace enthält. Diese Zeile wird weggelassen, wenn kein Bericht diesen Trace enthält.
Trace-ID Wenn Sie dieses Feld aufrufen möchten, klicken Sie auf das Menü Details .

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

Span-ID Wenn Sie dieses Feld aufrufen möchten, klicken Sie auf das Menü Details .

Die Kennung für den Span. Diese Kennzeichnung ist eine 64-Bit-numerische Ganzzahl außer 0. Weitere Informationen finden Sie unter TraceSpan.

GKE-Container

Wenn diese Tabelle angezeigt wird, enthält der Span die kanonischen Labels für einen GKE-Container. Jede Zeile in der Tabelle ist für ein bestimmtes Label vorgesehen. Der Wert ist ein Link, über den Sie weitere Informationen zur Ressource aufrufen können. Ausführliche Informationen zu allen Labels finden Sie unter Trace-Labels.

Die Labels und ihre Bedeutung sind in der folgenden Tabelle aufgeführt:

Label Wert
Project ID Das Google Cloud-Projekt, in dem der GKE-Cluster gehostet wird. Klicken Sie auf den Projektnamen, um zum GKE-Dashboard in der Google Cloud Console zu wechseln.
Cluster Name Identifiziert den GKE-Cluster. Klicken Sie auf diesen Wert, um die Konfigurationsseite Cluster aufzurufen.
Namespace Identifiziert den Namespace. Klicken Sie auf diesen Wert, um die GKE-Seite Arbeitslasten aufzurufen.
Pod Name Identifiziert den GKE-Pod. Klicken Sie auf diesen Wert, um das Dashboard Pod-Details aufzurufen.
Container Name Identifiziert den GKE-Container. Klicken Sie auf diesen Wert, um die Detailseite für den Container aufzurufen.
Labels Eine Tabelle mit Labels und Werten in der Anfrage. Labels sind anwendungsspezifisch. Ausführliche Informationen zu allen Labels finden Sie unter Trace-Labels.

Einige allgemeine Labels und ihre Bedeutung sind in der folgenden Tabelle aufgeführt:

Label Wert
http/host Der Name des Hosts, auf dem die Anwendung ausgeführt wird.
http/response/size Die Anzahl der Byte im HTTP-Antworttext.
http/url Relative URL für die Anfrage.
gae/request_log_id Interne App Engine-Anfrage-ID.

Wenn Ihr Anfragetyp HTTP ist oder Ihre Anwendung in App Engine ausgeführt wird, können zusätzliche Attribute aufgelistet werden. Die folgende Tabelle enthält eine unvollständige Liste einiger häufig beobachteter Attribute:

Attribut Beschreibung
Zeit mit Trace (Nur HTTP) Die Gesamtzeit, die für die Ausführung aller RPC-Aufrufe benötigt wurde.
Zeit ohne Trace (Nur HTTP) Der Zeitraum, währenddessen keine RPC-Aufrufe erfolgten. Damit wird die Zeit gemessen, die lokal in der Anwendung aufgewendet wird. Eine länger als gewöhnliche Zeit zu Beginn einer Anfrage kann häufig durch eine neue Instanz zur Verarbeitung der Last verursacht werden.
HTTP-Methode (Nur HTTP) Die HTTP-Methode für die Anfrage.
Dienst (Nur App Engine) Der App Engine-Dienst, der die Anfrage verarbeitet hat. Weitere Informationen finden Sie unter App Engine.
Version (Nur App Engine) Die Version der Anwendung, die die Anfrage verarbeitet hat.

Wenn Sie ein Ereignis markieren, werden die Ereignisdetails im Detailbereich angezeigt. Standardmäßig werden Ereignisse nicht im Wasserfalldiagramm angezeigt. Klicken Sie auf Ereignisse anzeigen, um sie in das Wasserfalldiagramm aufzunehmen.

Insights

Statistiken zur Leistung der Anfrage werden unterhalb der Zeitachse angezeigt, wenn Statistiken verfügbar sind.

Weitere Informationen finden Sie unter Statistiken.

Spans mit Annotationen versehen

Mit der Cloud Trace API v1 oder der Cloud Trace API v2 können Sie einen Trace annotieren. In diesem Abschnitt werden die verschiedenen Optionen beschrieben.

Zum Verknüpfen eines Trace mit einem Cloud Logging-Objekt LogEntry verwenden Sie Annotationen. Weitere Informationen zur Integration zwischen Cloud Trace und Cloud Logging finden Sie unter In Cloud Logging einbinden.

Annotationen mit Labels versehen

Sie können Annotationen zu Spans hinzufügen, indem Sie ein labels-Objekt erstellen und an das TraceSpan-Objekt anhängen, wenn Sie die Cloud Trace API v1 patchTraces verwenden.

Diese Annotationen werden als Labels angezeigt, wenn Sie die Details zu einem Trace ansehen. Weitere Informationen zu Labels finden Sie unter Trace-Labels.

Annotationen mit Attributen versehen

Sie können Spans annotieren, indem Sie ein attributes-Objekt erstellen und an das SpanObjekt anhängen, wenn Sie die Cloud Trace API v2 batchWrite verwenden.

Diese Annotationen werden als Labels angezeigt, wenn Sie die Details zu einem Trace ansehen. Weitere Informationen finden Sie unter Trace-Details ansehen auf dieser Seite.

Annotationen mit Zeitereignissen

Sie können Annotationen und Nachrichtenereignisse zu Spans hinzufügen, indem Sie ein TimeEvents-Objekt erstellen und an das Span-Objekt anhängen, wenn Sie die Cloud Trace API v2 batchWrite verwenden.

Das TimeEvents-Objekt ist ein Array von TimeEvent-Objekten, die jeweils ein Nachrichtenereignis und eine Annotation enthalten.

Wenn Sie TimeEvents für einen Trace aufrufen möchten, klicken Sie in der Wasserfallgrafik der Traces auf Ereignisse anzeigen. Bei Auswahl von TimeEvent werden die Details im Detailbereich angezeigt.

Nächste Schritte