Looker 管理员和已获得 see_system_activity
权限的用户可以在探索菜单中访问 Looker 的系统活动探索。
系统活动探索会连接到 Looker 的底层应用数据库。它们会显示您的 Looker 实例的相关信息,包括实例中保存的 Look 和信息中心、用户信息、历史查询信息以及实例性能统计信息。系统活动数据的粒度和保留度都受系统限制。“系统活动”旨在收集大量数据,而汇总数据可用于对业务日志进行补充。
默认情况下,系统活动数据存储在 Looker 的内部数据库中。为符合存储限制,系统会定期截断大多数表。例如,“历史记录”表格会被截断为过去 90 天的数据。部分表的数据保留政策更为严格。如要延长数据保留期,请考虑使用 Elite System Activity。
无法使用 SQL Runner 查询系统活动数据,因为 Looker 内部数据库的权限有限。
系统活动探索
以下是系统活动探索:
探索名称 | 说明 | 缓存时长 |
---|---|---|
内容使用 | 有关 Look 和信息中心使用情况的数据,包括查看频率、收藏、时间安排、嵌入,以及通过 API 访问数据。此外,还包括有关各个 Look 和信息中心的详细信息。 | 12 小时 |
数据库连接 | 有关数据库连接的详细信息。包含有关有权访问数据库连接的用户的信息。 | 1 小时 |
信息中心 | 有关所有信息中心和信息中心元素的详细信息。包含与信息中心关联的 Look、查询、角色、用户和文件夹的相关信息。 | 12 小时 |
信息中心性能 | 有关信息中心的性能和历史数据。 | 1 小时 |
事件 | Looker 中历史事件的相关信息,包括每个事件的名称、类型和频率。包括与事件关联的群组和用户的相关信息。 | 1 小时 |
事件属性 | 构成事件的属性的相关信息。包含 Event 探索中的数据,并添加属性信息。 | 12 小时 |
字段使用 | LookML 字段和使用次数。 | 1 小时 |
文件夹 | 有关所有文件夹、每个文件夹中存储的内容以及每个文件夹的创建者的信息。 | 1 小时 |
实体组 | 群组列表和关于这些群组的详细信息,包括父级群组和子级群组,以及属于每个群组的用户和角色。 | 1 小时 |
历史记录 | 过去 90 天内运行的所有查询的详细信息。 | 12 小时 |
Look | 所有 Look 的详细信息。包含与 Look 关联的信息中心、查询、用户和文件夹的相关信息。 | 12 小时 |
合并查询 | 有关合并查询的信息,包括源查询和合并查询的字段和其他元素。 | 1 小时 |
PDT build | 有关 PDT 构建的详细信息,包括完成构建所花费的时间,以及 PDT 所属的连接和模型。 | 1 小时 |
PDT 事件日志 | 与 PDT 相关的历史事件的信息,包括 PDT 重建和错误。如需详细了解如何查看和了解 PDT 日志操作及其对应的操作数据,请参阅了解 PDT 日志操作文档页面。 | 12 小时 |
查询性能指标 | 从 Looker 实例运行的查询的细分数据。 | 1 小时 |
角色 | Looker 角色以及构成这些角色的模型和权限集。 | 1 小时 |
SQL 查询 | 已运行的 SQL 查询,包括最近的运行频率和频率,以及运行这些查询的用户的详细信息。 | 1 小时 |
已安排的方案 | 有关所有预定数据交付的信息,包括之前预定的作业和当前预定作业。包含与预定的数据传送相关的信息中心、Look、查询、文件夹和用户的相关数据。 | 12 小时 |
用户 | 每个用户的详细信息,包括运行的历史查询,以及他们有权访问的内容和文件夹。 | 12 小时 |
请参阅本页面上的使用系统活动探索部分,了解内容使用情况、信息中心、事件、事件属性、历史记录、Look、合并查询、PDT build、查询、查询、查询的一些常见示例。
使用系统 Activity 探索
以下示例说明了如何使用系统 Activity 中的一些探索,以及一些常见问题的解答。您可以通过将示例网址中的 <instance_name.looker.com>
替换为 Looker 实例的地址来访问本部分中的示例“探索”。
API 用法
API 使用情况探索提供对 Looker 实例进行的 API 调用量的摘要。
您可以使用 API 使用情况中的“探索”部分来回答如下问题:
如何对 API 调用进行每日审核?
您可以使用 API 使用情况探索来检索任意给定时间段内在您的实例上执行的所有 API 调用的列表。如需查看特定日期拨打了哪些电话,请执行以下操作:
- 从 API 使用情况中选择端点。
- 从 API 用量中选择 Total Usage。
- 根据所需日期,根据 API 使用情况对创建日期进行过滤。
https://<instance_name.looker.com>/explore/system__activity/api_usage?fields=api_usage.endpoint,api_usage.total_usage&f[api_usage.created_date]=yesterday&sorts=api_usage.total_usage+desc&limit=500&column_limit=50&vis=%7B%7D&filter_config=%7B%22api_usage.created_date%22%3A%5B%7B%22type%22%3A%22advanced%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22yesterday%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A5%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded
如需详细了解每个 API 调用的用途,请参阅 Looker API 参考文档或 Looker API Explorer。
今年,我的实例上执行了多少次 API 调用?
您可以使用 API 使用情况探索来汇总任何时间范围内的 API 调用次数。例如,您可以创建一个显示每月 API 调用次数的年度报告:
- 从 API 使用情况中选择创建月份。
- 从 API 用量中选择 Total Usage。
- 根据所需年份的 API 使用情况对创建年份进行过滤。
https://<instance_name.looker.com>/explore/system__activity/api_usage?fields=api_usage.total_usage,api_usage.created_month&fill_fields=api_usage.created_month&f[api_usage.created_year]=last+year&sorts=api_usage.created_month+desc&limit=500&column_limit=50&vis=%7B%7D&filter_config=%7B%22api_usage.created_year%22%3A%5B%7B%22type%22%3A%22advanced%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22last+year%22%2C%22unit%22%3A%22yr%22%7D%2C%7B%7D%5D%2C%22id%22%3A6%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded
内容使用
“系统活动”中的内容使用情况“探索”部分提供了 Look 和信息中心使用情况的相关信息,包括查看频率、收藏、时间安排和通过 API 访问。还包括各个 Look 和信息中心的详细信息。
快速入门分析
内容使用情况“探索”部分包含快速入门分析,可帮助您快速回答问题或作为其他查询的起点。
在空白的“探索”界面中选择“快速开始”分析功能块,或者从已运行的“探索”中的闪电式快速入门菜单中选择“快速开始”分析功能块,Looker 会显示一个查询,其中包含预先选择和排序的字段,用于回答下列某个问题:
- 哪些内容收藏次数最多?
- 过去 3 天内访问过哪些内容?
- 哪些内容在过去 60 天内未被访问过?
- 使用 Looker API 最常访问哪些内容?
- 过去 7 天创建的信息中心的使用率最高?
- 过去 7 天内创建的哪些 Look 的使用率最高?
- 哪些棋盘被收藏次数最多?
- 哪些内容的观看次数最多?
热门 Look 和信息中心使用哪些过滤条件?
您可以使用内容使用情况探索来查找实例上最常用的 Look 或信息中心。然后,您可以使用历史记录探索功能来确定热门 Look 或信息中心使用的过滤条件。如需查找最热门的 Look 或信息中心,请执行以下操作:
- 在内容使用情况的“探索”中,从内容使用情况视图中选择内容 ID、内容标题和内容类型。
- 在内容使用情况视图中添加内容类型过滤条件,并将过滤条件值设置为
dashboard OR look
。 - 从内容使用情况中选择查看总计。您还可以在 Content Usage 视图中选择 Favorites Total、Schedule Total、API Total 和 Embed Total 等字段。
- 按查看总计对结果进行降序排序,最先列出最热门的内容。
- 您还可以在内容使用情况视图中的上次访问之后的天数字段中添加过滤条件,使数据仅显示特定时间段内的数据。例如,您可以将过滤条件值设置为
is less than 30
,从而仅查看过去 30 天的数据。
然后,您可以使用历史记录探索功能查找特定 Look 或信息中心中使用的过滤条件:
- 在历史记录探索中,按信息中心视图或 Look 视图中的 ID 字段进行过滤,然后输入您使用内容使用情况探索确定的信息中心或 Look 的 ID。
- 从查询视图中选择过滤条件,即可返回过滤的信息中心或 Look 使用的过滤条件列表。
信息中心
信息中心“探索”部分包含信息中心和信息中心元素(包括与信息中心关联的 Look、查询、角色、用户和文件夹)的详细信息。
快速入门分析
信息中心“探索”中包含快速入门分析,您可以利用它们快速回答问题或作为其他查询的起点。
在空白的“探索”界面中选择“快速开始”分析功能块,或者从已运行的“探索”中的闪电式快速入门菜单中选择“快速开始”分析功能块,Looker 会显示一个查询,其中包含预先选择和排序的字段,用于回答下列某个问题:
- 哪些信息中心使用多个探索?
- 哪些信息中心的自动刷新间隔较短?
- 有多少个信息中心设置为加载时运行?
- 哪些信息中心的板块超过 25 个?
- 哪些信息中心使用的合并查询最多?
- 哪些信息中心使用特定视图或字段?
- 哪些文件夹包含哪些信息中心?
- 各个仪表板由哪些板块构成?
事件
事件探索中包含 Looker 内历史事件的相关信息,包括每个事件的名称、类型和频率。此“探索”功能还包含与活动相关的群组和用户的相关信息。
以下是 Event 探索的一些常见用途:
如需详细了解如何查看事件和常见事件属性以及事件类型列表,请参阅 Looker 事件文档页面。
如何查找 API 请求并对其进行分类?
您可以使用活动“探索”页面查找系统发出的所有 API 请求,并将其归类:
- 从 Event 视图中选择 Name 和 Category 字段。
- 添加针对 Is API Call (Yes / No) 的过滤条件,并将过滤条件值设置为
Yes
。 - 您还可从事件中选择创建日期等字段,从用户中选择名称等字段,以了解特定 API 请求的相关信息。
https://<instance_name.looker.com>/explore/system__activity/event?fields=event.created_date,event.name,event.category,user.name&f[event.is_api_call]=Yes&sorts=event.name&limit=500
有没有办法调查内容更新?
您可以使用活动探索来调查内容更新,只需过滤出包含 update
一词的活动即可:
- 从事件视图中,选择名称。
- 在事件视图中为名称字段添加过滤条件,并将过滤条件值设置为
contains update
。 - 您还可以选择其他字段,以提供有关每项内容更新的更多信息,例如根据事件创建创建时间,以及从用户获取 ID。
https://<instance_name.looker.com>/explore/system__activity/event?fields=event.name,user.id,event.created_time&f[event.name]=%25update%25&sorts=event.created_time+desc&limit=500
如何查看登录事件?
您可以使用事件探索功能来确定哪些用户通过登录事件登录了系统。例如:
- 在事件视图中为名称字段添加过滤条件,并将过滤条件值设置为
login
。 - 从 User(用户)视图中选择 ID(ID)和 Name(名称)。
- 从事件视图中选择创建时间。
事件属性
事件属性探索包含事件探索中的数据,并提供了构成事件的属性的更多信息。
以下是“探索”事件属性的一些常见用法:
如需详细了解如何查看事件、常见事件属性和事件类型列表,请参阅 Looker 事件文档页面。
如何查看权限更改?
您可以使用事件属性“探索”来查看权限变化。例如,您可以查看权限的更改时间和更改者:
- 从事件视图中,选择创建时间和名称,了解更改时间和事件类型。
- 从“事件属性”中选择名称和值,即可返回所做更改的相关信息以及权限被更改的用户或具体权限已更改。
- 从用户中选择 ID 和任何其他所需字段,即可了解做出相应更改的用户的信息。
- 在事件视图中按名称进行过滤,并将值设置为
user_permission_elevation
。
https://<instance_name.looker.com>/explore/system__activity/event_attribute?fields=event.created_time,user.id,user.name,event_attribute.name,event_attribute.value&f[event.name]=%22user_permission_elevation%22&sorts=event.created_time+desc&limit=500
如何跟踪实验室功能的打开时间?
您可以使用事件属性“探索”来跟踪实验室功能的启用情况。例如,选择以下字段:
- 从事件字段中选择创建时间。
- 从事件属性字段中选择名称和值。
- 根据事件中的名称添加过滤条件,并将过滤条件值设置为
update_labs_feature
。 - 您还可以添加用户的 ID 或姓名等字段,以查看启用了实验室功能的用户的相关信息。
在此示例中,当“事件属性”的“名称”的值为 labs_feature_id
时,“事件属性”的“值”字段中会显示已启用或停用的实验室功能的名称。如果“事件属性”的“名称”的值为 labs_feature_value
,则值为 true
和 false
表示实验室功能是否已启用。
https://<instance_name.looker.com>/explore/system__activity/event_attribute?fields=event.created_time,event_attribute.name,event_attribute.value,user.id&f[event.name]=%22update_labs_feature%22&sorts=event.created_time+desc&limit=500
项目名称是何时更改的?
您可以使用事件属性“探索”来查看项目名称的更改时间:
- 从事件视图中,选择创建时间和名称。
- 从事件属性中选择名称和值。
- 在事件视图中添加名称过滤条件,并将过滤条件值设置为
rename_project_file
。
https://<instance_name.looker.com>/explore/system__activity/event_attribute?fields=event.created_time,event.name,event_attribute.name,event_attribute.value&f[event.name]=%22rename_project_file%22&sorts=event.created_time+desc&limit=500&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22event.name%22%3A%5B%7B%22type%22%3A%22%3D%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22rename_project_file%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded
历史记录
历史记录探索可提供单个查询的记录。这对于问题排查非常有用,因为它提供了过去 90 天内在您的实例上运行的所有查询的详细信息。
以下是关于使用历史记录“探索”工具的一些常见问题:
- 信息中心使用哪些模型?
- 如何识别长时间运行的查询?
- 用户上次使用 SQL Runner 是什么时候?
- 如何查找被数据库终止的查询?
- 按查询次数排序的最热门信息中心是什么?
- 对于不同的角色,哪些探索最受欢迎?
- 过去 90 天内是否有人查询过特定的“探索”?
- 在过去 90 天内,是否有人使用过特定数据视图中的字段?
- 哪些查询是从 Google 表格中发起的?
截断历史记录表
由于历史记录表的大小可能会快速增加,因此 Looker 会自动删除符合以下任一条件的记录:
history.created_time
是 90 天之前的日期。history.created_time
是过去 7 天以上的日期,history.source
是scheduled_task
。
关于选定字段的说明
历史记录探索中的每个字段都有相关说明,以帮助您了解其用途。下表包含对客户经常会询问的某些字段的更详细说明:
字段名称 | 说明 | 可能的值 |
---|---|---|
来源 | 查询的来源,例如 Look、探索、计划任务、提醒、信息中心等。 |
|
颁发者来源 | 分桶的查询的来源。 |
|
状态 | 历史记录事件的当前状态。 |
|
查询运行计数 | 此字段会过滤掉 Status 字段值为 cache_only_miss 的历史记录条目来统计查询运行的次数。也就是说,此字段仅包含 Status 字段值为 complete 、error 或 killed 的历史记录条目。 |
正整数。 |
快速入门分析
历史记录“探索”部分包含快速入门分析,可帮助您快速回答问题或作为其他查询的起点。
在空白的“探索”界面中选择“快速开始”分析功能块,或者从已运行的“探索”中的闪电式快速入门菜单中选择“快速开始”分析功能块,Looker 会显示一个查询,其中包含预先选择和排序的字段,用于回答下列某个问题:
- 过去一天中哪些查询来源的活跃度最高?
- 哪些用户在过去一周最活跃?
- 哪个用户的信息中心最受欢迎?
- 在过去 30 天内,特定信息中心使用了多少次?
- 最近运行的查询有哪些?
- 在过去 30 天内,某个特定 Look 使用了多少次?
- 各个模型的平均查询运行时是多少?
- 特定用户最近的查询活动是什么?
信息中心使用的所有模型有哪些?
您可以使用历史记录探索来查找信息中心使用的所有模型。例如,在用户无法查看信息中心内的数据时,这可帮助识别用户需要相关权限的模型。
- 从 Dashboard(信息中心)视图中选择 ID (Inclusive)(ID(包含))。
- 从查询视图中,选择模型和计数。
- 按 ID(包含)过滤,输入要作为过滤依据的信息中心的信息中心 ID。
在以下网址示例中,您可以将过滤条件元素 f[history.real_dash_id]=123
中的信息中心 ID 123
替换为要过滤的信息中心的 ID:
https://<instance_name.looker.com>/explore/system__activity/history?fields=history.real_dash_id,query.model,query.count&f[history.real_dash_id]=123&sorts=history.real_dash_id+desc&limit=500
如何识别长时间运行的查询?
假设您要为长时间运行的查询创建提醒。例如,您可以使用历史记录探索来查找运行时间最长的查询:
- 从查询中选择 ID 和链接。
- 从历史记录中选择平均运行时间(秒)和查询运行次数,以查看每个查询运行的平均时长以及该查询已经运行了多少次。
- 您可以在历史记录中针对完成日期添加过滤条件,并将过滤条件值设置为
is in the past 7 days
等时间范围,以限制显示的结果。 - 添加针对是单个查询(是 / 否)的过滤器,并将其值设置为
is Yes
,以从结果中排除合并查询。 - 您可以仅显示运行时超过特定阈值(例如 5 分钟)的查询;为此,可以按平均运行时间(秒)进行过滤,并将过滤条件值设置为
is greater than 300
。 - 按 History 中的平均运行时间(秒)降序排序,首先列出平均运行时间最长的查询。
然后,您可以将该查询保存为 Look,并创建提醒,以便在存在运行时超出您指定的阈值的查询时收到通知。
在以下网址示例中,通过将过滤条件元素 f[history.created_date]=7+days
中的 7+days
替换为所需的过滤条件值,您可以更改显示结果的时间范围。您还可以在平均运行时间(秒)中更改过滤条件的值,方法是将过滤条件元素 f[history.average_runtime]=%3E300
中的 is greater than 300
替换为所需的秒数。
https://<instance_name.looker.com>/explore/system__activity/history?fields=query.id,history.average_runtime,history.query_run_count,query.link&f[history.is_single_query]=Yes&f[history.created_date]=7+days&f[history.average_runtime]=%3E300&sorts=history.average_runtime+desc&limit=500
用户上次使用 SQL Runner 是什么时候?
要确定特定用户上次使用 HistoryExplore(历史记录探索)运行 SQL Runner 查询的时间,请执行以下操作:
- 从 SQL Runner 查询视图中,选择上次运行时和用户 ID。
- 在 SQL Runner 查询视图中,添加针对用户 ID 的过滤条件,并将过滤条件值设置为用户的 ID。
https://<instance_name.looker.com>/explore/system__activity/history?fields=sql_query.last_run_time,sql_query.user_id&sorts=sql_query.last_run_time+desc&limit=500&column_limit=50
如何查找被数据库终止的查询?
如需使用历史记录探索功能查找被您的数据库终止的查询,请执行以下操作:
- 为历史记录中的消息添加过滤条件,并将过滤条件值设置为
contains query killed
。 - 从历史记录中选择创建日期、ID 和消息。
- 从查询中选择 ID。
https://<instance_name.looker.com>/explore/system__activity/history?fields=history.id,history.created_date,query.id,history.message&f[history.message]=%25query+killed%25&sorts=history.message&limit=500
哪个信息中心最热门(按查询次数排序)?
信息中心“探索”部分会列出过去 90 天内访问过的每个信息中心的标题,并提供每个信息中心的访问次数计数:
- 从信息中心中选择标题。
- 从 History(历史记录)中选择 Query Run Count(查询运行计数)。
- 从信息中心为标题添加过滤条件,并将过滤条件值设置为
is not null
。
https://<instance_name.looker.com>/explore/system__activity/history?fields=dashboard.title,history.query_run_count&f[dashboard.title]=-NULL&sorts=history.query_run_count+desc&limit=500&column_limit=50
对于不同的角色,哪些探索最受欢迎?
此“探索”会显示过去 90 天内您实例上的每个角色运行“探索”的次数:
- 从查询中选择探索。
- 从用户角色中选择名称并对其进行透视。
- 从 History(历史记录)中选择 Query Run Count(查询运行计数)。
- 通过用户角色添加对名称的过滤条件,并将过滤条件值设置为
is not null
。
https://<instance_name.looker.com>/explore/system__activity/history?fields=history.query_run_count,query.view,role.name&pivots=role.name&f[role.name]=-NULL&sorts=history.query_run_count+desc+0,role.name&limit=500&column_limit=50
在过去 90 天内,是否有人查询过特定的“探索”?
您可以使用历史记录探索功能来确定过去 90 天内是否使用了特定的探索功能:
- 从历史记录中选择创建日期。
- 从查询中选择探索和链接。
- 通过 Query 为 Explore 添加过滤条件,然后输入“Explore”的名称。
在过去 90 天内,是否有人使用过特定数据视图中的字段?
您可以使用历史记录探索来确定过去 90 天内是否使用了特定数据视图中的任何字段:
- 从历史记录中选择创建日期。
- 从查询中选择探索和链接。
- 按“Query”(查询)中的 Fields used(使用的字段)进行过滤,输入视图名称,后跟英文句点(例如
orders.
),然后选择“contains”(包含)。过滤器中的句点可确保您的结果仅返回来自该数据视图的字段,而不返回来自名称相似的数据视图的字段。
在以下网址示例中,您可以将过滤器元素 f[query.formatted_fields]=%25order%5E_items.
中的 order%5E_items.
替换为要过滤的视图的名称,后跟英文句点:
https://<instance_name.looker.com>/explore/system__activity/history?fields=history.created_date,query.view,query.link&f[query.formatted_fields]=%25order%5E_items.%25&sorts=history.created_date+desc&limit=500&column_limit=50
哪些查询是从 Google 表格中发起的?
您可以使用历史记录探索功能查看在 Google 表格中使用 Looker 关联工作表功能生成的查询列表:
- 从历史记录的创建日期组中选择日期和时间。
- 从历史记录的 Query API 客户端属性群组中选择 API 客户端名称、关联工作表电子表格 ID 和关联工作表触发器。
- 从用户中选择名称。
- 在历史记录的 Query API 客户端属性组中,按关联工作表电子表格 ID进行过滤,然后将值设置为
is not null
。
https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000
Look
Look 探索中包含有关所有 Look 的详细信息,包括与 Look 关联的信息中心、查询、用户和文件夹的相关信息。
以下是有关使用 Look 探索功能的一些常见问题:
哪些 Look 会公开共享?
您可以使用 Look 探索来查看公开分享哪些 Look 或启用了公开网址。
- 使用 Look 中的 Public (Yes / No) 进行过滤,然后将过滤条件值设置为
Yes
。 - 从 Look 中选择 ID、Name 和 Link。
https://<instance_name.looker.com>/explore/system__activity/look?fields=look.id,look.title,look.link&f[look.public]=Yes&limit=500
特定 Look 的作者是谁?
如需查找特定 Look 的作者,请执行以下操作:
- 按 Look 中的 ID 进行过滤,将值设置为 Look 的 ID。
- 从用户中选择 ID 和名称。
- 您还可以从 Look 中选择创建日期和标题等字段。
哪些 Look 已被删除?
如需查看所有已删除 Look 的列表,请执行以下操作:
- 从 Look 中选择 ID、Title、Link 和 Deleted Date。
- 从 Look 中针对删除日期添加过滤条件,并将过滤条件值设置为
is not null
。
https://<instance_name.looker.com>/explore/system__activity/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
合并查询
合并查询探索包含有关合并查询的信息,包括源查询和合并查询的字段和其他元素。
您可以使用合并查询探索来回答如下问题:
哪些探索的合并频率最高?
您可以使用合并查询“Explore”找出最常合并的探索,并考虑联接表,以提升性能和使用更多功能。
- 从查询中选择探索。
- 从合并查询源查询中选择计数。
https://<instance_name.looker.com>/explore/system__activity/merge_query?fields=query.view,merge_query_source_query.count&sorts=merge_query_source_query.count+desc&limit=500&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%7D&origin=share-expanded
PDT build
PDT 构建探索中包含有关 PDT build 的信息,包括完成构建所需的时间以及 PDT 所属的连接和模型。
以下是 PDT build 探索的一些常见用法:
在同时运行多个 PDT 的实例上运行这些查询可能需要更长时间。
如何查看 PDT 构建时间?
您可以使用 PDT build 探索来查看 PDT 的构建时间。例如,如需查看过去 2 天的 PDT 构建时间,请使用以下命令:
- 在 PDT Builds 视图中,添加针对 Start Time 的过滤条件,并将其值设置为
is in the past 2 days
。 - 从 PDT 构建视图中选择开始时间、视图名称、连接、模型名称、用时分钟数和用时秒数。
https://<instance_name.looker.com>/explore/system__activity/pdt_builds?fields=pdt_builds.start_time,pdt_builds.view_name,pdt_builds.connection,pdt_builds.model_name,pdt_builds.elapsed_minutes,pdt_builds.elapsed_seconds&f[pdt_builds.start_time]=2+days&sorts=pdt_builds.start_time+desc&limit=500
如何确定要发出提醒的长时间运行的 PDT?
您可以使用 PDT build 探索来识别长时间运行的 PDT。然后,您可以将该查询保存为 Look,并创建提醒,以便在存在构建时间超过您指定的阈值的 PDT 时收到通知。
例如,如需查看平均构建时间超过 30 分钟的 PDT,请使用以下命令:
- 在 PDT build 视图中,针对平均构建时间分钟数添加过滤条件,并将其值设置为
is greater than 30
。 - 从 PDT build 视图中,选择视图名称、连接和平均构建时间分钟数。
如需从 PDT build 更改平均构建时间分钟数的过滤器值,请将过滤器元素 f[pdt_builds.average_build_time_minutes]=%3E20
中的 30
替换为所需的分钟数:
https://<instance_name.looker.com>/explore/system__activity/pdt_builds?fields=pdt_builds.view_name,pdt_builds.connection,pdt_builds.average_build_time_minutes&f[pdt_builds.average_build_time_minutes]=%3E30&sorts=pdt_builds.average_build_time_minutes+desc&limit=500
查询性能指标
查询性能指标探索会提供从 Looker 实例运行的每个查询的详细细分数据。
例如,您可以使用此“探索”来调查查询的哪些组件的加载时间最长。您还可以使用此“探索”来确定查询性能趋势和异常值。如需详细了解查询生命周期以及此探索中跟踪的字段,请参阅了解查询性能指标文档页面。
快速入门分析
查询性能探索中包含快速入门分析,可帮助您快速回答问题或作为其他查询的起点。
在空白的“探索”界面中选择“快速开始”分析功能块,或者从已运行的“探索”中的闪电式快速入门菜单中选择“快速开始”分析功能块,Looker 会显示一个查询,其中包含预先选择和排序的字段,用于回答下列某个问题:
- 每个查询阶段花了多长时间?
- 哪些探索的平均主查询执行时间最长?
- 哪些用户的平均主查询执行时间最长?
- 一天中哪个时段的异步工作器计时最长?
- 一天中哪些时段的查询初始化时间最长?
- 一天中哪个时段的连接处理时间最长?
- 一天中哪些时段的主要查询时间最长?
- 一天中哪些时段的查询后耗时最长?
SQL 查询
SQL 查询探索中包含已运行的 SQL 查询的相关信息,包括其最近一次运行时间和运行频率,以及运行这些查询的用户的详细信息。
您可以使用 SQL Query 探索来回答如下问题:
哪些用户运行的 SQL 查询最多?
您可以使用 SQL Query 探索来确定运行 SQL Runner 查询次数最多的用户:
- 从用户中选择 ID 和名称。
- 从 SQL Runner 查询中选择计数。
- 按 SQL Runner 查询中的计数降序排序,以列出首先运行的查询最多的用户。
https://<instance_name.looker.com>/explore/system__activity/sql_query?fields=sql_query.count,user.id,user.name&sorts=sql_query.count+desc&limit=500
已安排的方案
已安排的计划“探索”中包含与所有已安排的数据传送有关的信息,包括之前安排的作业和当前安排的作业。
以下是有关使用预定方案的“探索”页面的一些常见问题:
- 如何在一致的时区中查看已安排的方案?
- 时间安排在哪个阶段卡住了?
- 如何查找时间表所有者?
- 哪些已安排的方案会同时运行?
- 哪些时间表没有限制?
- 可以查看超过 50 个时间表的历史记录吗?
- 如何过滤出一组特定的时间表?
- 能否跨时间表识别错误趋势?
- 如何查看时间表的运行时指标?
如何在一致的时区中查看已安排的方案?
由于“系统活动”是在系统时区中存储时间数据,因此您可以使用已安排的计划查看同一时区中的所有已安排的计划:
- 从 Scheduled Plan 中选择 ID、Name 和 Next Runtime,查看系统时区中每个已安排计划的下一个运行时。
- 从用户中选择 ID 和名称,以查看创建该时间表的用户。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
No
,以排除仅发送一次的传送(例如提交 Look)或作为一次性测试发送的传送(例如交付 Look 测试)。 - 您还可以在 Scheduled Plan 视图中添加 Cron 时间安排和时区等字段。
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.id,scheduled_plan.next_run_time,scheduled_plan.cron_schedule,scheduled_plan.timezone,user.name&f[scheduled_plan.run_once]=No&sorts=scheduled_plan.timezone+desc&limit=500&column_limit=50
时间表会在哪个阶段卡住?
您可以使用已安排时间的计划探索来确定时间表在哪个阶段卡住了。例如:
- 如需查看特定计划作业在哪个阶段卡住,请根据计划作业中的 ID 进行过滤,并将过滤条件值设置为计划作业的 ID。 从计划作业阶段中选择阶段、计划作业 ID 和以秒为单位的运行时。
- 您还可以从已安排作业阶段中选择开始时间和完成时间。
然后,您可以使用 ID 和运行时间(秒)字段,根据安排的作业是卡在了 execute
阶段还是 enqueued for delivery
阶段等位置,对失败的作业进行问题排查。
在以下网址示例中,您可以将过滤条件元素 &f[scheduled_job.id]=12913
中的预定作业 ID 12913
替换为要过滤的预定作业的 ID:
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_job_stage.stage,scheduled_job_stage.scheduled_job_id,scheduled_job_stage.runtime,scheduled_job_stage.started_time,scheduled_job_stage.completed_time&f[scheduled_job.id]=12913&sorts=scheduled_job_stage.scheduled_job_id+desc&limit=500
如何查找时间表所有者?
您可以使用已安排的计划中的“探索”功能来查找时间表所有者:
- 从已安排的方案中选择 ID 和名称。
- 从用户中选择 ID 和名称。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
No
,以排除仅发送一次的传送(例如提交 Look)或作为一次性测试发送的传送(例如交付 Look 测试)。 - 要查找特定时间表的所有者,请根据已安排的方案中的 ID 进行过滤,然后将过滤条件值设置为该时间表的 ID。
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.id,user.name&f[scheduled_plan.run_once]=No&sorts=scheduled_plan.id&limit=500
哪些已安排的方案会同时运行?
您可以使用已安排时间的方案“探索”功能来确定安排在同一时间运行的方案:
- 从 Scheduled Plan 中选择 ID、Name、Cron Schedule 和 Next Run Time。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
No
,以排除仅发送一次的传送(例如提交 Look)或作为一次性测试发送的传送(例如交付 Look 测试)。 - 您还可以针对“下次运行时间”添加过滤条件,并将过滤条件值设置为
is not null
,以便在结果中仅包含现有的已安排的交付。
然后,您可以更改时间表的时间安排(例如,Look 的传送),以便多个时间表不会同时运行。
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,scheduled_plan.cron_schedule,scheduled_plan.next_run_time&f[scheduled_job.run_once]=No&f[scheduled_plan.next_run_time]=NOT+NULL&sorts=scheduled_plan.id&limit=500
哪些时间表没有限制?
您可以使用已安排时间的方案“探索”功能找出不限数量的时间表或行数上限为 -1
的时间表:
- 按发送所有结果进行过滤,然后将值设置为是。
- 从预定作业中选择 ID、创建时间、敲定时间和计数。
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_job.id,scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job.count&f[scheduled_plan.send_all_results]=Yes&sorts=scheduled_job.created_time+desc&limit=500
可以查看超过 50 个时间表的历史记录吗?
使用已安排的计划“探索”功能,您可以在时间表历史记录管理页面上查看可设置的 50 多个时间表的历史记录。例如:
- 从已安排的方案中选择 ID。
- 从用户中选择名称,查看每个时间表的创建者。
- 从 Scheduled Job 中选择 Cron Schedule,以 Cron 字符串形式查看每项已安排作业的计划传送时间。
- 从已安排的方案目标位置中选择类型,以查看目标位置类型(例如交付 Look)。
- 从预定作业中选择 ID、状态和状态详情,查看每个预定作业的状态和错误消息。
- 从预定作业中选择创建时间和最终时间。
- 从计划作业阶段中选择运行时(秒)。
- 您还可以从 Look 视图或信息中心视图中选择关联,以获取指向时间表或信息中心的链接。
- 要将结果限定为特定时间范围,请在 Scheduled Job 的 Created Date 中添加过滤条件,然后将过滤条件值设置为所需的时长,例如
is in the past 7 days
。 - 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
No
,以排除仅发送一次的传送(例如提交 Look)或作为一次性测试发送的传送(例如交付 Look 测试)。
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,user.name,scheduled_job.cron_schedule,scheduled_plan_destination.type,scheduled_job.id,scheduled_job.status,scheduled_job.status_detail,scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job_stage.runtime,look.link,dashboard.link&f[scheduled_plan.run_once]=No&f[scheduled_job.created_date]=7+days&sorts=scheduled_job.created_time+desc&limit=500
如何过滤出一组特定的时间表?
您可以使用已安排的计划中的“探索”功能,通过进行过滤(例如按特定信息中心、所有者或模型进行过滤),仅查看一组特定的时间表。例如,如需查看基于特定模型的时间表列表(如 thelook
),请使用以下命令:
- 从 Query 视图中添加 Model 的过滤条件,并将过滤条件值设置为模型的名称。
- 从已安排的方案中选择 ID 和名称。
- 从用户中选择名称,查看每个时间表的创建者。
- 从 Scheduled Plan(已安排的计划)中选择 Cron Schedule(Cron 时间安排),即可以 Cron 字符串形式查看每项时间表的已安排送货时间。
- 您还可以从 Look 视图或信息中心视图中选择关联,以获取指向时间表或信息中心的链接。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
No
,以排除仅发送一次的传送(例如提交 Look)或作为一次性测试发送的传送(例如交付 Look 测试)。
在以下网址示例中,您可以将过滤条件元素 f[query.model]=thelook
中的模型名称 thelook
替换为要过滤的模型的名称:
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.name,scheduled_plan.cron_schedule,look.link,dashboard.link&f[scheduled_plan.run_once]=No&f[query.model]=thelook&sorts=scheduled_plan.id&limit=500
是否可以跨时间表识别错误趋势?
“已安排的计划探索”功能的另一个用例是确定各个时间表的错误趋势,例如,发现 SFTP 时间表失败并显示了特定的错误消息:
- 从预定作业中选择创建时间、结束时间、ID、状态和状态详情,查看预定作业列表及其状态和错误消息。
- 从已安排作业阶段中选择阶段。
- 从已安排的方案目标位置中选择类型和格式,即可查看目标位置类型(例如 Looker 提交)和数据格式(例如 Look 提交)。
- 按预定作业中的状态进行过滤,并将过滤条件值设置为
failure
,以便仅包含失败的预定作业。 - 如需仅包含特定目标位置的结果,请在 Scheduled Plan Destination 的 Type 字段中进行过滤,然后将过滤条件值设置为所需的目标位置,例如
sftp
或email
。
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job.id,scheduled_job.status,scheduled_job.status_detail,scheduled_job_stage.stage,scheduled_plan_destination.type,scheduled_plan_destination.format&f[scheduled_job.status]=failure&sorts=scheduled_job.status&limit=500&column_limit=50
如何查看时间表的运行时指标?
您可以使用已安排的计划探索来调查时间表的运行时指标。例如,如需查看时间表的平均运行时,请执行以下操作:
- 从已安排的方案中选择 ID 和名称。
- 从用户中选择名称。
- 从已安排的计划中选择 Cron 时间表。
- 从预定作业阶段中选择平均运行时间(秒)。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
No
,以排除仅发送一次的传送(例如提交 Look)或作为一次性测试发送的传送(例如交付 Look 测试)。
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,scheduled_plan.name,user.name,scheduled_plan.cron_schedule,scheduled_job_stage.avg_runtime&f[scheduled_plan.run_once]=No&sorts=scheduled_plan.id&limit=500
如需查看预定作业的运行时,请执行以下操作:
- 如需查看特定方案中所有作业的运行时,请从已安排的方案中添加 ID 过滤条件,然后将过滤条件值设置为所需的已安排的方案 ID。
- 从已安排的方案中选择 ID。
- 从用户中选择名称。
- 从已安排的计划中选择 Cron 时间表。
- 从已安排的作业中选择 ID、状态、创建时间和敲定时间。
- 从计划作业阶段中选择运行时(秒)。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
No
,以排除仅发送一次的传送(例如提交 Look)或作为一次性测试发送的传送(例如交付 Look 测试)。
要在以下网址示例中更改已安排的方案中的“ID”过滤条件,请将过滤条件元素 f[scheduled_plan.id]=145
中的 145
替换为您想用作过滤条件的已安排方案的 ID:
https://<instance_name.looker.com>/explore/system__activity/scheduled_plan?fields=scheduled_plan.id,user.name,scheduled_job.cron_schedule,scheduled_job.id,scheduled_job.status,scheduled_job.created_time,scheduled_job.finalized_time,scheduled_job_stage.runtime&f[scheduled_plan.run_once]=No&f[scheduled_plan.id]=145&sorts=scheduled_job.created_time+desc&limit=500
用户
用户探索包含每个用户的详细信息,包括运行的历史查询以及用户有权访问的内容和文件夹。
快速入门分析
用户探索包含快速入门分析,可供您快速回答问题或作为其他查询的起点。
在空白的“探索”界面中选择“快速开始”分析功能块,或者从已运行的“探索”中的闪电式快速入门菜单中选择“快速开始”分析功能块,Looker 会显示一个查询,其中包含预先选择和排序的字段,用于回答下列某个问题:
- 有多少已启用的用户拥有查看者权限 (
access_data
)? - 在过去 7 天内,哪些用户有超过 3 次预定作业失败?
- 特定用户上一次登录是什么时候?
- 哪些用户最活跃?
- 哪些用户已经超过 90 天未登录?
- 哪些用户停用了访问权限?
- 哪些用户拥有开发者权限 (
develop
)? - 每个角色有多少用户?
如何查看哪些 Google 人员访问过我的实例?
除了支持访问权限页面的近期访问面板外,您还可以查看哪些 Google 人员访问过您的实例的相关信息。例如,如需查看哪些 Google 员工访问了您的实例、他们访问了您的实例的分钟数和运行的查询数量,请执行以下操作:
- 从用户中选择名称。
- 从历史记录中依次选择 Approximate Web Usage (minute) 和 Query Counts > Query Run Count。
- 在历史记录中按创建日期 > 日期进行过滤,然后将值设置为您希望 Google 员工查看访问权限的时间段。
- 在历史记录中按来源 > 来源进行过滤,并将值设置为
is not equal to
scheduled_task
,以消除所有计划任务。 - 在用户事实中按用户权限 > 是 Looker 员工(是 / 否)进行过滤,然后将值设置为
is Yes
,以便仅查看 Google 员工。
https://<instance_name>/explore/system__activity/user?fields=user.name,history.approximate_usage_in_minutes,history.query_run_count_drill&f[user.is_disabled]=No&f[history.created_date]=70+days&f[history.source]=-%22scheduled_task%22&f[user_facts.is_looker_employee]=Yes
System Activity Labs 功能的引导式分析
借助引导式分析,Looker 管理员和已获得 see_system_activity
权限的用户可以在历史记录探索中以问答形式快速回答有关实例使用情况的关键问题。为了让用户能够访问引导式分析,管理员必须启用系统活动中的引导式分析 “实验室”功能。
引导式分析包括预先填充的字段、值、可供选择的选项,以及显示所选指标的可视化图表。
为了更好地显示所选数据,Looker 会选择可视化类型,并且该类型无法更改。
目前,用户可在历史记录的“探索”中找到多个引导式分析选项:
- 您的实例中哪些用户最活跃?- 了解哪些客户从您的实例中获得最大价值
- 哪些内容会对实例征税?- 识别高使用率的内容
- 用户审核 - 按类型和角色了解用户活动
- 一段时间内的实例使用情况 - 比较一段时间内的不同活动指标
从空白“探索”中选择引导式分析
要运行引导式分析,请选择您要使用的分析选项。引导式分析部分中显示了分析选项。
引导式分析运行完毕后,您可以自定义数据值以回答关键问题、进一步探索分析结果,或保存分析结果以分享给其他拥有访问权限的用户。若要关闭分析,只需关闭其浏览器标签页即可。
探索运行后选择引导式分析
如果您已经运行过系统活动的历史记录探索,则可以通过选择“探索”名称旁边的快速入门按钮来选择引导式分析。
此操作会启动快速入门菜单。
从快速入门菜单中选择一项引导式分析,即可在新的浏览器标签页中打开并运行引导式分析。
引导式分析运行完毕后,您可以自定义数据值以回答关键问题、进一步探索分析结果,或保存分析结果以分享给其他拥有访问权限的用户。若要关闭分析,只需关闭其浏览器标签页即可。
自定义引导式分析
从空白探索或探索的快速入门菜单中选择引导式分析后,该分析将自动在新的浏览器标签页中打开并运行。
当引导式分析运行完毕后,您可以根据分析结果,从下拉菜单、日期菜单或单选按钮选项中选择值和条件,更改和创建预填充值的组合。
例如,您可以选择“哪些内容对您的实例收费?”分析,以识别 Looker 实例上频繁使用的内容。引导式分析加载完成后,您可以在“在什么时间范围内?”将默认时间范围值更改为“过去 30 天”。
引导式分析会自动根据所选的时间范围值进行更新。
在此阶段,您可以选择是否通过进一步探索数据来为分析提供更多洞见。您可以将分析保存为 Look 或信息中心,以便与其他拥有访问权限的用户共享,也可以通过关闭浏览器窗口来关闭分析。
引导式分析三点状选项菜单
在引导式分析中,用户可通过三点状选项菜单执行以下操作:
进一步探索引导式分析
通过引导式分析获得初始数据后,您可以选择进一步探索数据。为此,您可以选择三点状选项菜单,然后选择从这里探索。
系统会打开一个新的浏览器标签页,并在其中显示“探索”页面,其中预加载了引导式分析中的字段和可视化内容。
您可以通过添加或移除字段、数据透视或过滤条件以及进行其他自定义,进一步挖掘数据洞见。如需详细了解“探索”功能的最佳实践和提示,请参阅创建和修改探索文档页面。
保存引导式分析
自定义引导式分析后,您可能需要保存该分析,以便与其他拥有访问权限的人分享。您可以通过以下两种方式保存引导式分析:
要向信息中心添加引导式分析可视化图表,请从三点状选项菜单中选择 + 添加到信息中心,以打开将引导式分析保存到信息中心菜单。
将引导式分析保存到信息中心菜单打开后,请按以下步骤操作:
- 为引导式分析信息中心功能块输入标题。
- 选择要将引导式分析添加到哪个文件夹,以保存您要向其中添加引导式分析的信息中心。
- 选择所需的信息中心。
选择保存。
系统会弹出一个对话框,通知您引导式分析已添加到所选信息中心。
选择相应链接即可转到信息中心,以查看该信息中心或对其进行修改。
或者,选择完成以退出弹出式窗口。
如需将引导式分析保存为 Look,请从三点状选项菜单中选择从此处探索选项:
系统会打开一个新的浏览器标签页,并在其中显示“探索”页面,其中预加载了引导式分析中的字段和可视化内容:
如需将“探索”保存为 Look,请按以下步骤操作:
- 选择“探索”右上角的齿轮菜单。
- 选择保存。
选择作为 Look 以打开 Save Look 菜单。
在标题字段中,输入新标题。如果您要保存现有 Look,请将此字段留空。
在 Description(说明)字段中,您可以为 Look 输入说明。如果您要保存现有 Look,请将此字段留空。
在文件夹字段中,检查当前文件夹是否为所需的目标位置。文件夹字段显示所选文件夹的名称和位置,右侧显示所选文件夹的内容。如果您选择不允许保存 Look 的文件夹,菜单底部会显示一条警告,并且 Save & View Look 按钮将停用。
如果您想将 Look 保存到其他文件夹,请导航到您要将 Look 保存到的文件夹。您可以通过以下任一方式导航到该文件夹:
- 在文件夹字段中,选择任一父级文件夹即可转到相应位置。
- 在左侧,选择顶级文件夹的名称以导航到该文件夹。
- 在右侧,选择您要使用的子文件夹的名称,或导航到该子文件夹之一。
- 如果有多个子文件夹,您可以在按标题过滤字段中输入子文件夹名称,使列表仅显示该子文件夹。
如果您想保存某个现有 Look,请向下滚动,或使用按标题过滤字段查找并选择所需的 Look。Look 的标题和说明(如有)显示在 Title 和 Description 字段中。
保存您的 Look。
- 如需保存 Look 并返回“探索”页面,请选择保存。
- 如需保存和查看您的 Look,请选择保存和查看 Look。
您还可以从“探索”中选择其他选项来保存或分享引导式分析“探索”,例如:
- 下载 - 下载引导式分析“探索”页面
- 发送 - 一次性发送引导式分析“探索”
- 保存并安排 - 将引导式分析“探索”另存为 Look 或信息中心,并设置定期提交
- 合并结果 - 将引导式分析结果与其他“探索”结果合并
重新加载引导式分析
要在引导式分析中重新加载数据,请从三点状选项菜单中选择重新加载选项。
引导式分析将刷新并显示最新数据。