ログ エクスプローラを使用してログを表示する

このドキュメントでは、Google Cloud コンソールのログ エクスプローラの概要について説明します。これは、ログデータの取得、表示、分析に使用できます。ログ エクスプローラを使用すると、ログを検索して表示し、問題のトラブルシューティングを行えます。

ログ エクスプローラでは、集約オペレーション(特定のパターンを含むログエントリの数をカウントするなど)がサポートされていません。集約オペレーションを実行するには、ログバケットで分析を有効にしてから、[ログ分析] ページを使用します。ログ エクスプローラを使用して、分析が有効になっているバケットでログを表示することもできます。さらに詳しいことついては、ログ分析の概要をご覧ください。

Logging APIGoogle Cloud CLI を使用して、ログを読み取ることもできます。

始める

ログ エクスプローラの使用を開始するには、次のようにします。

  1. ログ エクスプローラでログを表示するために必要なロールがあることを確認します。

    • _Required バケット内のすべてのログを表示し、_Default バケットの _Default ビューでログを表示するには、ログ閲覧者(roles/logging.viewer)のロールが必要です。
    • データアクセス ログを含め、_Required バケットと _Default バケット内のすべてのログを表示するには、プライベート ログ閲覧者(roles/logging.privateLogViewer)のロールが必要です。

    • ユーザー定義のログバケットでログビューに保存されているログを表示するには、ログビューへのアクセス権を付与する条件でログ表示アクセス者(roles/logging.viewAccessor)のロールが必要です。ログビュー アクセサーのロールが条件なしで接続されている場合は、ユーザー定義のログバケットで任意のログビューに保存されているログを表示できます。例については、バケットからのログの読み取りをご覧ください。

    • バケット内の制限付き LogEntry フィールドを表示するには、ログフィールド アクセス者(roles/logging.fieldAccessor)のロールが必要です。詳細については、フィールド レベルのアクセスを構成するをご覧ください。

  2. Google Cloud コンソールでナビゲーション メニューから [ログ] を選択し、[ログ エクスプローラ] をクリックします。
    ログ エクスプローラに移動

  3. 適切な Google Cloud プロジェクトを選択します。

    Amazon Web Services Elastic Compute Cloud(AWS EC2)を使用する場合、ログエントリは AWS アカウントを Google Cloud サービスにリンクする AWS コネクタ プロジェクトにあります。

ログ エクスプローラのインターフェース

ログ エクスプローラのインターフェースを使用すると、ログの取得、ログデータの解析と分析、クエリ パラメータの絞り込みができます。

ログ エクスプローラのユーザー インターフェース

ログ エクスプローラには次のセクションがあります。このページで詳しく説明します。

  1. [アクション] ツールバー
  2. クエリペイン
  3. [結果] ツールバー
  4. ログフィールド] ペイン
  5. ヒストグラム
  6. [クエリ結果] ペイン

[アクション] ツールバー

[アクション] ツールバー機能を使用すると、次のことができます。

  • 範囲を絞り込む: 現在の Google Cloud プロジェクトのログのみ、または 1 つ以上のストレージ ビューで、検索の範囲を絞り込むことができます。範囲指定の詳細については、範囲の調整をご覧ください。
  • 学習: 関連ドキュメントやトピックへのリンクが表示されます。
  • 共有リンク: 現在のクエリの短縮 URL を作成し、クリップボードにコピーします。これにより、クエリの共有が簡単になります。コピーした URL には、クエリの現在の時間範囲で表される対応する絶対時間範囲が設定されます。例: 7:49:37 PM - 8:49:37 PM

範囲を絞り込む

ログがログバケットに保存されている場合は、ログ エクスプローラでログを表示できます。選択したプロジェクトによっては、ログ エクスプローラの範囲を調整して、特定のログバケットに保存されているログを表示しなければならない場合があります。デフォルトでは、ログ エクスプローラには、プロジェクトで生成された、またはプロジェクトに直接ルーティングされたログが表示されますが、プロジェクト内のログバケットに転送されたログは表示されません。

たとえば、Project-A という名前の Google Cloud プロジェクトがログを生成し、Project-B という名前のプロジェクトにそれらのログをルーティングするとします。Project-B のログ エクスプローラにどのログが表示されるかを説明するシナリオについては、次の表をご覧ください。

シナリオ ログシンクのエクスポート先
Project-B のログ エクスプローラのデフォルト ビューにログは表示されますか?

