使用稽核記錄和警示監視 AI/BI 使用量

這很重要

這項功能目前處於 公開預覽版。

本文提供工作區系統管理員可用來監視與儀錶板和 Genie 空間相關聯的活動範例查詢。 所有查詢都會存取稽核記錄數據表，這是一個系統數據表，可儲存您區域中工作區中所有稽核事件的記錄。

請參閱 使用系統資料表監控帳戶活動。 如需可用稽核記錄服務和事件的完整參考，請參閱 診斷記錄參考。

監控草稿和已發佈的儀錶板

本節中的範例示範如何擷取有關儀錶板活動常見問題的稽核記錄。

過去一周已建立多少個儀錶板？

下列查詢會傳回過去一周在工作區中建立的儀錶板數目。

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

下圖顯示範例查詢結果：

過去一天用戶檢視的數目為何？

下列查詢會識別查看器在過去一天存取儀錶板的次數。 結果包括使用者存取已發佈的儀表板（getPublishedDashboard）或草稿儀表板（getDashboard）。

SELECT
  user_identity.email as username,
  COUNT(user_identity.email) as num_views,
  action_name
FROM
  system.access.audit
WHERE
  service_name = 'dashboards'
AND action_name in ('getDashboard', 'getPublishedDashboard')
AND event_time > now() - interval '1 day'
GROUP BY username, 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%"

下圖顯示範例查詢結果：

追蹤Genie的互動空間

本節中的範例示範如何擷取有關 Genie 空間活動的常見問題稽核記錄。

查詢意見反應

下列查詢會傳回過去 30 天內針對工作區中 Genie 空間提交的 意見反應評等 。 查詢中的數據行包括 space_id 提交意見反應之使用者的 和電子郵件位址，以及系統數據表中所有其他數據行。

SELECT
  user_identity.email as user_email,
  action_name,
  request_params.space_id,
  request_params.feedback_rating,
  *
FROM
  system.access.audit
WHERE
  service_name = 'aibiGenie'
  AND action_name = 'updateConversationMessageFeedback'
  AND event_date >= current_date() - interval 30 days

退回審核申請

下列查詢會傳回過去 30 天內 Genie 空間 的檢閱活動要求 。 space_id其中包括新增批註的使用者電子郵件地址、動作類型，以及源數據表中的所有其他列。

SELECT
  user_identity.email as user_email,
  action_name,
  request_params.space_id,
  *
FROM
  system.access.audit
WHERE
    service_name = 'aibiGenie'
    AND action_name = 'createConversationMessageComment'
    AND event_date >= current_date() - interval 30 days

設定警示

您可以設定警示，將這種類型的監視自動化。 請參閱 建立警示 ，以瞭解如何在特定閾值上設定警示。