Rapports d'utilisation
Rapports d’utilisation montre qui utilise quoi dans votre espace de travail : les écrans, tableaux de bord, applications et notebooks que les membres ouvrent, le nombre de membres qui reviennent et où ils vont ensuite. Servez-vous-en pour voir ce que vos membres adoptent, quels tableaux de bord et quelles applications justifient leur existence, et à quel endroit les gens abandonnent un processus.
Ouvrez-le depuis Rapports d’utilisation sous Analyses, dans le rail de l’onglet Identité. Il s’ouvre comme une page dans Identité, à côté du rail, plutôt que dans une fenêtre distincte.
Qui peut y accéder
Section intitulée « Qui peut y accéder »Rapports d’utilisation exige la même autorisation que le Journal de sécurité : identity.security_log.read. Sans elle, l’élément du rail n’est pas affiché, et un membre qui ouvre tout de même le rapport voit un avis lui indiquant qu’il n’y a pas accès.
Les rapports montrent l’utilisation par membre aux endroits suivants : l’onglet Membres, les listes de membres que vous ouvrez depuis Contenu et Vue d’ensemble, ainsi que les exportations Activité quotidienne par membre et Première utilisation, qui incluent les identifiants des membres. Tout le reste est comptabilisé pour l’ensemble des membres. N’accordez l’autorisation qu’aux personnes qui doivent voir l’activité individuelle. L’ouverture de l’utilisation d’un membre est elle-même enregistrée ; consultez Confidentialité et audit.
Ce qui est comptabilisé
Section intitulée « Ce qui est comptabilisé »Rapports d’utilisation combine cinq domaines. Choisissez-en un dans Domaine, ou laissez Tous les domaines.
| Domaine | Ce qui est enregistré |
|---|---|
| Application PlaidCloud | Les écrans que les membres ouvrent et les actions qu’ils effectuent dans l’application. |
| Tableaux de bord | Les consultations de tableaux de bord et de graphiques. |
| Applications | Les visites d’applications et le temps que les membres passent dans chacune. |
| Serveurs de notebooks | Le temps que les membres passent dans des sessions de serveur de notebooks. |
| Notebooks | Les notebooks que les membres ouvrent et enregistrent. |
Les serveurs de notebooks et les notebooks sont des domaines distincts : vous pouvez choisir l’un ou l’autre. Les applications forment un seul domaine. Les événements de notebook ne sont enregistrés que pour les notebooks qui s’exécutent sur l’image de notebook par défaut. Une image personnalisée ne les signale pas.
Les événements et les domaines apparaissent sous des noms lisibles, tels que Notebook ouvert, App serveur visitée et App navigateur visitée, plutôt que sous forme de codes internes. Les visites d’applis Dash et WASM apparaissent sous Visites d’apps dans la colonne Domaine. Choisir Applications dans Domaine les exclut. Pour les inclure, laissez Domaine sur Tous les domaines. Un tableau de bord ou une application qui a depuis été supprimé apparaît sous le nom Tableau de bord supprimé ou Appli supprimée.
Lire les rapports
Section intitulée « Lire les rapports »La barre en haut de la page contient les filtres. Chaque onglet se charge à sa première ouverture, puis de nouveau lorsque vous modifiez un filtre.
| Filtre | Fonction |
|---|---|
| Domaine | Limite le rapport à un domaine. Il est masqué sur Entonnoir, qui choisit un domaine pour chaque étape, et sur Exportations, qui a son propre choix. |
| Groupe | Limite le rapport aux membres d’un groupe de sécurité. Voir Limiter à un groupe. |
| Plage de dates | 7 derniers jours, 30 derniers jours, 90 derniers jours, 180 derniers jours, Ce mois-ci, Mois précédent, ou Personnalisé… pour une date de début et une date de fin sur 180 jours au maximum. |
| Actualiser | Recharge les chiffres (F5). Mis à jour indique quand ils ont été chargés pour la dernière fois. |
La plage de dates est partagée par tous les onglets, et l’onglet où vous vous trouviez ainsi que la plage choisie sont enregistrés avec les paramètres de votre compte : la page se rouvre donc là où vous l’avez laissée, sur n’importe quel ordinateur. Modifier la plage recharge l’onglet affiché, puis les autres onglets au moment où vous les ouvrez. Chaque onglet a ses propres explications : pointez un titre ou un chiffre pour lire ce qu’il signifie.
Pendant le chargement d’un onglet, vous voyez un espace réservé plutôt qu’une page vide. Si un rapport ne peut pas se charger, l’onglet affiche la raison avec Réessayer et Copier les détails. Lorsqu’une plage n’a aucune activité, l’onglet suggère d’essayer une plage plus longue. Pour ouvrir une ligne, double-cliquez dessus ou sélectionnez-la et appuyez sur Entrée. Précédent ramène de l’élément ouvert à la liste.
Vue d’ensemble
Section intitulée « Vue d’ensemble »Les chiffres clés de la plage, chacun accompagné d’une flèche et d’un pourcentage indiquant l’évolution par rapport à la période précédente de même durée :
| Chiffre | Signification |
|---|---|
| Membres actifs | Membres ayant une activité quelconque. |
| Nouveaux membres | Membres vus pour la première fois dans la plage. Affiché sous la forme d’un tiret lorsque la plage commence avant le début de la collecte, car les premières utilisations antérieures ne peuvent pas être déterminées. |
| Membres récurrents | Membres actifs vus pour la première fois avant la plage. |
| Minutes d’activité | Estimation : cinq minutes pour chaque période de cinq minutes comportant une action ou une consultation. |
| Minutes d’ouverture des applications | Durée pendant laquelle des applications et des serveurs de notebooks étaient ouverts, temps d’inactivité compris. Comptabilisé séparément des minutes d’activité. |
| Événements | Tout ce qui est enregistré. |
Les événements qui ne peuvent pas être rattachés à un membre sont comptés à part, sur une ligne sous les chiffres. Ils comptent comme événements, pas comme membres.
Points clés liste jusqu’à quatre éléments qui méritent un coup d’œil, chacun étant un lien vers l’endroit où en voir davantage :
- Une hausse ou une baisse de 10 % ou plus du nombre de membres actifs par rapport à la période précédente.
- Le nombre de membres non actifs dans la plage. Sélectionnez-le pour ouvrir la liste des membres inactifs.
- Le nombre de tableaux de bord et d’applications que personne n’a ouverts. Sélectionnez-le pour ouvrir Contenu avec les éléments inutilisés en premier.
- L’élément le plus utilisé, lorsqu’au moins cinq membres l’ont utilisé.
Un point clé n’apparaît que s’il a quelque chose à dire. Lorsque PlaidCloud ne parvient pas à déterminer un décompte, le point clé est masqué au lieu d’afficher 0, et si rien ne ressort, vous voyez Aucun changement notable sur cette période.
Les plus utilisés liste chaque écran, tableau de bord, graphique ou élément avec son domaine, son événement, son nombre de membres et sa Portée, la part des membres actifs qui l’ont utilisé dans la plage. Le sélecteur de colonnes ajoute Événements et Événements non liés à un membre. Par mois (tout l’historique) montre les membres actifs, la moyenne de membres par jour et le Taux d’engagement (DAU/MAU) pour chaque mois, avec une remarque lorsque le mois est encore en cours ou n’est couvert qu’en partie. Le taux d’engagement est la moyenne quotidienne de membres actifs divisée par le nombre de membres actifs du mois ; une valeur plus élevée signifie donc que les gens reviennent plus de jours.
Activité
Section intitulée « Activité »Les membres actifs par période Quotidien, Hebdomadaire ou Mensuel, ainsi que Rétention par première semaine : pour chaque semaine où des membres sont apparus pour la première fois, la Taille de la cohorte et la part de ces membres encore actifs chacune des semaines suivantes. Une période marquée d’un astérisque n’est pas entièrement comprise dans la plage.
Les déplacements les plus fréquents entre écrans, sous la forme Déplacement depuis, Déplacement vers et Nombre de passages, tous domaines confondus. Les chemins couvrent les 30 derniers jours au plus.
Afficher bascule entre deux listes :
- Actif comporte une ligne par membre vu dans la plage : nom, nom d’utilisateur, jours actifs, événements, minutes d’activité, minutes d’ouverture des applications, ainsi que la date de première et de dernière observation. Ouvrez une ligne pour voir les événements du membre par jour et ce qu’il a utilisé.
- Inactif liste les membres actuels sans activité dans la plage, avec la date à laquelle ils sont devenus membres et celle de leur dernière observation. Aucune enregistrée signifie aucune activité dans l’historique conservé, soit 25 mois au maximum et uniquement depuis le début de la collecte. Téléchargez la liste avec Télécharger en CSV. Inactif signifie aucune activité dans aucun domaine : la liste ignore donc Domaine. Un membre retiré de l’espace de travail ou désactivé n’est ni listé ni compté.
Chaque tableau de bord, application et notebook avec son Type, ses Membres, sa Portée, ses Ouvertures, ses Minutes d’ouverture des applications (applications uniquement), une Tendance hebdomadaire et la date de sa Dernière utilisation. Choisissez un Type pour restreindre la liste, ou sélectionnez Masquer les inutilisés pour écarter les éléments que personne n’a ouverts. Ouvrez une ligne pour voir les membres qui ont utilisé l’élément, et téléchargez l’une ou l’autre liste avec Télécharger en CSV. Une remarque sous la liste indique quels types ne sont pas encore collectés ou ne le sont que depuis une date ultérieure. Si les noms des tableaux de bord et des applications ne peuvent pas être consultés, un avertissement indique Names are unavailable right now, so items nobody used are not listed. Les éléments qui ont été utilisés apparaissent toujours.
Limiter à un groupe
Section intitulée « Limiter à un groupe »Groupe limite Vue d’ensemble, Contenu et la liste Inactif aux membres d’un groupe de sécurité. Choisissez Tout le monde pour supprimer la limite. Saisissez du texte dans la zone pour rechercher parmi les groupes de l’espace de travail. Le rapport utilise la composition actuelle du groupe, et non celle au moment de l’activité, et le signale à côté du filtre.
- Les membres Actif, Activité, Chemins et Exportations ne sont pas restreints. Le filtre est désactivé sur ces onglets et en indique la raison.
- Par mois n’est pas affiché pour un groupe, car l’historique mensuel est conservé pour tout le monde.
- Un groupe sans membre, ou un groupe qui n’existe plus, renvoie des résultats vides et un avertissement qui le signale, et non une erreur.
- Si vous ne pouvez pas lire les groupes de sécurité de l’espace de travail, le filtre n’est pas proposé.
Exportations
Section intitulée « Exportations »Téléchargez un résumé au format CSV. Choisissez le Résumé et une Plage de dates, puis sélectionnez Télécharger en CSV. La plage peut aller jusqu’à 25 mois.
| Résumé | Contenu |
|---|---|
| Activité quotidienne | Membres et événements pour chaque jour, domaine, événement et sujet. |
| Activité quotidienne par membre | La même chose pour chaque membre, avec les identifiants des membres. |
| Adoption mensuelle | Membres et événements pour chaque mois, domaine, événement et sujet. |
| Membres actifs mensuels | Membres actifs pour chaque mois et domaine. |
| Première utilisation | Date à laquelle chaque membre a utilisé chaque domaine pour la première fois, avec les identifiants des membres. |
L’exportation utilise le domaine que vous avez choisi au-dessus des onglets. Un résumé volumineux se télécharge par lots de 50 000 lignes au maximum, et la page les combine en un seul fichier. Si le fichier dépassait ce que la page peut construire, elle enregistre ce qu’elle a et vous indique que le fichier est incomplet : choisissez une plage plus courte pour obtenir le reste.
Chaque exportation é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.
Pour placer ces chiffres dans une table de façon planifiée, utilisez plutôt l’étape Get Workspace Usage.
Entonnoir
Section intitulée « Entonnoir »Voyez combien de membres parcourent une séquence d’étapes. Une étape est un événement de l’un des domaines, pour un sujet particulier, ou Tout sujet. L’entonnoir utilise la plage de dates que vous avez choisie, jusqu’aux 90 derniers jours, et l’indique lorsqu’il raccourcit une plage plus longue.
- Sélectionnez Ajouter une étape et choisissez le domaine, l’événement et le sujet de chaque étape. Un entonnoir compte de 2 à 6 étapes.
- Choisissez le Délai autorisé entre les étapes : 1, 6, 24, 72 ou 168 heures.
- 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é, et le temps médian depuis l’étape précédente. Chaque étape sauf la dernière indique combien de membres se sont arrêtés là. La dernière étape indique combien ont terminé l’entonnoir. Les étapes peuvent mélanger les domaines : vous pouvez donc suivre un membre d’un écran PlaidCloud jusqu’à un tableau de bord. Entonnoirs récents rouvre un entonnoir exécuté précédemment. Une liste d’étapes ne propose que les événements enregistrés dans la plage.
Utilisation non attribuée
Section intitulée « Utilisation non attribuée »Certains événements ne peuvent pas être rattachés à un membre PlaidCloud. Ils comptent dans Événements et dans Événements non attribués, mais jamais dans les décomptes de membres. 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é des applications et des serveurs de notebooks que les journaux de la plateforme ne peuvent pas rattacher à un membre. Leur attribution provient de ces journaux ; considérez-la donc comme approximative.
Une forte part non attribuée dans un domaine signifie que ses décomptes de membres sont sous-estimés.
Début de l’historique
Section intitulée « Début de l’historique »L’historique commence lorsque la collecte de l’utilisation est activée pour votre espace de travail, et 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 pendant environ 90 jours. Au démarrage de la collecte, ces deux domaines récupèrent au plus cet historique antérieur. Superset récupère le sien à partir de ses propres journaux, jusqu’à 180 jours. Seule l’application PlaidCloud part de zéro au démarrage de la collecte.
Rapports d’utilisation conserve les événements bruts pendant 180 jours, ce qui explique que la plage la plus longue soit de 180 jours, et conserve les résumés mensuels pendant 25 mois. Lorsqu’un membre est retiré 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. Une plage qui commence avant les 180 jours d’activité détaillée affiche un avertissement au lieu de la liste des membres inactifs, car le détail nécessaire pour savoir qui était absent n’existe plus.
Confidentialité et audit
Section intitulée « Confidentialité et audit »Certaines consultations de l’utilisation de membres nommés sont elles-mêmes auditées. Ces actions écrivent une entrée dans le Journal de sécurité indiquant qui les a effectuées :
- L’ouverture du profil d’utilisation d’un membre.
- L’ouverture ou le téléchargement de la liste Inactif.
- L’ouverture ou le téléchargement des membres qui ont utilisé un élément dans Contenu.
- Le téléchargement de la liste Contenu.
- L’ouverture de Vue d’ensemble ou de Contenu limitée à un groupe.
- Chaque exportation, comme décrit sous Exportations.
La liste Actif sous Membres n’est pas enregistrée.
Effacer l’utilisation d’un membre
Section intitulée « 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 plus tard. 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 du membre et son enregistrement de première utilisation, et à partir de cet instant les rapports et les exportations laissent le membre de côté. Son utilisation n’est plus collectée, et l’historique lu ultérieurement à partir des journaux de Panel et de 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 rétablit pas ce qui a été effacé.
Les deux actions écrivent une entrée dans le Journal de sécurité.