ログ エクスプローラでクエリを作成する

このドキュメントでは、Google Cloud Console のログ エクスプローラでクエリを作成してログを取得し、分析する方法について説明します。

Logging のクエリ言語の詳細については、Logging クエリ言語リファレンスをご覧ください。

使用する一般的なクエリの例については、ログ エクスプローラを使用したサンプルクエリをご覧ください。

準備

Amazon Web Services(AWS)アカウントから Logging に送信するログを表示するには、Google Cloud Console リソース選択ツールで AWS コネクタ プロジェクトを選択してから、ログ エクスプローラを使用します。AWS コネクタ プロジェクトは、AWS アカウントの Amazon Resource Name(ARN)を保存し、AWS アカウントを Google Cloud サービスにリンクします。詳細については、AWS アカウントの指標の表示をご覧ください。

ログ エクスプローラを使用してクエリを作成するための、適切な Identity and Access Management の権限またはロールがあることを確認します。必要な IAM 権限の詳細については、IAM: Cloud Console 権限によるアクセス制御をご覧ください。

始める

Cloud Console を使用してクエリの作成を開始するには、ログ エクスプローラに移動します。

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

ログを表示する対象の適切な Cloud プロジェクトまたは他の Google Cloud リソースを選択します。

クエリを作成する

ログ エクスプローラでクエリを作成する場合は、主に [クエリ] ペインを使用します。

ログ エクスプローラのクエリペイン

[クエリ] ペインには、クエリ式を作成して実行するための複数の方法が用意されています。

  • Query Editor のフィルタメニューからオプションを選択します。
  • Logging のクエリ言語を使用したクエリ
  • [最近]、[保存済み]、[推奨] の各タブでクエリを表示、編集、実行します。

以降の手順では、これらのステップについて詳しく説明します。

Query Editor のフィルタ メニュー

クエリエディタのフィルタ メニューを使用して、リソース、ログ名、ログの重大度、期間パラメータをクエリエディタに追加できます。これらのオプションは、Logging のすべてのログの LogEntry フィールドに対応します。

Query Editor のプルダウン メニュー

  • リソース: リソースタイプを指定できます。Query Editor に追加するリソースは、一度に 1 つ選択できます。エントリには、論理演算子 AND を使用します。
  • ログ名: logName を指定できます。同時に複数のログ名を選択して Query Editor に追加できます。複数のエントリを選択する場合は、論理演算子 OR を使用します。
  • 重大度: 重大度を指定できます。同時に複数の重大度レベルを選択して Query Editor に追加できます。複数のエントリを選択する場合は、論理演算子 OR を使用します。

フィルタ メニューを使用するには、次の操作を行います。

  1. [クエリ] ペインで [Expand query preview] をクリックします。
  2. 1 つまたは複数のパラメータを選択します。
  3. [追加] をクリックします。Query Editor にパラメータが表示されます。
  4. クエリを確認したら、[クエリを実行] をクリックします。クエリの結果は [クエリ結果] ペインに表示されます。

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

時間制限のあるクエリ

時間に基づいてログをクエリする方法は 2 つあります。

  1. Query Editor でタイムスタンプ式を使用してクエリを実行します。
  2. 期間セレクタを使用したクエリ。

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

Logging のクエリ言語を使用したクエリ

Logging のクエリ言語を使用して、ログ エクスプローラの Query Editor、Logging API、またはコマンドライン インターフェースでクエリを作成できます。

詳細については、Logging のクエリ言語をご覧ください。

最近のクエリ

クエリを実行すると、そのクエリは [最近] クエリのリストに追加されます。このリストには、過去 30 日間の上位 10,000 件の一意のクエリが含まれます。

最近のクエリを表示するには、[Query] ペインで [最近] タブを選択します。[最近] タブには、次のオプションが表示されます。

  • ストリーム: クエリを実行して結果をストリーミングするには、このオプションを選択します。
  • 実行: クエリを実行するには、このオプションを選択します。
  • 他のオプション : クエリを実行するか、[保存済み] クエリのリストに保存するかを選べるオプションを指定できるクエリ式が表示されます。クエリを直接選択して、これらのオプションを指定することもできます。

    クエリを保存するには、次の操作を行います。

    1. [名前を付けて保存] をクリックします。 [クエリの保存] ダイアログが開きます。
    2. 次のフィールドに値を入力します。

      • 名前(必須): クエリの名前を指定します。名前は 64 文字に制限されています。
      • 説明(省略可): クエリの目的がわかるような説明を入力します。
      • 概要フィールドを含める(省略可): [概要フィールドを含める] を有効にして、表示する概要フィールドを入力します。
      • [サマリー フィールドを切り捨て](省略可): [サマリー フィールドを切り捨て] を有効にして、切り捨てる文字数と切り捨てを実行するかどうかを選択します。
    3. [クエリを保存] をクリックします。 これで、クエリが保存済みクエリリストに表示されるようになりました。

最近のクエリを並べ替えることもフィルタリングすることもできます。フィルタはクエリ式内のテキストと一致します。

保存したクエリ

[Query] ペインには [保存済み] タブがあり、このタブから保存したクエリにアクセスできます。 保存したクエリを使用すると、クエリの式を保存し、より一貫性のある効率的な方法でログを分析できます。

