[使用状況] ページは Looker で作成されたダッシュボードで、Looker インスタンスに関する使用状況情報を表示します。管理者はこのデータを使用して、ユーザーがアプリケーションを利用する方法をより深く理解できます。[使用状況] ページを表示するには、[管理者] メニューの [サーバー] セクションで [使用状況] を選択します。
使用状況ダッシュボード
[Server] セクションの [Admin] パネルから、[Usage] ダッシュボードにアクセスします。
その他のダッシュボードと同様に、[Usage] ダッシュボードのダウンロードまたはスケジュールが可能です。
[Usage] ダッシュボードのデータポイントをドリルダウンすることもできます。
ソースタイルによるクエリ
[ソースによるクエリ] タイルは [使用状況] ページの上部にあり、Looker 内のさまざまなソースから実行されるクエリの数に関する情報が含まれています。考えられるソースは次のとおりです。
- API(バージョン番号): Looker API からインスタンスに対するクエリ。
- ダッシュボード: ダッシュボードに表示されるタイルに関連するクエリ。
- ダッシュボードのプリフェッチ: ダッシュボードを事前実行するための API からのクエリ。
- Explore: Explore の実行に関連するクエリ。
- その他: 他のカテゴリに該当しないソースからのクエリ。
- 非公開埋め込み: 非公開埋め込みコンテキストによって開始されたクエリ。
- 公開埋め込み: 公開 URL 経由でアクセスされるコンテンツから実行されたクエリ。
- クエリ:
source_query
の略。Looker の内部 i__looker データベースによって生成されたクエリ。 - レンダラ: スケジュールされたアイテムとダウンロードの画像(.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 は、[Admin] メニューの [Users] ページにあるユーザー ID と照合できます。history_slug
: Looker インスタンスによりデータベース上で実行される各クエリの一意の識別子。instance_slug
: クエリを発行した Looker インスタンスの ID 番号。必要に応じ、Looker のサポートはこの情報を使用してトラブルシューティングを支援できます。
コンテキスト コメントは、SQL がデータベースに送信される直前に SQL コマンドの送信に追加されます。これにより、コメントが Looker クエリのキャッシュに影響を与えなくなります。また、これは、Looker のほとんどの場所([クエリ] ページや i__looker)で、追加されたコメントを表示できないことも意味します。
代わりに、これらのコメントはデータベース クエリログで確認できます。