Project-B のログ エクスプローラ
のログバケット ビューにログは表示されますか?
シナリオ 1 Project-A のログバケット いいえ いいえ
シナリオ 2 Project-B のログバケット いいえ
シナリオ 3 プロジェクト B はい はい

ログ エクスプローラに表示するログをカスタマイズするには、[アクション] ツールバーの [範囲を絞り込む] ボタンを使用します。

  • プロジェクトで絞り込む(デフォルト): 現在のプロジェクトで生成されたログ、または現在のプロジェクトに直接ルーティングされたログを表示するには、[プロジェクトで絞り込む] を選択します。

  • ストレージによるスコープ: 現在のプロジェクトに属するログバケットのログを表示する、または現在のプロジェクトがルーティングしたログバケットのログを表示するには、次を選択します。ストレージ スコープ。ダイアログでは、ログを表示するバケットでログビューを選択できます。ログビューの詳細については、バケットレベルのアクセスの構成をご覧ください。

クエリペイン

[クエリ] ペイン機能を使用して、次の操作を行います。

  • [クエリ] タブ: 次の機能を使用してクエリを作成、絞り込みます。

    • 期間セレクタ: 表示するログの期間を指定します。詳しくは、期間セレクタを使用するをご覧ください。

    • 検索テキスト ボックス: 検索キーワードやフレーズに一致するログエントリを検索します。詳細については、複数のログフィールドを検索するをご覧ください。

    • フィルタ メニュー: リソースログ名重大度に基づいてクエリを作成します。詳細については、フィルタ メニューの使用をご覧ください。

    • クエリエディタ フィールド: Logging のクエリ言語を使用して高度なクエリを作成します。詳細については、高度なクエリの作成をご覧ください。

  • [最近] タブ: 最近実行したクエリが表示されます。詳細については、最近のクエリを使用するをご覧ください。

  • 保存済み: 保存済みのクエリと、Google Cloud プロジェクトの他のユーザーから共有されているクエリを表示できます。詳細については、クエリを保存するクエリを共有するをご覧ください。

  • [推奨] タブ: Google Cloud プロジェクトのリソースに基づいて候補のクエリを表示します。詳細については、候補のクエリを使用するをご覧ください。

  • [ライブラリ] タブ: ユースケースに基づいて、Google 提供のクエリを表示して実行します。詳細については、ライブラリからクエリを選択するをご覧ください。

  • 保存: [保存済み] タブで表示、実行できるクエリを保存します。

  • クエリをクリア: [クエリ] ペインでクエリの作成時に行った選択をクリアしてリセットします。

  • ログのストリーミング: Logging がログエントリを取り込む際に、ログエントリを表示できます。詳細については、ログをストリームをご覧ください。

  • クエリの実行: [クエリ] ペインで作成したクエリを実行します。

クエリエディタ フィールドが表示されない場合は、[クエリを表示] を有効にします。検索テキスト ボックスに検索キーワードを追加すると、クエリエディタ フィールドにも表示され、クエリ式の一部として評価されます。

クエリを確認したら、[クエリを実行] をクリックします。クエリに一致するログが [クエリ結果] ペインの下に表示されます。[ヒストグラム] ペインと [ログフィールド] ペインもクエリ式に従って調整されます。

ログをストリーム

ロギングがログを取り込む際に、ログをストリーミングできます。また、クエリを追加して、クエリに一致するログのみをストリーミングすることもできます。

クエリに基づいてログをストリーミングするには、[クエリ] ペインにクエリを追加して、[ログをストリーミングする] を選択します。Logging がログデータを取り込むと、[クエリ結果] ペインにクエリに一致するログのみが表示されます。クエリが指定されない場合、Logging は各ログが取り込まれると表示します。

ストリーミングを停止するには、[ストリーミングを停止する] をクリックするか、[クエリ結果] ペインでスクロールします。

結果ツールバー

