Logeinträge korrelieren

In diesem Dokument wird beschrieben, wie Sie Logeinträge mit dem Log-Explorer in einem hierarchischen Format gruppieren und ansehen können. Wenn Sie Logeinträge in Cloud Logging schreiben, wird jeder Logeintrag normalerweise separat und nicht korreliert angezeigt. Mithilfe des Felds trace im Protokollobjekt können Sie Ihre Logeinträge jedoch gruppieren oder korrelieren.

Wenn Sie Logeinträge korrelieren, können Sie im Log-Explorer einen übergeordneten Logeintrag mit mehreren untergeordneten Logeinträgen aufrufen.

Korrelierte Logeinträge einrichten

Zum Einrichten korrelierter Logeinträge können Sie das Feld trace manuell ausfüllen oder Ihre Anwendung so einrichten, dass mithilfe von Google-Clientbibliotheken Traces an Cloud Trace gesendet werden. Mit den folgenden Konfigurationen werden Ihre Trace-Daten automatisch erfasst:

  • App Engine-Standardumgebung

  • Cloud Functions und Cloud Run

Informationen zur Instrumentierung Ihrer Anwendung zum Erfassen von Trace-Daten finden Sie unter Übersicht über die Instrumentierung für Cloud Trace.

Damit der Log-Explorer eine Sammlung von Logeinträgen korrelieren kann, müssen die Logeinträge die folgenden Anforderungen erfüllen:

  • Das Feld trace im LogEntry-Objekt ist auf einen String mit dem folgenden Format festgelegt:

       projects/PROJECT_ID/traces/TRACE_ID

    Dabei ist PROJECT_ID die ID Ihres Google Cloud-Projekts und TRACE_ID die Trace-ID.

  • Die trace-Felder in den Logeinträgen sind identisch.

  • Jeder Logeintrag gehört zu einem eindeutigen Log. Das heißt, der Wert der logName-Felder muss unterschiedlich sein.

Korrelierte Logeinträge im Log-Explorer ansehen

Wenn Sie die untergeordneten Logeinträge aufrufen möchten, die mit einem übergeordneten Logeintrag korrelieren, den Sie im Log-Explorer aufrufen, maximieren Sie den Logeintrag.

So rufen Sie beispielsweise den App Engine-Anfrage- und Anwendungs-Logeintrag auf:

  1. Wählen Sie im Navigationsbereich der Google Cloud Console Logging und anschließend Log-Explorer aus:

    Zum Log-Explorer

  2. Wählen Sie im Drop-down-Menü Ressource die Option GAE-Anwendung aus.

  3. Wählen Sie im Drop-down-Menü Logname die Option request_log aus.

  4. Klicken Sie im Bereich Abfrageergebnisse zum Maximieren eines Logeintrags auf Maximieren.

    Mit dem Anfragelogeintrag korrelierte Anwendungslogeinträge sind im Anfragelogeintrag verschachtelt:

    Anwendungslogeinträge sind im Anfragelogeintrag verschachtelt.

    Im Screenshot oben hat der übergeordnete Logeintrag zehn untergeordnete Logeinträge. Sie können diese untergeordneten Logeinträge maximieren, um die zugehörigen Details anzusehen.

Korrelierte Logeinträge suchen

Mit der korrelierten Suche können Sie sowohl übergeordnete als auch untergeordnete Logeinträge mit einer Abfrage durchsuchen. Das Ergebnis der Suche ist eine Liste der übergeordneten Logeinträge, die mit der Abfrage in den übergeordneten oder untergeordneten Logeinträgen übereinstimmen. So suchen Sie beispielsweise in den untergeordneten und übergeordneten Logeinträgen nach dem String „Anwendungsprotokollnachricht“:

  1. Wählen Sie im Navigationsbereich der Google Cloud Console Logging und anschließend Log-Explorer aus:

    Zum Log-Explorer

  2. Geben Sie "app log message" in das Suchfeld ein und klicken Sie auf Abfrage ausführen. Untergeordnete Logeinträge, die „Anwendungsprotokollnachricht“ enthalten, werden im Bereich Abfrageergebnisse aufgelistet.

  3. Klicken Sie im Bereich Abfrageergebnisse auf Korrelieren nach und wählen Sie ein übergeordnetes Log aus. Wählen Sie request_log aus und klicken Sie auf Anwenden, um App Engine-Anfragelogs anzusehen.

  4. Im Bereich Abfrageergebnisse werden alle übergeordneten Logeinträge aufgelistet, die den String "app log message" oder ein untergeordnetes Element mit dem String enthalten.

    Zum Aufrufen verschachtelter untergeordneter Logeinträge klicken Sie zum Maximieren des übergeordneten Logeintrags auf Maximieren.

    Anwendungslogeinträge sind im Anfragelogeintrag verschachtelt.

    Im vorherigen Screenshot hat der übergeordnete Logeintrag zehn untergeordnete Logeinträge, die den String „Anwendungsprotokollnachricht“ enthalten. Sie können diese untergeordneten Logeinträge maximieren, um die zugehörigen Details anzusehen.

    Wenn Sie ein übergeordnetes Log ausgewählt haben und im Bereich Abfrageergebnisse keine Logeinträge angezeigt werden, sind keine korrelierten übergeordneten und untergeordneten Einträge vorhanden, die Ihrer Abfrage entsprechen.

Nächste Schritte