使用“系统活动”探索创建 Looker 使用情况报告

已获授 see_system_activity 权限的 Looker 管理员和用户可以访问 探索菜单中的 Looker 系统活动探索。

系统活动探索会连接到 Looker 的底层应用数据库。这些页面会显示与您的 Looker 实例相关的信息,包括在实例中保存的 Look 和信息中心、用户信息、历史查询信息以及实例性能统计信息。系统活动数据的粒度和保留期限都受系统限制。“系统活动”旨在收集大量数据,汇总这些数据可用于补充您的业务日志。

默认情况下,系统活动数据会存储在 Looker 的内部数据库中。大多数表都会按定期时间表截断,以遵守存储空间限制。例如,“历史记录”表格会截断为过去 90 天的数据。某些表采用更严格的数据保留政策。如需提高数据保留率,不妨考虑使用精英系统活动

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

系统活动探索

以下是系统活动探索:

探索名称 说明 缓存时长
内容使用 有关“外观”和信息中心使用情况的数据,包括查看、收藏、安排、嵌入和通过 API 访问的频率。此外,还包含有关各个外观和信息中心的详细信息。 12 小时
数据库连接 数据库连接的详细信息。包含有权访问数据库连接的用户的相关信息。 1 小时
信息中心 有关所有信息中心和信息中心元素的详细信息。包含与信息中心相关联的视图、查询、角色、用户和文件夹的相关信息。 12 小时
信息中心效果 信息中心的效果和历史数据。 1 小时
事件 Looker 中历史事件的相关信息,包括每个事件的名称、类型和频率。包含与事件相关联的群组和用户的相关信息。 1 小时
事件属性 有关构成事件的属性的信息。在事件“探索”中包含数据,并添加属性信息。 12 小时
字段用法 LookML 字段和使用次数。 1 小时
文件夹 有关所有文件夹、每个文件夹中存储的内容以及每个文件夹的创建者的信息。 1 小时
群组 群组列表以及这些群组的详细信息,包括父级群组和子群组,以及每个群组所属的用户和角色。 1 小时
历史记录 过去 90 天内运行的所有查询的详细信息。 12 小时
Look 所有外观的详细信息。包含与数据分析关联的信息中心、查询、用户和文件夹。 12 小时
合并查询 有关合并的查询的信息,包括来源查询和合并的查询的字段和其他元素。 1 小时
PDT build 有关 PDT build 的详细信息,包括完成 build 所需的时间,以及 PDT 所属的连接和模型。 1 小时
PDT 事件日志 与 PDT 相关的历史事件的相关信息,包括 PDT 重新构建和错误。

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

如需查看内容使用情况信息中心事件事件属性历史记录外观合并查询PDT buildSQL 查询定期方案用户探索的常见用例示例,请参阅本页中的使用系统活动探索部分。

使用系统活动探索

以下是一些示例,展示了如何在“系统活动”中使用某些探索,以及一些常见问题的解答。如需访问本部分中的探索示例,请将示例网址中的 <instance_name.looker.com> 替换为您的 Looker 实例的地址。

API 使用情况

API 使用情况探索摘要会显示对 Looker 实例进行的 API 调用量。

您可以使用 API 使用情况探索功能来回答以下问题:

如何获取 API 调用的每日审核报告?

您可以使用 API 用量探索功能,检索在任何给定时间段内对您的实例进行的所有 API 调用的列表。如需查看特定日期的通话记录,请执行以下操作:

  1. API 使用情况中选择端点
  2. API 使用情况中选择总使用量
  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 使用情况中选择总使用量
  3. 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 访问的频率。其中还包含有关各个外观和信息中心的详细信息。

快速入门分析

内容使用情况“探索”部分包含快速入门分析,您可以使用这些分析快速解答问题,或将其用作其他查询的起点。

在空白探索中选择“快速开始”分析功能块,或在已运行的探索中选择闪电图标 快速开始菜单,Looker 会显示一个包含预选和排序字段的查询,以回答以下某个问题:

  • 哪些内容被用户收藏次数最多?
  • 过去 3 天内访问了哪些内容?
  • 过去 60 天内未访问过哪些内容?
  • 使用 Looker API 访问的内容中,哪些内容的访问频率最高?
  • 过去 7 天内创建的哪些信息中心使用频率最高?
  • 过去 7 天内创建的哪些外观被使用最多?
  • 哪些董事会被收藏的次数最多?
  • 哪些内容的观看次数最多?