結果ツールバーでは次の操作ができます。

  • [ログフィールド] ペインを表示: このペインは、[ログ エクスプローラ] ページ レイアウトから簡単に表示または非表示にできます。
  • [ヒストグラム] ペインの表示: このペインは、[ログ エクスプローラ] ページ レイアウトから簡単に表示または非表示にできます。
  • 指標を作成する: 現在のクエリ式に基づいてログベースの指標を設定します。
  • アラートを作成する: 現在のクエリ式に基づいてログベースのアラートを設定します。
  • 現在に移動: クエリ結果を強制的に更新して、現在の時刻を含めます。期間セレクタでカスタム範囲を使用し、終了時刻が設定されている場合、クエリはデフォルトの期間である 1 時間で実行されます。それ以外の場合は、現在の開始日または期間で更新され、クエリが実行されます。なお、この機能を使用しても、クエリ式は変更されません。
  • その他の操作: その他のオプションを使用して管理ログベースのアラートまたはシンクの作成を行います。

[ログフィールド] ペイン

[ログフィールド] ペインにはログデータの概要が表示され、クエリをより効率的に絞り込むことができます。ログエントリは、これらのエントリのフィールドに対応する、さまざまな項目で分類されて表示されます。[ログフィールド] ペインには、フィールドごとに値とインシデントが頻度による降順で表示されます。ログフィールドの数は、期間セレクタ内の期間に対応しています。

[ログ フィールド] ペインを表示または非表示にするには、[結果] ツールバーの [ログ フィールド] ボタンをクリックします。

[ログフィールド] ペインは、[クエリビルダー] で実行されたクエリに基づいて入力および更新されます。

空のクエリがある場合、[ログフィールド] ペインにリソースタイプ フィールド別および重大度フィールド別のログエントリの数が表示されます。

[ログフィールド] ペイン。

[ストレージにごとのスコープ] を選択すると、プロジェクト ID と、対応するログエントリの数も確認できます。

[ログフィールド] ペインでリソースタイプを選択すると、ペインの関連する一連のフィールドにリソースラベルに基づいて値が入力されます。これにより、この特定のリソースタイプのログデータを調べることができます。削除する場合は、[リソースタイプ] フィールドの横にある [クリア] をクリックします。

[ログフィールド] ペインにフィールドを追加します

特定の LogEntry Key-Value ペアを、[クエリ結果] ペインに入力されるログエントリの [ログフィールド] ペインに追加できます。フィールドを [ログフィールド] ペインに追加するには、次の操作を行います。

  1. [クエリ結果] ペインで、展開ボタン をクリックしてログエントリを展開します。

  2. フィールドの値をクリックします。メニューから [ログフィールド ペインにフィールドを追加] を選択します。

    このカスタム フィールドは、[ログフィールド] ペインに Key-Value ペアのリストとして表示されます。

[ログフィールド] ペインからカスタム フィールドを削除するには、フィールドの横にある [削除] をクリックします。

なお、次のタイプのフィールドは、[ログフィールド] ペインに追加できません。

  • 時間に関連するフィールド(例: receiveTimestampprotoPayload.startTime)。
  • カーディナリティが高いフィールド(例: insertIdprotoPayload.latency)。
  • パスの配列インデックスが含まれるフィールド(例: protoPayload.authorizationInfo[0].resource)。

[ログフィールド] ペインを使用したログの分析

クエリを絞り込むには、[ログのフィールド] ペインから [クエリ] ペインにフィールドと値のペアを追加します。これを行うには、[ログのフィールド] ペインでフィールドの値をクリックします。これにより、AND 演算子を使用して、式にフィールドと値のペアが追加されます。そうしてクエリが動作します。

[ログフィールド] ペインには、ネストされたフィールドと値のペアと、最上位のフィールドと値のペアを追加できます。たとえば、[ログフィールド] ペインに jsonPayload.message を追加したとします。特定の jsonPayload.message 値を選択すると、[Query Editor] にその値が入力されます。

また、[ヒストグラム] ペインと [クエリ結果] ペインも現在のクエリを反映するように変更されます。

クエリが実行されると、ログエントリがスキャンされ、ログフィールドの数が変化します。クエリが完了すると、すべてのログフィールドの合計数が表示されます。

ヒストグラム

[ヒストグラム] ペインでは、時間の経過に伴うログの分布を可視化できます。クエリを実行するとヒストグラムが再生成されるため、ログデータの傾向を確認し、問題のトラブルシューティングを簡単に行うことができます。

[ヒストグラム] ペインを表示または非表示にするには、[結果] ツールバーの [ヒストグラム] ボタンをクリックします。

ヒストグラムの機能

