使用系统活动探索功能创建 Looker 使用情况报告

在使用 MySQL 后端为客户托管的 Looker 部署启用系统活动之前，请验证您是否已为后端数据库正确设置用户。具体而言，您必须先执行到 grant all on looker_tmp.* to '<DB_username>'@'%'; 的步骤，然后才能启用系统活动功能。请参阅将 Looker 后端数据库迁移到 MySQL 文档流程。

拥有 see_system_activity 权限的 Looker 管理员和用户可以在 浏览菜单中访问 Looker 的系统活动中的探索功能。

系统 Activity 探索会连接到 Looker 的底层应用数据库。它们会显示有关您的 Looker 实例的信息，包括保存在实例中的外观和信息中心、用户信息、历史查询信息和实例性能统计信息。系统活动数据的粒度和保留情况都受到系统限制的约束。系统活动旨在收集海量数据，并可通过汇总数据来补充业务日志。

这些数据对于补充监控和审核活动很有用，但并不会取代您当前的合规性策略。

默认情况下，系统活动数据存储在 Looker 的内部数据库中。大多数表都会定期被截断，以符合存储限制。例如，历史记录表格会被截断为过去 90 天的数据。部分表具有更严格的数据保留政策。如需提高数据保留率，不妨考虑使用 Elite System Activity。

由于 Looker 内部数据库的权限有限，因此无法使用 SQL Runner 查询系统活动数据。

用户运行的过滤器中的文本可以在“系统活动”中访问，并且任何有权查看“系统活动”模型的用户均可查看。

采取行动：修改哪些人有权访问“系统活动”模型。Looker 管理员默认可以使用此模型。如果非管理员用户拥有 see_system_activity 权限，则可以获得系统活动模型的访问权限。

系统活动信息中心和探索的可运行并发查询数量有限。此限制可能会增加系统活动探索的加载时间。

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

系统活动探索

以下是系统活动探索：

探索名称 说明
内容使用情况 关于外观和信息中心使用情况的数据，包括观看次数、偏好、调度、嵌入和通过 API 进行访问的相关数据。此外，还包含有关各个外观和信息中心的详细信息。
数据库连接 有关数据库连接的详细信息。包括有关拥有数据库连接访问权限的用户的信息。
信息中心 所有信息中心和信息中心元素的详细信息。包含与信息中心关联的外观、查询、角色、用户和文件夹的相关信息。
信息中心效果 信息中心的性能和历史数据。
事件 Looker 中历史事件的信息，包括每个事件的名称、类型和频率。包括与事件相关联的群组和用户的相关信息。
事件属性 事件所含属性的相关信息。包含 Event 探索中的数据，并添加属性信息。
字段使用情况 LookML 字段和使用次数。
文件夹 有关所有文件夹、每个文件夹中存储的内容以及有权访问每个文件夹的用户的信息。
群组 群组列表以及这些群组的详细信息，包括上级和下级群组，以及各群组的用户和角色。
历史记录 过去 90 天内运行的所有查询的详细信息。
Look 所有样式的详细信息。包含与 Looks 关联的信息中心、查询、用户和文件夹的相关信息。
合并查询 关于合并查询的信息，包括源查询和合并查询的字段和其他元素。
PDT build PDT 构建的详细信息，包括完成构建所花费的时间，以及 PDT 所属的连接和模型。
PDT 事件日志 与 PDT 相关的历史事件的信息，包括 PDT 重建和错误。

如需详细了解如何查看和了解 PDT 日志操作及其对应的操作数据，请参阅了解 PDT 日志操作文档页面。
查询效果指标 从 Looker 实例运行的查询的详细细分数据。
角色 构成角色的 Looker 角色以及模型和权限集。
SQL 查询 已运行的 SQL 查询，包括其运行频率和频率，以及已运行这些查询的用户的详细信息。
已安排的方案 所有预定数据传送的信息，包括之前预定的作业和当前预定的作业。包括与信息中心、Looks、查询、文件夹以及与预定的数据传送相关的用户的相关数据。
用户 每个用户的详细信息，包括运行的历史查询及其有权访问的内容和文件夹。

