Description des scripts
Trois scripts Munin ont été développés :
Un script de statistiques indiquant le nombre de medias par types disponibles dans la ou les fermes de MediaSPIP installées sur la machine.
( Ce script est spécifique à MediaSPIP. )
Exemple :
Un script de statistiques affichant le nombre de sites installés dans la ou les fermes SPIP du serveur.
( Ce script n’est pas spécifique à MediaSPIP particulièrement, il peut être utile pour toute mutualisation de SPIP. )
Exemple :
Un script montrant les tailles des instances de SPIP de la ou des fermes SPIP du serveur.
( Ce script n’est pas spécifique à MediaSPIP particulièrement, il peut être utile pour toute mutualisation de SPIP. )
Exemple :
Installer et configurer les scripts
Ce petit tutoriel d’installation est basé sur une distribution Linux de type Debian ou Ubuntu. Pour tout autre type de distribution, vous devrez adapter les commandes.
Ces scripts fonctionnent à l’aide de l’outil de surveillance Munin. Un des scripts lit des informations d’un fichier journal qui est mis à jour par un script supplémentaire. Celui-ci sera déclaré en tâche planifié du service cron. Ainsi, munin ne parcourira pas les dossiers toutes les 5 minutes. L’administrateur pourra modifier la fréquence de lancement de la tâche planifiée selon sa convenance.
1. Installation de Munin
Avant toute chose, vous devez avoir un client Munin fonctionnel sur le serveur hébergeant les instances à monitorer. Pour ce faire vous pouvez vous référer à ce tutoriel d’installation de Munin.
2. Récupération des scripts
Les scripts de monitoring sont disponibles sur Github.
On va donc utiliser git pour les récupérer. On vérifie tout d’abord que git est bien installé :
- sudo apt-get install git
Puis on récupère le code dans /usr/local/src
:
- cd /usr/local/src
- sudo git clone https://github.com/kent1D/mediaspip_munin.git
- cd mediaspip_munin
3. Création des liens symboliques des scripts
On crée les liens symboliques pour activer les plugins :
- sudo ln -s /usr/local/src/mediaspip_munin/plugins/spip_mutu_sites /etc/munin/plugins/
- sudo ln -s /usr/local/src/mediaspip_munin/plugins/mediaspip_media /etc/munin/plugins/
- sudo ln -s /usr/local/src/mediaspip_munin/plugins/spip_mutu_taille /etc/munin/plugins/
Attention : pour que spip_mutu_taille
fonctionne, il doit faire appel en CRON, régulièrement, à un script de calcul de taille. L’administrateur peut ainsi régler la fréquence de mise à jour des informations, et diminuer les accès disque, sans toucher au script. Pour ce faire, il est nécessaire d’installer le script de calcul et la tâche CRON :
- # Rendre exécutable le script de calcul
- chmod +x bin/spip_taille_instance.sh
- # Installer le script de calcul dans le répertoire des logiciels
- ln -s /usr/local/src/mediaspip_munin/bin/spip_taille_instance.sh /usr/local/bin
- # Installer la tâche CRON
- ln -s /usr/local/src/mediaspip_munin/cron/spip_taille_instance /etc/cron.d
Configuration des scripts de monitoring
Pour configurer les scripts, il suffit de modifier le fichier /etc/munin/plugin-conf.d/munin-node
:
- sudo nano /etc/munin/plugin-conf.d/munin-node
Si la ferme de MediaSPIP est installée à son emplacement par défaut, on y ajoute le texte suivant :
- [mediaspip*]
- user root
- [spip_mutu*]
- user root
Cette installation de base suppose que l’installation est comme par défaut, située dans le répertoire /var/www/mediaspip
.
Si ce n’est pas le cas, vous devez ajouter l’option env.dossier
dans les deux blocs de configuration ci-dessus. Par exemple :
- env.dossier /mon/dossier/installation/sites/
Le chemin doit pointer vers le répertoire sites/
.
Si vous souhaitez monitorer plusieurs mutualisations différentes, vous pouvez séparer les dossiers par " :" (double point) :
- env.dossier /mon/dossier/installation/sites/:/mon/autre/installation/sites/