Surveiller l'utilisation du tableau de bord

info

Aperçu

Cette fonctionnalité est en aperçu public.

Cette page contient des exemples de query que les administrateurs peuvent utiliser pour surveiller l'activité associée aux tableaux de bord. Toutes les queries accèdent à la table des logs d'audit, qui est une table système qui stocke les enregistrements de tous les événements d'audit provenant des Workspaces de votre région.

Les utilisateurs ayant les rôles d'administrateur de compte et d'administrateur de metastore ont accès aux tables système par default. Ces administrateurs peuvent accorder l'accès à d'autres utilisateurs. Voir Accorder l'accès aux tables système.

Consultez la référence des tables système. Pour une référence complète des services et événements de logs d’audit disponibles, consultez la référence des logs d’audit.

Surveillez les tableaux de bord brouillons et publiés

Les exemples de cette section montrent comment récupérer les logs d'audit pour les questions courantes concernant l'activité du tableau de bord.

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

La query suivante renvoie le nombre de tableaux de bord qui ont été créés dans votre workspace au cours de la semaine dernière.

SQL

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 présente des exemples de résultats de query :

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

La plupart des exemples de cet article se concentrent sur l'audit de l'activité sur un tableau de bord spécifique. Vous pouvez utiliser les Logs d'audit pour récupérer des ID de tableau de bord spécifiques. La query suivante récupère les tableaux de bord les plus consultés en comptant les actions getDashboard et getPublishedDashboard associées aux ID.

SQL

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 présente des exemples de résultats de query :

Combien de fois ce tableau de bord a-t-il été consulté au cours de la semaine écoulée ?

La query suivante utilise un dashboard_id spécifique pour afficher le nombre de fois où le tableau de bord a été consulté au cours de la semaine passée. La colonne action_name 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 query, l'ID du tableau de bord est fourni en tant que parameter. Pour en savoir plus sur l'utilisation des parameters de tableau de bord, consultez Utiliser les parameters de tableau de bord. Pour obtenir la dashboard_id pour un tableau de bord spécifique, consultez URL et ID du tableau de bord.

SQL

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 présente des exemples de résultats de query :

Quel est le nombre de vues par utilisateur au cours du dernier jour ?

La query suivante identifie le nombre de fois qu'un utilisateur a consulté un tableau de bord au cours des dernières 24 heures. Les résultats indiquent si l'utilisateur a consulté le tableau de bord publié (getPublishedDashboard) ou le tableau de bord brouillon (getDashboard).

SQL

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 présente des exemples de résultats de query :

Qui ont été les principaux utilisateurs la semaine dernière ?

La query suivante identifie les utilisateurs qui consultent le plus fréquemment un tableau de bord spécifique au cours de la semaine écoulée. Il indique également si ces vues se trouvaient sur des tableaux de bord brouillons ou publiés. Pour cette requête, l'ID du 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 les paramètres de tableau de bord.

SQL

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 présente des exemples de résultats de query :

Surveiller les tableaux de bord intégrés

Vous pouvez surveiller l'activité sur les tableaux de bord intégrés à l'aide des Logs d'audit pour les événements du workspace. Pour en savoir plus sur les autres événements du workspace qui apparaissent dans le journal d'audit, consultez Événements du workspace.

La query suivante récupère les détails des tableaux de bord qui ont été intégrés dans des sites web ou des applications externes.

SQL

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 présente des exemples de résultats de query :

Configurer les alertes

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