Surveiller l’utilisation du tableau de bord avec les journaux d’audit

Important

Cette fonctionnalité est disponible en préversion publique.

Cet article fournit 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 IA/BI. 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.

Consultez Surveiller l’activité du compte avec les 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 avec la plupart des vues en comptant les actions et getDashboard les getPublishedDashboard actions 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 :

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 brouillons 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 :