[ヒストグラム] ペイン。

  1. ヒストグラム バー: 各ヒストグラム バーは、期間を表します。各バーでは、各バーの期間で取得されたログの重大度の分類が 3 色で表示されます。この色は、次のログ重大度を表します。

    • 青(重大度低): デフォルトデバッグ情報通知
    • 黄(重大度中): 警告
    • 赤(重大度高): エラー重大アラート緊急

    各ヒストグラム バーには、ログを分析するためのオプションのメニューがあります。

  2. 時間コントロール: [クエリ結果] ペインに表示されるログの期間を調整できます。これらのオプションの詳細については、時間コントロールを使用してログを分析するをご覧ください。

  3. タイムライン: [クエリ結果] ペインに現在表示されている、ログの期間をヒストグラム バーで表示します。このタイムラインにより、クエリのより長い期間内で、現在表示されているログの位置がわかります。

時間コントロールを使用してログを分析する

ログデータの調査と分析に、ヒストグラムの時間コントロールを使用できます。

時間をすばやく調整する

ヒストグラムには、ログ エクスプローラに表示されるデータをすばやく調整できる時間コントロールがあります。

ヒストグラム ペイン タイムラインで、クイック時間コントロールが表示されます。

  • 時間ハンドル: タイムラインのハンドルを内側にドラッグすると、データが絞り込まれます。また、ヒストグラムのタイムラインでデータを拡大するには、外側にドラッグします。[実行] をクリックします。

  • タイムラインを前後にスライドする: の矢印をクリックして、タイムラインを後にスライドします。 の矢印をクリックして、タイムラインを前の位置にスライドします。

  • ズームインとズームアウト: ズームアウト アイコンをクリックすると、タイムラインに表示されるデータを拡大できます。 ズームイン アイコンをクリックすると、タイムラインに表示されるデータを絞り込めます。

タイムラインを変更できるのは、現在(「現在の時刻」)から 30 日前までの期間までです。

時間のスクロールまたはズーム

上記の時間コントロールに加えて、ヒストグラムには Scroll to time および Zoom to time 機能があり、ログ エクスプローラの他のペインに表示されるヒストグラムとデータをより詳細に制御できます。

ヒストグラムペインのタイムラインには、時間へのスクロールと時間へのズームのコントロールが表示されています。

おそらく、その相対的なサイズまたは重大度レベルに基づいて、特定のヒストグラム バーに興味を持たれるでしょう。そのヒストグラム バーを選択し、ログ エクスプローラに表示されるログデータを調整できます。

[時間までスクロール] 機能を使用すると、[ヒストグラム] ペインや [ログ フィールド] ペインの値を変更せずに、ログデータを参照できます。[時間までスクロール] 機能を選択すると、次のようになります。

  • [クエリ結果] ペインに表示されるログデータは、選択したヒストグラム バーで取得された期間に応じて調整されます。

    クエリは実行されませんが、選択したヒストグラム バーの期間に対応するログをクエリ結果ペインに表示できるようにするため、データが部分的に再読み込みされることがあります。

  • コンソール URL が更新され、選択したヒストグラム バーの期間で取得された最新のログの timestamp が含まれます。

[時間に合わせてスクロール] 機能を選択するには、次の手順を行います。

  1. ヒストグラムのバーにカーソルを合わせます。指定した期間のログデータの概要を含むペインが表示されます。

  2. このペインで、[時間までスクロール] を選択します。

    または、カーソルを合わせる代わりに、ヒストグラム バーをクリックしても [時間までスクロール] の選択と同様の結果が得られます。

[時間に合わせてズーム] 機能は、[時間までスクロール] と類似していますが、選択したヒストグラム バーで取得された期間に基づいたログデータに対するクエリが実行されます。[時間に合わせてズーム] 機能を選択すると、次のようになります。

  • [クエリ結果] ペインに表示されるログデータは、選択したヒストグラム バーの期間制限に応じて再読み込みされ、絞り込まれます。
  • コンソール URL が更新され、選択したヒストグラム バーの期間で取得された最新のログの timestamp が含まれます。
  • ヒストグラムは変更され、選択したヒストグラム バーの期間内にある timestamp 値を持つログのみが表示されます。
  • [ログフィールド] ペインのデータは、選択したヒストグラム バーで取得された期間に応じて調整されます。

[時間に合わせてズーム] 機能を選択するには、次の手順を行います。

  1. ヒストグラムのバーにカーソルを合わせます。指定した期間のログデータの概要を含むペインが表示されます。

  2. このペインで、[時間に合わせてズーム] を選択します。

クエリ結果

