このドキュメントでは、アナリティクス ビューを作成して管理する方法について説明します。分析ビューを作成したら、ログビューをクエリする場合と同様にクエリできます。アナリティクス ビューについて詳しくは、アナリティクス ビューについてをご覧ください。
始める前に
-
Verify that billing is enabled for your Google Cloud project.
-
分析ビューの作成、管理、使用に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
-
オブザーバビリティ分析ユーザー (
roles/observability.analyticsUser
) -
ログ表示アクセス者(
roles/logging.viewAccessor
)
プリンシパルを特定のログビューに制限するには、プロジェクト レベルで付与されたログ表示アクセス者ロールに IAM 条件を追加するか、ログビューのポリシー ファイルに IAM バインディングを追加します。詳細については、ログビューへのアクセスを制御するをご覧ください。
ユーザー定義バケットに対するビューのクエリ実行、または
_Default
ログバケットの_AllLogs
ビューのクエリ実行に必要な追加のロールについて詳しくは、Cloud Logging のロールをご覧ください。 -
オブザーバビリティ分析ユーザー (
- ログ分析を使用するようにアップグレードされたログバケットがあることを確認します。この手順については、ログバケットを構成するをご覧ください。
アナリティクス ビューを作成する
アナリティクス ビューを作成するには、次の手順で操作します。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
- [ログ分析] ページを構成します。
- ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
- [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して last_page [ビューとスキーマ] をクリックします。
アナリティクス ビューとして保存するクエリを入力して検証します。
アナリティクス ビューがクエリするログビューのデフォルトのクエリを読み込んで編集することがあります。デフォルト クエリを読み込む手順は次のとおりです。
[ビュー] メニューで、[
ログ] セクションに移動し、クエリするログビューを見つけて選択します。[スキーマ] ツールバーで [クエリ] をクリックし、[上書き] をクリックします。
[クエリ] ペインが更新され、SQL クエリが表示されます。
クエリ結果に満足するまで、クエリを更新します。
分析ビューを作成します。
ツールバーで [
保存] をクリックし、[アナリティクス ビューとして保存] を選択します。アナリティクス ビューの名前と説明を入力します。
名前は 100 文字に制限され、英字、数字、アンダースコア、ハイフンのみを使用できます。アナリティクス ビューの作成後に名前を変更することはできません。
[保存] をクリックします。
アナリティクス ビューが作成され、[
アナリティクス ビュー] セクションの [ビュー] ペインに表示されます。
アナリティクス ビューをクエリする
アナリティクス ビューのクエリは、ログビューのクエリと同様の方法で行います。分析ビューをクエリするには、FROM
句で次の形式を使用します。
FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
前の式のフィールドの意味は次のとおりです。
- PROJECT_ID: プロジェクトの ID。
- LOCATION: アナリティクス ビューのロケーション。
- ANALYTICS_VIEW_ID: 分析ビューの ID。100 文字以内で、使用できるのは英字、数字、アンダースコア、ハイフンのみです。
詳細については、ログのクエリと分析の概要をご覧ください。
アナリティクス ビューを一覧で取得する
Google Cloud プロジェクト内のアナリティクス ビューの一覧を取得する手順は次のとおりです。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
- [ログ分析] ページを構成します。
- ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
- [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して last_page [ビューとスキーマ] をクリックします。
- [ビュー] メニューで、[ アナリティクス ビュー] セクションに移動します。
分析ビューの詳細を取得する
[スキーマ] ペインのオプションを使用すると、アナリティクス ビューに関する次の情報を表示できます。
- 名前。
- 作成日。
- 最終更新。
- Schema.
- Query.
アナリティクス ビューの詳細を表示するには、プロジェクト内のアナリティクス ビューを一覧表示してから、次の操作を行います。
- 情報を表示するアナリティクス ビューを選択します。
- [スキーマ] ツールバーで [アナリティクス ビューのオプションを表示します] をクリックし、[詳細を表示] を選択します。more_vert
アナリティクス ビューを変更する
アナリティクス ビューを変更するには、次の操作を行います。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
- [ログ分析] ページを構成します。
- ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
- [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して last_page [ビューとスキーマ] をクリックします。
- [ビュー] メニューで、[ アナリティクス ビュー] セクションに移動し、変更するアナリティクス ビューを選択します。
[スキーマ] ツールバーで [アナリティクス ビューのオプションを表示] をクリックし、[ビューを編集] を選択します。more_vert
アナリティクス ビューに関する情報が表示されたダイアログが開きます。説明とクエリは変更できます。
変更が完了したら、[保存したビューを上書き] をクリックします。
アナリティクス ビューを削除する
アナリティクス ビューを削除する手順は次のとおりです。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
- [ログ分析] ページを構成します。
- ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
- [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して last_page [ビューとスキーマ] をクリックします。
- [ビュー] メニューで、[ アナリティクス ビュー] セクションに移動し、削除するアナリティクス ビューを選択します。
- [スキーマ] ツールバーで、more_vert [アナリティクス ビューのオプションを表示します] をクリックし、[ビューを削除] を選択して、ダイアログを完了します。
制限事項
分析ビューには次の制限が適用されます。
- 分析ビューでクエリできるのはログビューのみです。
- 分析ビューの親リソースは Google Cloud プロジェクトである必要があります。
- 分析ビューをクエリできるのは、[ログ分析] ページを使用する場合のみです。また、[ログ分析(デフォルト)] クエリエンジンを使用する場合のみです。
- アナリティクス ビューがクエリするすべてのビューは、同じロケーションに存在する必要があります。
- 分析ビューを作成または管理するには、 Google Cloud コンソールを使用する必要があります。
- Google Cloud プロジェクトあたり最大 100 個の分析ビューを作成できます。
- リージョンごとに最大 50 個のアナリティクス ビューを作成できます。
- 1 つの Google Cloud プロジェクトで分析ビューを含めることができるリージョンは最大 10 個です。