使用量ベースの料金 Looker イベントの定義

このページでは、Looker（Google Cloud コア）の従量課金制モデルで使用される主な使用量指標である Looker イベントのコンセプトについて説明します。

注: 消費量ベースの料金設定のコンテキストにおける Looker イベントは、クエリタスクの実行を表します。これらは、Looker サーバーによって生成される管理ログとユーザー監査ログ（create_dashboard、login、delete_user など）であるシステム アクティビティの Looker イベントとは異なります。

Looker イベントとは

Looker イベントは、Looker（Google Cloud コア）インスタンスの使用量の測定単位です。これは、Looker がセマンティック レイヤからクエリを生成し、ビジネスデータを取得して、エンドユーザー向けにそのデータに変換または視覚的なコンテキストを適用する価値を表します。

内部的には、各 Looker イベントはクエリタスクの実行にマッピングされます。

クエリタスクの定義

クエリタスクは、クエリの開始元に関係なく、クエリ オペレーションの内部表現です。クエリタスクの例を次に示します。

• Looker Explore またはセルフサービス Explore でクエリを実行する
• ダッシュボードまたは Look のタイルを更新する
• Explore、Look、またはダッシュボード タイルの PDF を作成する
• Looker API を使用してプログラムによるリクエストとして実行されるクエリ、または結果をマージした Explore の一部として実行されるセカンダリ クエリ
• Looker のスケジューラまたはアラートを使用する自動データ配信

これらの各タスクは 1 つの Looker イベントを表します。たとえば、10 個のタイルを含むダッシュボードを更新すると、10 個のクエリタスクが生成され、10 個の課金対象の Looker イベントが発生します。

1 つのクエリタスクは、クエリ オペレーションの全期間（クエリが開始されてから結果が開始元にストリーミングされるまで）をカバーします。

使用量ベースの料金設定にクエリタスクが使用される理由

クエリタスクは、次のようないくつかの理由から、Looker で顧客価値とシステム リソースの使用量の両方を測定するのに適しています。

• コアバリューの表現: Looker のすべてのコア機能（ダッシュボード、自動アラート、スケジュール設定されたレポート、視覚的なデータ探索など）は、最終的にクエリを実行します。クエリタスクは、この価値創出アクティビティを直接反映します。
• 包括的なカバレッジ: この指標にはギャップがありません。クエリタスクは、リクエストの開始方法（ユーザー インターフェース、API の使用、スケジュールされた配信など）に関係なく、実行されるすべてのクエリに対して生成されます。
• 正規化された値: クエリタスク指標は、結果がデータベースから取得されたか、内部 Looker キャッシュから提供されたかに関係なく、データ取得の値を正規化します。
• 一貫した測定: API エンドポイント（スコープ設定の有無によってシステム使用率が異なる可能性がある）とは異なり、クエリタスクはすべてのアクティビティで一貫した測定単位を提供します。

請求対象外のクエリタスク

インスタンスの健全なパフォーマンスを確保し、明確で公平なユーザー エクスペリエンスを提供するため、特定のタイプのクエリタスクは課金パイプラインから除外されます。次のクエリタスクで生成された Looker イベントは課金対象外です。

1. システム アクティビティ クエリ: 内部計測モデルに対して実行され、Looker のモニタリング、使用状況レポート、システム アクティビティ（helltool で使用される internal_model 構成）を強化するクエリ。これにより、管理者は、課金またはガバナンスの制限を超えた場合でも、パフォーマンスとテレメトリー情報（Elite System Activity（ESA）など）に常にアクセスできます。
2. 候補クエリ: ユーザーがフィルタ テキスト フィールドに入力したときに、フィルタ候補を生成するためにデータベースに送信される自動クエリ。これらは顧客に直接的なスタンドアロンの価値をもたらすものではないため、課金対象から除外されます。
3. 永続的な派生テーブル（PDT）のクエリ実行: PDT のビルドまたは再ビルドのために実行されるクエリ。PDT はユーザー エクスペリエンスの向上に推奨されるパフォーマンス最適化ツールであるため、PDT の再構築コマンドは、その使用を妨げないように、また標準クエリの実行中にインラインでトリガーされる可能性もあるため、別途課金されません。
4. PDF プリレンダリング クエリ: PDF ドキュメントの生成中にキャッシュにデータを入力するクエリを実行するタスク。PDF の印刷では、タイルごとに 2 つのクエリがトリガーされます（1 つは結果をキャッシュに保存するため、もう 1 つはキャッシュからレンダリングするため）。最終的なキャッシュ読み取りクエリのみが課金対象のイベントとしてカウントされ、事前入力クエリは除外されます。

5. 成功しなかったクエリ: ユーザーに結果を返せなかったクエリタスク。このタスクは、COMPLETE 以外のステータスを返すデータベース クエリを対象としています。たとえば、次のようなクエリです。

   • ERROR
   • KILLED
   • CACHE_ONLY_MISS
   • REJECTED（ガバナンス拒否）

キャッシュ ヒットを含む他のすべてのクエリタスクは、Looker インスタンスで処理されるクエリ トラフィックを適切に反映するために、引き続き課金対象となります。