クエリの結果を表示するには、[クエリ結果] ペインを使用します。アプリケーションのトラブルシューティングに役立つように、個々のログエントリの詳細を表示し、ログエントリをグループ化および分析してログのパターンを見つけることができます。

概要フィールドを使用してログでパターンを検索する

クエリ結果のログエントリに目を通し、特定の LogEntry フィールドですばやく調べたいとします。または、特定のフィールドと値のペアでログエントリをグループ化したい場合があります。結果に概要フィールドを追加できます。これは、各ログエントリ行の先頭にチップとして表示されます。たとえば、次の画像は、各ログエントリ行に概要フィールド resource.type が追加されたクエリ結果を示しています。

ログ エクスプローラによって、リソースタイプを表示している緑色のテキストが前に付いたログが表示されます。

ログ エクスプローラには、デフォルトの概要フィールドとカスタムの概要フィールドがあります。デフォルトのサマリー フィールドは、現在のクエリ結果によって異なります。カスタム サマリー フィールドを使用すると、LogEntry の任意のフィールドを選択できます。

概要フィールドを変更するには、次の操作を行います。

  1. [概要] 列で、[編集] をクリックして、編集メニューを開きます。

    クエリ結果ペインには、概要フィールドを編集するためのボタンが表示されます。

  2. [概要フィールドの管理] ダイアログでは、次の操作を行えます。

    • ログエントリを未加工のテキスト形式で表示するには、切り替えスイッチ を使用して [デフォルトの概要フィールド] をオフにし、カスタムの概要フィールドは追加しません。

    • カスタム フィールド名を [カスタム概要フィールド] に追加します。

      概要フィールドの選択には次の特徴があります。

      • クエリ結果に現在表示されているログを使用したオートコンプリート。
      • 引用符で囲まれた有効文字のフィールド修正

      たとえば、「jsonPayload.id-field」と入力すると jsonPayload."id-field" に変わります。

      オートコンプリート機能によって提案されたかどうかにかかわらず、任意の LogEntry フィールドを選択することもできます。

      既存のカスタム概要フィールドを削除するには、そのチップ内の X をクリックします。

    • カスタム サマリー フィールドの切り捨てを有効または無効にします。概要フィールドを切り捨てることで、切り替えスイッチを使用して、概要フィールド値の表示を短くします。次に、フィールドが切り捨てられる前に表示する文字数を選択して、フィールドの先頭と末尾のどちらが表示されるかを指定します。

  3. [適用] をクリックします。

    これで、クエリ結果の概要フィールドが更新されました。

クエリ結果を検索する

[クエリ結果] の内容を検索するには、[クエリ結果] ペインで [結果で検索] をクリックし、検索キーワードを入力します。このフィルタを使用すると、新しいクエリを作成せずに、ログエントリの情報を検索できます。

検索条件に一致する用語が [クエリ結果] ペインのログエントリでハイライト表示されます。

一致する検索用語を含むログエントリがハイライト表示されます。

類似したログエントリを表示する

選択したログエントリに類似したログエントリを表示して、関心のあるログに集中できます。

類似したログエントリを表示するには、次の操作を行います。

  1. [クエリ結果] ペインで、 ログエントリを開きます。

  2. [類似のエントリ] をクリックし、[類似のエントリを表示] を選択します。

    クエリは次のようなクエリで更新され、クエリ結果が再読み込みされます。

    --Show similar entries
    protoPayload.methodName="io.k8s.core.v1.configmaps.update"
    --End of show similar entries
    

類似したログエントリのプレビューを表示するには、次の操作を行います。

  1. [クエリ結果] ペインで、 ログエントリを開きます。

  2. [類似のエントリ] メニューを開き、[類似のエントリをプレビュー] を選択します。

    次の情報を含む別のダイアログが開きます。

    • 見つかったパターン
    • パターンを含むログエントリの割合
    • パターンを含むログエントリの例

    このダイアログでは、ログエントリの表示と非表示を切り替えることができます。

    [ログエントリのプレビュー] ダイアログでは、類似したログエントリの表示と非表示を切り替えることができます。

類似したログエントリを非表示にする

類似したログエントリを非表示にして、クエリ結果からログを削除できます。

