Table des matières
Guide d'installation
Rapport Zabbix
Prérequis
Pour pouvoir faire fonctionner le plugin de collecte des indicateurs de fonctionnement de Moodle sur Zabbix vous devrez au préalable :
Version zabbix préconisée : 6.4
- Avoir installé un serveur Zabbix sur un serveur. La version du serveur Zabbix doit correspondre à la version des clients Zabbix installés sur les machines qui font fonctionner Moodle.
- Avoir installé un frontend compatible, pour la consultation des données.
- Avoir installé un client Zabbix sur la machine qui opérera les tâches programmées d'émission des indicateurs.
- Avoir installé l'utilitaire zabbix_sender permettant à un exécutable d'émettre une donnée vers le serveur Zabbix.
- Avoir installé les modèles de collecte Moodle dans le serveur
- Avoir configuré un utilisateur d'administration distante, sans accès au frontend
Prérequis supplémentaires
Pour pouvoir émettre des rapports automatisés à partir de zabbix vers des utilisateurs désignés,
- Installer un compilateur C++
- Installer un environnement Go en version 1.3 minimum (https://www.itzgeek.com/how-tos/linux/debian/how-to-install-go-lang-on-debian-11-debian-10.html)
- Compiler et installer les web_services zabbix
- Installer un chromium ou version de chrome capable de fonctionner en “headless”
- Si le fichier de configuration n'est pas présent dans /etc/zabbix, le créer (zabbix_webservice.conf) en se référant à https://www.zabbix.com/documentation/current/en/manual/appendix/config/zabbix_web_service et démarrer les web services par la commande :
zabbix_web_service -c /etc/zabbix/zabbix_webservice.conf &
Installation du plugin Moodle
- Déployez l'archive du plugin dans le répertoire /report de votre installation Moodle
- Naviguez vers les notifications d'administration pour terminer l'installation logique du plugin
Configuration
La configuration est nécessaire pour permettre de tirer les mesures vers le bon hôte serveur Zabbix. L'émission utilise la technique du “trapper” zabbix. Les mesures sont émises via l'utilitaire “zabbix_sender”, sans faire appel à la configuration de l'agent zabbix installé localement. Les données nécessaires à l'émission d'une mesure sont :
- L'IP ou l'hôte zabbix à contacter (fourni par la configuration).
- La clef de la mesure (fourni par l'implémentation de l'indicateur mobilisé).
- L'hôte d'origine de la mesure (implicitement fourni par
$CFG→wwwroot, ou surchargé par la valeur de configurationreport_zabbix|zabbixhostname).
La configuration du plugin permet en outre de raccorder le plugin aux APIs d'administration distante du serveur Zabbix, pour actionner l'enregistrement du site moodle dans Zabbix, et son ajout aux groupes d'agrégation désirés.
Enregistrement du moodle comme hôte zabbix
Attention : afin de pouvoir réaliser l'enregistrement automatique du moodle dans zabbix, l'utilisateur administrateur désigné dans la configuration doit être un utilisateur connu de zabbix, avec des droits administrateur lui permettant de créer des configurations d'hôtes et de rajouter cette configuration dans les groupes configurés.
Le réenregistrement d'un hôte ne détruit pas les anciennes données accumulées préalablement.