In diesem Dokument wird beschrieben, wie Sie einen Trace mit einem Cloud Logging-LogEntry
verknüpfen.
Logeintrag mit einem Trace oder Span verknüpfen
Wenn Sie die Cloud Logging API zum Schreiben von Logdaten verwenden oder strukturierte Logdaten schreiben, können Sie einen Logeintrag mit einem Trace oder einem Span verknüpfen. Im Logeintrag kann auch aufgezeichnet werden, ob für das Trace eine Stichprobe erstellt wurde. Informationen dazu, wie der Ops-Agent strukturierte Logdaten in Felder in einem LogEntry
konvertiert, finden Sie unter Spezielle Felder in strukturierten Nutzlasten.
Zum Verknüpfen eines Logeintrags mit einem Trace legen Sie das Feld trace
im Objekt LogEntry
fest.
Das Feld trace
muss auf einen String im folgenden Format festgelegt werden:
projects/PROJECT_ID/traces/TRACE_ID
Dabei ist PROJECT_ID
Ihre Google Cloud-Projekt-ID und TRACE_ID
die Trace-ID.
Wenn Sie bei Verwendung der Cloud Logging API einen Logeintrag mit einem Span verknüpfen möchten, legen Sie für das Feld spanId
im Objekt LogEntry
die aus 16 Zeichen bestehende hexadezimale Codierung der Span-ID fest.
Wenn Sie beispielsweise einen Logeintrag mit einem Span mit der ID 74
verknüpfen möchten, legen Sie die Span-ID auf 000000000000004a
fest.
Legen Sie das Feld traceSampled
im Objekt LogEntry
fest, um anzugeben, dass Sie Trace Sampling verwenden und dass das Trace zum Speichern zur Speicherung erfasst wurde, als der Logeintrag geschrieben wurde. Wenn Sie Trace Sampling verwenden, wird möglicherweise ein Logeintrag erstellt, wenn der Trace selbst nicht erfasst wird.
Logs ansehen
Den Logeintrag für einen Trace können Sie neben der Wasserfallgrafik oder in der Loganzeige ansehen. Wenn Sie die Loganzeige verwenden, wird sie automatisch auf den Zeitstempelbereich des Trace beschränkt. Wenn keine Logeinträge vorhanden sind, wird der Loganzeige die Nachricht No entries found matching current filter
angezeigt.
Führen Sie im Bereich Trace-Details einen der folgenden Schritte aus, um sich den Logeintrag für den Trace anzusehen:
Klicken Sie in der Wasserfallgrafik auf Logs anzeigen, um die Trace-Logeinträge neben der Wasserfallgrafik anzuzeigen. Wenn Logs anzeigen nicht angezeigt wird, sind keine Logeinträge verfügbar.
Klicken Sie im Bereich Details neben dem Label Log auf Anzeigen, um den Logeintrag in der Loganzeige anzuzeigen. Beachten Sie, dass Sie bei einem Cloud Load Balancing-Trace neben dem Label VM-Log auf Ansicht klicken müssen.
Weitere Informationen zum Ansehen von Logeinträgen in Cloud Logging finden Sie unter Log-Explorer verwenden.
Berechtigungen zur Loganzeige
Zum Anzeigen von Logeinträgen ist die Berechtigung logging.logEntries.list
in Ihrem Projekt erforderlich. Diese Berechtigung wird durch die IAM-Rollen Logbetrachter und Projektbetrachter erteilt.
Zum Anzeigen des VM-Instanz-Logs ist die Berechtigung compute.instances.get
in Ihrem Projekt erforderlich. Diese Berechtigung wird durch die IAM-Rollen Compute Engine-Netzwerkbetrachter und Projektbetrachter erteilt.