您可以使用内容使用情况“探索”部分,查找您实例中最受欢迎的主题或信息中心。然后,您可以使用历史记录探索来确定热门外观或信息中心使用的过滤条件。如需查找最热门的 Look 或信息中心,请执行以下操作:

  1. 内容使用情况“探索”部分,从内容使用情况视图中选择 Content IDContent TitleContent Type
  2. 内容使用情况视图中,针对内容类型添加过滤条件,并将过滤条件值设为 dashboard OR look
  3. 内容使用情况中选择查看总数。您还可以从内容使用情况视图中选择收藏总数时间表总数API 总数嵌入总数等字段。
  4. 总观看次数对结果进行降序排序,以便优先列出最热门的内容。
  5. 您还可以在内容使用情况视图的上次访问过后天数字段中添加过滤条件,以将数据限制在特定时长内。例如,您可以将过滤条件值设置为 is less than 30,以将您查看的数据限制为过去 30 天内的数据。

然后,您可以使用历史记录探索来查找特定数据洞见或信息中心中使用的过滤条件:

  1. 历史记录探索中,从信息中心视图或外观视图中,按 ID 字段进行过滤,然后输入您使用内容使用情况探索功能确定的信息中心或外观的 ID。
  2. 查询视图中选择过滤条件,系统会返回您要过滤的 Dashboard 或 Look 使用的过滤条件列表。

信息中心

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

快速入门分析

信息中心“探索”部分包含快速入门分析,您可以使用这些分析快速解答问题,或将其用作其他查询的起点。

在空白探索中选择“快速开始”分析功能块,或在已运行的探索中选择闪电图标 快速开始菜单,Looker 会显示一个包含预选和排序字段的查询,以回答以下某个问题:

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

事件

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

以下是活动探索的一些常见用途:

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

如何查找和分类 API 请求?

您可以使用事件探索功能查找已发出的所有 API 请求并对其进行分类:

  1. 事件视图中选择名称类别字段。
  2. Is API Call (Yes / No)(是否为 API 调用)上添加一个过滤条件,并将过滤条件值设置为 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. 用户视图中选择 ID名称
  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

如何跟踪实验性功能的启用时间?

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

  1. 事件字段中选择创建时间
  2. 事件属性字段中选择名称
  3. 事件中,针对名称添加过滤条件,并将过滤条件值设置为 update_labs_feature
  4. 您还可以从用户中添加 IDName 等字段,以查看启用实验性功能的用户的相关信息。

在此示例中,当“事件属性”的名称labs_feature_id 时,已启用或已停用的实验性功能的名称会显示在“事件属性”的字段中。事件属性中的名称值为 labs_feature_value 时,值 truefalse 表示实验性功能处于开启还是关闭状态。

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

历史记录

History(历史记录)探索卡片会记录各个查询。该报告可用于排查问题,因为其中包含过去 90 天内在您的实例上运行的所有查询的详细信息。

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

截断“历史记录”表

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

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

对部分字段的说明

历史记录探索中的每个字段都有说明,可帮助您了解其用途。下表更详细地介绍了客户经常询问的某些字段:

