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 im 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 LogEntry-Objekt fest, um anzugeben, dass der Trace beim Schreiben des Logeintrags erfasst wurde. 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 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 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 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.