類似したログエントリを非表示にするには、次の 2 つの方法があります。

  • 自動的にグループ化された多数のログエントリを非表示にする。クエリを実行すると、クエリ結果がパターンについて分析され、ログエントリが類似したログフィールドの内容に基づいて自動的にグループ化されます。際立ったパターンが検出された場合は、[クエリ結果] ペインに、非表示になる結果の割合を示すバナーが表示されます。

    類似したログのバナーを非表示にします。

    類似のエントリを非表示: このボタンは、クエリに句を追加し、クエリ結果が再読み込みします。

    プレビュー: 別のウィンドウを開き、見つかったパターンとエントリの例を表示します。

    類似したログを非表示にすると、ログ エクスプローラ セッションの外部に情報が保存されず、各クエリは表示されたログのみに基づいて新しい分析を生成します。返されるログの種類によって、異なるクエリでは、ログエントリの異なる部分が分析されます。

  • 特定のログエントリに類似したログエントリを非表示にする。ログエントリに類似したログエントリを非表示にするには、次の操作を行います。

    1. ログエントリで [拡張] をクリックし、[類似エントリ] メニューをクリックして、[類似エントリを非表示] を選択します。

      クエリが更新され、[クエリ結果] ペインが再読み込みされます。選択したログエントリに類似したログエントリは表示されません。

フィールドに一致するログエントリを表示または非表示にする

ログエントリのフィールドに一致するログエントリを表示または非表示にできます。これにより、同じフィールドの内容が含まれているエントリに集中できます。

ログエントリの特定のフィールドに一致するログエントリを表示または非表示にするには、次の操作を行います。

  1. [クエリ結果] ペインで、ログエントリの [展開] をクリックします。

  2. ログエントリ内のフィールドの値(serviceNamecompute.googleapis.com など)をクリックします。

    次のメニューが表示されます。

    特定のフィールドに基づいてログエントリを非表示または表示する選択肢があるメニュー。

  3. [一致するエントリを表示] または [一致するエントリを非表示] を選択します。

    クエリは、類似したエントリを表示または非表示にするクエリで更新され、クエリ結果が新しい結果で再読み込みされます。

ログエントリを固定する

クエリを実行した後は、ログエントリを固定することでハイライト表示できます。固定されたログエントリは、[クエリ結果] ペインの中央に表示されます。新しいクエリを実行するときに、固定されたログエントリが含まれていない場合は、ログエントリの固定を解除するよう求められます。

ログエントリを固定するには、次の操作を行います。

  1. 固定するログエントリにカーソルを合わせます。
  2. 固定アイコン をクリックします。

ログエントリを固定すると、その背景が暗くなり、ピンアイコンが表示されます。固定されたログエントリの timestamp に基づいて、[ヒストグラム] ペインにも固定アイコンが表示されます。

ログ エクスプローラにより [クエリ結果] ペインと [ヒストグラム] ペインに、固定されたログエントリが表示されます。

ログエントリの固定を解除するには、ピンアイコンを再度クリックします。

固定されたログエントリのリソースと一致するログを表示する

ログエントリを固定すると、固定されたログのリソースタイプまたはリソースラベルと一致するログエントリを表示する新しいクエリを実行できます。

ログエントリを固定し、同じリソースタイプまたはリソースラベルに一致するログエントリを表示するには、次の操作を行います。

  1. 固定されたログの横にある下矢印 をクリックして、固定メニューを開きます。

  2. 固定メニューから選択します。

    • 固定されたログと同じ resource.type を使用してクエリを再実行するには、[同じ resource.type] を選択します。

      たとえば、resource.typek8s_node のログエントリを固定するとします。[同じ resource.type] を選択すると、クエリが再実行され、resource.type="k8s_node" を含むすべてのログエントリが表示されます。

    • 固定されたログと同じ resource.labels を使用してクエリを再実行するには、[同じ resource.labels] を選択します。

    • 固定されたログと同じ trace を使用してクエリを再実行するには、[同じトレース] を選択します。

    • クエリをクリアしてすべてのログエントリを表示するには、[すべて表示] を選択します。

固定されたログエントリを [ヒストグラム] ペインに表示する

[ヒストグラム] ペインを使用すると、固定されたログエントリのハイライト表示、スクロール、詳細の確認を行うことができます。

[ヒストグラム] ペインで、固定アイコン をクリックし、次のメニュー オプションから選択します。

  • ログエントリまでスクロール: ログエントリが現在の [クエリ結果] ペインに表示され、固定されたログエントリを周辺のコンテキスト ログで確認できます。
  • ログエントリに合わせてズーム: [ヒストグラム] ペインに表示される期間が絞り込まれ、固定されたログの近くにあるログを分離するようにクエリを調整できます。