请参阅本页面的使用系统 Activity 探索部分，了解 Content Usage、信息中心、事件、事件属性、历史记录、Look、Merge Query、PDT Builds、Planning、Planning、、、、、{/2、}、计划、、、、{/2、}、{2、}计划或}计划。

使用系统 Activity 探索

下面列举了一些示例来说明如何使用“系统活动”中的部分“探索”功能以及一些常见问题的解答。在本部分中，您可以访问将示例网址中的 <instance_name.looker.com> 替换为您的 Looker 实例的地址。

API 使用情况

API 使用情况探索提供了对 Looker 实例进行的 API 调用量的摘要。

您可以使用 API Usage 探索来回答以下问题：

如何获取 API 调用的每日审核？

您可以使用 API 使用情况“探索”功能检索对任意给定时间段内实例发出的所有 API 调用的列表。要查看在某一天拨打了哪些电话，请执行以下操作：

  1. 从 API Usage 中选择 Endpoint。
  2. 从 API Usage 中选择 Total Usage。
  3. 根据 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 调用：

  1. 从 API 使用情况中选择创建月份。
  2. 从 API Usage 中选择 Total Usage。
  3. 根据 API Usage 使用所需的年份过滤 Created Year。
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 进行访问。还包含有关各个外观和信息中心的详细信息。

“快速入门”分析

内容使用情况探索包括快速入门分析，您可以快速从中分析问题，或者作为其他查询的起点：

在空白的“探索”中或从“探索”已运行的闪电般的快速入门菜单中选择“快速入门”分析图块，Looker 会显示带有预选字段并经过排序的查询，以回答以下某个问题：

  • 哪些内容的收藏次数最多？
  • 过去 3 天内访问过哪些内容？
  • 哪些内容在过去 60 天内未被访问？
  • 您使用 Looker API 最常访问哪些内容？
  • 过去 7 天创建的信息中心最常使用吗？
  • 过去 7 天内创建了哪些外观的使用频率最高？
  • 哪些 Jamboard 的收藏次数最多？
  • 哪些内容的观看量最多？

您可以使用内容使用情况“探索”功能查找实例中最热门的外观或信息中心。然后，您可以使用历史记录“探索”功能识别热门外观或信息中心使用的过滤条件。如需查找最热门的外观或信息中心，请按以下步骤操作：

  1. 在内容使用情况“探索”中，从内容使用情况视图中选择 Content ID、内容标题和内容类型。
  2. 从“内容使用情况”视图中添加“内容类型”过滤器，并将过滤器值设置为“dashboard OR look”。
  3. 从 Content Usage 中选择 View Total。您还可以在内容使用情况视图中选择收藏内容总计、时间安排总计、API 总计和嵌入内容总计等字段。
  4. 在查看总数中按降序对结果进行排序，首先列出最热门的内容。
  5. 您还可以从内容使用情况视图中的“上次访问后的天数”字段中添加过滤条件，将数据限制为特定的时间长度。例如，您可以将过滤条件值设置为 is less than 30，将查看的数据限制为过去 30 天。

然后，您可以使用历史记录“探索”功能查找在特定外观或信息中心中使用的滤镜：

  1. 在历史记录“探索”部分，从信息中心视图或外观视图中按 ID 字段进行过滤，然后输入您使用内容使用情况探索找到的信息中心或样式的 ID。
  2. 从查询视图中选择过滤器，以返回信息中心或作为过滤依据的样式使用的过滤器列表。

信息中心

信息中心“探索”部分包含有关信息中心和信息中心元素的详细信息，包括与信息中心关联的外观、查询、角色、用户和文件夹。

“快速入门”分析