字段名称 说明 可能的值
来源 查询的来源,例如数据洞察、探索、定时任务、提醒、信息中心等。
  • alerts:查询是通过提醒发起的。
  • api:查询是使用 Looker API 发起的。
  • api3:查询是使用 Looker API 发起的。
  • authenticated_download:查询是使用 Looker Action Hub流式传输操作按计划启动的。
  • dashboard:查询是从信息中心发起的。(查询可能是通过界面、API 或计划任务启动的。)
  • dashboard_prefetch:查询是从信息中心预提取发起的。
  • data-download-api:此查询是通过以 CSV 格式下载的控制台发起的。
  • drill_modal:在用户深入数据时发起了查询。
  • explore:查询是从探索启动的。(查询可能通过界面或 API 发起)
  • guided_analysis:该查询是使用“系统活动”实验室中的引导式分析功能创建的。
  • internal:Looker 运行了该查询,以出于内部用途检索元数据。
  • look:查询是从外观启动的。(查询可能由界面、API 或计划任务启动。)
  • merge_query:查询是通过合并查询发起的。
  • private_embed:查询是从不公开嵌入发起的。
  • public_url:查询是从启用了公开访问的“外观”启动的。
  • regenerator:查询由 PDT 再生器发起。
  • render_manager_cache:查询是由以 PDF 或 PNG 格式下载内容而发起的。这可以是数据分析卡片或信息中心。
  • scheduled_task:查询按时间表运行,并生成了 PDF。(此来源不包括安排以非 PDF 格式(例如 CSV)提交的文件。)
  • sql_interface:查询由使用开放式 SQL 接口的第三方应用发起。
  • sqlrunner:查询是从 SQL Runner 发起的。
  • suggest:查询是作为过滤器建议查询创建的。
发卡机构来源 查询的来源(已分桶)。
  • Action Hub:查询是使用 Looker Action Hub 发起的。其中包括 Sourceauthenticated_download
  • API:查询是使用 Looker API 发起的。其中包括 Sourceapi3
  • 系统:Looker 发起了查询,无需用户直接干预。这包括来源alertsdata-download-apischeduled_task
  • 用户:查询由 Looker 用户发起。这包括来源dashboarddrill_modalexplorelookmerge_queryprivate_embedrender_managersqlrunnersuggest
  • 其他:查询不属于任何其他类别。其中包括 Sourceinternal
状态 历史记录事件的当前状态。
  • cache_only_miss:查询是使用 cache_only=TRUE 选项运行的,并且不存在缓存条目。
  • complete:查询已成功完成。
  • error:查询因出现错误而失败。添加 Message 字段以查看错误详情。
  • killed:查询已被用户、数据库或 Looker 取消。
查询运行次数 此字段会通过滤除 Status 字段值为 cache_only_miss 的历史记录来统计查询运行次数。换句话说,此字段仅包含 Status 字段值为 completeerrorkilled 的历史记录。 正整数。

快速入门分析

历史记录“探索”部分包含快速入门分析,您可以使用这些分析快速解答问题,也可以将其用作其他查询的起点。

在空白探索中选择“快速开始”分析功能块,或在已运行的探索中选择闪电图标 快速开始菜单,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. 查询中选择 IDLink
  2. 历史记录中选择平均运行时间(以秒为单位)查询运行次数,即可查看每个查询的平均运行时间和查询的运行次数。
  3. 您可以在历史记录中针对完成日期添加过滤条件,并将过滤条件值设置为 is in the past 7 days 等时间范围,以限制显示的结果。
  4. 是否为单个查询(是 / 否)上添加过滤条件,并将其值设置为 is Yes,以便从结果中排除合并查询。
  5. 您可以仅显示运行时长超过特定阈值(例如 5 分钟)的查询;为此,您可以按平均运行时长(以秒为单位)进行过滤,并将过滤条件值设为 is greater than 300
  6. 历史记录中,按平均运行时间(秒)降序排序,以便先列出平均运行时间最长的查询。

然后,您可以将查询另存为“查看”,并创建提醒,以便在有查询的运行时超出您指定的阈值时通知您。

在以下网址示例中,您可以通过将过滤条件元素 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

从 Google 表格中发起了哪些查询?

您可以使用历史记录探索查看使用 Looker 专用关联工作表功能在 Google 表格中生成的查询列表:

  1. 历史记录创建日期组中,选择日期时间
  2. 历史记录Query API Client Properties 组中,选择 API Client NameConnected Sheets Spreadsheet IDConnected Sheets Trigger
  3. 用户中选择姓名
  4. 历史记录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 探索的常见问题:

哪些外观会公开分享?

您可以使用外观探索功能查看哪些外观是公开分享的或启用了公开网址。

  • 外观中,按公开(是 / 否)过滤,并将过滤条件值设为 Yes
  • 外观中选择 ID名称链接
https://<instance_name.looker.com>/explore/system__activity/look?fields=look.id,look.title,look.link&f[look.public]=Yes&limit=500

特定外观的作者是谁?

