使用 i__looker 创建 Looker 使用情况和元数据报告

Looker 管理员和已被授予 see_system_activity 权限的用户可以访问实例的使用情况面板,该面板可直接连接到 Looker 的底层应用数据库,名为 i__lookeri__looker 数据库会存储有关 Looker 实例的信息,包括实例中保存的所有 Looks 和信息中心、用户信息以及 90 天的历史查询:

本页介绍了 i__looker 中最常用的探索,并提供了一些常见用法示例。此功能可用于审核和监控。

SQL 文本以及用户运行的过滤器中的文本可在 i__looker 中访问,并且任何有权查看 i__looker 模型的用户均可查看。

采取行动:修改对 i__looker 模型拥有查看权限的用户。默认情况下,Looker 的管理员有权访问“i__looker”。非管理员用户可以获得 i__looker 的访问权限(如果他们获得 see_system_activity 权限)。

Chat 团队提示i__looker 中基于时间的数据存储在 Looker 系统时区中。如需了解详情,请参阅使用时区设置页面。

探索历史

“历史记录探索”包含过去 90 天内在您的 Looker 实例上运行的每个查询的相关信息。

您可以访问以下网址中的历史记录探索,将 <instance_name.looker.com> 替换为 Looker 实例的地址:

https://<instance_name.looker.com>/explore/i__looker/history

“历史记录探索”可用作管理页面上的查询面板的更详细版本。该面板包含查询面板上的所有信息,但比最近的 50 个查询更详细,并且包含有关用户、角色、群组等的更多信息。

历史探索不是

“历史记录探索”包含名为外观信息中心用户的视图。这些视图不会列出您实例中的所有外观、信息中心和用户。这些视图会列出过去 90 天内访问过或处于有效状态的样式、信息中心和用户。如需查看外观、信息中心或用户的完整列表,请使用本页下文所述的“探索”。

“历史记录”表被截断

由于“历史记录”表的大小可能会快速增加,因此 Looker 会自动删除符合以下任一条件的记录:

  • history.created_time 距今已超过 90 天。
  • history.created_time 距今已超过 7 天,history.sourcescheduled_task

“历史记录探索”中的实用字段

“历史记录探索”中有许多字段。下面是一些最常用的字段:

  • history.source:查询的来源,例如已保存的外观、信息中心、探索、计划任务、API 等。

  • history.created_time:历史记录探索中的事件创建日期和时间。每个事件都与 Looker 中的查询相关联。查询来自“探索”页面、信息中心、Looks、API 调用和预定事件。

  • history.result_source:查询结果是从缓存中返回,还是从数据库作为新查询返回。

  • history.runtime_in_seconds:查询运行的时间。这包括查询的构造、查询在队列中的任何时间、与数据库之间来回传输以及查询的数据库执行。

  • query.model:与查询相关联的 LookML 模型。

  • query.explore:与查询相关联的 LookML 探索。

  • query.sql_text:为查询运行的实际 SQL。

示例

以下是历史记录探索的一些常见用途。请注意,您必须将网址开头的 <instance_name.looker.com> 替换为 Looker 实例的地址,才能使这些链接生效。

我的实例中不同模型的平均运行时数是多少?

此“探索”会列出过去 90 天内查询的每个模型,并显示过去 90 天内基于这些模型的查询的平均运行时:

https://<instance_name.looker.com>/explore/i__looker/history?fields=query.model,history.average_runtime&f[history.result_source]=query&sorts=history.average_runtime+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22history.result_source%22%3A%5B%7B%22type%22%3A%22%3D%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22query%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

“探索”功能会列出过去 90 天内访问的每个信息中心的标题,以及每个信息中心被访问的次数。

https://<instance_name.looker.com>/explore/i__looker/history?fields=dashboard.title,history.query_run_count&f[dashboard.title]=-NULL&sorts=history.query_run_count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.title%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

此“探索”显示过去 90 天内实例中的每个角色运行探索的次数:

https://<instance_name.looker.com>/explore/i__looker/history?fields=history.query_run_count,query.view,role.name&pivots=role.name&f[role.name]=-NULL&sorts=history.query_run_count+desc+0&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22role.name%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

有人在过去 90 天内查询特定的“探索”吗?

您可以使用历史记录探索功能来确定过去 90 天内是否使用了某个特定的“探索”功能:

  1. 选择字段 history.created_datequery.explorequery.link
  2. 按“query.explore”过滤,输入“探索”的名称。
  3. 点击运行

过去 90 天内是否有人使用过特定视图中的字段?

您可以使用“历史记录探索”功能来确定特定数据视图中是否有任何字段在过去 90 天内使用过:

  1. 选择字段 history.created_datequery.explorequery.link
  2. query.fields_used 过滤,输入视图名称,后跟英文句点(例如 orders.),然后选择包含作为过滤条件。过滤器中的时间段可确保您只返回该视图中的字段,而不是来自命名类似的视图的字段。
  3. 点击运行

Look Look 探索

Look Discover 包含 Looker 实例上所有已保存的 Look 的相关信息,例如:

  • 外观是由谁创建的以及何时创建
  • 构成 Look 的字段
  • 存储 Looks 的文件夹

您可以通过以下网址访问 Look Finder,将 <instance_name.looker.com> 替换为 Looker 实例的地址:

https://<instance_name.looker.com>/explore/i__looker/look

Look Discover 中的实用字段