トレースデータを表示する

ログエントリに trace とレイテンシ関連のフィールドの両方が含まれている場合、レイテンシとトレースのアイコンが表示されます。

トレースデータが含まれるログエントリが表示されます。

ログエントリに trace フィールドしか含まれていない場合は、トレース アイコンのみが表示されます。

トレース フィールドのみを含むログエントリの表示にはトレース アイコンが付いています。

ログエントリに関連するトレースデータを表示するには、トレース アイコンをクリックします。次を選択できます。

  • トレースの詳細表示: 親スパンと子トレースのほか、トレースの詳細を表示します。トレースの詳細を表示するには、[トレースで表示] をクリックして Cloud Trace に移動します。詳細パネルの内容について詳しくは、トレースの詳細の表示をご覧ください。
  • このトレースのすべてのログを表示: ログエントリに関連付けられたトレースの識別子に trace フィールドを追加して、クエリを調整して実行します。

  • トレースされたリクエストのみを表示: True に設定された traceSampled フィールドを追加して、クエリを調整して実行します。サンプリングについてさらに詳しくは、サンプリング レートをご覧ください。

Monitoring データを表示する

GKE や Compute Engine ログなどの特定のログについては、ログの概要行でリソースタイプをクリックすると、次のオプションを含むメニューが表示されます。

  • Monitoring 詳細の表示: GKE リソースの詳細パネルが開きます。詳細パネルについては、リソースの詳細の表示をご覧ください。
  • Monitoring で表示: リソースの [Monitoring] ページが表示されます。
  • GKE で表示、または Compute Engine で表示: GKE または Compute Engine インターフェース内のリソースについては、[詳細] ページを開きます。

GKE リソースの [ログ エクスプローラ] メニューを表示します。

ログへのリンクを共有するには、ログエントリを展開して、[リンクをコピー] を選択します。 リンクがクリップボードにコピーされます。Google Cloud プロジェクトにアクセスできるユーザーにリンクを送信できるようになりました。ユーザーがブラウザにリンクを貼り付けるか選択すると、Logging は [クエリ結果] ペインにログエントリを固定します。

他のユーザーと共有するログエントリのリンクをコピーします。

ログをダウンロード

ログは CSV 形式または JSON 形式でダウンロードできます。ログをダウンロードするには、次のいずれかの Identity and Access Management のロールが必要です。

  • Logging 管理者roles/logging.admin
  • ログ表示アクセス者roles/logging.viewAccessor

ログをダウンロードする手順は次のとおりです。

  1. [クエリ結果] ペインで [ダウンロード] をクリックします。

  2. [ログのダウンロード] ダイアログで、CSV 形式または JSON 形式を選択します。

  3. ログデータの処理方法を選択します。これらの欄から、以下の設定を行えます。

    • コンピュータにデータをダウンロードします。
    • Google ドライブにデータをダウンロードします。
    • 新しいタブにデータを表示します。

    CSV を保存して Google ドライブを選択すると、Google スプレッドシートでファイルを開くことができます。

クエリの例

Google Cloud プロダクトとユースケースで整理された推奨クエリについては、ログ エクスプローラを使用したサンプルクエリをご覧ください。たとえば、Kubernetes 関連のクエリを実行して、Google Kubernetes Engine のログを検索できます。

Compute Engine のログを表示する

特定の Compute Engine リソースタイプ(gce_instancegce_network など)では、ログ エクスプローラのいくつかの場所にリソース ID を含むリソース名がサブテキストとして表示されます。たとえば、gce_instance リソースタイプの場合、VM 名と VM ID が並んで表示されます。リソース名は、クエリを作成する正しいリソース ID の特定に役立ちます。

Compute Engine のリソース名は次の場所に表示されます。

  • [クエリ] ペインのフィルタ メニュー: Compute Engine のリソースタイプではリソース名が表示され、対応するリソース ID がサブテキストとして表示されます。
  • ログフィールド: Compute Engine リソースタイプは、フィールド ディメンションにリソース ID ではなくリソース名を表示します。
  • クエリ結果: Compute Engine VM インスタンス ログの場合、resource.labels フィールドに、対応するリソース名を含むメタデータが表示されます。
  • 概要フィールド: Compute Engine VM インスタンス ログの場合、チップにはリソース ID の代わりにリソース名が表示されます。

