Logeinträge korrelieren

In diesem Dokument wird beschrieben, wie Sie Logeinträge im Log-Explorer im Format „Übergeordnet-Untergeordnet“ gruppieren und ansehen. Normalerweise werden Logeinträge, die Sie in Cloud Logging schreiben, separat und ohne Korrelation angezeigt. Sie können Ihre Logeinträge jedoch mithilfe des Felds trace im LogEntry-Objekt 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

Um korrelierte Logeinträge einzurichten, können Sie das Feld trace manuell ausfüllen oder Ihre Anwendung instrumentieren, um Traces mithilfe von Google-Clientbibliotheken an Cloud Trace zu senden. Bei den folgenden Konfigurationen werden Ihre Trace-Daten automatisch erfasst:

  • App Engine-Standardumgebung

  • Cloud Run Functions und Cloud Run

Informationen zur Instrumentierung Ihrer Anwendung zum Erfassen von Trace-Daten finden Sie unter Übersicht zur 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 wird auf einen String im folgenden Format festgelegt:

       projects/PROJECT_ID/traces/TRACE_ID

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

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

  • Jeder Logeintrag gehört zu einem eindeutigen Log. Das heißt, die Werte der Felder logName müssen sich unterscheiden.

Korrelierte Logeinträge im Log-Explorer abfragen

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

So können Sie beispielsweise Ihren App Engine-Anfragelogeintrag und die Anwendungslogeinträge aufrufen:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf:

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

  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 auf  Maximieren, um einen Logeintrag zu maximieren.

    Anfragelogeinträge, die mit Anwendungslogeinträgen korreliert sind, sind im Anfragelogeintrag verschachtelt:

    Die Einträge des Anwendungslogs sind im Anfragelogeintrag verschachtelt.

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

Nach korrelierten Logeinträgen 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 von übergeordneten Logeinträgen, die der Abfrage in den übergeordneten oder untergeordneten Logeinträgen entsprechen. Wenn Sie beispielsweise sowohl in den untergeordneten als auch in den übergeordneten Logeinträgen nach dem String „app log message“ suchen möchten, gehen Sie so vor:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf:

    Zum Log-Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

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

  3. Klicken Sie im Bereich Abfrageergebnisse auf Korrelieren nach und wählen Sie ein übergeordnetes Log aus. Wenn Sie App Engine-Anfragelogs aufrufen möchten, wählen Sie request_log aus und klicken Sie auf Übernehmen.

  4. Im Bereich Abfrageergebnisse werden alle übergeordneten Logeinträge aufgeführt, die den String "app log message" enthalten oder ein untergeordnetes Element haben, das den String enthält.

    Wenn Sie verschachtelte untergeordnete Logeinträge ansehen möchten, klicken Sie auf  Maximieren, um den übergeordneten Logeintrag zu maximieren.

    Die Einträge des Anwendungslogs sind im Anfragelogeintrag verschachtelt.

    Im vorherigen Screenshot hat der übergeordnete Logeintrag 10 untergeordnete Logeinträge, die den String „app log message“ enthalten. Sie können diese untergeordneten Logeinträge maximieren, um die zugehörigen Details aufzurufen.

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

Nächste Schritte