クエリを保存して共有する

プレビュー

このプロダクトまたは機能は サービス固有規約の「一般サービス規約」セクションの「一般提供前のサービス規約」の対象となります 。 pre-GA のプロダクトと機能は「現状のまま」利用できますが、サポートが制限されることがあります。 詳細については、 リリース ステージの説明をご覧ください。

このドキュメントでは、ログ分析で作成したクエリを保存して共有する方法について説明します。ログ分析について詳しくは、 トレースのクエリと分析をご覧ください。

クエリをグラフ化する方法、または BigQuery で トレースデータをクエリする方法については、このドキュメントの 次のステップに記載されているドキュメントをご覧ください。

始める前に

アカウントにログインします。 Google Cloud を初めて使用する場合は、 アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。 Google Cloud新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. [ログ分析] ページの読み込み、トレースデータに対する非公開クエリの作成、実行、保存に必要な権限を取得するには、 次の IAM ロールを付与するよう管理者に依頼してください。

   • オブザーバビリティ閲覧アクセサー （roles/observability.viewAccessor）クエリを実行するオブザーバビリティ ビューに対する このロールは IAM 条件をサポートしているため、特定のビューへの付与を制限できます。ロール付与に条件を付加しない場合、プリンシパルはすべてのオブザーバビリティ ビューにアクセスできます。
   • オブザーバビリティ分析ユーザー （roles/observability.analyticsUser）プロジェクトに対する。このロールには、非公開クエリの保存と実行、共有クエリの実行に必要な権限が含まれています。
   • ログビューア （roles/logging.viewer）プロジェクトに対する。

   ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

   必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

   **注**: 共有クエリを作成して管理する場合は、上記の IAM ロールだけでは不十分です。共有クエリを作成して管理するには、IAM ロールに logging.queries.{share, updateShared, deleteShared} 権限が含まれている必要があります。

クエリを保存する

実行するすべてのクエリは自動的に 30 日間保存され、[ログ分析] ページの [最近] タブを選択することでアクセスできます。[最近] タブに表示されるクエリを検索、表示、実行、共有できます。

クエリを後で使用できるようにするには、自分に役立つ情報でアノテーションを付けるか、同僚がクエリを表示して実行できるようにしてから、クエリを保存します。保存したクエリは、名前、説明、公開設定ラベルで検索、並べ替えることができます。これらのクエリは編集、削除することもできます。保存したクエリは、削除するまで保持されます。

Google Cloud プロジェクトごとに 10,000 件のクエリを保存できます。

コンソール

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

1. コンソールで、 [**ログ分析**] ページに移動します。 Google Cloud

   [ログ分析] に移動

   このページを検索バーで検索する場合は、小見出しが「Logging」の結果を選択します。

2. [クエリ] ペインにクエリを入力します。

   [クエリ] ペインにクエリを入力するには、新しいクエリを入力するか、[最近] タブからクエリを選択するか、[保存済み] タブからクエリを選択します。

   クエリには、有効なビュー、複数のビュー、分析ビューを含めることができます。

   [クエリ] ペインのクエリが有効になると、[save 保存] が有効になります。

3. [save 保存] をクリックし、[クエリを保存] を選択して、[名前] フィールドと [説明] フィールドに入力します。これらのフィールドに設定した値は、[保存済み] タブに表示されます。

4. 省略可: Google Cloud プロジェクト ビューの [ログ分析] ページへのアクセス権を持つユーザーが保存したクエリを実行できるようにするには、[プロジェクトで共有] の切り替えを有効にします。

   デフォルトでは、この切り替えは無効になっており、表示が制限されています。

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

6. 省略可: 表示可能な保存済みクエリを表示、並べ替え、実行するには、[保存済み] タブを選択します。

   保存したクエリは、名前、説明、公開設定ラベルで並べ替えおよびフィルタリングできます。クエリの内容でフィルタすることもできます。

[保存済み] タブのオプションを使用して、作成したクエリを編集および削除できます。

• クエリを編集するには、（その他のオプション）をクリックし、[編集] を選択します。[名前] フィールドと [説明] フィールドの値は変更できますが、クエリ自体は変更できません。

• 保存済みクエリを削除するには、 [その他のオプション] をクリックし、[削除] を選択します。

クエリを共有する

保存したクエリは、Google Cloud プロジェクトにアクセスできるすべてのユーザーと共有できます。ただし、クエリを実行できるかどうかと、クエリで返されるデータは、プリンシパルの IAM ロールによって決まります。

コンソール

問題のトラブルシューティングを行う場合や、異常な結果が発生した場合、クエリとその結果を同僚と共有することをおすすめします。[ログ分析] ページでクエリ結果を表示するときに、URL をコピーできます。この URL を開くと、実行したクエリとその結果が表示されます。

クエリと結果をチームメンバーと共有する手順は、次のとおりです。

1. コンソールで、 [**ログ分析**] ページに移動します。 Google Cloud

   [ログ分析] に移動

   このページを検索バーで検索する場合は、小見出しが「Logging」の結果を選択します。

2. [クエリ] ペインにクエリを入力し、[クエリを実行] をクリックします。

   [クエリ] ペインにクエリを入力するには、新しいクエリを入力するか、[最近] タブからクエリを選択するか、[保存済み] タブからクエリを選択します。

3. [ リンクを共有] をクリックします。

4. 同僚にリンクを送信します。

   同僚がリンクを開くと、[ログ分析] ページが開き、クエリが表示されますが、実行されません。同僚はクエリを手動で実行する必要があります。

   クエリが BigQuery エンジンで実行され、クエリ対象のリソースが同じ所有権境界にない場合、[ログ分析] ページに警告ダイアログが表示されます。所有権境界は、いくつかの要因によって決まります。その 1 つは、クエリで使用するリソースの階層です。

   URL を正常に開くには、プロジェクトのユーザーの IAM ロールに、 [ログ分析] ページの表示に必要な権限が付与されている必要があります。 Google Cloud

最近のクエリまたは保存済みクエリの表示と実行

クエリを表示または再実行するには、[ログ分析] ページで [最近] タブを選択し、クエリを探します。

• クエリを実行するには、[実行] をクリックします。
• クエリを表示するには、（その他のオプション）メニューのオプションを使用します。

保存済みクエリを表示、編集、実行するには、[ログ分析] ページの [保存済み] タブを選択し、クエリを探します。

• クエリを実行するには、[実行] をクリックします。
• クエリを編集、表示、削除するには、（その他のオプション）メニューのオプションを使用します。

次のステップ

• SQL クエリ結果をグラフ化する。
• サンプル SQL クエリ。
• BigQuery でリンクされたデータセットに対してクエリを実行する。