如需查找特定外观的作者,请执行以下操作:

  1. 外观中的 ID 进行过滤,将值设置为外观的 ID。
  2. 用户中选择 IDName
  3. 您还可以从外观中选择创建日期标题等字段。

哪些 Look 已被删除?

如需查看所有已删除的妆容的列表,请执行以下操作:

  1. 查看中选择 ID标题链接删除日期
  2. 查看中,按删除日期添加过滤条件,并将过滤条件值设置为 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. 合并查询来源查询中选择计数
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 构建时间,请执行以下操作:

  1. PDT Builds 视图中,针对 Start Time 添加过滤条件,并将其值设置为 is in the past 2 days
  2. PDT Builds 视图中选择 Start TimeView NameConnectionModel NameElapsed MinutesElapsed 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”,并创建提醒,以便在有 build 时间超出您指定阈值的 PDT 时通知您。

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

  1. PDT Builds 视图中,针对 Average Build Time Minutes 添加过滤条件,并将其值设置为 is greater than 30
  2. PDT Builds 视图中选择 View NameConnectionAverage 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 会显示一个包含预选和排序字段的查询,以回答以下某个问题:

  • 每个查询阶段花了多长时间?
  • 哪些探索的主查询平均执行时间最长?
  • 哪些用户的主查询平均执行时间最长?
  • 一天中的哪些时间异步 worker 的时间最长?
  • 一天中的哪些时间查询初始化时间最长?
  • 一天中的哪些时间连接处理时间最长?
  • 一天中的哪些时间主查询用时最长?
  • 一天中的哪些时间查询后延迟时间最长?

SQL 查询

SQL 查询探索卡片包含已运行的 SQL 查询的相关信息,包括最近运行的时间和频率,以及运行这些查询的用户的详细信息。

您可以使用 SQL 查询探索功能来回答以下问题:

哪些用户运行的 SQL 查询最多?

您可以使用 SQL 查询探索功能来确定运行 SQL Runner 查询次数最多的用户:

  1. 用户中选择 IDName
  2. SQL Runner 查询中选择计数
  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. 已安排的方案中选择 ID名称下次运行时间,以查看系统时区中每个已安排的方案的下次运行时间。
  2. 用户中选择 ID名称,以查看创建时间表的用户。
  3. 运行一次(是/否)进行过滤,并将过滤条件值设为 No,以排除已发送一次(例如,投放了外观)或作为一次性测试发送(例如,投放了外观的测试)的传送。
  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. 您还可以从安排的作业阶段中选择开始时间完成时间

然后,您可以根据已安排的作业是卡在 execute 阶段还是 enqueued for delivery 阶段等情况,使用 IDRuntime 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

如何查找时间表所有者?

您可以使用已安排的方案“探索”部分查找时间表所有者:

  1. 定时发布方案中选择 ID名称
  2. 用户中选择 IDName
  3. 运行一次(是/否)进行过滤,并将过滤条件值设为 No,以排除已发送一次(例如,投放了外观)或作为一次性测试发送(例如,投放了外观的测试)的传送。
  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. 安排的方案中选择 ID 名称 Cron 时间表下次运行时间
  2. 运行一次(是/否)进行过滤,并将过滤条件值设为 No,以排除已发送一次(例如,投放了外观)或作为一次性测试发送(例如,投放了外观的测试)的传送。
  3. 您还可以在下次运行时间上添加过滤条件,并将过滤条件值设为 is not null,以便在结果中仅包含现有的安排的传送时间。

