Integration in Cloud Logging

Sie können Ihren Traces Annotationen hinzufügen, mit denen Sie einen Trace mit einem Cloud Logging-Objekt LogEntry verknüpfen können. Weitere Informationen zu Annotationen finden Sie unter Spans mit Annotationen versehen.

Einen Trace mit einem Logeintrag verknüpfen

Wenn Sie die Trace-Clientbibliotheken oder die OpenCensus-Bibliothek für Python oder Java verwenden, können Sie einen Trace mit einem Logeintrag verknüpfen, indem Sie das trace-Feld im LogEntry-Objekt festlegen.

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.

Sie können einen Span mit einem Logeintrag verknüpfen, indem Sie das Feld spanId im LogEntry-Objekt festlegen. Legen Sie in diesem Fall für das Feld spanId die 16-stellige hexadezimale Codierung der Span-ID fest. Ein Span mit der ID 74 wird beispielsweise als 000000000000004a dargestellt. Wenn Sie Trace Sampling verwenden, legen Sie das Feld traceSampled im Objekt LogEntry fest, um anzugeben, dass der Trace beim Speichern des Logeintrags als Stichprobe dient. Es ist möglich, dass ein Logeintrag erstellt wird, 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 Log-Explorer neben dem Label Log im Abschnitt Details auf Anzeigen, um den Logeintrag aufzurufen. Wenn Sie einen Cloud Load Balancing-Trace haben, klicken Sie neben dem Label VM-Log auf Ansehen.

Weitere Informationen zum Anzeigen von Logeinträgen in Cloud Logging finden Sie unter Logs ansehen.

Berechtigungen zur Loganzeige

Zum Anzeigen von Logeinträgen ist die Berechtigung logging.logEntries.list in Ihrem Projekt erforderlich. Diese Berechtigung wird von den Rollen Logbetrachter und Projektbetrachter Identity and Access Management (IAM) erteilt.

Zum Anzeigen des VM-Instanz-Logs ist die Berechtigung compute.instances.get in Ihrem Projekt erforderlich. Diese Berechtigung wird von den IAM-Rollen Compute Engine-Netzwerkbetrachter und Projektbetrachter gewährt.