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 annotieren.

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 span_id im LogEntry-Objekt festlegen. Legen Sie in diesem Fall das Feld span_id auf die aus 16 Zeichen bestehende hexadezimale Codierung der Span-ID fest. Ein Span mit der ID 74 wird beispielsweise als 000000000000004a dargestellt. Wenn Sie das Trace-Sampling verwenden, legen Sie im Feld trace_sampled im LogEntry-Objekt fest, dass der Trace beim Schreiben des Logeintrags zur Speicherung als Stichprobe verwendet wurde. Es ist möglich, dass ein Logeintrag erstellt wird, wenn der Trace selbst nicht erfasst wird.

Logs ansehen

Sie können den Logeintrag für einen Trace neben der Wasserfallgrafik oder in der Loganzeige aufrufen. Wenn Sie die Loganzeige verwenden, ist sie automatisch auf den Zeitstempelbereich des Trace beschränkt. Wenn keine Logeinträge angezeigt werden, wird in der Loganzeige die Meldung No entries found matching current filter angezeigt.

Führen Sie im Bereich Trace-Details einen der folgenden Schritte aus, um den Logeintrag für den Trace anzuzeigen:

  • Wenn Sie die Trace-Logeinträge neben der Wasserfallgrafik anzeigen möchten, klicken Sie in der Wasserfallgrafik auf Logs anzeigen. Wenn Logs anzeigen nicht angezeigt wird, sind keine Logeinträge verfügbar.

  • Klicken Sie zum Anzeigen des Logeintrags in der Loganzeige im Abschnitt Details neben dem Label Log auf Anzeigen. Beachten Sie, dass Sie bei einem Cloud Load Balancing-Trace neben dem Label VM Log auf Ansicht klicken.

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

Berechtigungen zur Loganzeige

Zum Anzeigen von Logeinträgen benötigen Sie die Berechtigung logging.logEntries.list in Ihrem Projekt. Diese Berechtigung wird von den Cloud 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 von den Cloud IAM-Rollen Compute Engine-Netzwerkbetrachter und Projektbetrachter erteilt.