ログ エクスプローラの使用

このガイドでは、Google Cloud Console のログ エクスプローラを使用して、ログを検索し表示する方法について説明します。

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

始める

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

  • ログを表示する適切な Identity and Access Management ロールがあることを確認します。IAM ロールと権限の詳細については、IAM によるアクセス制御をご覧ください。

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

  • BindPlane でオンプレミスとハイブリッド クラウドのログを取り込む場合、これらのログはリソースタイプ generic_node にあります。

  • [ログ エクスプローラ] に移動します。

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

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

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

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

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

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

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

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

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

  • オプション: 以前のログビューアに移動して、フィードバックを送信し、新しい Logging 機能の概要を表示します。
  • 範囲を絞り込む: 現在の Cloud プロジェクトのログのみ、または 1 つ以上のストレージ ビューで、検索の範囲を絞り込むことができます。範囲指定の詳細については、範囲の調整をご覧ください。
  • 共有リンク: 現在のクエリの短縮 URL を作成し、クリップボードにコピーします。これにより、クエリの共有が簡単になります。コピーした URL には、クエリの現在の時間範囲で表される対応する絶対時間範囲が設定されます。例: 7:49:37 PM - 8:49:37 PM
  • 期間セレクタ: クエリ結果を期間で制限します。詳細については、期間セレクタをご覧ください。
  • 学習: 関連ドキュメントやトピックへのリンクが表示されます。

期間セレクタ

期間セレクタ: クエリ結果を期間で制限できます。

デフォルトの期間は 1 時間です。[期間の選択] オプションを使用して、特定のタイムスタンプの前後の期間を限定することもできます。

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

期間セレクタから、日付や時刻などのリージョンの設定ができます。

  1. [カスタム範囲を入力] を選択します。
  2. [日付と時刻の形式の変更] を選択します。
  3. [言語と地域] メニューで設定を更新します。
  4. [保存] をクリックします。

    ブラウザを更新すると、希望するログ形式がログ エクスプローラに表示されます。

範囲を絞り込む

ログ エクスプローラに表示されるログの範囲を絞り込むには、[範囲を絞り込む] オプションを使用します。現在の Cloud プロジェクト内のログのみを検索することも、1 つ以上のストレージ ビューでログを検索することもできます。ログ エクスプローラの範囲を絞り込むには、次の手順を行います。

  1. [アクション] ツールバーで [範囲を絞り込む] を選択します。

  2. [範囲を絞り込む] ダイアログで、[絞り込む] オプションを選択します。

    [範囲を絞り込む] ダイアログ

    • [プロジェクトで絞り込む] を使用すると、現在の Cloud プロジェクトで生成されるログを検索できます。

    • [ストレージで絞り込む] を使用すると、1 つ以上のストレージ ビューに基づいてログを検索できます。ログビューの詳細については、ログバケットでのログビューの管理をご覧ください。

  3. [ストレージで絞り込む] を選択した場合は、表示するバケットを 1 つ以上選択します。

    ダイアログには、次の条件を満たしているストレージ ビューが一覧表示されます。

    • ユーザーはストレージ ビューにアクセスできます。
    • ログバケットが選択した Cloud プロジェクトに属しているか、選択した Cloud プロジェクトがストレージ バケットにログをすでにルーティングしています。
  4. [適用] をクリックします。

クエリペイン

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

  • Query Editor フィールド: Logging クエリ言語を使用してクエリ式を構築します。
  • クエリエディタのプルダウン メニュー: リソースログ名重大度に基づいてクエリ式を追加します。詳細については、クエリのプルダウン メニューをご覧ください。
  • [最近] タブ: 最近のクエリを表示します。詳細については、最近のクエリをご覧ください。
  • 保存済み: 保存済みのクエリと、Cloud プロジェクトの他のユーザーから共有されているクエリを表示できます。詳細については、保存済みのクエリ共有クエリをご覧ください。
  • [推奨] タブ: Cloud プロジェクトのリソースに基づいて推奨クエリを表示します。詳細については、候補クエリをご覧ください。
  • 保存: [保存済み] タブで表示、実行できるクエリを保存します。
  • ログのストリーミング: 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. このペインで、[時間に合わせてズーム] を選択します。

クエリ結果

[クエリ結果] ペインを使用すると、ヒストグラムの時間コントロールまたは期間セレクタを使用して、クエリ式と選択した期間に一致するログエントリを調べることができます。

