Logeinträge korrelieren

In diesem Dokument wird beschrieben, wie Sie Logeinträge in hierarchischen Gruppen zusammenfassen und ansehen. mithilfe des Log-Explorers. Normalerweise wird beim Schreiben von Logeinträgen in Cloud Logging wird jeder Logeintrag separat und nicht korreliert. 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 einen übergeordneten Logeintrag mit mehreren untergeordnete Logeinträge im Log-Explorer.

Korrelierte Logeinträge einrichten

Zum Einrichten korrelierter Logeinträge können Sie das Feld trace manuell ausfüllen. Alternativ können Sie Ihre Anwendung so instrumentieren, dass Traces an Cloud Trace gesendet werden, mithilfe von Google-Clientbibliotheken. Die folgenden Konfigurationen werden automatisch erfassen Sie die Trace-Daten:

  • App Engine-Standardumgebung

  • Cloud Run-Funktionen 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 auf einen String mit folgendem Format festgelegt ist:

       projects/PROJECT_ID/traces/TRACE_ID

    Dabei ist PROJECT_ID Ihre Google Cloud-Projekt-ID 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, die Werte der logName-Felder müssen unterschiedlich sein.

Korrelierte Logeinträge im Log-Explorer abfragen

Um die untergeordneten Logeinträge anzuzeigen, die mit einem übergeordneten Maximieren Sie den Logeintrag, wenn Sie ihn im Log-Explorer ansehen.

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 aus, dessen Zwischenüberschrift Monitoring ist.

  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.

    Anwendungslogeinträge, die mit dem Anfragelogeintrag korrelieren, sind im Anfragelogeintrag verschachtelt:

    Die Einträge des Anwendungslogs sind im Anfragelogeintrag verschachtelt.

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

Korrelierte Logeinträge suchen

Mit der Korrelationssuche können Sie sowohl übergeordnete als auch untergeordnete Logeinträge mit einer Abfrage durchsuchen. Das Ergebnis der Suche ist eine Liste übergeordneter Logeinträge, die mit der Abfrage in über- oder untergeordnete Logeinträge. Wenn Sie beispielsweise sowohl in untergeordneten als auch in übergeordneten Logeinträgen nach dem String „App-Lognachricht“ 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 aus, dessen Zwischenüberschrift Monitoring ist.

  2. "app log message eingeben in das Suchfeld und klicken Sie auf Abfrage ausführen. Untergeordnete Logeinträge, die „App-Lognachricht“ enthalten sind in der Abfrage Ergebnisse angezeigt.

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

  4. Im Bereich Abfrageergebnisse sind 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 aufrufen möchten, maximieren Sie den übergeordneten Logeintrag. Klicken Sie dazu auf  Maximieren.

    Anwendungslogeinträge sind im Anfragelogeintrag verschachtelt.

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

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

Nächste Schritte