信息中心浏览部分包含快速入门分析，您可以快速从中分析问题，或者作为其他查询的起点：

在空白的“探索”中或从“探索”已运行的闪电般的快速入门菜单中选择“快速入门”分析图块，Looker 会显示带有预选字段并经过排序的查询，以回答以下某个问题：

  • 哪些信息中心使用多个探索？
  • 哪些信息中心的自动刷新间隔较短？
  • 有多少信息中心设置为加载时运行？
  • 哪些信息中心内的图块超过 25 个？
  • 哪些信息中心使用的合并查询最多？
  • 哪些信息中心使用了特定的视图或字段？
  • 哪些文件夹包含哪些信息中心？
  • 单个信息中心的板块有哪些？

事件

事件“探索”包含 Looker 中历史事件的相关信息，包括每个事件的名称、类型和频率。“探索”还包含与事件相关联的群组和用户的相关信息。

以下是活动“探索”功能的一些常见用法：

如需详细了解如何查看事件和常见事件属性，以及事件类型列表，请参阅 Looker 事件文档页面。

如何查找和分类 API 请求？

您可以使用事件“探索”查找发出的所有 API 请求并对其进行分类：

  1. 从事件视图中选择名称和类别字段。
  2. 添加针对 Is API Call（是 / 否）的过滤条件，并将过滤条件值设置为 Yes。
  3. 您还可以选择特定字段（例如事件中的创建日期和用户中的名称）来获取有关特定 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 的事件进行过滤，以调查内容更新：

  1. 从事件视图中选择名称。
  2. 在事件视图中添加“名称”字段的过滤条件，然后将过滤条件值设置为contains update。
  3. 您还可以选择其他字段以提供有关每项内容更新的更多信息，例如来自事件的创建时间和来自用户的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

如何查看登录事件？

您可以使用事件“探索”页面来确定哪些用户通过登录事件登录了系统。例如：

  1. 在事件视图中添加“名称”字段的过滤条件，然后将过滤条件值设置为login。
  2. 从 User 视图中选择 ID 和 Name。
  3. 从事件视图中选择创建时间。

事件属性

事件属性“探索”功能包含事件“探索”功能中的数据，提供有关构成事件的属性的更多信息。

以下是“事件属性”“探索”的一些常见用法：

如需详细了解如何查看事件、常见事件属性以及事件类型列表，请参阅 Looker 事件文档页面。

如何查看权限更改？

您可以使用事件属性“探索”来查看权限更改。例如，您可以查看权限发生更改的时间以及更改者：

  1. 更改时间及事件类型，从事件视图中选择创建时间和名称。
  2. 从事件属性中选择名称和值，即可返回所做更改的类型以及更改过权限的用户或已更改的具体权限的信息。
  3. 选择 ID 以及用户中的任何其他字段，即可了解更改用户的相关信息。
  4. 在事件视图中按名称进行过滤，将值设置为 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

如何跟踪实验室功能的启用时间？

您可以使用事件属性“探索”功能来跟踪 Google 实验室功能的启用时间。例如，选择以下字段：

  1. 从事件字段中选择创建时间。
  2. 从事件属性字段中选择名称和值。
  3. 在事件中添加名称过滤条件，然后将过滤条件值设置为 update_labs_feature。
  4. 您还可以添加 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

项目名称何时更改？

您可以使用事件属性“浏览”来查看项目名称何时发生了变化：

  1. 从事件视图中选择创建时间和名称。
  2. 从事件属性中选择名称和值。
  3. 从事件视图中添加“名称”过滤条件，然后将过滤条件值设置为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 天内在您的实例上运行的所有查询的详细信息。

以下是关于使用历史记录“探索”的一些常见问题：

“历史记录”表被截断

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

  • history.created_time 距今已超过 90 天。
  • history.created_time 距今已超过 7 天，history.source 为 scheduled_task。

“快速入门”分析