Look Look 中一些最常用的字段包括:

  • look.created_date:创建 Look 的日期。

  • look.deleted_date:删除样式的日期。如果 Look 未删除,则此字段将为 NULL。

  • look.public:样式是否已公开。

  • look.public_slugLook 网址 的哈希部分。

  • query.link:指向“探索”底层的“探索”的链接。

  • space.name:存储 Look 的文件夹的名称。

示例

以下是 Look Discover 的一些常见用途。请注意,您必须将网址开头的 <instance_name.looker.com> 替换为 Looker 实例的地址,才能使这些链接生效。

公开样式有多少种?

此“探索”会列出您的实例中已公开的所有 Looks:

https://<instance_name.looker.com>/explore/i__looker/look?fields=look.id,look.title,look.link&f[look.public]=Yes&sorts=look.title&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.public%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

哪些样式已被删除?

此“探索”会列出所有已删除的 Looks:

https://<instance_name.looker.com>/explore/i__looker/look?fields=look.id,look.title,look.link,look.deleted_date&f[look.deleted_date]=NOT+NULL&sorts=look.title&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.deleted_date%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%227%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

我的样式保存在哪些文件夹中?

此“探索”会列出您的所有样式,并按它们存储的文件夹排序:

https://<instance_name.looker.com>/explore/i__looker/look?fields=space.name,look.id,look.title,look.link&f[look.deleted_date]=NOT+NULL&sorts=space.name+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.deleted_date%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%227%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

信息中心探索

“信息中心探索”包含与您的 Looker 实例中保存的每个信息中心相关的信息。与 Look Look 类似,您可以查找信息中心的相关信息,例如创建者、创建时间以及文件夹。您还可以找到有关信息中心设置和元素的信息。

您可以通过以下网址访问信息中心的探索功能,请将 <instance_name.looker.com> 替换为 Looker 实例的地址:

https://<instance_name.looker.com>/explore/i__looker/dashboard

“信息中心”探索中的实用字段

“信息中心探索”中的字段与“探索”功能类似。除了这些字段之外,下面还有一些“探索”工具经常使用的字段:

  • dashboard.refresh_interval:如果信息中心启用了自动刷新,信息中心将多久刷新一次。

  • dashboard.run_on_load:信息中心上是否启用了在加载时运行

示例

以下是“信息中心探索”的一些常见用途。您必须将网址开头的 <instance_name.looker.com> 替换为 Looker 实例的地址,才能使这些链接生效。

加载时运行多少个信息中心?

此“探索”会显示您的实例中有多少信息中心配置为在加载时运行

https://<instance_name.looker.com>/explore/i__looker/dashboard?fields=dashboard.count&f[dashboard.run_on_load]=Yes&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.run_on_load%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%7D%5D%7D&origin=share-expanded

有多少个经常更新的信息中心?

加载时运行类似,如果您有频繁频繁刷新的信息中心,自动刷新设置可能会影响 Looker 的性能。此“探索”部分会显示设置为自动刷新的信息中心数量,以及每个时间间隔内刷新多少次:

https://<instance_name.looker.com>/explore/i__looker/dashboard?fields=dashboard.refresh_interval,dashboard.count&f[dashboard.refresh_interval]=-NULL&sorts=dashboard.count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.refresh_interval%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

用户探索

用户探索包含有关 Looker 实例上的每位用户的信息。其中包括如下信息:

  • 用户 API 凭据

  • 用户群组

  • 分配给用户的角色、权限和权限集

  • 用户详细信息和设置,例如名称、ID 以及实例上是否已启用用户

您可以通过以下网址访问用户探索,请将 <instance_name.looker.com> 替换为 Looker 实例的地址:

https://<instance_name.looker.com>/explore/i__looker/user

用户探索中的实用字段

“用户探索”中的一些常用字段包括:

  • group.name:用户所属的群组的名称

  • permission_set.permissions:向用户授予的权限列表

  • role.name:分配给用户的角色

  • user.dev_mode:用户当前是否处于开发模式

  • user.is_disabled:是否已在 Looker 实例上停用用户

  • user.edit_link:链接到 Looker 中的页面,您可以在其中修改用户信息

  • role.edit_link:链接到 Looker 中的页面,您可以在该页面中修改分配给用户的角色信息

  • group.edit_link:链接到 Looker 中的页面,您可以在该页面中修改用户拥有的一组群组

示例

以下是用户探索的一些常见用途。请注意,您必须将网址开头的 <instance_name.looker.com> 替换为 Looker 实例的地址,才能使这些链接生效。

哪些用户的访问权限已被停用?

此“探索”页面列出了已撤消访问权限的所有用户:

https://<instance_name.looker.com>/explore/i__looker/user?fields=user.name&f[user.is_disabled]=Yes&sorts=user.name&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22user.is_disabled%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%7D%5D%7D&origin=share-expanded

哪些用户拥有特定权限?

此“探索”会列出您的实例中具有 develop 权限的所有用户:

https://<instance_name.looker.com>/explore/i__looker/user?fields=user.name&f[permission_set.permissions]=%25develop%25&sorts=user.name&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22permission_set.permissions%22%3A%5B%7B%22type%22%3A%22contains%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22develop%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

我的实例上每个角色有多少用户?

此“探索”会统计实例上每个角色的活跃用户数。请注意,用户可以分配多个角色。例如,如果某个用户同时具有“开发者”角色和“管理员”角色,该用户将被计为两次:

https://<instance_name.looker.com>/explore/i__looker/user?fields=role.name,user.count&f[user.is_disabled]=No&sorts=user.count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22user.is_disabled%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22No%22%7D%2C%7B%7D%5D%2C%22id%22%3A2%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded