已获授 see_system_activity
权限的 Looker 管理员和用户可以访问 探索菜单中的 Looker 系统活动探索。
系统活动探索会连接到 Looker 的底层应用数据库。这些页面会显示与您的 Looker 实例相关的信息,包括在实例中保存的 Look 和信息中心、用户信息、历史查询信息以及实例性能统计信息。系统活动数据的粒度和保留度都受系统限制。系统活动设计用于收集大量数据,而汇总数据可用于对业务日志进行补充。
默认情况下,系统活动数据存储在 Looker 的内部数据库中。为符合存储限制,系统会定期截断大多数表。例如,“历史记录”表格会被截断为过去 90 天的数据。某些表采用更严格的数据保留政策。如需提高数据保留率,不妨考虑使用精英系统活动。
无法使用 SQL Runner 查询系统活动数据,因为 Looker 内部数据库的权限受到限制。
系统活动探索
以下是系统活动探索:
探索名称 | 说明 | 缓存时长 |
---|---|---|
内容使用 | 有关 Look 和信息中心使用情况的数据,包括查看频率、收藏、时间安排、嵌入,以及通过 API 访问数据。此外,还包括有关各个 Look 和信息中心的详细信息。 | 12 小时 |
数据库连接 | 有关数据库连接的详细信息。包含有关有权访问数据库连接的用户的信息。 | 1 小时 |
信息中心 | 有关所有信息中心和信息中心元素的详细信息。包含与信息中心相关联的主题、查询、角色、用户和文件夹的相关信息。 | 12 小时 |
信息中心性能 | 有关信息中心的性能和历史数据。 | 1 小时 |
事件 | Looker 中历史事件的相关信息,包括每个事件的名称、类型和频率。包含与事件相关联的群组和用户的相关信息。 | 1 小时 |
事件属性 | 构成事件的属性的相关信息。包含 Event 探索中的数据,并添加属性信息。 | 12 小时 |
字段使用 | LookML 字段和使用次数。 | 1 小时 |
文件夹 | 有关所有文件夹、每个文件夹中存储的内容以及每个文件夹的创建者的信息。 | 1 小时 |
群组 | 群组列表和关于这些群组的详细信息,包括父级群组和子级群组,以及属于每个群组的用户和角色。 | 1 小时 |
历史记录 | 过去 90 天内运行的所有查询的详细信息。 | 12 小时 |
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 小时 |
如需查看内容使用情况、信息中心、事件、事件属性、历史记录、外观、合并查询、PDT build、SQL 查询、定期方案和用户探索的常见用例示例,请参阅本页中的使用系统活动探索部分。
使用系统 Activity 探索
以下是一些示例,展示了如何在“系统活动”中使用某些探索,以及一些常见问题的解答。如需访问本部分中的探索示例,请将示例网址中的 <instance_name.looker.com>
替换为您的 Looker 实例的地址。
API 使用情况
API 使用情况探索提供了对 Looker 实例发出的 API 调用量的摘要。
您可以使用 API 使用情况中的“探索”部分来回答如下问题:
如何对 API 调用进行每日审核?
您可以使用 API 用量探索功能,检索在任何给定时间段内对您的实例进行的所有 API 调用的列表。要查看指定日期拨打了哪些电话,请执行以下操作:
- 从 API 使用情况中选择端点。
- 从 API 用量中选择总用量。
- 根据所需日期,根据 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 使用情况中选择总使用量。
- 在 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
内容使用
系统活动中的内容使用情况探索卡片会提供有关外观和信息中心使用情况的信息,包括查看、收藏、安排和通过 API 访问的频率。还包括各个 Look 和信息中心的详细信息。
快速入门分析
“内容使用情况”下的“探索”部分包含快速入门分析,可帮助您快速回答问题或作为其他查询的起点。
在空白探索中选择“快速开始”分析功能块,或在已运行的探索中选择闪电图标 快速开始菜单,Looker 会显示一个包含预选和排序字段的查询,以回答以下某个问题:
- 哪些内容收藏次数最多?
- 过去 3 天内访问了哪些内容?
- 过去 60 天内未访问过哪些内容?
- 使用 Looker API 访问的内容中,哪些内容的访问频率最高?
- 过去 7 天创建的信息中心的使用率最高?
- 过去 7 天内创建的哪些外观被使用最多?
- 哪些董事会被收藏的次数最多?
- 哪些内容的观看次数最多?
热门 Look 和信息中心使用哪些过滤条件?
您可以使用内容使用情况探索来查找实例上最常用的 Look 或信息中心。然后,您可以使用历史记录探索功能来确定热门外观或信息中心使用的过滤条件。如需查找最热门的 Look 或信息中心,请执行以下操作:
- 在内容使用情况“探索”部分,从内容使用情况视图中选择 Content ID、Content Title 和 Content Type。
- 在内容使用情况视图中,按内容类型添加过滤条件,并将过滤条件值设为
dashboard OR look
。 - 从内容使用情况中选择查看总数。您还可以在 Content Usage 视图中选择 Favorites Total、Schedule Total、API Total 和 Embed Total 等字段。
- 按总观看次数降序排列结果,以便优先列出最热门的内容。
- 您还可以在内容使用情况视图的上次访问过后天数字段中添加过滤条件,以将数据限制在特定时长内。例如,您可以将过滤条件值设置为
is less than 30
,以将您查看的数据限制为过去 30 天内的数据。
然后,您可以使用历史记录探索功能查找特定 Look 或信息中心中使用的过滤条件:
- 在历史记录探索中,按信息中心视图或 Look 视图中的 ID 字段进行过滤,然后输入您使用内容使用情况探索确定的信息中心或 Look 的 ID。
- 从查询视图中选择过滤条件,系统会返回您要过滤的 Dashboard 或 Look 使用的过滤条件列表。
信息中心
信息中心“探索”部分包含信息中心和信息中心元素(包括与信息中心关联的 Look、查询、角色、用户和文件夹)的详细信息。
快速入门分析
信息中心“探索”部分包含快速入门分析,您可以使用这些分析快速解答问题,也可以将其用作其他查询的起点。
在空白的“探索”界面中选择“快速开始”分析功能块,或者从已运行的“探索”中的闪电式快速入门菜单中选择“快速开始”分析功能块,Looker 会显示一个查询,其中包含预先选择和排序的字段,用于回答下列某个问题:
- 哪些信息中心使用多个探索?
- 哪些信息中心的自动刷新间隔较短?
- 有多少信息中心设置为在加载时运行?
- 哪些信息中心包含的功能块超过 25 个?
- 哪些信息中心使用的合并查询最多?
- 哪些信息中心使用特定视图或字段?
- 哪些文件夹包含哪些信息中心?
- 各个信息中心由哪些板块构成?
事件
事件探索中包含 Looker 内历史事件的相关信息,包括每个事件的名称、类型和频率。此探索还包含与事件相关联的群组和用户的相关信息。
以下是 Event 探索的一些常见用途:
如需详细了解如何查看事件和常见事件属性以及事件类型列表,请参阅 Looker 事件文档页面。
如何查找和分类 API 请求?
您可以使用事件探索功能查找已发出的所有 API 请求并对其进行分类:
- 从事件视图中选择名称和类别字段。
- 添加针对 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
。 - 从用户视图中选择 ID 和名称。
- 从事件视图中选择创建时间。
事件属性
事件属性探索包含事件探索中的数据,并提供了构成事件的属性的更多信息。
以下是“探索”事件属性的一些常见用法:
如需详细了解如何查看事件、常见事件属性和事件类型列表,请参阅 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 或 Name 等字段,以查看启用实验性功能的用户的相关信息。
在此示例中,当“事件属性”的“名称”的值为 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
。
选定字段的说明
历史记录探索中的每个字段都有说明,可帮助您了解其用途。下表更详细地介绍了客户经常询问的某些字段:
字段名称 | 说明 | 可能的值 |
---|---|---|
来源 | 查询的来源,例如数据洞察、探索、定期任务、提醒、信息中心等。 |
|
发卡机构来源 | 查询的来源(已分桶)。 |
|
状态 | 历史记录事件的当前状态。 |
|
查询运行计数 | 此字段会过滤掉 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
。 - 在历史记录中,按平均运行时间(秒)降序排序,以便先列出平均运行时间最长的查询。
然后,您可以将该查询保存为 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 天内是否使用了特定数据视图中的任何字段:
- 从历史记录中选择创建日期。
- 从查询中选择探索和关联。
- 在查询中按使用的字段进行过滤,输入视图名称后跟一个英文句点(例如
orders.
),然后为过滤条件选择包含。过滤器中的句点可确保结果仅返回该视图中的字段,而不返回具有相似名称的视图中的字段。
在以下网址示例中,您可以将过滤器元素 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 表格中发起的?
您可以使用历史记录探索查看使用 Looker 专用关联工作表功能在 Google 表格中生成的查询列表:
- 从历史记录的创建日期组中选择日期和时间。
- 在历史记录的 Query API Client Properties 组中,选择 API Client Name、Connected Sheets Spreadsheet ID 和 Connected Sheets Trigger。
- 从用户中选择姓名。
- 在历史记录的 Query API Client Properties 组中,按关联的 Google 表格电子表格 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 探索的常见问题:
哪些外观会公开分享?
您可以使用外观探索功能查看哪些外观是公开分享的或启用了公开网址。
- 在外观中,按公开(是/否)过滤,并将过滤条件值设为
Yes
。 - 从外观中选择 ID、名称和链接。
https://<instance_name.looker.com>/explore/system__activity/look?fields=look.id,look.title,look.link&f[look.public]=Yes&limit=500
特定外观的作者是谁?
如需查找特定 Look 的作者,请执行以下操作:
- 按外观中的 ID 进行过滤,将值设置为外观的 ID。
- 从用户中选择 ID 和名称。
- 您还可以从 Look 中选择创建日期和标题等字段。
哪些 Look 已被删除?
如需查看所有已删除的妆容的列表,请执行以下操作:
- 从 Look 中选择 ID、Title、Link 和 Deleted Date。
- 在查看中,按删除日期添加过滤条件,并将过滤条件值设置为
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
合并查询
合并查询探索包含有关合并查询的信息,包括源查询和合并查询的字段和其他元素。
您可以使用合并查询探索来回答以下问题:
哪些探索最常合并?
您可以使用合并查询探索来了解哪些探索最常合并,并考虑联接表以提升性能并使用更多功能。
- 从查询中选择探索。
- 从合并查询来源查询中选择计数。
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 build 探索卡片包含与 PDT build 相关的信息,包括完成 build 所需的时间,以及 PDT 所属的关联和模型。
以下是 PDT Builds 探索的一些常见用法:
在同时运行多个 PDT 的实例上运行这些查询可能需要更长时间。
如何查看 PDT 构建时间?
您可以使用 PDT build 探索功能查看 PDT 的构建时间。例如,如需查看过去 2 天内的 PDT 构建时间,请执行以下操作:
- 在 PDT Builds 视图中,针对 Start Time 添加过滤条件,并将其值设置为
is in the past 2 days
。 - 从 PDT Builds 视图中选择 Start Time、View Name、Connection、Model Name、Elapsed Minutes 和 Elapsed Seconds。
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 Builds 视图中,针对 Average Build Time Minutes 添加过滤条件,并将其值设置为
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 查询探索功能来回答以下问题:
哪些用户运行的 SQL 查询最多?
您可以使用 SQL 查询探索功能来确定运行 SQL Runner 查询次数最多的用户:
- 从用户中选择 ID 和名称。
- 从 SQL Runner 查询中选择 Count(计数)。
- 按 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 个时间表的历史记录吗?
- 如何过滤出一组特定的时间表?
- 能否跨时间表识别错误趋势?
- 如何查看时间表的运行时指标?
如何在一致的时区中查看已安排的方案?
由于“系统活动”是在系统时区中存储时间数据,因此您可以使用已安排的计划查看同一时区中的所有已安排的计划:
- 从已安排的方案中选择 ID、名称和下次运行时间,以查看系统时区中每个已安排的方案的下次运行时间。
- 从用户中选择 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 和运行时(秒)。
- 您还可以从已安排作业阶段中选择开始时间和完成时间。
然后,您可以根据已安排的作业是卡在 execute
阶段还是 enqueued for delivery
阶段等情况,使用 ID 和 Runtime in Seconds 字段来排查失败作业的问题。
在以下网址示例中,您可以将过滤条件元素 &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 和 Name。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
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
哪些已安排的方案会同时运行?
您可以使用已安排时间的方案“探索”功能来确定安排在同一时间运行的方案:
- 从安排的方案中选择 ID、 名称、 Cron 时间表和下次运行时间。
- 使用运行一次(是/否)进行过滤,然后将过滤条件值设置为
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。
- 从用户中选择姓名,即可查看各个时间表的创建者。
- 从定期作业中选择 Cron 时间表,以 Cron 字符串的形式查看每个定期作业的预定提交时间。
- 从安排的方案目标中选择类型,以查看目标类型(例如,投放外观)。
- 从预定作业中选择 ID、状态和状态详情,查看每个预定作业的状态和错误消息。
- 从预定作业中选择创建时间和最终时间。
- 从计划作业阶段中选择运行时(秒)。
- 您还可以在外观视图或信息中心视图中选择链接,以获取指向外观或信息中心(用于查看时间表)的链接。
- 如需将结果仅限于特定时间范围,请在定期作业的创建日期上添加过滤条件,并将过滤条件值设为所需的时长,例如
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 和名称。
- 从用户中选择姓名,即可查看各个时间表的创建者。
- 从定期投放方案中选择 Cron 时间表,以便以 Cron 字符串的形式查看每个时间表的定期投放时间。
- 您还可以在外观视图或信息中心视图中选择链接,以获取指向外观或信息中心(用于查看时间表)的链接。
- 按运行一次(是/否)进行过滤,并将过滤条件值设为
No
,以排除已发送一次(例如,投放了外观)或作为一次性测试发送(例如,投放了外观的测试)的传送。
在以下网址示例中,您可以将过滤条件元素 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、状态和状态详情,查看预定作业列表及其状态和错误消息。
- 从预定作业阶段中选择阶段。
- 从定期方案目标位置中选择类型和格式,以查看目标位置类型(例如,投放外观)和数据格式(例如,投放外观)。
- 在已安排的作业中,按状态过滤,并将过滤条件值设为
failure
,以便仅包含已失败的已安排作业。 - 如需仅包含特定目标位置的结果,请按定期方案目标位置中的类型字段进行过滤,并将过滤条件值设为所需的目标位置,例如
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
,以排除已发送一次(例如,投放了外观)或作为一次性测试发送(例如,投放了外观的测试)的传送。
如需在以下网址示例中将 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 员工访问过您的实例、他们访问了您的实例了多少分钟以及运行了多少次查询,请执行以下操作:
- 从用户中选择名称。
- 从历史记录中,依次选择大致的网站使用时长(分钟)和查询次数 > 查询运行次数。
- 按创建日期 > 过滤历史记录中的日期,然后将该值设置为您希望 Google 员工查看访问权限的时间段。
- 按来源 >历史记录中的“Source”,并将值设置为
is not equal to
scheduled_task
,以消除所有计划任务。 - 按用户权限 >Is Looker Employee (Yes / No),并在 User Facts 中将值设置为
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
“系统活动”Labs 功能中的引导式分析
借助引导式分析,Looker 管理员和已获得 see_system_activity
权限的用户可以在历史记录“探索”中以问答形式快速回答有关实例使用情况的关键问题。为了让用户能够访问引导式分析,管理员必须启用系统活动中的引导式分析 “实验室”功能。
引导式分析包括预先填充的字段、值、可供选择的选项,以及显示所选指标的可视化图表。
为了更好地显示所选数据,Looker 会选择可视化类型,并且该类型无法更改。
用户目前可以通过历史记录“探索”部分访问多种引导式分析选项:
- 您的实例中哪些用户最活跃?- 了解哪些客户从您的实例中获得最大价值
- 哪些内容会给您的实例带来负担?- 识别使用频率较高的内容
- 用户审核 - 按类型和角色了解用户活动
- 实例使用情况随时间推移 - 比较不同活动指标随时间推移的变化情况
在空白探索中选择引导式分析
如需运行引导式分析,请选择要使用的分析选项。引导式分析部分中显示了分析选项。
引导式分析运行完毕后,您可以自定义数据值以回答关键问题、进一步探索分析结果,或保存分析结果以分享给其他拥有访问权限的用户。若要关闭分析,只需关闭其浏览器标签页即可。
在运行探索后选择引导式分析
如果您已运行系统活动历史记录探索,则可以选择相应探索名称旁边的快速开始按钮,以选择引导式分析。
此操作会启动快速开始菜单。
从快速入门菜单中选择一项引导式分析,即可在新的浏览器标签页中打开并运行引导式分析。
引导式分析运行完毕后,您可以自定义数据值来回答关键问题、进一步探索分析结果,或保存分析以与其他有权访问的用户共享。若要关闭分析,只需关闭其浏览器标签页即可。
自定义引导式分析
从空白探索或“探索”的快速开始菜单中选择引导式分析后,系统会自动打开该分析并在新的浏览器标签页中运行。
当引导式分析运行完毕后,您可以根据分析结果,从下拉菜单、日期菜单或单选按钮选项中选择值和条件,更改和创建预填充值的组合。
例如,您可以选择“哪些内容对您的实例收费?”分析,以识别 Looker 实例上频繁使用的内容。引导式分析加载完毕后,您可以将“在什么时间范围内?”中的默认时间范围值更改为“过去 30 天”。
引导式分析会自动根据所选的时间范围值进行更新。
在此阶段,您可以选择是否通过进一步探索数据,从分析中获得更多数据洞见。您可以将分析保存为“数据洞见”或保存到信息中心,以便与其他有权访问的用户共享;也可以关闭浏览器窗口来关闭分析。
引导式分析的三点状“选项”菜单
引导式分析中的三点状 Options(选项)菜单可让用户:
进一步探索引导式分析
通过引导式分析获得初始数据后,您可以选择进一步探索数据。为此,您可以选择三点状选项菜单,然后选择从这里探索。
系统会打开一个新的浏览器标签页,并在其中显示“探索”页面,其中预加载了引导式分析中的字段和可视化内容。
您可以通过添加或移除字段、数据透视表或过滤条件等其他自定义设置,获得更多数据洞见。如需了解有关探索的更多最佳实践和提示,请参阅创建和修改探索文档页面。
保存引导式分析
自定义引导式分析后,您可能需要保存该分析,以便与其他拥有访问权限的人分享。您可以通过以下两种方式保存引导式分析:
如需将引导式分析可视化图表添加到信息中心,请从三点状 Options(选项)菜单中选择 + Add to Dashboard(添加到信息中心),打开 Save Guided Analysis to a Dashboard(将引导式分析保存到信息中心)菜单。
将引导式分析保存到信息中心菜单打开后,请按以下步骤操作:
- 输入引导式分析信息中心功能块的标题。
- 选择要将引导式分析添加到哪个文件夹,以保存您要向其中添加引导式分析的信息中心。
- 选择所需的信息中心。
选择保存。
系统会弹出一个对话框,通知您已将引导式分析添加到所选信息中心。
选择相应链接可前往信息中心,查看或修改信息中心。
或者,选择完成退出弹出式窗口。
如需将引导式分析保存为“探索主题”,请从三点状图标 Options(选项)菜单中选择 Explore from Here(从这里开始探索)选项:
系统会打开一个新的浏览器标签页,并在其中显示“探索”页面,其中预加载了引导式分析中的字段和可视化内容:
请按照以下步骤将“探索”保存为 Look:
- 在“探索”页面右上角,选择齿轮图标菜单。
- 选择保存。
选择作为外观以打开保存外观菜单。
在标题字段中,输入新标题。如果您要保存现有 Look,请将此字段留空。
在 Description(说明)字段中,您可以为 Look 输入说明。如果您要保存现有 Look,请将此字段留空。
在文件夹字段中,检查当前文件夹是否为所需的目标位置。文件夹字段显示所选文件夹的名称和位置,右侧显示所选文件夹的内容。如果您选择的文件夹不允许保存外观,菜单底部会显示一条警告,并且保存并查看外观按钮将处于停用状态。
如果您想将 Look 保存到其他文件夹,请导航到您要将 Look 保存到的文件夹。您可以通过以下任一方式前往该文件夹:
- 在文件夹字段中,选择任一父级文件夹即可转到相应位置。
- 在左侧,选择要前往的顶级文件夹的名称。
- 在右侧,选择您要使用的子文件夹的名称,或导航到该子文件夹之一。
- 如果有多个子文件夹,您可以在按标题过滤字段中输入子文件夹名称,使列表仅显示该子文件夹。
如果您想覆盖现有外观,请向下滚动或使用按标题过滤字段查找并选择所需的外观。外观的标题和说明(如果有)会显示在标题和说明字段中。
保存您的 Look。
- 如需保存您的外观并返回“探索”页面,请选择保存。
- 如需保存和查看您的 Look,请选择保存并查看 Look。
您还可以从“探索”中选择其他选项来保存或分享引导式分析探索,例如:
- 下载 - 下载引导式分析“探索”
- 发送 - 一次性发送引导式分析“探索”
- 保存并安排 - 将引导式分析“探索”另存为 Look 或信息中心,并设置定期提交
- 合并结果 - 将引导式分析结果与其他“探索”结果合并
重新加载引导式分析
如需重新加载引导式分析中的数据,请从三点状图标 Options(选项)菜单中选择 Reload(重新加载)选项。
引导式分析会刷新并显示最新数据。