历史记录探索包含快速入门分析，您可以快速从中分析问题，或者作为其他查询的起点：

在空白的“探索”中或从“探索”已运行的闪电般的快速入门菜单中选择“快速入门”分析图块，Looker 会显示带有预选字段并经过排序的查询，以回答以下某个问题：

  • 过去一天哪些查询来源的活跃度最高？
  • 过去一周哪些用户最为活跃？
  • 哪个用户的信息中心最受欢迎？
  • 过去 30 天内，特定信息中心使用过多少次？
  • 最近运行的查询有哪些？
  • 在过去 30 天内，特定外观被使用了多少次？
  • 各个模型的平均查询运行时数是多少？
  • 特定用户的近期查询活动是什么？

信息中心使用的所有模型有哪些？

您可以使用历史记录“探索”功能查找信息中心使用的所有模型。例如，这有助于在用户无法查看信息中心中的数据时识别用户需要权限的模型。

  1. 从信息中心视图中选择 ID（含边界值）。
  2. 从查询视图中选择模型和计数。
  3. 按 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

如何识别长时间运行的查询？

假设您要为长时间运行的查询创建提醒。例如，您可以使用历史记录“探索”功能查找运行时间最长的查询：

  1. 从 Query 中选择 ID 和 Link。
  2. 从历史记录中选择平均运行时间（秒）和查询运行计数，以查看每个查询的平均运行时间以及查询运行的次数。
  3. 您可以在历史记录中添加“完成日期”过滤条件，然后将过滤条件值设置为时间范围（如 is in the past 7 days）以限制显示的结果。
  4. 添加过滤条件为 Is Single Query (Yes / No)，并将其值设置为 is Yes 以从结果中排除合并查询。
  5. 您只能显示运行时超过特定阈值（如 5 分钟）的查询；为此，您可以过滤平均运行时（以秒为单位）并将过滤条件值设置为 is greater than 300。
  6. 按历史记录中平均运行时（以秒为单位）的降序排序，首先列出平均运行时最长的查询。

然后，您可以将查询保存为 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 是什么时候？

如需确定特定用户上次使用历史记录“探索”功能运行 SQL Runner 查询的时间，请执行以下操作：

  1. 从 SQL Runner 查询视图中选择上次运行时间和用户 ID。
  2. 从 SQL Runner Query 视图添加 User 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

如何查找被数据库终止的查询？

如需通过历史记录“探索”查找被数据库终止的查询，请执行以下操作：

  1. 从历史记录中针对邮件添加过滤条件，并将过滤条件值设置为 contains query killed。
  2. 从历史记录中选择创建日期、ID 和邮件。
  3. 从查询中选择 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 天内访问的每个信息中心的标题，以及每个信息中心被访问的次数。

  1. 从信息中心中选择标题。
  2. 从历史记录中选择查询运行计数。
  3. 从信息中心添加标题过滤条件，然后将过滤条件值设置为 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 天内实例中的每个角色运行探索的次数：

  1. 从查询中选择探索。
  2. 从用户角色中选择并透视名称。
  3. 从历史记录中选择查询运行计数。
  4. 添加用户角色的名称过滤条件，然后将过滤条件值设置为 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 天内是否使用了某个特定的“探索”功能：

  1. 从历史记录中选择创建日期。
  2. 从查询中选择探索和关联。
  3. 在查询中添加探索过滤器，然后输入“探索”的名称。

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

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

  1. 从历史记录中选择创建日期。
  2. 从查询中选择探索和关联。
  3. 对查询中的使用的字段进行过滤，输入视图名称，后跟英文句点（例如 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

Look

Look“探索”包括所有 Looks 的详细信息，包括与 Looks 关联的信息中心、查询、用户和文件夹的相关信息。

以下是关于使用 Look 探索的一些常见问题：

公开共享哪些样式？

