管理者設定 - 使用状況

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

使用状況ダッシュボード

[Server] セクションの [Admin] パネルから、[Usage] ダッシュボードにアクセスします。

その他のダッシュボードと同様に、[Usage] ダッシュボードのダウンロードまたはスケジュールが可能です。

[Usage] ダッシュボードのデータポイントをドリルダウンすることもできます。

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

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

  • API（バージョン番号）: インスタンスの Looker API から送信されたクエリ。
  • ダッシュボード: ダッシュボードに表示されているタイルに関連するクエリ。
  • ダッシュボード プリフェッチ: ダッシュボードを事前に実行するための API からのクエリ。
  • Explore: Explore の実行に関連付けられたクエリ。
  • その他: 他のカテゴリに該当しないソースからのクエリ。
  • 非公開埋め込み: 限定公開埋め込みコンテキストによって開始されたクエリ。
  • 公開埋め込み: 公開 URL 経由でアクセスされるコンテンツから実行されたクエリ。
  • クエリ: source_query の略。Looker の内部 i__looker データベースによって生成されるクエリ。
  • Renderer: スケジュール設定されたアイテムとダウンロードの画像（.png と .pdf）の生成に関連するクエリ。
  • SQL Runner: SQL Runner で直接実行されるクエリ。
  • 保存された Look: Look に関連付けられたクエリ。
  • スケジュール指定タスク: 配信用の Look またはダッシュボードを生成するときに Looker によって実行されるクエリ。
  • フィルタを提案: 候補を生成するフィルタをユーザーがクリックしたときに生成されるクエリ。この場合、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 は、[Admin] メニューの [Users] ページにあるユーザー ID と照合できます。

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

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

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

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