然后,您可以更改时间安排(例如投放外观的时间),以免多个时间安排同时运行。

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. 发送所有结果进行过滤,然后将值设置为
  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. 安排的方案目标中选择类型,以查看目标类型(例如,投放外观)。
  5. 定期作业中选择 ID状态状态详情,以查看每个定期作业的状态和任何错误消息。
  6. 已安排的作业中选择创建时间完成时间
  7. 定时作业阶段中选择运行时(以秒为单位)
  8. 您还可以在外观视图或信息中心视图中选择链接,以获取指向外观或信息中心(用于查看时间表)的链接。
  9. 如需将结果限制为特定时间范围,请在定期作业创建日期上添加过滤条件,并将过滤条件值设为所需的时长,例如 is in the past 7 days
  10. 运行一次(是/否)进行过滤,并将过滤条件值设为 No,以排除已发送一次(例如,投放了外观)或作为一次性测试发送(例如,投放了外观的测试)的传送。
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. 定期投放方案中选择 Cron 时间表,以便以 Cron 字符串的形式查看每个时间表的定期投放时间。
  5. 您还可以在外观视图或信息中心视图中选择链接,以获取指向外观或信息中心(用于查看时间表)的链接。
  6. 运行一次(是/否)进行过滤,并将过滤条件值设为 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 时间表会失败并显示特定错误消息:

  1. 定期作业中选择创建时间完成时间ID状态状态详情,以查看定期作业及其状态和错误消息的列表。
  2. 已安排的作业阶段中选择阶段
  3. 定期方案目标位置中选择类型格式,以查看目标位置类型(例如,投放外观)和数据格式(例如,投放外观)。
  4. 已安排的作业中,按状态过滤,并将过滤条件值设为 failure,以便仅包含已失败的已安排作业。
  5. 如需仅包含特定目标的结果,请按定期方案目标位置中的类型字段进行过滤,并将过滤条件值设置为所需的目标位置,例如 sftpemail
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. 用户中选择姓名
  3. 定期发布方案中选择 Cron 时间表
  4. 已安排的作业阶段中选择平均运行时(秒)
  5. 运行一次(是/否)进行过滤,并将过滤条件值设为 No,以排除已发送一次(例如,投放了外观)或作为一次性测试发送(例如,投放了外观的测试)的传送。
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. 用户中选择姓名
  4. 定期发布方案中选择 Cron 时间表
  5. 定时作业中选择 ID状态创建时间完成时间
  6. 定时作业阶段中选择运行时(以秒为单位)
  7. 运行一次(是/否)进行过滤,并将过滤条件值设为 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 人员访问了您的实例、他们访问了您的实例的时长以及他们运行了多少次查询,请执行以下操作:

  1. 用户中选择姓名
  2. 历史记录中,依次选择大致的网站使用情况(以分钟为单位)查询次数 > 查询运行次数
  3. 历史记录中,按创建日期 > 日期过滤,并将值设置为您要查看 Google 人员访问记录的时间段。
  4. 历史记录中,依次选择来源 > 来源进行过滤,并将值设为 is not equal to scheduled_task,以消除所有已安排的任务。
  5. 用户事实中,依次选择用户权限 > 是否为 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

“系统活动”Labs 功能中的引导式分析

借助引导式分析,Looker 管理员和已获授 see_system_activity 权限的用户可以通过问答形式在历史记录“探索”部分中快速解答与实例用量相关的关键问题。如需让用户能够访问引导式分析,管理员必须启用“系统活动”中的引导式分析 实验性功能

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

Looker 会选择可视化类型,以最佳方式显示所选数据,且该类型无法更改。

用户目前可以通过历史记录“探索”部分访问多种引导式分析选项:

  • 您的实例中哪些用户最活跃?- 了解哪些用户从您的实例中获得了最多价值
  • 哪些内容会给您的实例带来负担?- 识别使用频率较高的内容
  • 用户审核 - 按类型和角色了解用户活动
  • 实例使用情况随时间推移 - 比较不同活动指标随时间推移的变化情况

在空白探索中选择引导式分析

如需运行引导式分析,请选择要使用的分析选项。分析选项显示在引导式分析部分。

引导式分析运行完毕后,您可以自定义数据值来回答关键问题、进一步探索分析结果,或保存分析以与其他有权访问的用户共享。如需关闭分析,只需关闭其浏览器标签页即可。

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

如果您已运行系统活动历史记录探索,则可以选择相应探索名称旁边的快速开始按钮,以选择引导式分析。

此操作会启动快速开始菜单。

快速开始菜单中选择一个引导式分析,以便在新的浏览器标签页中打开并运行引导式分析。

引导式分析运行完毕后,您可以自定义数据值来回答关键问题、进一步探索分析结果,或保存分析以与其他有权访问的用户共享。如需关闭分析,只需关闭其浏览器标签页即可。

自定义引导式分析

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