您可以使用探索功能查看公开共享了哪些样式或启用了公开网址。

  • 在查找中选择公开（是 / 否），然后将过滤条件值设置为 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 的作者，请执行以下操作：

  1. 从 Look 中过滤 ID，将值设置为 Look' ID。
  2. 从 User 中选择 ID 和 Name。
  3. 您也可以从查看中选择创建日期和标题等字段。

哪些样式已被删除？

如需查看所有已删除的 Look 的列表，请执行以下操作：

  1. 从 Look 中选择 ID、Title、Link 和 Deleted Date。
  2. 在删除日期中添加 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

合并查询

合并查询“探索”部分包含有关合并查询的信息，包括源查询和合并查询的字段和其他元素。

您可以使用合并查询“探索”功能来回答以下问题：

哪些探索的合并频率最高？

您可以使用合并查询“探索”功能探索合并次数最多的“探索”功能，并考虑联接这些表格以获得更好的效果和更多功能。

  1. 从查询中选择探索。
  2. 从 Merge Query Source Query 中选择 Count。
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 build“探索”功能的一些常见用途：

在同时运行许多 PDT 的实例上运行这些查询可能需要更长时间。

如何查看 PDT 构建时间？

您可以使用 PDT build 浏览功能来了解 PDT 的构建时间。例如，如需查看过去 2 天的 PDT 构建时间，请执行以下操作：

  1. 从 PDT Build 视图中添加 Start Time 过滤条件，并将其值设置为 is in the past 2 days。
  2. 从 PDT Build 视图中选择 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 并创建提醒，以便在构建时间超过您指定的阈值时通知您。

例如，如需查看平均构建时间超过 30 分钟的 PDT，请执行以下操作：

  1. 从 PDT Build 视图添加 Average Build Time Minutes（平均构建分钟数）过滤条件，并将其值设置为 is greater than 30。
  2. 从 PDT Build 视图中选择 View Name、Connection 和 Average Build Time Minutes。

如需更改来自“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 运行程序查询的用户：

  1. 从 User 中选择 ID 和 Name。
  2. 从 SQL Runner 查询中选择 Count。
  3. 对 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

已安排的方案

已安排的计划“探索”会提供有关所有已安排的数据交付的信息，包括之前安排的作业和当前安排的作业。

以下是关于使用计划的计划“探索”的一些常见问题：

如何以统一的时区查看已安排的方案？

由于系统活动会将基于时间的数据存储在系统时区中，因此您可以使用预定的方案查看采用一致时区的所有已安排方案：

  1. 从 Scheduled Plan 中选择 ID、Name 和 Next Runtime，以查看系统时区中每个已安排的计划的下一个运行时。
  2. 从 User 中选择 ID 和 Name，以查看创建了时间安排的用户。
  3. 按是一次运行 (Yes/No)（是/否）进行过滤，并将过滤值设置为 No，以排除那些仅发送过一次（例如，用于传送 Look）或作为一次性测试（例如用于测试 Look 传送）发送的传送。
  4. 您还可以从已安排的计划视图中添加 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

时间表在哪个阶段卡住？

您可以使用已安排的方案“探索”功能来确定时间表卡在哪个阶段。例如：

  1. 如需查看特定计划作业卡住的阶段，请从计划的作业按 ID 过滤，然后将过滤条件值设置为计划作业的 ID。 从计划作业阶段选择阶段、预定作业 ID 和运行时（以秒为单位）。
  2. 您还可以在“计划作业”阶段中选择开始时间和已完成时间。

然后，您可以根据 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

如何查找时间表所有者？

您可以使用已安排的方案“探索”功能来查找计划所有者：

  1. 从已安排的方案中选择 ID 和名称。
  2. 从 User 中选择 ID 和 Name。
  3. 按是一次运行 (Yes/No)（是/否）进行过滤，并将过滤值设置为 No，以排除那些仅发送过一次（例如，用于传送 Look）或作为一次性测试（例如用于测试 Look 传送）发送的传送。
  4. 如需查找特定时间表的所有者，请从预定的方案中按 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

