アナリティクス ビューの作成、クエリ、管理

プレビュー

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

このドキュメントでは、アナリティクス ビューを作成して管理する方法について説明します。アナリティクス ビューを作成した後は、オブザーバビリティ ビューをクエリするのと同様にクエリできます。

アナリティクス ビューの概要については、 アナリティクス ビューについてをご覧ください。

始める前に

アカウントにログインします。 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）プロジェクトに対する。

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

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

2. オブザーバビリティ ビューがあることを確認します。詳細については、 Cloud Trace ストレージ モデルをご覧ください。

アナリティクス ビューを作成する

注: アナリティクス ビューでクエリできるのはオブザーバビリティ ビューです。アナリティクス ビューで複数のビューをクエリする場合、それらのビューは同じロケーションに存在する必要があります。

アナリティクス ビューを作成するには、次の手順で操作します。

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

   [ログ分析] に移動

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

2. [ログ分析] ページを構成します。
   1. ツールバーに [クエリを実行] が表示されていることを確認します。 ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析（デフォルト）] を選択します。
   2. [ビュー] メニューが表示されない場合は、ナビゲーション パネルに移動して [ ビューとスキーマ] をクリックします。

3. アナリティクス ビューとして保存するクエリを入力して検証します。

   アナリティクス ビューでクエリするオブザーバビリティ ビューのデフォルトのクエリを読み込んで編集することもできます。 デフォルトのクエリを読み込むには、次の操作を行います。

   1. [ビュー] メニューで、 [トレース] セクションに移動し、 _Trace.Spans._AllSpans を選択します。

   2. [スキーマ] ツールバーで [クエリ] をクリックし、 [上書き] をクリックします。

      [クエリ] ペインが更新され、SQL クエリが表示されます。

   3. 目的のクエリの結果が得られるまでクエリを更新します。

4. アナリティクス ビューを作成します。

   1. ツールバーで [save 保存] をクリックし、[アナリティクス ビューとして保存] を選択します。

   2. アナリティクス ビューの名前と説明を入力します。

      名前は 100 文字に制限され、英字、数字、アンダースコア、ハイフンのみを使用できます。アナリティクス ビューの作成後に名前を変更することはできません。

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

   アナリティクス ビューが作成され、[data_table アナリティクス ビュー] セクションの [ビュー] ペインに表示されます。

アナリティクス ビューをクエリする

アナリティクス ビューのクエリは、オブザーバビリティ ビューのクエリと同様の方法で行います。アナリティクス ビューをクエリするには、FROM 句に次の形式を使用します。

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

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

• PROJECT_ID: プロジェクトの ID。
• LOCATION: アナリティクス ビューのロケーション。
• ANALYTICS_VIEW_ID：分析ビューの ID。100 文字以内で、使用できるのは英字、 数字、アンダースコア、ハイフンのみです。

詳細については、トレースのクエリと分析をご覧ください。

アナリティクス ビューを一覧で取得する

プロジェクト内のアナリティクス ビューの一覧を取得する手順は次のとおりです。 Google Cloud

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

   [ログ分析] に移動

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

2. [ログ分析] ページを構成します。
   1. ツールバーに [クエリを実行] が表示されていることを確認します。 ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析（デフォルト）] を選択します。
   2. [ビュー] メニューが表示されない場合は、ナビゲーション パネルに移動して [ ビューとスキーマ] をクリックします。

3. [ビュー] メニューで、[data_table アナリティクス ビュー] セクションに移動します。

アナリティクス ビューの詳細を取得する

[スキーマ] ペインのオプションを使用して、アナリティクス ビューに関する次の情報を表示できます。

• 名前。
• 作成日。
• 最終更新日時。
• スキーマ。
• クエリ。

アナリティクス ビューの詳細を表示するには、プロジェクト内のアナリティクス ビューを一覧表示してから、次の操作を行います。

1. 情報を表示するアナリティクス ビューを選択します。
2. [スキーマ] ツールバーで [ アナリティクス ビューのオプションを表示します] をクリックし、[詳細を表示] を選択します。

アナリティクス ビューを変更する

アナリティクス ビューを変更するには、次の操作を行います。

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

   [ログ分析] に移動

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

2. [ログ分析] ページを構成します。
   1. ツールバーに [クエリを実行] が表示されていることを確認します。 ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析（デフォルト）] を選択します。
   2. [ビュー] メニューが表示されない場合は、ナビゲーション パネルに移動して [ ビューとスキーマ] をクリックします。

3. [ビュー] メニューで、[data_table アナリティクス ビュー] セクションに移動し、クエリするアナリティクス ビューを選択します。

4. [スキーマ] ツールバーで [ アナリティクス ビューのオプションを表示します] をクリックし、[ビューを編集] を選択します。

   アナリティクス ビューに関する情報が表示されたダイアログが開きます。説明とクエリは変更できます。

5. 変更が完了したら、[保存したビューを上書き] をクリックします。

アナリティクス ビューを削除する

注: アナリティクス ビューに対してクエリを作成してアナリティクス ビューを削除すると、それらのクエリは失敗します。

アナリティクス ビューを削除する手順は次のとおりです。

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

   [ログ分析] に移動

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

2. [ログ分析] ページを構成します。
   1. ツールバーに [クエリを実行] が表示されていることを確認します。 ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析（デフォルト）] を選択します。
   2. [ビュー] メニューが表示されない場合は、ナビゲーション パネルに移動して [ ビューとスキーマ] をクリックします。

3. [ビュー] メニューで、[data_table アナリティクス ビュー] セクションに移動し、削除するアナリティクス ビューを選択します。
4. [スキーマ] ツールバーで、[ アナリティクス ビューのオプションを表示します] をクリックし、[ビューを削除] を選択して、ダイアログを完了します。

制限事項

アナリティクス ビューには次の制限が適用されます。

• アナリティクス ビューでクエリできるのはオブザーバビリティ ビューのみです。
• アナリティクス ビューの親リソースは Google Cloud プロジェクトである必要があります。
• アナリティクス ビューをクエリできるのは、[ログ分析] ページで [ログ分析（デフォルト）] クエリエンジンを使用する場合のみです。
• アナリティクス ビューでクエリするすべてのビューは、同じロケーションに存在する必要があります。
• アナリティクス ビューの作成と管理には、 Google Cloud コンソールを使用する必要があります。
• 作成できるアナリティクス ビューの数は Google Cloud プロジェクトあたり 100 個までです。
• 作成できるアナリティクス ビューの数はリージョンあたり 50 個までです。
• 各 Google Cloud プロジェクトでアナリティクス ビューを含めることができるリージョンの数は 10 個までです。

次のステップ

• トレースのクエリと分析を行う。
• SQL クエリ結果をグラフ化する。
• クエリの保存と共有を行う。
• サンプル SQL クエリ。