[使用状況] ページは Looker で作成されたダッシュボードで、Looker インスタンスに関する使用状況情報を表示します。管理者はこのデータを使用して、ユーザーがアプリケーションをどのように利用しているかをより詳細に把握できます。[使用状況] ページを表示するには、[管理者] メニューの [サーバー] セクションで [使用状況] を選択します。
使用状況ダッシュボード
[Server] セクションの [管理パネル] から、[Usage] ダッシュボードにアクセスします。
その他のダッシュボードと同様に、[Usage] ダッシュボードのダウンロードまたはスケジュールが可能です。
[Usage] ダッシュボードのデータポイントをドリルダウンすることもできます。
ソースによるクエリタイル
[ソースによるクエリ] タイルは [使用状況] ページの上部にあり、Looker 内のさまざまなソースから実行されるクエリの数に関する情報が含まれています。考えられるソースは次のとおりです。
- API(バージョン番号): インスタンスの Looker API から送信されたクエリ。
- ダッシュボード: ダッシュボードに表示されるタイルに関連するクエリ。
- ダッシュボード プリフェッチ: ダッシュボードを事前に実行するための API からのクエリ。
- Explore: 実行中の Explore に関連付けられたクエリ。
- その他: 他のカテゴリに当てはまらないソースからのクエリ。
- 非公開埋め込み: 限定公開埋め込みコンテキストによって開始されたクエリ。
- 公開埋め込み: 公開 URL 経由でアクセスされるコンテンツから実行されたクエリ。
- クエリ:
source_queryの略。Looker の内部データベースによって生成されるクエリ。 - レンダラ: スケジュール設定されたアイテムとダウンロード用の画像(.png と .pdf)の生成に関連するクエリ。
- SQL Runner: SQL Runner で直接実行されるクエリ。
- 保存された Look: Look に関連付けられたクエリ。
- スケジュールされたタスク: Looker が配信用の Look またはダッシュボードを生成するときに実行するクエリ。
- フィルタを提案: 候補を生成するフィルタをユーザーがクリックしたときに生成されるクエリ。この場合、Looker はフィルタされたフィールドに対して
SELECT DISTINCTを実行し、ユーザーに表示する候補を見つけます。
SQL クエリのコンテキスト コメント
Lookerは各SQLクエリの先頭に一意のコメントが追加します。 コメントは、Explore、SQL Runner、API、フィルタ候補のクエリに追加されます。コンテキスト コメントは自動的に含まれます。
コンテキスト コメントは次の形式で追加されます。
-- 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 のほとんどの場所([クエリ] ページやシステム アクティビティ)で、追加されたコメントを表示できないことも意味します。
代わりに、これらのコメントはデータベース クエリログに表示されます。