哪些计划同时运行？

您可以使用已安排的方案“探索”功能来确定已安排同时运行的方案：

  1. 从 Scheduled Plan 中选择 ID、Name、Cron Schedule 和 Next Run Time。
  2. 按是一次运行 (Yes/No)（是/否）进行过滤，并将过滤值设置为 No，以排除那些仅发送过一次（例如，用于传送 Look）或作为一次性测试（例如用于测试 Look 传送）发送的传送。
  3. 您还可以添加 Next Run Time 过滤条件，并将过滤条件值设置为 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 的时间表：

  1. 过滤 Send All Results，并将值设置为 Yes。
  2. 从预定作业中选择 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 多个时间表的历史记录，例如：

  1. 从已安排的方案中选择 ID。
  2. 从用户中选择名称，即可查看各个时间表的创建者。
  3. 从预定作业中选择 Cron 时间表，以 Cron 字符串的形式查看每个预定作业的预定交付时间。
  4. 从 Scheduled Plan Destination 中选择 Type（类型），以查看目的地类型（例如，对于 Look 的投放）。
  5. 从预定作业中选择 ID、状态和状态详情，即可查看每个预定作业的状态和所有错误消息。
  6. 从预定作业中选择创建时间和最终时间。
  7. 从计划作业阶段中选择运行时（以秒为单位）。
  8. 您也可以从外观视图或信息中心视图中选择链接视图，以便查看相应时间表的“外观”或“信息中心”链接。
  9. 要限定结果仅在特定时间范围内显示，请添加在计划作业中的创建日期进行过滤，然后将过滤条件值设置为所需的时间长度，例如 is in the past 7 days。
  10. 按是一次运行 (Yes/No)（是/否）进行过滤，并将过滤值设置为 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）的时间表列表，请运行以下命令：

  1. 从查询视图添加模型过滤条件，然后将过滤条件值设置为模型的名称。
  2. 从已安排的方案中选择 ID 和名称。
  3. 从用户中选择名称，即可查看各个时间表的创建者。
  4. 从 Scheduled Plan（安排的计划）中选择 Cron Schedule（安排时间表），以 Cron 字符串的形式查看每个时间表的计划投放时间。
  5. 您也可以从外观视图或信息中心视图中选择链接视图，以便查看相应时间表的“外观”或“信息中心”链接。
  6. 按是一次运行 (Yes/No)（是/否）进行过滤，并将过滤值设置为 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 时间表因特定错误消息而失败的情况：

  1. 从预定作业中选择创建时间、最终时间、ID、状态和状态详情，查看已安排作业及其状态和错误消息的列表。
  2. 从计划作业阶段中选择阶段。
  3. 从 Scheduled Plan Destination 中选择 Type（类型）和 Format（格式），以查看目的地类型（例如 Look of Delivery 的目标位置）和数据格式（例如，传送 Look 的目标位置）。
  4. 从预定作业中过滤状态，并将过滤条件值设置为 failure 以仅包含失败的预定作业。
  5. 要仅添加特定目的地的结果，请从计划的计划目的地按类型字段进行过滤，然后将过滤条件值设置为所需的目的地，例如 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

如何查看时间表的运行时指标？

您可以使用计划的计划来探索时间表的运行时指标。例如，如需查看时间表的平均运行时，请执行以下操作：

  1. 从已安排的方案中选择 ID 和名称。
  2. 从 User 中选择 Name。
  3. 从 Scheduled Plan 中选择 Cron Schedule。
  4. 从计划作业阶段中选择平均运行时（以秒为单位）。
  5. 按是一次运行 (Yes/No)（是/否）进行过滤，并将过滤值设置为 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