トラブルシューティング

このセクションでは、ログ エクスプローラを使用する際の一般的な問題のトラブルシューティングの手順を説明します。

宛先のシンクでログを表示する際に問題が発生した場合は、ルーティングとシンクのトラブルシューティングをご覧ください。

VM インスタンスのコンソールログが見つからない

Compute Engine インスタンスのコンソールに書き込まれたログが、ログ エクスプローラでは使用できない場合があります。ログを表示するには、次のようにします。

  1. Google Cloud プロジェクトの VM インスタンスのリストに移動します。

    [VM インスタンス] に移動

  2. インスタンスを選択し、ページの [ログ] セクションで [シリアルポート 1(コンソール)] を選択します。

シリアルポート出力が Cloud Logging に送信されるようにインスタンスを構成できます。詳細については、シリアルポート出力のロギングの有効化と無効化をご覧ください。

Google Cloud プロジェクトまたは組織 ID を取得する

Google Cloud コンソールの任意の場所から Google Cloud プロジェクトまたは組織 ID を取得するには、Google Cloud プロジェクトと組織のセレクタから Google Cloud プロジェクトのリストを展開し、[ID] 列で Google Cloud プロジェクト ID を見つけます。

プロジェクトの ID が表示されます。

ログエントリを表示できない

ログエントリが表示されない場合は、次の点を確認します。

  • 正しい Google Cloud プロジェクトが選択されているか。そうでない場合は、Google Cloud プロジェクトと組織セレクタから正しい Google Cloud プロジェクトを選択します。

  • Google Cloud プロジェクトでログを生成するリソースを使用しているか。また、そのリソースにアクティビティがあるか。Google Cloud プロジェクトが新規の場合でも、作成されたという事実を記録した監査ログがあるはずです。ログを生成するリソースを使用していることを確認するには、モニタリング対象リソースの一覧のページの「サービスのリソースタイプへのマッピング」セクションに移動します。

  • 期間が短すぎるかどうか。クエリの期間が正しいことを確認します。

  • 現在の除外クエリを表示して、探しているログが誤って除外されていないか確認します。

  • ログの表示に正しいスコープが使用されているか。検索範囲を調整する手順については、範囲を絞り込むをご覧ください。

クエリは正しいが、ログエントリが表示されない

  • Logging の保持期間を経過したログエントリは表示できません。有効なログの保持期間については、ログの保持期間をご覧ください。

  • 負荷が高くなっている場合、Logging へのログの送信やログの受信と表示に遅延が生じることがあります。

  • 未来のタイムスタンプを持つログエントリは、現在の時刻がタイムスタンプに「追いつく」までログ エクスプローラに表示されません。これは異常な状況です。おそらく、ログを送信しているアプリケーションの時間のずれが原因です。

  • クエリの範囲が大きすぎるため、妥当な時間内に完了できませんでした。「オペレーションが完了する前に期限が切れました」などと表示されます。クエリをより限定的なものにするか、期間を短くしてみてください。

クエリでエラーが返される

バケットを指定せずにリソースにクエリを発行した場合、Cloud Logging は Google Cloud プロジェクト内のシンクの履歴を使用して、そのリソースに対してエントリが書き込まれた場所を特定します。エントリが書き込まれた可能性がある 200 個を超えるバケットを Cloud Logging が識別すると、Error: Invalid query というメッセージが表示されてクエリが失敗します。

この問題を解決するには、クエリの範囲をストレージのサブセットに絞り込みます。詳細については、範囲を絞り込むをご覧ください。

クエリ結果の期間とクエリが一致しない

[クエリ結果] ペインと [ログフィールド] ペインに表示されるログデータは、ヒストグラム タイムラインでキャプチャされた期間に従って調整されます。ヒストグラムのタイムラインは、ヒストグラムの時間コントロールまたは期間セレクタを使用して調整します。これらの時間コントロールを調整しても、[クエリ] ペインのクエリ式は変更されません。

タイムスタンプのあるクエリの場合、時間範囲セレクタは無効になり、クエリはタイムスタンプ式を時間範囲の制限として使用します。クエリがタイムスタンプ式を使用しない場合、クエリは期間セレクタを期間の制限として使用します。

サポートを受ける

サポートを受ける方法については、Google Cloud のオペレーション スイートのサポートページをご覧ください。