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

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

始める前に

分析ビューはログビューに対してクエリを実行するため、分析ビューを作成してクエリを実行するには、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. [ビュー] メニューで [ ログ] セクションに移動し、クエリするログビューを選択します。

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

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

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

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

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

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

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

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

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

    アナリティクス ビューが作成され、[ ビュー] ペインの [アナリティクス ビュー] セクションに表示されます。リスト内の各エントリの形式は 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. [ビュー] メニューで、[ アナリティクス ビュー] セクションに移動し、クエリするアナリティクス ビューを選択します。

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

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

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

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

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

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

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

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

    [ログ分析] に移動

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

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

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

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

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

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

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

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

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

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

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

    [ログ分析] に移動

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

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

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

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

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

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

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

    [ログ分析] に移動

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

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

制限事項

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

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

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

次のステップ