Usage

[Usage] ページは Looker が作成したダッシュボードであり、Looker インスタンスに関する使用状況の情報が表示されます。管理者はデータを使用して、ユーザーがどのようにアプリケーションを使用しているかを詳しく把握できます。[使用状況] ページを表示するには、[管理] メニューの [サーバー] セクションで [使用状況] を選択します。

i__looker モデル

[使用状況] パネルの情報はすべて、i__looker という LookML モデルに基づいています。このモデルを理解すると、Looker インスタンスの使用状況や保存済み Look やダッシュボードに関する情報について、便利なカスタム レポートを作成できます。詳しくは、i__looker を使用した Looker の使用状況とメタデータのレポートの作成に関するドキュメントをご覧ください。

使用状況ダッシュボード

使用状況ダッシュボードには、Looker の [管理] ページからアクセスできます。

使用状況ダッシュボードは、他のダッシュボードと同様にダウンロードしたり、スケジュールを設定したりできます。

また、他のダッシュボードと同様に、指標と要素の詳細を確認することもできます。

ソースタイルによるクエリ

[使用状況] ページの上部にある [クエリ元] タイルには、Looker 内のさまざまなソースから実行されたクエリの数に関する情報が表示されます。考えられるソースは次のとおりです。

  • API（バージョン番号）: インスタンスの Looker API から送信されたクエリ。
  • ダッシュボード: ダッシュボードに表示されるタイルに関連するクエリ。
  • ダッシュボードのプリフェッチ: API からクエリを実行してダッシュボードを事前実行します。
  • Explore: 実行中の Explore に関連するクエリ。
  • その他: 他のカテゴリに分類されないクエリ。
  • プライベート埋め込み: プライベート埋め込みコンテキストによって開始されたクエリ。
  • 一般公開の埋め込み: 公開 URL を介してアクセスしたコンテンツからクエリが実行されます。
  • クエリ: source_query（Looker 内部の i__looker データベースで生成されたクエリ）の略です。
  • Renderer: スケジュールされたアイテムとダウンロードの画像（.png と .pdf）の生成に関するクエリ。
  • SQL Runner: SQL Runner で直接実行されるクエリ。
  • 保存済みの Look: Look に関連付けられているクエリ。
  • スケジュールされたタスク: Looker が Look またはダッシュボードを生成して配信時に実行するクエリ。
  • 候補のフィルタ: 候補を生成するフィルタをユーザーがクリックしたときに生成されるクエリ。この場合、Looker はフィルタされたフィールドで SELECT DISTINCT を実行し、ユーザーに提示する候補を見つけます。

SQL クエリのコンテキスト コメント

Looker では、各 SQL クエリの先頭に一意のコメントが追加されます。コメントは、Explore、SQL Runner、API、フィルタの候補からのクエリに追加されます。コンテキスト コメントは自動的に含まれます。

Google BigQuery 接続のコンテキスト コメントは、デフォルトで無効になっています。これは、Google BigQuery のキャッシュ機能が無効になり、キャッシュのパフォーマンスに悪影響が及ぶ可能性があるためです。BigQuery 接続のコンテキスト コメントを有効にするには、接続の接続設定ページで、コンテキスト コメントの無効化設定の選択を解除します。詳細については、Google BigQuery のドキュメント ページをご覧ください。

コンテキスト コメントは次の形式で追加されます。

-- Looker Query Context '{ "user_id":<user ID>,"history_slug":<history slug>,"instance_slug":"<Looker instance number>}'

コメントには次の情報が含まれます。

  • user_id: Looker インスタンス上の各ユーザーの一意の識別子。[管理] メニューの [ユーザー] ページで、このユーザー ID をユーザー ID と照合できます。

  • history_slug: Looker インスタンスによってデータベースで実行される各クエリの一意の識別子。

  • instance_slug: クエリを発行した Looker インスタンスの ID 番号。必要に応じ、Lookerのサポートはこの情報を使用して、トラブルシューティングを支援できます。

SQL がデータベースに送信される直前に、コンテキスト SQL が送信 SQL コマンドに追加されます。コメントは Looker クエリのキャッシュに影響しませんが、Looker のほとんどの場所（[クエリ] ページや i__looker など）では、追加されたコメントを表示できません。

代わりに、これらのコメントがデータベースのクエリログに表示されます。