Query Editor で作成したクエリ式を保存するには、次の操作を行います。

  1. [Query] ペインで [保存] をクリックします。[クエリを保存] ダイアログが表示され、クエリ式が Query Editor に表示されます。

  2. 次のフィールドに値を入力します。

    • 名前(必須): クエリの名前を指定します。名前は 64 文字に制限されています。
    • 説明(省略可): クエリの目的がわかるような説明を入力します。
    • 概要フィールドを含める(省略可): [概要フィールドを含める] を有効にして、表示する概要フィールドを入力します。
    • [サマリー フィールドを切り捨て](省略可): [サマリー フィールドを切り捨て] を有効にして、切り捨てる文字数と切り捨てを実行するかどうかを選択します。
    1. [クエリを保存] をクリックします。 保存したクエリは、[保存済み] タブのリストに表示されます。

保存したクエリを実行するには、[実行] をクリックします。クエリを実行して結果をストリーミングするには、[ストリーム] をクリックします。

保存したクエリを並べ替えることもフィルタリングすることもできます。フィルタはクエリ式内のテキストと一致します。

共有クエリ

共有クエリを使用すると、プロジェクトのユーザーが、保存したクエリを互いに共有できます。 共有クエリは [保存済み] タブで確認できます。

共有クエリの表示と編集に必要なロールと権限については、Cloud Console の権限をご覧ください。 なお、IAM ロール roles/logging.admin または roles/editor を持つユーザーは、他のユーザーの共有クエリを編集できます。

クエリを共有する

すでに保存したクエリを共有することも、新しいクエリを共有することもできます。

クエリを作成して共有する方法は次のとおりです。

  1. Query Editor にクエリを入力します。

  2. [保存] をクリックします。

  3. [クエリの保存] ダイアログのフィールドに値を入力します。

  4. [Share with project] を有効にします。

  5. [クエリを保存] をクリックします。

クエリが Cloud プロジェクトの他のユーザーと共有されるようになりました。

すでに保存したクエリを共有するには、次の操作を行います。

  1. [保存済み] タブを選択します。

  2. [その他のオプション ] > [編集 ] を選択するか、クエリを直接選択します。

  3. [クエリを編集] ダイアログで、[Share with project] を有効にして、[クエリを更新] を選択します。

クエリが Cloud プロジェクトの他のユーザーと共有されるようになりました。

共有クエリを表示

すべての共有クエリをすばやく表示するには、[公開設定] 列を並べ替えて共有クエリを最初に表示します。

  1. [保存済み] タブを選択します。

  2. [すべて] をクリックします。

  3. [公開設定] 列を並べ替えます。

[公開設定] 列は、クエリの共有有無および共有方法を表します。

  • Shared by me: 自分が保存して、Cloud プロジェクトの他のユーザーと共有したクエリ。
  • 共有: Cloud プロジェクトの他のユーザーが共有したクエリ。
  • 非公開: 自分が保存して、Cloud プロジェクトの他のユーザーと共有しなかったクエリ。

クエリのみを表示する

作成または共有した保存済みクエリを表示するには、[Mine] をクリックします。作成して保存したクエリのリストが表示されます。[公開設定] 列で、共有されていない非公開クエリを確認できます。共有したクエリは [Shared by me] で示されます。

推奨クエリ

Logging は、使用している Google Cloud プロダクトなどの Cloud プロジェクトのコンテキストに基づいて、推奨クエリを生成します。推奨クエリを使用することで、問題を特定したり、システム全体の健全性に関する分析情報を得たりできます。たとえば、Google Kubernetes Engine の使用を検出すると、Logging はコンテナのすべてのエラーログを検索するクエリを提案することがあります。

推奨クエリを表示して実行するには、[クエリ] ペインで [推奨] タブを選択します。[推奨] タブには、クエリのリスト、各クエリの説明および次のオプションが表示されます。

  • ストリーム: クエリを実行して結果をストリーミングするには、このオプションを選択します。
  • 実行: クエリを実行するには、このオプションを選択します。
  • 他のオプション : クエリを実行するか、保存するかを選べるオプションを指定できるクエリ式の詳細が表示されます。クエリを直接選択して、これらのオプションを指定することもできます。

    推奨クエリの詳細を確認するには、次のいずれかを行います。

    • クエリの行を選択します。

    • その他 をクリックして、[表示] を選択します。[クエリの詳細] ダイアログが開きます。

    [クエリの詳細] ダイアログにクエリと、実行ストリームまたは名前を付けて保存のオプションが表示されます。

    • クエリを保存するには、次の操作を行います。

      1. [名前を付けて保存] をクリックします。
      2. [クエリの保存] ダイアログのフィールドに値を入力します。

      編集したクエリが [保存済み] のリストに表示されます。このリストでは、後でクエリを実行することもできます。

    • クエリを今すぐ実行するには、[実行] をクリックします。クエリが実行され、クエリエディタに表示されます。

    • クエリを今すぐ実行して結果をストリーミングするには、[ストリーム] をクリックします。

    • ダイアログを閉じて推奨クエリのリストに戻るには、[閉じる] をクリックします。

次の想定される動作に注意してください。

  • ページを続けて読み込んだ際、同じクエリが同じ順序で表示されない場合があります。
  • 推奨クエリが表示されないことがあります。
  • 推奨クエリを実行しても、ログが返されないことがあります。