BigQuery エンジンでトレースクエリを実行する

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

デフォルトでは、Observability Analytics ページはデフォルトのクエリエンジンでクエリを実行します。このエンジンは、デフォルトのスロットを使用してクエリを実行します。BigQuery エンジンも、スロットを予約しない限り、デフォルトのスロットでクエリを実行します。スロットを予約すると、クエリの送信時にデフォルトのスロットが占有されているために発生する遅延を解消できます。

デフォルトのクエリエンジンを使用する場合でも、BigQuery エンジンを使用する場合でも、オブザーバビリティ ビュー、ログバケットのビュー、分析ビューに対してクエリを実行できます。

始める前に

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. BigQuery エンジンを使用して Observability Analytics からクエリを実行するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

    • オブザーバビリティ閲覧アクセサー roles/observability.viewAccessor) クエリを実行するオブザーバビリティ ビューに対するこのロールは IAM 条件をサポートしているため、特定のビューへの付与を制限できます。ロール付与に条件を付加しない場合、プリンシパルはすべてのオブザーバビリティ ビューにアクセスできます。
    • BigQuery ユーザー roles/bigquery.user)プロジェクトに対する
    • BigQuery ジョブユーザー roles/bigquery.jobUser)プロジェクトに対する

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

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

  7. トレースデータを保存するオブザーバビリティ データセットに、 リンクされた BigQuery データセット があることを確認します。リンクされた BigQuery データセットが存在しない場合は、作成します。

BigQuery エンジンでクエリを実行するように Observability Analytics ページを構成する予定で、Virtual Private Cloud(VPC)Service Controls でプロジェクトを使用している場合は、BigQuery の Enterprise Edition を使用していることを確認してください。 詳細については、 BigQuery のエディションについてをご覧ください。

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

Observability Analytics ページを使用しているときに BigQuery エンジンでクエリを実行するには、次の操作を行います。

  1. コンソールで、 [Observability Analytics] ページに移動します。 Google Cloud

    Observability Analytics に移動

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

  2. クエリを入力または読み込みます。詳細については、 トレースのクエリと分析をご覧ください。

    グラフをダッシュボードに保存できます。グラフには、オブザーバビリティ データと他のビジネスデータの結合結果が表示されます。この場合、FROM 句では、オブザーバビリティ データセットのビューまたはログバケットのビューを指定する必要があります。また、クエリ対象のデータのリンクされたデータセットも必要です。JOIN ステートメントで BigQuery テーブルを指定できます。ただし、BigQuery テーブルに対してクエリを実行するには、必要な IAM 権限が必要です。

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

    ツールバーに [Run Query] と表示されている場合は、 [ Settings] をクリックして [BigQuery] を選択します。

    [BigQuery で実行] ボタンが無効になっている場合は、リンクされたデータセットがないことを示します。このエラーを解決するには、 リンクされた BigQuery データセットを作成します

  4. [BigQuery で実行] をクリックします。

料金

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

次のステップ