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.