通过

使用审核日志监视仪表板使用情况

  • 项目

重要

此功能目前以公共预览版提供。

本文提供一些示例查询，工作区管理员可以使用这些查询来监视与 AI/BI 仪表板关联的活动。 所有查询都可访问审核日志表，该表是一个系统表，用于存储所在区域的工作区中所有审核事件的记录。

有关可用审核日志服务和事件的综合参考，请参阅诊断日志参考。

监视草稿仪表板和已发布的仪表板

本节中的示例演示如何检索有关仪表板活动的常见问题的审核日志。

过去一周创建了多少个仪表板？

以下查询返回过去一周在工作区中创建的仪表板的数量。


SELECT
  action_name,
  COUNT(action_name) as num_dashboards
FROM
  system.access.audit
WHERE
  action_name = "createDashboard"
  AND event_date >= current_date() - interval 7 days
GROUP BY
  action_name

下图显示示例查询结果：

显示前一周创建的仪表板数量的示例查询结果。

本文中的大多数示例重点关注特定仪表板上的审核活动。 可使用审核日志来检索特定的仪表板 ID。 以下查询通过计算与 ID 关联的 getDashboard 和 getPublishedDashboard 操作来检索具有最多视图的仪表板。

SELECT
  request_params.dashboard_id as dashboard_id,
  COUNT(*) AS view_count
FROM
  system.access.audit
WHERE
  action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY
  dashboard_id
ORDER BY
  view_count DESC

下图显示示例查询结果：

显示仪表板 ID 和视图计数的示例查询结果。

过去一周查看了此仪表板多少次？

以下查询使用特定的 dashboard_id 来显示过去一周查看仪表板的次数。 action_name 列显示是访问的草稿仪表板还是已发布的仪表板。 getPublishedDashboard 指已发布仪表板的视图。 getDashboard 指草稿仪表板的视图。 运行查询时，将 <dashboard_id> 替换为与工作区中仪表板关联的 UUID 字符串。


SELECT
  action_name,
  COUNT(action_name) as view_count
FROM
  system.access.audit
WHERE
  request_params.dashboard_id = "<dashboard_id>"
  AND event_date >= current_date() - interval 7 days
  AND action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY action_name

下图显示示例查询结果：

按操作名称显示仪表板视图的示例查询结果。

过去的一周中，谁的查看频率最高？

以下查询标识在过去一周中最频繁查看特定仪表板的用户。 还显示这些视图是在草稿仪表板还是已发布的仪表板上。 对于此查询，仪表板 ID 作为参数提供。 要了解使用仪表板参数的更多信息，请参阅使用仪表板参数。

SELECT
  user_identity.email as user_email,
  action_name,
  COUNT(action_name) as view_count
FROM
  system.access.audit
WHERE
  request_params.dashboard_id = :dashboard_id
  AND event_date >= current_date() - interval 7 days
  AND action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY action_name, user_email

下图显示示例查询结果：

按用户和操作名称显示仪表板视图的示例查询结果。

监视嵌入式仪表板

可使用工作区事件的审核日志监视嵌入式仪表板上的活动。 要了解审核日志中显示的其他工作区事件，请参阅工作区事件。

以下查询检索已嵌入外部网站或应用程序的仪表板的详细信息。


SELECT
  request_params.settingTypeName,
  source_ip_address,
  user_identity.email,
  action_name,
  request_params
FROM
  system.access.audit
WHERE
  request_params.settingTypeName ilike "aibi%"

下图显示示例查询结果：

显示嵌入式仪表板详细信息的示例查询结果。