使用情况页面是 Looker 创建的信息中心,其中显示了 Looker 实例的使用情况信息。管理员可以利用这些数据更好地了解用户如何使用该应用。如需查看使用情况页面,请在管理菜单的服务器部分中选择使用情况。
用量信息中心
通过服务器部分下的管理面板访问使用情况信息中心。
您可以像下载或安排其他任何信息中心一样,下载或安排使用情况信息中心。
您还可以深入分析使用情况信息中心内的数据点。
“按来源划分的查询”板块
位于使用情况页面顶部的按来源查询图块包含有关在 Looker 中从不同来源运行的查询数量的信息。可能的原因如下:
- API(版本号):来自相应实例的 Looker API 的查询。
- 信息中心:与信息中心内显示的图块相关的查询。
- 信息中心预取:来自 API 的查询,用于预先运行信息中心。
- 探索:与运行探索相关的查询。
- 其他:不属于任何其他类别的来源的查询。
- 私密嵌入:由私密嵌入上下文发起的查询。
- 公开嵌入:通过公开网址访问的内容运行的查询。
- 查询:
source_query
的简称,由 Looker 的内部数据库生成的查询。 - 渲染器:与为预定项目和下载内容生成图片(.png 和 .pdf)相关的查询。
- SQL Runner:直接在 SQL Runner 中运行的查询。
- 已保存的 Look:与 Look 关联的查询。
- 预定任务:Looker 在生成 Look 或信息中心以进行交付时运行的查询。
- 建议过滤条件:用户点击生成建议的过滤条件时生成的查询。在这种情况下,Looker 会对过滤后的字段运行
SELECT DISTINCT
,以查找要向用户显示的建议。
SQL 查询的上下文注释
Looker 会在每条 SQL 查询的开头添加一条唯一注释。这些注释会添加到来自以下位置的查询中:探索、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 命令中。这样可以防止注释影响 Looker 查询的缓存,但也意味着您无法在 Looker 中的大多数位置(例如查询页面或系统活动)中看到添加的注释。
不过,您会在数据库查询日志中看到这些注释。