ログエントリを関連付ける

このドキュメントでは、ログ エクスプローラを使用して「親子」形式のログエントリをグループ化して表示する方法について説明します。通常、ログエントリを Cloud Logging に書き込むと、各ログエントリは個別に表示され、相関関係はありません。ただし、LogEntry オブジェクトの trace フィールドを使用して、ログエントリをグループ化または関連付けることができます。

ログエントリを関連付けると、ログ エクスプローラで複数の子ログエントリを持つ親ログエントリを表示できます。

相関ログエントリを設定する

相関ログエントリを設定するには、trace フィールドに値を手動で入力するか、Google クライアント ライブラリを使用してトレースを Cloud Trace に送信するようにアプリケーションをインストルメント化します。次の設定は、トレースデータを自動的にキャプチャします。

  • App Engine スタンダード環境

  • Cloud Functions と Cloud Run

トレースデータを収集するようにアプリケーションをインストルメント化する方法については、Cloud Trace のインストルメント化の概要をご覧ください。

ログ エクスプローラがログエントリのコレクションを関連付けるには、ログエントリが次の要件を満たしている必要があります。

  • LogEntry オブジェクトの trace フィールドが、次の形式の文字列に設定されている。

       projects/PROJECT_ID/traces/TRACE_ID

    ここで、PROJECT_ID は Google Cloud プロジェクト ID、TRACE_ID はトレース ID です。

  • ログエントリの trace フィールドが同じ。

  • 各ログエントリは一意のログに属します。つまり、logName フィールドの値は異なる必要があります。

ログ エクスプローラのログエントリを表示する

ログ エクスプローラで表示している親ログエントリに関連付けられた子ログエントリを表示するには、そのログエントリを開きます。

たとえば、App Engine リクエストのログエントリとアプリケーション ログエントリを表示するには、次のようにします。

  1. Google Cloud コンソールのナビゲーション パネルで、[ロギング] を選択してから、[ログ エクスプローラ] を選択します。

    [ログ エクスプローラ] に移動

  2. [リソース] プルダウン メニューで [GAE アプリケーション] を選択します。

  3. [ログ名] プルダウン メニューで [request_log] を選択します。

  4. [クエリ結果] ペインで、ログエントリを開くには、 [開く] をクリックします。

    リクエストログのエントリに関連付けられたアプリケーション ログエントリは、リクエスト ログエントリにネストされています。

    アプリケーションのログエントリが、リクエスト ログエントリにネストされています。

    上のスクリーンショットでは、親ログエントリに 10 個の子ログエントリがあります。 子ログエントリを展開して詳細を表示できます。

関連するログエントリを検索する

相関検索では、クエリを使用して親ログエントリと子ログエントリの両方を検索できます。検索の結果は、親ログエントリまたは子ログエントリのクエリに一致する親ログエントリのリストになります。たとえば、子ログエントリと親ログエントリの両方で文字列「app log message」を検索するには、次のようにします。

  1. Google Cloud コンソールのナビゲーション パネルで、[ロギング] を選択してから、[ログ エクスプローラ] を選択します。

    [ログ エクスプローラ] に移動

  2. 検索フィールドに「"app log message」と入力し、[クエリを実行] をクリックします。 [クエリ結果] ペインに「アプリログ メッセージ」を含む子ログエントリが表示されます。

  3. [クエリ結果] ペインで、[相関] をクリックし、親ログを選択します。App Engine のリクエストログを表示するには、[request_log] を選択して [適用] をクリックします。

  4. [クエリ結果] ペインに、文字列 "app log message" を含むか、文字列を含む子を持つ、すべての親ログエントリが一覧表示されます。

    ネストされた子ログエントリを表示するには、親ログエントリを開いて [ 展開] をクリックします。

    アプリケーションのログエントリが、リクエスト ログエントリにネストされています。

    上のスクリーンショットでは、親ログエントリに「app log message」という文字列を含む子ログエントリが 10 個あります。これらの子ログエントリを展開して詳細を表示できます。

    親ログを選択しても、[クエリ結果] ペインにログエントリが表示されない場合は、クエリに一致する相関する親エントリと子エントリが存在しません。

次のステップ