Rapports d'utilisation

Rapports d’utilisation indique qui utilise quoi dans votre espace de travail : les écrans, tableaux de bord, applications et notebooks que les utilisateurs ouvrent, le nombre de personnes qui reviennent et leurs parcours. Utilisez-le pour voir ce que vos membres adoptent, quels tableaux de bord et applications sont réellement utiles, et à quel endroit les utilisateurs abandonnent un processus.

Ouvrez-le depuis l’onglet Identité, à côté du Journal de sécurité.

Qui peut y accéder

Les Rapports d’utilisation exigent la même autorisation que le Journal de sécurité : identity.security_log.read. Sans elle, le bouton n’est pas proposé, et un membre qui ouvre malgré tout le rapport voit un avis lui indiquant qu’il n’a pas accès.

Les rapports présentent l’utilisation par membre à deux endroits : l’onglet Utilisateurs, ainsi que les exports Daily activity by member et First use, qui incluent les identifiants des membres. Tout le reste est comptabilisé tous membres confondus. N’accordez cette autorisation qu’aux personnes qui doivent voir l’activité individuelle.

Ce qui est comptabilisé

Les Rapports d’utilisation combinent cinq sources. Choisissez-en une dans Source, ou laissez Toutes les sources.

Source	Ce qui est enregistré
Application PlaidCloud	Les écrans que les membres ouvrent et les actions qu’ils effectuent dans l’application.
Superset	Les consultations de tableaux de bord et de graphiques.
Applications Panel	Les visites des applications et le temps que les membres passent dans chacune.
JupyterHub	Le temps que les membres passent dans les sessions JupyterHub.
Notebooks Jupyter	Les notebooks que les membres ouvrent et enregistrent.

Les sessions JupyterHub et les notebooks Jupyter sont des sources distinctes : vous pouvez donc choisir l’une ou l’autre. Les applications Panel forment une seule source. Les événements de notebook ne sont enregistrés que pour les notebooks exécutés sur l’image de notebook par défaut. Une image personnalisée ne les signale pas.

Note

Chaque jour dans les rapports est un jour UTC. Un membre qui travaille tard le soir sur le continent américain peut apparaître au jour suivant.

Lire les rapports

Choisissez une source et une Plage de dates en haut de la fenêtre, puis sélectionnez Actualiser. Les plages disponibles sont les 7, 30, 90 ou 180 derniers jours. Chaque onglet se charge à sa première ouverture, puis à nouveau lorsque vous changez de source ou de plage.

Vue d’ensemble

Les chiffres clés de la plage :

Chiffre	Signification
Utilisateurs actifs	Membres ayant eu une activité quelconque.
Nouveaux utilisateurs	Membres vus pour la première fois dans la plage.
Utilisateurs récurrents	Membres actifs vus pour la première fois avant la plage.
Minutes actives	Valeur approximative : cinq minutes pour chaque période avec activité.
Événements	Tout ce qui est enregistré.
Événements non attribués	Événements pour lesquels aucun membre n’a pu être identifié. Ils comptent comme des événements, pas comme des utilisateurs.
Minutes de session	Durée des sessions Panel et JupyterHub, comptabilisée séparément des minutes actives.

Adoption liste chaque écran, tableau de bord, graphique ou élément avec sa source, son événement, son nombre d’utilisateurs, sa part des utilisateurs actifs, ses événements et ses événements non attribués. Par mois présente les utilisateurs actifs, la moyenne quotidienne d’utilisateurs et l’attachement (« stickiness ») pour chaque mois, avec une note lorsque le mois est encore en cours, partiellement couvert ou qu’il s’agit d’un instantané figé.

Activité

Les utilisateurs actifs par période Quotidien, Hebdomadaire ou Mensuel, ainsi que la Rétention par première semaine : pour chaque semaine où des membres sont apparus pour la première fois, combien sont revenus lors de chacune des semaines suivantes. Une période marquée d’un astérisque n’est pas entièrement comprise dans la plage.

Parcours

Les déplacements les plus fréquents entre écrans, présentés avec Déplacement depuis, Déplacement vers et Nombre de passages, à travers les applications et les sources. Les parcours couvrent au maximum les 30 derniers jours.

Utilisateurs

Une ligne par membre : nom, nom d’utilisateur, jours actifs, événements, minutes actives, minutes de session, ainsi que la date de première et de dernière activité.

Exports

Téléchargez un résumé au format CSV. Choisissez le Résumé et une Plage de dates pouvant aller jusqu’à 25 mois, puis sélectionnez Télécharger en CSV.

Résumé	Contenu
Activité quotidienne	Utilisateurs et événements pour chaque jour, source, événement et sujet.
Activité quotidienne par membre	Les mêmes données pour chaque membre, avec les identifiants des membres.
Adoption mensuelle	Utilisateurs et événements pour chaque mois, source, événement et sujet.
Utilisateurs actifs mensuels	Utilisateurs actifs pour chaque mois et chaque source.
Première utilisation	Date à laquelle chaque membre a utilisé chaque source pour la première fois, avec les identifiants des membres.

