監査ログによるダッシュボードの使用状況の監視

プレビュー

この記事では、ワークスペース管理者が AI/BI ダッシュボードに関連付けられたアクティビティを監視するために使用できるサンプルクエリを提供します。すべてのクエリは、リージョン内のワークスペースからのすべての監査イベントのレコードを格納するシステムテーブルである監査ログテーブルにアクセスします。

「システムテーブルによる使用状況の監視」を参照してください。使用可能な監査ログサービスとイベントの包括的なリファレンスについては、「監査ログリファレンス」を参照してください。

ドラフトダッシュボードと公開済みダッシュボードの監視

このセクションの例では、ダッシュボードのアクティビティに関する一般的な質問の監査ログを取得する方法を示します。

先週作成されたダッシュボードの数はいくつですか?

次のクエリは、過去 1 週間にワークスペースで作成されたダッシュボードの数を返します。

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 を取得できます。次のクエリは、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

次の図は、クエリ結果の例を示しています。

このダッシュボードは過去 1 週間に何回表示されましたか?

次のクエリでは、特定の dashboard_id を使用して、過去 1 週間にダッシュボードが表示された回数を示します。 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

次の図は、クエリ結果の例を示しています。

先週の視聴者数が多かったのは誰でしたか?

次のクエリは、過去 1 週間に最も頻繁に特定のダッシュボードを表示したユーザーを特定します。また、これらのビューがドラフトダッシュボードまたは公開済みダッシュボードのどちらにあったかも表示されます。このクエリでは、ダッシュボード 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

次の図は、クエリ結果の例を示しています。

埋め込みダッシュボードの監視

ワークスペースイベントの監査ログを使用して、埋め込みダッシュボードのアクティビティを監視できます。監査ログに表示されるその他のワークスペースイベントについては、「ワークスペースイベント」を参照してください。

次のクエリは、外部の Web サイトまたはアプリケーションに埋め込まれたダッシュボードの詳細を取得します。

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

次の図は、クエリ結果の例を示しています。