リンクされた BigQuery データセットを作成する

オブザーバビリティ データセットにリンクされた BigQuery データセットを作成すると、BigQuery サービス を使用してトレースデータをクエリできます。 その後、BigQuery Studio または BigQuery API を使用して、トレースデータをビジネス データセットと結合し、スパンを分析できます。

オブザーバビリティ分析を使用する場合、SQL でトレースデータを分析するために、リンクされた BigQuery データセットは必要ありません。オブザーバビリティ分析を使用すると、トレースデータとログデータを結合することもできます。詳細については、 SQL でトレースをクエリして分析すると オブザーバビリティ分析でログをクエリして分析するをご覧ください。

リンクされたデータセットが必要な場合

次のいずれかを行う場合は、リンクされた BigQuery データセットが必要です。

リンクされた BigQuery データセットを作成する

このセクションでは、オブザーバビリティ データセットにリンクされた BigQuery データセットを作成する方法について説明します。これにより、BigQuery サービスを使用してトレースデータをクエリできます。各オブザーバビリティ データセットは、1 つのリンクされた BigQuery データセットをサポートします。

オブザーバビリティ データセットにリンクを作成すると、次のようになります。

  • Google Cloud Observability は、次のサービス アカウントを作成するか、IAM ロールの付与を変更する場合があります。

  • 監査ログには、リンクを作成するリクエストと、モニタリング サービス エージェントの IAM ロールをモニタリング サービス アカウントに付与する サービス エージェント マネージャーからのリクエストが記録されます。 モニタリング サービス エージェントの IAM ロールを モニタリング サービス アカウントに付与する サービス エージェント マネージャーからのリクエストが記録されます。これらのログには、長時間実行オペレーションの完了も記録されます。

始める前に

  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. Enable the Cloud Monitoring and Observability APIs.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

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

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

  7. Enable the Cloud Monitoring and Observability APIs.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

    8.

  8. オブザーバビリティ データセットにリンクを作成するために必要な権限を取得するには、プロジェクトに対するオブザーバビリティ編集者 （roles/observability.editor）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

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

データセットを作成

gcloud

後述のコマンドデータを使用する前に、 次のように置き換えます。

  • LINK_ID: BigQuery データセットの名前。
  • DATASET_ID: データセットの ID。トレースデータは `Spans` Spansという名前のデータセットに保存されます。
  • BUCKET_ID: オブザーバビリティ バケットの ID。たとえば、この ID は _Trace になります。
  • LOCATION: オブザーバビリティ バケットのロケーション。
  • PROJECT_ID: プロジェクトの ID。

gcloud beta observability buckets datasets links create コマンドを実行します。

Linux、macOS、Cloud Shell

gcloud beta observability buckets datasets links create \
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID \
 --dataset=DATASET_ID\
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID

Windows（PowerShell）

gcloud beta observability buckets datasets links create `
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID `
 --dataset=DATASET_ID`
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID

Windows（cmd.exe）

gcloud beta observability buckets datasets links create ^
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID ^
 --dataset=DATASET_ID^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID

create コマンドは、長時間実行オペレーションを開始します。コマンドが成功した場合のレスポンスの例を次に示します。 

Create request issued for: [mydataset]
Waiting for operation [projects/my-project/locations/us/operations/operation-1775164903749-64e80c9817833-9ff804b6-c3e9cbe7] to complete...done.
Created link [mydataset].

REST

BigQuery データセットへのリンクを作成するには、 projects.locations.buckets.datasets.links.create エンドポイントにリクエストを送信します。

次の形式の parent パラメータを指定する必要があります。

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

上記の式のフィールドの意味は次のとおりです。

  • PROJECT_ID: プロジェクトの ID。
  • LOCATION: オブザーバビリティ バケットのロケーション。
  • BUCKET_ID: オブザーバビリティ バケットの ID。たとえば、この ID は _Trace になります。
  • DATASET_ID: クエリ対象のデータセットの ID。たとえば、この ID は Spans になります。

このコマンドには、クエリ パラメータとリクエスト本文が必要です。

  • クエリ パラメータ linkId を指定し、BigQuery データセットの名前に設定する必要があります。たとえば、linkId="my_link" のようにします。BigQuery データセット名は プロジェクト Google Cloud 内で一意である必要があり、100 文字以内で、文字、数字、アンダースコアのみを含めることができます。

  • リクエスト本文は Link オブジェクトです。name フィールドの値は次の形式です。

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID

    name フィールドに指定する値は、クエリ パラメータで参照されるリンクされた BigQuery データセットと一致する必要があります。

    LINK_ID フィールドは、BigQuery データセットの名前です。

レスポンスは Operation オブジェクトです。 このオブジェクトには、メソッドの進行状況に関する情報が含まれています。メソッドが完了すると、Operation オブジェクトにステータス データが含まれます。

オブザーバビリティ API エンドポイントの一覧については、 オブザーバビリティ API リファレンス ドキュメントをご覧ください。

リンクされたデータセットの作成時に権限エラーが発生した場合は、 権限エラーのトラブルシューティングをご覧ください。

次のステップ