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

このドキュメントでは、アナリティクス ビューの作成、管理、クエリの方法について説明します。コンセプトの概要については、アナリティクス ビューについてをご覧ください。

始める前に

分析ビューはログビューに対してクエリを実行するため、分析ビューを作成してクエリを実行するには、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 のロールをご覧ください。

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

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

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

   [ログ分析] に移動

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

2. [ビュー] メニューで [segment ログ] セクションに移動し、クエリするログビューを選択します。

   ログビューを検索するには、[フィルタ] バーを使用するか、ログビューのリストをスクロールします。filter_listリスト内の各エントリは BUCKET_ID.LOG_VIEW_ID の形式で、これらのフィールドはログバケットとログビューの ID を参照します。

3. [スキーマ] ツールバーで [クエリ] をクリックします。

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

4. ツールバーに [クエリを実行] が表示されていることを確認します。

   ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析（デフォルト）] を選択します。

5. クエリの結果に満足するまで、[クエリ] ペインで SQL クエリを更新します。

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

7. アナリティクス ビューの名前と説明を入力し、[保存] をクリックします。

   名前は 100 文字に制限され、英字、数字、アンダースコア、ハイフンのみを使用できます。

   アナリティクス ビューが作成され、[data_table ビュー] ペインの [アナリティクス ビュー] セクションに表示されます。リスト内の各エントリの形式は LOCATION.ANALYTICS_VIEW_ID です。これらのフィールドは、アナリティクス ビューの場所と ID を参照します。たとえば、ログバケットが global リージョンにあるログビューをクエリする my-analytic-view という名前のアナリティクス ビューを作成した場合、このセクションには global.my-analytic-view と表示されます。

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

アナリティクス ビューがあれば、ログビューをクエリする場合と同様にクエリできます。[ログ分析] ページの使用方法を説明するドキュメントのリストについては、このドキュメントの次のステップをご覧ください。

アナリティクス ビューのデフォルト クエリを実行する手順は次のとおりです。

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

   [ログ分析] に移動

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

2. クエリを入力するか、アナリティクス ビューのデフォルトのクエリを読み込みます。クエリの FROM 句の形式は次のとおりです。

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

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

   • PROJECT_ID: プロジェクトの ID。
   • LOCATION: アナリティクス ビューのロケーション。アナリティクス ビューのロケーションは、クエリするリソースから継承されます。たとえば、アナリティクス ビューが global ロケーションにあるログビューをクエリする場合、アナリティクス ビューのロケーションも global にする必要があります。
   • ANALYTICS_VIEW_ID: アナリティクス ビューの ID。100 文字以内で、使用できるのは英字、数字、アンダースコア、ハイフンのみです。

   デフォルト クエリを実行する手順は次のとおりです。

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

      アナリティクス ビューを検索するには、[フィルタ] バーを使用するか、アナリティクス ビューのリストをスクロールします。filter_listリスト内の各エントリの形式は LOCATION.ANALYTICS_VIEW_ID です。これらのフィールドは、アナリティクス ビューの場所と ID を参照します。

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

      [クエリ] ペインが更新され、選択したアナリティクス ビューをクエリする SQL クエリが表示されます。

3. [クエリを実行] をクリックします。

   ツールバーに [BigQuery で実行] と表示されている場合は、[settings 設定] をクリックして、[ログ分析（デフォルト）] を選択します。

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

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

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

   [ログ分析] に移動

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

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

   アナリティクス ビューのリストが表示されます。リスト内の各エントリの形式は LOCATION.ANALYTICS_VIEW_ID です。これらのフィールドは、アナリティクス ビューの場所と ID を参照します。たとえば、ログバケットが global リージョンにあるログビューをクエリする my-analytic-view という名前のアナリティクス ビューを作成した場合、このセクションには global.my-analytic-view と表示されます。

3. 特定のアナリティクス ビューの詳細を表示する手順は次のとおりです。

   1. アナリティクス ビューを選択します。

      アナリティクス ビューのスキーマは [スキーマ] セクションに表示されます。

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

      アナリティクス ビューの作成日、スキーマ、クエリなど、アナリティクス ビューに関する情報がダイアログに表示されます。

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

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

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

   [ログ分析] に移動

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

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

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

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

4. 変更を加えた後、[保存したビューを上書き] をクリックします。

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

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

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

   [ログ分析] に移動

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

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

制限事項

分析ビューには次の制限が適用されます。

• 分析ビューで別の分析ビューをクエリすることはできません。
• 分析ビューでは、複数のログビューをクエリできます。ただし、クエリされたログビューをホストするログバケットは 1 つのロケーションに存在する必要があります。たとえば、us-east1 と asia-east1 の 2 つのログバケットがあるとします。これらのログバケットのログビューをクエリする分析ビューを作成することはできません。
• 分析ビューの親リソースは Google Cloud プロジェクトである必要があります。フォルダや組織に分析ビューを作成することはできません。
• リンクされたデータセットは、分析ビューではサポートされていません。したがって、分析ビューをクエリできるのは、[ログ分析] ページを使用する場合のみです。また、これらのクエリはデフォルトの Cloud Logging サービスで実行する必要があります。
• 分析ビューの作成や管理は API ではサポートされていません。

• 分析ビューには以下の上限が適用されます。

  • Google Cloud プロジェクトあたりの分析ビューの最大数: 100
  • 1 つの Google Cloud プロジェクトのリージョンあたりの分析ビューの最大数: 50
  • 1 つの Google Cloud プロジェクトで分析ビューを保存できるリージョンの最大数: 10

次のステップ

• ログのクエリと分析の概要
• SQL クエリを保存して共有する
• SQL クエリの結果をグラフ化する
• SQL クエリのサンプル