監査ログとアラートを使用して AI/BI の使用状況を監視する

Von Bedeutung

この機能は パブリック プレビュー段階です。

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

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

下書きダッシュボードと発行済みダッシュボードを監視する

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

過去 1 週間に作成されたダッシュボードの数はいくつですか?

次のクエリは、過去 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 日のユーザーごとのビューの数は何ですか?

次のクエリは、過去 1 日にビューアーがダッシュボードにアクセスした回数を識別します。 結果には、ユーザーが発行済みのダッシュボード (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

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

過去 1 週間の上位視聴者は誰でしたか?

次のクエリでは、過去 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

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

埋め込みダッシュボードを監視する

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

次のクエリでは、外部の 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%"

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

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

アラートを設定する

アラートを設定して、この種類の監視を自動化できます。 特定のしきい値 にアラートを 設定する方法については、「アラートの作成」を参照してください。