BigQuery エンジンでログクエリを実行する

このドキュメントでは、オブザーバビリティ分析ページを構成して BigQuery エンジンでクエリを実行する方法について説明します。SQL ベースのアラート ポリシーがある場合は、BigQuery エンジンでクエリを実行する必要があります。SQL ベースのグラフをダッシュボードに保存し、グラフのクエリでオブザーバビリティ データと他のビジネスデータを結合する場合にも、このクエリ エンジンを使用する必要があります。

[オブザーバビリティ分析] ページでは、デフォルトのクエリエンジンでクエリが実行されます。ただし、このページを構成して、BigQuery エンジンでクエリを実行できます。両方のクエリエンジンが無料スロットでクエリを実行します。ただし、BigQuery エンジンを使用してスロットを予約すると、そのエンジンは予約済みのスロットでクエリを実行します。

デフォルトのクエリエンジンまたは BigQuery エンジンを使用しているかどうかにかかわらず、オブザーバビリティ ビュー、ログバケットのビュー、分析ビューをクエリできます。デフォルトのクエリエンジンでクエリを実行すると、Logging 権限が確認されます。ただし、BigQuery エンジンでクエリを実行する場合は、BigQuery 権限がチェックされます。

詳細については、オブザーバビリティ分析クエリ エンジンを選択するをご覧ください。

始める前に

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

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.

1. BigQuery Studio からリンクされたデータセットに対してクエリを実行するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

   • クエリするプロジェクトまたはビューに対するログビューアクセサー （roles/logging.viewAccessor）。
   • プロジェクトに対する BigQuery ユーザー （roles/bigquery.user）。
   • プロジェクトに対する BigQuery ジョブユーザー （roles/bigquery.jobUser）。

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

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

2. ログバケットにリンクされた BigQuery データセットがあることを確認します。データセットが存在しない場合は作成します。

BigQuery エンジンでクエリを実行するように [オブザーバビリティ分析] ページを構成する予定で、Virtual Private Cloud（VPC）Service Controls でプロジェクトを使用している場合は、BigQuery の Enterprise Edition を使用していることを確認してください。詳細については、BigQuery のエディションについてをご覧ください。

BigQuery エンジンでオブザーバビリティ分析クエリを実行する

アラート ポリシーを使用して SQL クエリの結果をモニタリングする場合は、次の操作を行って BigQuery エンジンでクエリを実行します。

1. BigQuery エンジンでクエリを実行するように Observability Analytics を構成します。

   1. Google Cloud コンソールで、 [オブザーバビリティ分析] ページに移動します。

      Observability Analytics に移動

      検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。

   2. [ログビュー] リストでビューを見つけて、[クエリ] を選択するか、クエリを入力します。

      クエリペインに FROM ステートメントを参照するエラー メッセージが表示される場合、特定のログビューに解決されません。このエラーの解決方法については、エラー FROM clause must contain exactly one log view をご覧ください。

   3. ツールバーに移動し、[BigQuery で実行] というボタンが表示されていることを確認します。

      ツールバーに [クエリを実行] と表示されている場合は、[ 設定] をクリックして [BigQuery] を選択します。

      [BigQuery で実行] ボタンが無効になっている場合は、リンクされたデータセットを作成する必要があります。

   4. クエリを実行します。

      ツールバー オプションを使用して、クエリをフォーマットし、クエリを消去して、BigQuery SQL リファレンス ドキュメントを開くことができます。

料金

BigQuery の使用に関連する費用については、BigQuery の料金をご覧ください。

次のステップ

• アラート ポリシーを使用して SQL クエリの結果をモニタリングする
• SQL クエリを保存して共有する
• SQL クエリのサンプル
• SQL クエリの結果をグラフ化する