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

プレビュー

このプロダクトまたは機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能は「現状のまま」ご利用いただけますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

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

始める前に

注: 分析ビューの作成またはクエリに必要な権限を含む、事前定義された Cloud Logging Identity and Access Management（IAM）ロールはありません。

分析ビューはログビューに対してクエリを実行するため、分析ビューを作成してクエリを実行するには、IAM ロールでログビューに対してクエリを実行し、Log Analytics を使用することも許可されている必要があります。このセクションでは、分析ビューの作成に必要な IAM ロールと、ログビューのクエリと Log Analytics の使用に必要な IAM ロールについて説明します。

• 分析ビューの作成、管理、使用に必要な権限を取得するには、プロジェクトに対するオブザーバビリティ分析ユーザー （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 つのロケーションに存在する必要があります。たとえば、us-east1 ロケーションに 2 つのログバケットがある場合は、それらのログバケットのログビューをクエリする分析ビューを作成します。

分析ビューを作成するには、次の操作を行います。

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

   [ログ分析] に移動

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

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

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

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

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

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

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

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

6. ツールバーで [保存] [保存] をクリックし、[分析ビューとして保存] を選択します。

7. 分析ビューの名前と説明を入力し、[保存] をクリックします。

   注: アナリティクス ビューの名前は、作成後に変更できません。説明とクエリは変更できます。

   アナリティクス ビューが作成され、[ビュー] ペインの [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。

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

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

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

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

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

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

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

アナリティクス ビューを一覧表示する

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. [Schema] ツールバーで [アナリティクス ビューのオプションを表示] をクリックし、[詳細を表示] を選択します。

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

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

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

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

   [ログ分析] に移動

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

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

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

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

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

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

注: 分析ビューに対してクエリを作成して分析ビューを削除すると、そのクエリは失敗します。

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

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

   [ログ分析] に移動

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

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

制限事項

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

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

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

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

次のステップ

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