如需查看预定作业的运行时，请执行以下操作：

  1. 要查看特定计划的所有作业的运行时，请添加计划中的 ID 过滤器，并将过滤器值设置为所需的计划计划 ID。
  2. 从已安排的方案中选择 ID。
  3. 从 User 中选择 Name。
  4. 从 Scheduled Plan 中选择 Cron Schedule。
  5. 从预定作业中选择 ID、状态、创建时间和最终时间。
  6. 从计划作业阶段中选择运行时（以秒为单位）。
  7. 按是一次运行 (Yes/No)（是/否）进行过滤，并将过滤值设置为 No，以排除那些仅发送过一次（例如，用于传送 Look）或作为一次性测试（例如用于测试 Look 传送）发送的传送。

若要在以下网址示例中从 Scheduled Plan 更改 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 员工访问了您的实例，他们访问了您的实例数分钟，以及他们运行的查询数量：

  1. 从 User 中选择 Name。
  2. 从历史记录中选择大致的 Web 使用量（以分钟为单位）和查询数 &gt；查询运行计数。
  3. 在历史记录中按创建日期>日期进行过滤，并将值设为您要 Google 员工查看访问权限的时间段。
  4. 在历史记录中按来源 > 来源进行过滤，并将值设置为 is not equal to scheduled_task 以排除任何计划任务。
  5. 在用户信息中，过滤 User Permissions > Is Looker Employee (Yes / No)，并将值设置为 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

系统活动实验室功能中的指导分析

借助引导式分析，拥有 see_system_activity 权限的 Looker 管理员和用户可以快速通过历史记录“探索”功能以问答形式解答有关实例使用的关键问题。为了让用户能够访问引导式分析，管理员必须启用系统活动中的引导式分析实验室功能。

引导式分析包括预先填充的字段、值和可供选择的选项，以及显示所选指标的可视化图表：

该可视化类型由 Looker 选择，以最好地显示所选的数据，并且无法更改。

用户现在可以通过历史记录探索访问多种引导式分析选项：

  • 您的实例中哪些用户最活跃？— 了解谁从您的实例中获得最大价值
  • 哪些内容会给实例报税？— 识别频繁使用的内容
  • 用户审核 - 按类型和角色了解用户活动
  • 一段时间内的实例使用量 - 比较一段时间内不同的活动指标

从空白的“探索”工具中选择引导式分析

要运行引导式分析，请选择要使用的分析选项。分析选项显示在“快速入门”分析选项上方的“引导式分析”部分中：

在引导式分析运行后，您可以自定义数据值以回答关键问题，深入探索分析，或保存分析以与有权访问的其他用户共享。要关闭分析，只需关闭其浏览器标签页即可。

运行探索后选择引导式分析

如果您已运行系统活动历史记录，则可以选择引导式分析，只需选择“探索”名称旁边的闪电图标即可：

系统随即会启动快速入门菜单：

从快速入门菜单中选择一项引导式分析，即可在新的浏览器标签页中打开并运行这项分析。

在引导式分析运行后，您可以自定义数据值以回答关键问题，深入探索分析，或保存分析以与有权访问的其他用户共享。要关闭分析，只需关闭其浏览器标签页即可。

自定义引导式分析

从空白的“探索”或“探索”的快速入门菜单中选择引导式分析后，分析会自动在新的浏览器标签页中打开并运行。

在引导式分析运行完毕后，您可以更改下拉菜单并创建预填充的值组合，方法是从下拉菜单、日期菜单或单选按钮选项中选择所需值和条件，具体视分析结果而定。

例如，用户选择哪些内容对实例造成了费用？分析，以确定其 Looker 实例上大量使用的内容。引导式分析加载后，用户将“在以下哪个时间范围内？”的默认时间范围值更改为“过去 30 天”：

引导式分析会根据更新后的时间范围值自动重新运行：

在此阶段，您可以选择通过进一步探索数据来进一步深入分析；可以将分析保存为 Look 或保存至数字面板，以便与具有访问权的其他用户共享；或者通过关闭浏览器窗口关闭分析。