引导式分析运行完毕后,您可以根据分析结果,从下拉菜单、日期菜单或单选按钮选项中选择值和条件,以更改和创建预先填充值的组合。

例如,您可以选择哪些内容会给您的实例带来较大负担?分析,以确定 Looker 实例中使用频率较高的内容。引导式分析加载完毕后,您可以将在什么时间范围内中的默认时间范围值更改为过去 30 天

引导式分析将自动更新为所选时间范围值。

在此阶段,您可以选择是否通过进一步探索数据,从分析中获得更多数据洞见。您可以将分析保存为“视图”或保存到信息中心,以便与其他有权访问的用户共享;也可以关闭浏览器窗口来关闭分析。

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

借助引导式分析中的三点状 Options(选项)菜单,用户可以:

进一步探索引导式分析

获得引导式分析的初始数据后,您可以选择进一步探索这些数据。为此,您可以选择三点状 Options(选项)菜单,然后选择 Explore from Here(从此处探索)。

系统随即会打开一个新的浏览器标签页,其中包含一个“探索”页面,该页面会预先加载引导式分析中的字段和可视化图表。

您可以通过添加或移除字段、数据透视表或过滤条件等其他自定义设置,获得更多数据洞见。如需了解有关探索的更多最佳实践和提示,请参阅创建和修改探索文档页面。

保存引导式分析

自定义引导式分析后,您可能需要保存该分析,以便与其他有权访问的用户共享。您可以通过以下两种方式保存引导式分析:

向信息中心添加引导式分析可视化结果

如需将引导式分析可视化图表添加到信息中心,请从三点状 Options(选项)菜单中选择 + Add to Dashboard(添加到信息中心),打开将引导式分析保存到信息中心菜单。

将引导式分析保存到信息中心菜单打开后,请按以下步骤操作:

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

    系统会弹出一个对话框,通知您已将引导式分析添加到所选信息中心。

  5. 选择相应链接可前往信息中心,查看或修改信息中心。

  6. 或者,选择完成退出弹出式窗口。

将引导式分析另存为 Look

如需将引导式分析保存为“探索主题”,请从三点状图标 Options(选项)菜单中选择 Explore from Here(从这里开始探索)选项:

系统随即会打开一个新的浏览器标签页,其中包含一个“探索”页面,该页面会预加载引导式分析中的字段和可视化结果:

如需将探索保存为外观,请按以下步骤操作:

  1. 在“探索”页面右上角,选择齿轮图标菜单。
  2. 选择保存
  3. 选择作为外观以打开保存外观菜单。

  4. 标题字段中,输入新标题。如果您要覆盖现有外观,请将此字段留空。

  5. 说明字段中,您可以输入相应外观的说明。如果您要覆盖现有外观,请将此字段留空。

  6. 文件夹字段中,检查当前文件夹是否为所需的目标位置。Folder 字段会显示所选文件夹的名称和位置,右侧会显示所选文件夹的内容。如果您选择的文件夹不允许保存外观,菜单底部会显示一条警告,并且保存并查看外观按钮将处于停用状态。

  7. 如果您想保存到其他文件夹,请前往要保存 Look 的文件夹。您可以通过以下任一方式前往该文件夹:

    • 文件夹字段中,选择要前往的任何父级文件夹。
    • 在左侧,选择要前往的顶级文件夹的名称。
    • 在右侧,选择要使用的子文件夹的名称,或前往其中一个子文件夹。
    • 如果子文件夹很多,您可以在按标题过滤字段中输入子文件夹名称,以便将列表过滤为仅包含该子文件夹。

  8. 如果您想覆盖现有外观,请向下滚动或使用按标题过滤字段查找并选择所需的外观。外观的标题和说明(如果有)会显示在标题说明字段中。

  9. 保存您的 Look。

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

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

  • 下载 - 下载引导式分析“探索”
  • 发送 - 将引导式分析“探索”作为一次性提交内容发送
  • 保存并安排时间 - 将引导式分析探索保存为“情景”或信息中心,并设置定期提交
  • 合并结果 - 用于将引导式分析探索结果与其他探索结果合并

重新加载引导式分析

如需重新加载引导式分析中的数据,请从三点状图标 Options(选项)菜单中选择 Reload(重新加载)选项。

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