このドキュメントでは、アナリティクス ビューを作成して管理する方法について説明します。アナリティクス ビューを作成した後は、ログビューをクエリするのと同様にクエリできます。アナリティクス ビューについて詳しくは、アナリティクス ビューについてをご覧ください。
始める前に
-
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 ビューとスキーマ] をクリックします。
- [ビュー] メニューで、[ アナリティクス ビュー] セクションに移動します。
アナリティクス ビューの詳細を取得する
[スキーマ] ペインのオプションを使用して、アナリティクス ビューに関する次の情報を表示できます。
- 名前。
- 作成日。
- 最終更新日時。
- スキーマ。
- クエリ。
アナリティクス ビューの詳細を表示するには、プロジェクト内のアナリティクス ビューを一覧表示してから、次の操作を行います。
- 情報を表示するアナリティクス ビューを選択します。
- [スキーマ] ツールバーで [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 個までです。
- 各 Google Cloud プロジェクトでアナリティクス ビューを含めることができるリージョンの数は 10 個までです。