| |
| blocks:usestats:technique:db [2026/01/13 08:19] – créée - modification externe 127.0.0.1 | blocks:usestats:technique:db [2026/10/18 00:11] (Version actuelle) – admin |
|---|
| <html><!-- nomoodle --></html>{{ :blocks:logo-apl.png?nolink |}}<html><!-- /nomoodle --></html> | <html><!-- nomoodle --></html>{{ :blocks:logo-apl.png?nolink |}}<html><!-- /nomoodle --></html> |
| ===== Bloc Use Stats (Mesure d'activité) : Modèle de données===== | ===== Bloc Use Stats (Mesure d'activité) : Modèle de données ===== |
| |
| Le bloc Use_Stats ajoute deux tables à Moodle. | Le bloc Use_Stats ajoute trois tables à Moodle. Aucune d'elles ne contient de donnée saisie par l'utilisateur : toutes sont calculées à partir des logs standard de Moodle et peuvent être reconstruites en cas de besoin (voir le réglage //Date de dernière compilation// dans la [[:blocks:usestats:technique:settings|configuration générale]]). |
| |
| ==== Table : block_use_stats ==== | ==== Table : block_use_stats_log ==== |
| |
| Cette table sert de cache au block Use_Stats pour stocker les indicateurs de temps calculé et nombre de hits pour un usager depuis le début de son utilisation. | Cette table est alimentée au fil de l'eau par la tâche planifiée de compilation, qui traite les logs standard de Moodle. Elle stocke, pour chaque entrée de log : |
| |
| ==== Table : block_use_stats_log ==== | * **logid** : l'identifiant de l'entrée de log d'origine (unique) |
| | * **gap** : le délai par rapport à l'entrée de trace précédente du même utilisateur, en secondes (//timegap//) |
| | * **userid**, **course**, **time** : les qualifieurs principaux de l'entrée de trace (utilisateur, cours, horodatage) |
| | * **customtag1** à **customtag6** : les qualifieurs de cubing (6 qualifieurs configurables, version PRO). Les trois premiers font 20 caractères, les trois derniers 128. |
| |
| Cette table est alimentée au fil de l'eau par le traitement régulier des logs standard de Moodle, afin de stocker, pour chaque entrée de log : | La table est indexée sur ''logid'', ''userid'', ''course'' et sur les trois premiers qualifieurs, pour permettre des requêtes de reporting rapides. |
| | |
| | Cette table est la base de tous les calculs de temps : le temps de chaque entrée de log est déduit de son //gap//, ce qui évite de reparcourir et de comparer les logs à chaque affichage. Une tâche planifiée nocturne supprime les lignes dont l'entrée de log d'origine n'existe plus (suite à une purge des logs de Moodle). |
| | |
| | ==== Table : block_use_stats_session ==== |
| | |
| | Cette table stocke les sessions de travail reconstituées par l'analyseur : |
| | |
| | * **userid** : l'utilisateur |
| | * **sessionstart** : horodatage du début de la session |
| | * **sessionend** : horodatage de fin de la session (estimé : voir le seuil de détection et le crédit de fin de session) |
| | * **courses** : liste des identifiants des cours traversés par la session |
| | |
| | Une session n'est enregistrée qu'une fois : les sessions déjà connues d'un utilisateur sur la période compilée sont ignorées. |
| | |
| | ==== Table : block_use_stats ==== |
| |
| * Le logid d'orgine | Table historique, créée à l'origine pour mettre en cache les indicateurs de temps calculé et le nombre d'événements d'un utilisateur par contexte (champs ''userid'', ''contextid'', ''elapsed'', ''events'' et ''compiletime''). Le code actuel du bloc ne lit ni n'écrit cette table : le cache d'agrégats est désormais porté par l'API de cache de Moodle (voir [[:blocks:usestats:technique:cache|Cache d'agrégats]]). Elle est conservée pour la compatibilité avec les anciennes versions. |
| * Le délai par rapport à l'entrée de trace précédente du même utilisateur (timegap). | |
| * Les qualificateurs principaux de l'entrée de trace (cours, utilisateur associé) | |
| * Les qualifieurs de cubing (6 qualifieurs configurables) | |
| |
| ---------- | ---------- |
| <html><!-- nomoodle --></html> | <html><!-- nomoodle --></html> |
| [[:blocks:usestats:Technique|Revenir à l'index du guide technique]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]] | [[:blocks:usestats:technique|Revenir à l'index du guide technique]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]] |
| <html><!-- /nomoodle --></html> | <html><!-- /nomoodle --></html> |
