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

このドキュメントでは、アナリティクス ビューを作成して管理する方法について説明します。分析ビューを作成したら、ログビューをクエリする場合と同様にクエリできます。アナリティクス ビューについて詳しくは、アナリティクス ビューについてをご覧ください。

始める前に

  1. Verify that billing is enabled for your Google Cloud project.

  2. 分析ビューの作成、管理、使用に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

    プリンシパルを特定のログビューに制限するには、プロジェクト レベルで付与されたログ表示アクセス者ロールに IAM 条件を追加するか、ログビューのポリシー ファイルに IAM バインディングを追加します。詳細については、ログビューへのアクセスを制御するをご覧ください。

    ユーザー定義バケットに対するビューのクエリ実行、または _Default ログバケットの _AllLogs ビューのクエリ実行に必要な追加のロールについて詳しくは、Cloud Logging のロールをご覧ください。

  3. ログ分析を使用するようにアップグレードされたログバケットがあることを確認します。この手順については、ログバケットを構成するをご覧ください。

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

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

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

    [ログ分析] に移動

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

  2. [ログ分析] ページを構成します。
    1. ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
    2. [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して [ビューとスキーマ] をクリックします。

  3. アナリティクス ビューとして保存するクエリを入力して検証します。

    アナリティクス ビューがクエリするログビューのデフォルトのクエリを読み込んで編集することがあります。デフォルト クエリを読み込む手順は次のとおりです。

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

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

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

    3. クエリ結果に満足するまで、クエリを更新します。

  4. 分析ビューを作成します。

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

    2. アナリティクス ビューの名前と説明を入力します。

      名前は 100 文字に制限され、英字、数字、アンダースコア、ハイフンのみを使用できます。アナリティクス ビューの作成後に名前を変更することはできません。

    3. [保存] をクリックします。

    アナリティクス ビューが作成され、[ アナリティクス ビュー] セクションの [ビュー] ペインに表示されます。

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

アナリティクス ビューのクエリは、ログビューのクエリと同様の方法で行います。分析ビューをクエリするには、FROM 句で次の形式を使用します。

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

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

  • PROJECT_ID: プロジェクトの ID。
  • LOCATION: アナリティクス ビューのロケーション。
  • ANALYTICS_VIEW_ID: 分析ビューの ID。100 文字以内で、使用できるのは英字、数字、アンダースコア、ハイフンのみです。

詳細については、ログのクエリと分析の概要をご覧ください。

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

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

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

    [ログ分析] に移動

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

  2. [ログ分析] ページを構成します。
    1. ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
    2. [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して [ビューとスキーマ] をクリックします。

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

分析ビューの詳細を取得する

[スキーマ] ペインのオプションを使用すると、アナリティクス ビューに関する次の情報を表示できます。

  • 名前。
  • 作成日。
  • 最終更新。
  • Schema.
  • Query.

アナリティクス ビューの詳細を表示するには、プロジェクト内のアナリティクス ビューを一覧表示してから、次の操作を行います。

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

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

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

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

    [ログ分析] に移動

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

  2. [ログ分析] ページを構成します。
    1. ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
    2. [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して [ビューとスキーマ] をクリックします。

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

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

  5. 変更が完了したら、[保存したビューを上書き] をクリックします。

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

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

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

    [ログ分析] に移動

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

  2. [ログ分析] ページを構成します。
    1. ツールバーに [クエリを実行] が表示されていることを確認します。ツールバーに [BigQuery で実行] と表示されている場合は、[ 設定] をクリックして、[ログ分析(デフォルト)] を選択します。
    2. [ビュー] メニューが表示されていない場合は、ナビゲーション ペインに移動して [ビューとスキーマ] をクリックします。

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

制限事項

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

  • 分析ビューでクエリできるのはログビューのみです。
  • 分析ビューの親リソースは Google Cloud プロジェクトである必要があります。
  • 分析ビューをクエリできるのは、[ログ分析] ページを使用する場合のみです。また、[ログ分析(デフォルト)] クエリエンジンを使用する場合のみです。
  • アナリティクス ビューがクエリするすべてのビューは、同じロケーションに存在する必要があります。
  • 分析ビューを作成または管理するには、 Google Cloud コンソールを使用する必要があります。
  • Google Cloud プロジェクトあたり最大 100 個の分析ビューを作成できます。
  • リージョンごとに最大 50 個のアナリティクス ビューを作成できます。
  • 1 つの Google Cloud プロジェクトで分析ビューを含めることができるリージョンは最大 10 個です。

次のステップ