Skip to content

Tableau de bord non officiel Grafana Skolengo/K-D'Ecole/Mon Bureau Numérique

License

Notifications You must be signed in to change notification settings

maelgangloff/kdecole-docker-grafana

Tableau de bord - Relevés de notes

Discord

Utilise l'API K-D'Ecole pour récupérer ses notes et les représenter graphiquement.
🚨 Attention : ce projet utilise l'ancienne version de l'API Skolengo (module kdecole-api). Il est possible qu'elle devienne obsolète dans l'éventualité où l'accès à l'ancienne API serait définitivement clos.

Installation

  1. Installer docker et docker-compose
  2. Créer les volumes docker. Vos données y seront stockées.
docker volume create mariadb-storage
docker volume create grafana-storage
  1. Cloner le projet
git clone https://github.com/maelgangloff/kdecole-docker-grafana
  1. Modifier le fichier docker-compose.yml :
    • KDECOLE_TOKEN : Pour obtenir votre jeton d'authentification K-D'Ecole, reportez-vous à la section correspondante.
    • KDECOLE_URL : L'URL de l'API.
    • KDECOLE_ACADEMIE : Le nom de votre circonscription académique.
  2. Démarrez les conteneurs Docker
docker-compose up --build -d
  1. Rendez-vous à l'adresse http://localhost:3000
  2. Se connecter (par défaut, le nom d'utilisateur et le mot de passe sont admin) puis changez votre mot de passe.
    Un tableau de bord est déjà configuré. Pour être fonctionnel, il nécessite quelques ajustements. Si les moyennes des matières ne sont pas trouvées, il faut modifier la requête pour trouver l'identifiant de la période de notation.
  3. Créez votre tableau de bord

Obtenir son jeton d'authentification K-D'Ecole

  • Installer NodeJs
  • Installer la librairie kdecole-api en global
npm -i kdecole-api
  • Exécuter le binaire pour obtenir le jeton
npx kdecole-api -u IDENTIFIANT -p CODE_TEMPORAIRE --ent PROD_MON_BUREAU_NUMERIQUE

Ne communiquez jamais votre jeton à un tier. Il vous est strictement personnel. Si vous pensez que votre jeton a fuité, révoquez-le immédiatement.

Créer son tableau de bord

Avant de créer votre premier tableau de bord, il vous faudra ajouter une source de données.
Pour se faire, rendez-vous dans les paramètres et cliquez sur Data Sources.
Ajoutez une source de données MySQL en précisant:

  • Le nom d'host: database:3306
  • La base de données: KDECOLE
  • Le nom d'utilisateur: root
  • Le mot de passe: root

Créer son tableau de bord sur Grafana est assez simple. Il vous suffit d'ajouter quelques widgets.
La seule "difficulté" est de faire la bonne requête à la base de données.

Exemple de tableau de bord

gafana dashboard Si vous voulez partir d'une base, le code JSON de ce dashboard est disponible.
Cependant, il n'est pas assuré que cet exemple fonctionne du premier coup, il est peut-être nécessaire de modifier les identifiants de période de notation (vous pouvez les retrouver en explorant le contenu des données récoltées via l'outil Explore de Grafana).

Exemples de requêtes SQL

  • Nombre de notes au total dans la base
     SELECT NOW() AS "time",
     COUNT(*) 
    FROM devoirs;
  • Nombre de notes dans la base pour un élève précis (Changer l'identifiant par l'identifiant de l'élève)
     SELECT NOW() AS "time",
     COUNT(*)
    FROM devoirs
    WHERE idEleve = 'AAP05567';
  • Toutes les notes d'un élève
     SELECT timestamp AS "time",
      matiere AS metric,
      note 
    FROM devoirs
    WHERE idEleve = 'AAP05567'
    ORDER BY timestamp;
  • Nombre de jours avant les vacances (Adapter KDECOLE_ACADEMIE dans docker-compose.yml)
     SELECT NOW() AS "time",
      jMoins
     FROM holidays;
  • Moyennes des matières dans un trimestre (Adapter idPeriode par celui du trimestre voulu)
    SELECT NOW() AS "time",
     matiereLibelle AS metric,
     moyenneEleve
    FROM moyennes
    WHERE idPeriode = 25
    ORDER BY idPeriode;