L’export utilise la source que vous avez choisie au-dessus des onglets. Un résumé volumineux est téléchargé par lots pouvant atteindre 50 000 lignes, et la fenêtre les assemble en un seul fichier. Si le fichier dépasse la taille que la fenêtre peut construire, elle enregistre ce qu’elle a et vous signale que le fichier est incomplet : choisissez une plage plus courte pour obtenir le reste.

Chaque export écrit une entrée dans le Journal de sécurité indiquant qui a exporté quel résumé, la plage et le nombre de lignes. Un résumé réparti sur plusieurs lots écrit une entrée pour chaque lot.

Attention

Les résumés mensuels incluent une ligne de total pour chaque événement, avec le sujet *. Cette ligne correspond aux utilisateurs et événements distincts sur l’ensemble des sujets de l’événement. Ne l’additionnez pas aux lignes de sujet, sinon vous compterez tout deux fois.

Entonnoir

Voyez combien de membres parcourent une séquence d’étapes. Une étape est un événement issu de l’une des sources, pour un sujet particulier, ou Tout sujet.

1. Sélectionnez Ajouter une étape et choisissez la source, l’événement et le sujet de chaque étape. Un entonnoir comporte de 2 à 6 étapes.
2. Choisissez le Délai autorisé entre les étapes : 1, 6, 24, 72 ou 168 heures.
3. Choisissez une Plage de dates de 7, 30 ou 90 jours.
4. Sélectionnez Exécuter l’entonnoir.

Le résultat indique, pour chaque étape, combien de membres l’ont atteinte, la part de ceux qui ont commencé, combien se sont arrêtés là, et le délai médian depuis l’étape précédente. Les étapes peuvent mélanger les sources : vous pouvez donc suivre un membre depuis un écran PlaidCloud jusqu’à un tableau de bord Superset. Entonnoirs récents rouvre un entonnoir que vous avez déjà exécuté. Une liste d’étapes ne propose que les événements enregistrés dans la plage.

Utilisation non attribuée

Certains événements ne peuvent pas être rattachés à un membre PlaidCloud. Ils sont comptés dans Événements et dans Événements non attribués, mais jamais dans les nombres d’utilisateurs. Les principaux cas :

• Un compte Superset créé dans Superset plutôt que via PlaidCloud.
• La consultation d’un tableau de bord intégré, qui n’a pas d’utilisateur Superset.
• L’activité Panel et JupyterHub que les journaux de la plateforme ne permettent pas de rattacher à un membre. Leur attribution provient de ces journaux ; considérez-la donc comme approximative.

Une part importante d’événements non attribués pour une source signifie que ses nombres d’utilisateurs sont sous-estimés.

Début de l’historique

L’historique commence lorsque la collecte d’utilisation est activée pour votre espace de travail ; un jour ou un mois antérieur n’affiche aucune activité. Le premier mois contenant des données est signalé comme partiel.

Panel et JupyterHub sont lus à partir des journaux de la plateforme, conservés environ 90 jours. Au démarrage de la collecte, ces deux sources comblent au plus cet historique antérieur. Superset le comble à partir de ses propres journaux, jusqu’à 180 jours. Seule l’application PlaidCloud démarre de zéro au lancement de la collecte.

Les Rapports d’utilisation conservent les événements bruts pendant 180 jours, ce qui explique que la plage la plus longue soit de 180 jours, et conservent les résumés mensuels pendant 25 mois. Lorsqu’un membre est supprimé en dehors de PlaidCloud, par exemple via SCIM ou Keycloak, son utilisation brute expire après 180 jours et son enregistrement de première utilisation après 25 mois.

Effacer l’utilisation d’un membre

Un administrateur de l’espace de travail (ou un super utilisateur) disposant de l’autorisation identity.security_log.read peut effacer l’utilisation d’un membre et cesser de la collecter, puis lever l’effacement ultérieurement. L’effacement comme la restauration exigent cette autorisation et ce rôle. Ces deux actions ne sont disponibles que via l’API REST.

Action	Requête
Effacer	DELETE /rest/v1/identity/usage/users/{user_id}
Restaurer	DELETE /rest/v1/identity/usage/users/{user_id}/erasure

L’effacement supprime les événements et l’enregistrement de première utilisation du membre ; dès cet instant, les rapports et les exports excluent le membre. Son utilisation n’est plus collectée, et l’historique lu ultérieurement à partir des journaux Panel et JupyterHub est lui aussi écarté. Si la suppression ne peut pas se terminer immédiatement, la réponse l’indique et la prochaine maintenance horaire la termine.

La restauration lève l’effacement afin que la nouvelle activité soit de nouveau collectée. Elle ne ramène pas ce qui a été effacé.

Les deux actions écrivent une entrée dans le Journal de sécurité.

Voir aussi

• Gestion des identités et des accès
• Gestion des groupes de sécurité