Surveiller l’utilisation de l’IA/BI avec les journaux d’audit et les alertes

Cet article contient des exemples de requêtes que les administrateurs de l’espace de travail peuvent utiliser pour surveiller l’activité associée aux tableaux de bord et aux espaces Génie. Toutes les requêtes accèdent à la table des journaux d’audit, qui est une table système qui stocke les enregistrements de tous les événements d’audit à partir d’espaces de travail de votre région.

Veuillez consulter Surveiller l’activité du compte avec des tables système. Pour obtenir une référence complète des services et événements de journal d’audit disponibles, consultez la référence du journal de diagnostic.

Surveiller les tableaux de bord brouillons et publiés

Les exemples de cette section montrent comment récupérer les journaux d’audit pour des questions courantes sur l’activité du tableau de bord.

Combien de tableaux de bord ont été créés la semaine dernière ?

La requête suivante retourne le nombre de tableaux de bord créés dans votre espace de travail au cours de la semaine dernière.

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

L’image suivante montre des exemples de résultats de requête :

Quels sont les ID de tableau de bord associés aux tableaux de bord les plus populaires ?

La plupart des exemples de cet article se concentrent sur l’activité d’audit sur un tableau de bord spécifique. Vous pouvez utiliser les journaux d’audit pour récupérer des ID de tableau de bord spécifiques. La requête suivante récupère les tableaux de bord ayant le plus de vues en comptant les actions getDashboard et getPublishedDashboard associées aux ID.

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

L’image suivante montre des exemples de résultats de requête :

Combien de fois ce tableau de bord a-t-il été consulté la semaine dernière ?

La requête suivante utilise une requête spécifique dashboard_id pour afficher le nombre de fois où le tableau de bord a été affiché au cours de la semaine précédente. La action_name colonne indique si le tableau de bord brouillon ou publié a été consulté. getPublishedDashboard fait référence aux vues du tableau de bord publié. getDashboard fait référence aux vues du tableau de bord brouillon. Lorsque vous exécutez la requête, remplacez <dashboard_id> par la chaîne UUID associée à un tableau de bord dans votre espace de travail.

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

L’image suivante montre des exemples de résultats de requête :

Quel est le nombre de vues par utilisateur au cours de la dernière journée ?

La requête suivante identifie le nombre de fois où une visionneuse a accédé à un tableau de bord au cours du dernier jour. Les résultats incluent si l’utilisateur a accédé au tableau de bord publié (getPublishedDashboard) ou au tableau de bord brouillon (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

L’image suivante montre des exemples de résultats de requête :

Qui étaient les meilleurs spectateurs de la semaine dernière ?

La requête suivante identifie les utilisateurs qui affichent un tableau de bord spécifique le plus fréquemment au cours de la semaine précédente. Il indique également si ces vues étaient sur des tableaux de bord en brouillon ou publiés. Pour cette requête, l’ID de tableau de bord est fourni en tant que paramètre. Pour en savoir plus sur l’utilisation des paramètres de tableau de bord, consultez Utiliser des paramètres de tableau de bord.

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

L’image suivante montre des exemples de résultats de requête :

Surveiller les tableaux de bord incorporés

Vous pouvez surveiller l’activité sur des tableaux de bord incorporés à l’aide des journaux d’audit des événements d’espace de travail. Pour en savoir plus sur les autres événements d’espace de travail qui apparaissent dans le journal d’audit, consultez événements d’espace de travail.

La requête suivante récupère les détails des tableaux de bord qui ont été incorporés dans des sites web ou applications externes.

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

L’image suivante montre des exemples de résultats de requête :

Suivre les interactions spatiales de Génie

Les exemples de cette section montrent comment récupérer les journaux d’audit pour des questions courantes sur l’activité spatiale Génie.

Rechercher des commentaires

La requête suivante retourne les évaluations des commentaires envoyées pour les espaces Génie dans votre espace de travail au cours des 30 derniers jours. Les colonnes de la requête incluent l’adresse space_id e-mail de l’utilisateur qui a envoyé les commentaires, ainsi que toutes les autres colonnes de la table système.

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

Demandes de retour pour révision

La requête suivante retourne l’activité de demande de révision des espaces Genie au cours des 30 derniers jours. Il inclut l’adresse space_ide-mail de l’utilisateur qui a ajouté le commentaire, le type d’action et toutes les autres colonnes de la table source.

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

Configurer des alertes

Vous pouvez définir des alertes pour automatiser ce type de surveillance. Consultez Créer une alerte pour savoir comment définir une alerte sur un seuil spécifique.