引导式分析三点状选项菜单

借助引导式分析中的三点状选项菜单，用户可以执行以下操作：

深入探索引导式分析

通过引导式分析获得初始数据后，您可以选择进一步探索这些数据。为此，您可以选择三点状的选项菜单，然后选择从此处探索：

系统会打开一个新的浏览器标签页，其中会预先加载一些包含引导式分析中的字段和可视化图表的“探索”功能：

您可以添加或移除字段、数据透视或过滤条件，以及其他自定义设置，从而获取更多数据洞见。如需详细了解“探索”方面的最佳做法和提示，请参阅在 Looker 中探索数据。

保存引导式分析

自定义引导式分析后，您可以保存分析以与具有访问权限的其他人共享。您可以通过以下两种方式保存引导式分析：

向信息中心添加引导式分析可视化图表

要向信息中心添加引导式分析可视化图表，请打开三点状选项菜单中的 + 添加到信息中心，打开将引导式分析保存到信息中心菜单：

将将引导式分析保存到信息中心后：

  1. 为引导式分析信息中心图块输入标题。
  2. 选择将要添加引导式分析的信息中心保存到的文件夹。
  3. 选择所需的信息中心。

  4. 选择保存。

    系统会弹出一条确认消息，通知您系统指导的分析已添加到选定的信息中心：

  5. 选择转到信息中心的链接可查看或修改信息中心。

  6. 您也可以选择完成以退出弹出式窗口。

将引导式分析保存为外观

要将引导式分析保存为 Look 分析，请从三点状 Options 菜单中选择 Choose from Here 选项：

系统会打开一个新的浏览器标签页，其中会预先加载一些包含引导式分析中的字段和可视化图表的“探索”功能：

执行其余步骤，将“探索”功能另存为外观：

  1. 选择“探索”右上角的齿轮菜单。
  2. 选择保存。

  3. 选择 Looks 以打开 Save Look 菜单。

  4. 在标题字段中，输入新标题。如果您要保存现有 Look，请将此字段留空。

  5. 在 Description 字段中，您可以输入 Look 的说明。如果您要保存现有 Look，请将此字段留空。

  6. 在文件夹字段中，检查当前文件夹是否为所需的目的地。文件夹字段显示所选文件夹的名称和位置，右侧显示所选文件夹的内容。如果您选择的文件夹不允许保存样式，则菜单底部会显示警告，并且保存和查看视图按钮将被停用。

  7. 如果您想保存到其他文件夹，请找到用于保存 Look 的文件夹。您可以通过以下任一方式导航到该文件夹：

    • 在文件夹字段中，选择要转到的任意父级文件夹。
    • 在左侧，选择一个顶级文件夹的名称以导航到此文件夹。
    • 在右侧，选择要使用的子文件夹的名称，或导航至该子文件夹之一。
    • 如果子文件夹过多，您可以在按标题过滤字段中输入子文件夹名称，将列表过滤为仅包含该子文件夹。

  8. 如果您想保存现有样式，请向下滚动或使用按标题过滤字段以查找并选择所需的样式。样式的标题和说明（如果有）会显示在标题和说明字段中。

  9. 保存外观。

    • 如需保存外观并返回“探索”页面，请选择保存。
    • 要保存和查看您的外观，请选择保存并查看。

您还可以从“探索”中选择其他选项，以保存或分享引导式分析探索，例如：

  • 下载 - 下载引导式分析
  • 发送 - 发送引导式分析“探索”会作为一次性传送
  • 保存并安排时间 - 保存引导式分析“探索”模式或信息中心，并设置定期传送
  • 合并结果 - 合并引导式分析 探索结果与其他探索结果

重新加载引导式分析

要在引导式分析中重新加载数据，请在三点状选项菜单中选择重新加载选项：

引导式分析将刷新并显示最新数据。