Surveiller l’utilisation du tableau de bord

Important

Cette fonctionnalité est disponible en préversion publique.

Cette page contient des exemples de requêtes que les administrateurs peuvent utiliser pour surveiller l’activité associée aux tableaux de bord. 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.

Les administrateurs de compte ont accès aux tables système par défaut. Pour accorder l’accès à d’autres utilisateurs, consultez Accorder l’accès aux tables système.

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.

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. Pour obtenir l’ID dashboard_id d’un tableau de bord spécifique, consultez l’URL et l’ID du tableau de bord.

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 :

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.