[クエリ結果] ペイン

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

  • クエリ結果: クエリから取得したログエントリを構造化 JSON 形式で表示します。クエリ結果を展開するには、[クエリ結果を全画面表示] をクリックします。
  • タイムゾーン: ログが表示されるタイムゾーンを変更します。
  • ログをダウンロード: クエリ結果からログをダウンロードします。
  • トレースデータ: トレースの詳細を表示し、トレースに基づいてクエリを絞り込みます。詳細については、トレースデータを表示するをご覧ください。
  • ログの概要の非表示: クエリ結果からログの概要行を非表示にします。
  • ネストされたログフィールドの展開または折りたたみ: ネストされたフィールドを展開または折りたたみます。
  • クリップボードにコピー: JSON 形式でログエントリをコピーします。
  • ログエントリへのリンクをコピーする: ログエントリへのリンクを共有できます。詳細については、ログエントリへのリンクをコピーするをご覧ください。
  • 編集: ログフィールドの値をログエントリの先頭または末尾の概要行に追加します。最新のログを最初または最後に表示することもできます。概要フィールドの追加に関する詳細については、概要フィールドの追加をご覧ください。
  • ログエントリを固定する: ログエントリを [クエリ結果] と [ヒストグラム] ペインに固定します。詳細については、ログを固定するをご覧ください。
  • カーソルのスクロール: [クエリ結果] でログをスクロールすると、URL が調整され、cursorTimestamp が含まれます。これは、現在の [クエリ結果] ペインに表示される最新ログの timestamp を示しています。

クエリ結果ペインで、フィールドの値をクリックして次の操作を選択できます。

  • 一致エントリを表示: 一致するログエントリを照会します。
  • 一致エントリを非表示: 選択した式に一致しないログエントリを照会します。
  • 概要行にフィールドを追加: フィールドを概要行としてログエントリに追加します。

概要フィールドを追加して管理する

概要フィールドを使用すると、ログのパターンをすばやく確認できます。

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

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

ログ エクスプローラには、現在のクエリ結果に依存するデフォルトの概要フィールドと、LogEntry の任意のフィールドを対象にできるカスタムの概要フィールドがあります。

カスタム編集とデフォルト概要フィールドはいずれも、クエリ結果の編集メニューから管理できます。展開されたログエントリからカスタム サマリー フィールドを直接追加することもできます。

ログエントリからカスタム概要フィールドを追加する

ログエントリからカスタム概要フィールドを直接追加するには、次の手順を行います。

  1. 展開ボタン をクリックしてログエントリを展開します。

  2. フィールドの値をクリックして、[概要行にフィールドを追加] を選択します。

これで、概要フィールドがそのフィールドを含むログエントリの前にチップとして表示されます。

カスタム サマリー フィールドを削除するには、ログエントリ行のそのチップをクリックし、[概要行からフィールドを削除] を選択します。カスタム サマリー フィールドをさらに管理するには、次のセクションの手順をご覧ください。

編集メニューを使用して概要フィールドを管理する

編集メニューを使用してカスタム概要フィールドとデフォルト概要フィールドを管理するには、次の手順に従います。

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

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

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

    1. 切り替えスイッチ を使用して、[デフォルト概要フィールド] をオンまたはオフにします。

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

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

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

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

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

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

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

      ヒント: クエリ結果で、切り捨てられた概要フィールドにカーソルを合わせると、完全な値が表示されます。

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

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

ログエントリを固定する

ログエントリを固定し、目的のログエントリをハイライト表示できます。

ログエントリを固定するには、固定するログエントリにカーソルを合わせて、固定アイコンを選択します。ログエントリを固定すると、その背景が暗くなり、ピンアイコンが表示されます。

ログエントリを固定してクエリを再実行すると、固定されたログエントリがログデータの構成に応じて [クエリ結果] ペインの上部または下部に表示されます。固定されたログエントリの timestamp に基づいて、[ヒストグラム] ペインにも固定アイコンが表示されます。

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

ログエントリの固定を解除するには、ピンアイコンを選択し、続いて [ログエントリの固定を解除] を選択します。

リソース コンテキスト内で固定されたログエントリを表示する

リソース コンテキスト内で固定されたログエントリを表示するには、ピンアイコン を選択して、[リソースのログエントリを固定し、表示します] を選択します。

[リソース ログエントリを固定して表示] が選択されています。

Logging は、固定されたログエントリの resource.type フィールドを Query Editor に入力して、クエリを実行します。これで、固定されたログエントリをリソースタイプと関連付けて表示できるようになりました。

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

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

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

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

ヒストグラムの期間が絞り込まれます。

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

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

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

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

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

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

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

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

Monitoring データを表示する

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

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

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

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

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

ログをダウンロード

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

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

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

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

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

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

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

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

クエリの例

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

Compute Engine のログを表示する

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

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

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

トラブルシューティング

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

サポートを受ける

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