このドキュメントでは、アナリティクス ビューの作成、管理、クエリの方法について説明します。コンセプトの概要については、アナリティクス ビューについてをご覧ください。
始める前に
分析ビューはログビューに対してクエリを実行するため、分析ビューを作成してクエリを実行するには、IAM ロールでログビューに対してクエリを実行し、ログ分析を使用することも許可されている必要があります。このセクションでは、分析ビューの作成に必要な IAM ロールと、ログビューへのクエリ実行とログ分析の使用に必要な IAM ロールについて説明します。
-
分析ビューの作成、管理、使用に必要な権限を取得するには、プロジェクトに対する Observability Analytics ユーザー(
roles/observability.analyticsUser
)IAM ロールを付与するよう管理者に依頼してください。この事前定義ロールには、分析ビューの作成、管理、使用に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
分析ビューを作成、管理、使用するには、次の権限が必要です。
-
observability.analyticsViews.get
-
observability.analyticsViews.list
-
observability.analyticsViews.create
-
observability.analyticsViews.update
-
observability.analyticsViews.delete
-
-
ログビューへのクエリ実行とログ分析の使用に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
_Required
および_Default
のログバケットに対してクエリを実行する: ログ閲覧者(roles/logging.viewer
)- プロジェクトのすべてのログビューに対してクエリを実行する: ログ表示アクセス者(
roles/logging.viewAccessor
)
プリンシパルを特定のログビューに制限するには、プロジェクト レベルで付与されたログ表示アクセス者ロールに IAM 条件を追加するか、ログビューのポリシー ファイルに IAM バインディングを追加します。詳細については、ログビューへのアクセスを制御するをご覧ください。
ユーザー定義バケットに対するビューのクエリ、または
_Default
ログバケットの_AllLogs
ビューのクエリに必要な追加ロールについて詳しくは、Cloud Logging のロールをご覧ください。
アナリティクス ビューを作成する
アナリティクス ビューを作成するには、次の手順で操作します。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
[ビュー] メニューで [
ログ] セクションに移動し、クエリするログビューを選択します。ログビューを検索するには、[フィルタ] バーを使用するか、ログビューのリストをスクロールします。filter_listリスト内の各エントリは
BUCKET_ID.LOG_VIEW_ID
の形式で、これらのフィールドはログバケットとログビューの ID を参照します。[スキーマ] ツールバーで [クエリ] をクリックします。
[クエリ] ペインが更新され、SQL クエリが表示されます。
ツールバーに [クエリを実行] が表示されていることを確認します。
ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
クエリの結果に満足するまで、[クエリ] ペインで SQL クエリを更新します。
ツールバーで [
保存] をクリックし、[アナリティクス ビューとして保存] を選択します。アナリティクス ビューの名前と説明を入力し、[保存] をクリックします。
名前は 100 文字に制限され、英字、数字、アンダースコア、ハイフンのみを使用できます。
アナリティクス ビューが作成され、[
ビュー] ペインの [アナリティクス ビュー] セクションに表示されます。リスト内の各エントリの形式はLOCATION.ANALYTICS_VIEW_ID
です。これらのフィールドは、アナリティクス ビューの場所と ID を参照します。たとえば、ログバケットがglobal
リージョンにあるログビューをクエリするmy-analytic-view
という名前のアナリティクス ビューを作成した場合、このセクションにはglobal.my-analytic-view
と表示されます。
アナリティクス ビューをクエリする
アナリティクス ビューがあれば、ログビューをクエリする場合と同様にクエリできます。[ログ分析] ページの使用方法を説明するドキュメントのリストについては、このドキュメントの次のステップをご覧ください。
アナリティクス ビューのデフォルト クエリを実行する手順は次のとおりです。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
クエリを入力するか、アナリティクス ビューのデフォルトのクエリを読み込みます。クエリの
FROM
句の形式は次のとおりです。FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
上の式で、フィールドの意味は次のとおりです。
- PROJECT_ID: プロジェクトの ID。
- LOCATION: アナリティクス ビューのロケーション。アナリティクス ビューのロケーションは、クエリするリソースから継承されます。たとえば、アナリティクス ビューが
global
ロケーションにあるログビューをクエリする場合、アナリティクス ビューのロケーションもglobal
にする必要があります。 - ANALYTICS_VIEW_ID: アナリティクス ビューの ID。100 文字以内で、使用できるのは英字、数字、アンダースコア、ハイフンのみです。
デフォルト クエリを実行する手順は次のとおりです。
[ビュー] メニューで、[
アナリティクス ビュー] セクションに移動し、クエリするアナリティクス ビューを選択します。アナリティクス ビューを検索するには、[フィルタ] バーを使用するか、アナリティクス ビューのリストをスクロールします。filter_listリスト内の各エントリの形式は
LOCATION.ANALYTICS_VIEW_ID
です。これらのフィールドは、アナリティクス ビューの場所と ID を参照します。[スキーマ] ツールバーで [クエリ] をクリックします。
[クエリ] ペインが更新され、選択したアナリティクス ビューをクエリする SQL クエリが表示されます。
[クエリを実行] をクリックします。
ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
アナリティクス ビューを一覧で取得する
Google Cloud プロジェクト内のアナリティクス ビューの一覧を取得する手順は次のとおりです。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
[ビュー] メニューで、[
アナリティクス ビュー] セクションに移動します。アナリティクス ビューのリストが表示されます。リスト内の各エントリの形式は
LOCATION.ANALYTICS_VIEW_ID
です。これらのフィールドは、アナリティクス ビューの場所と ID を参照します。たとえば、ログバケットがglobal
リージョンにあるログビューをクエリするmy-analytic-view
という名前のアナリティクス ビューを作成した場合、このセクションにはglobal.my-analytic-view
と表示されます。特定のアナリティクス ビューの詳細を表示する手順は次のとおりです。
アナリティクス ビューを選択します。
アナリティクス ビューのスキーマは [スキーマ] セクションに表示されます。
[スキーマ] ツールバーで [アナリティクス ビューのオプションを表示します] をクリックし、[詳細を表示] を選択します。more_vert
アナリティクス ビューの作成日、スキーマ、クエリなど、アナリティクス ビューに関する情報がダイアログに表示されます。
アナリティクス ビューを変更する
アナリティクス ビューを変更するには、次の操作を行います。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
- [ビュー] メニューで、[ アナリティクス ビュー] セクションに移動し、クエリするアナリティクス ビューを選択します。
[スキーマ] ツールバーで [アナリティクス ビューのオプションを表示] をクリックし、[ビューを編集] を選択します。more_vert
アナリティクス ビューに関する情報が表示されたダイアログが開きます。説明とクエリは変更できます。
変更を加えた後、[保存したビューを上書き] をクリックします。
アナリティクス ビューを削除する
アナリティクス ビューを削除する手順は次のとおりです。
-
Google Cloud コンソールで、[ログ分析] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
- [ビュー] メニューで、[ アナリティクス ビュー] セクションに移動し、クエリするアナリティクス ビューを選択します。
- [スキーマ] ツールバーで、more_vert [アナリティクス ビューのオプションを表示します] をクリックし、[ビューを削除] を選択して、ダイアログを完了します。
制限事項
分析ビューには次の制限が適用されます。
- 分析ビューで別の分析ビューをクエリすることはできません。
- 分析ビューでは、複数のログビューをクエリできます。ただし、クエリされたログビューをホストするログバケットは 1 つのロケーションに存在する必要があります。たとえば、
us-east1
とasia-east1
の 2 つのログバケットがあるとします。これらのログバケットのログビューをクエリする分析ビューを作成することはできません。 - 分析ビューの親リソースは Google Cloud プロジェクトである必要があります。フォルダや組織に分析ビューを作成することはできません。
- リンクされたデータセットは、分析ビューではサポートされていません。したがって、分析ビューをクエリできるのは、[ログ分析] ページを使用する場合のみです。また、これらのクエリはデフォルトの Cloud Logging サービスで実行する必要があります。
- 分析ビューの作成や管理は API ではサポートされていません。
分析ビューには以下の上限が適用されます。
- Google Cloud プロジェクトあたりの分析ビューの最大数: 100
- 1 つの Google Cloud プロジェクトのリージョンあたりの分析ビューの最大数: 50
- 1 つの Google Cloud プロジェクトで分析ビューを保存できるリージョンの最大数: 10