使用稽核記錄監視儀錶板使用量

重要

這項功能處於公開預覽狀態。

本文提供工作區系統管理員可用來監視與 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

下圖顯示範例查詢結果：

哪些儀錶板標識碼與最受歡迎的儀錶板相關聯？

本文中的大部分範例都著重於特定儀錶板上的稽核活動。 您可以使用稽核記錄來擷取特定的儀錶板標識碼。 下列查詢會藉由計算 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

下圖顯示範例查詢結果：

此儀錶板在過去一周中檢視了多少次？

下列查詢會使用特定的 dashboard_id 來顯示過去一周檢視儀錶板的次數。 數據 action_name 行會顯示是否已存取草稿或已發佈的儀錶板。 getPublishedDashboard 是指已發佈儀錶板的檢視。 getDashboard 是指草稿儀錶板的檢視。 當您執行查詢時，請以工作區中儀錶板相關聯的 UUID 字串取代 <dashboard_id> 。

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

下圖顯示範例查詢結果：

過去一周誰是頂級觀眾？

下列查詢會識別過去一周最常檢視特定儀錶板的使用者。 它也會顯示這些檢視是在草稿或已發佈的儀錶板上。 針對此查詢，儀錶板標識碼會以參數的形式提供。 若要深入瞭解如何使用儀錶板參數，請參閱 使用儀錶板參數。

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%"

下圖顯示範例查詢結果：