Le plugin Monitoring

Introduction

Le plugin monitoring à pour but "d'intégrer" Shinken à GLPI. En effet grâce à ce plugin Shinken sera paramétrable à partir de GLPI et les alertes seront visibles dans celui-ci ! GLPI devient donc un outil complet d'inventaire, monitoring et gestion d'assistance.

Pré-requis :

- Plugin FusionInventory (Qui gère l'inventaire des machines. http://fusioninventory.org/wordpress/)
- Plugin Webservices (Permettra de gérer les communications par service web)
- Le plugin monitoring
- Shinken (Peut être installé sur un serveur distant)

Installation

Pour l'installation des plugins, visiter cette page.

Et pour Shinken celle-ci ou http://www.shinken-monitoring.org/wiki/shinken_10min_start pour d'autres systèmes d'exploitation.

Configuration

Comptes

Il faut créer 2 comptes. Un dans GLPI pour permettre à Shinken de se connecter au plugin Webservices afin de récupérer sa configuration, et un dans la base MySql pour lui donner la possibilité d'altérer la base de données (notamment pour les alertes).

Compte GLPI

Créer un compte local GLPI via Administration > Utilisateur.

Compte MySql

"Il faut créer un compte MySQL car le module Broker de Shinken va ajouter et mettre à jour des évènements dans la base de donées."

Connecter à la base

mysql -u root -p glpi_db
Enter password: 

Créer un hash du password

SELECT PASSWORD('mypass');

Copiez le.

Créer un utilisateur (en utilisant le hash pour le password)

CREATE USER shinkenbroker IDENTIFIED BY PASSWORD 'votre_hash';

La documentation nous dit :
"Vous pouvez définir les droits sur toute la base GLPI mais, pour une meilleure sécurité, donnez les droits uniquement aux tables :

• base glpi\glpi_plugin_monitoring_services (SELECT et UPDATE seulement)
• base glpi\glpi_plugin_monitoring_serviceevents (INSERT seulement)
• glpi database\glpi_plugin_monitoring_servicescatalogs (SELECT et UPDATE uniquement)"

GRANT select,update ON glpi_plugin_monitoring_services TO shinkenbroker IDENTIFIED BY 'password';
GRANT insert ON glpi_plugin_monitoring_serviceevents TO shinkenbroker IDENTIFIED BY 'password';
GRANT select,update ON glpi_plugin_monitoring_servicescatalogs TO shinkenbroker IDENTIFIED BY 'password';

Plugin WebServices

Je n'aurais pas pu faire beaucoup mieux que la doc... :

"Configurer les services web de GLPI pour Shinken Dans GLPI, aller dans le menu Plugins > Web Services, et ajouter un nouveau service web. Mettre les valeurs :
• Nom : Shinken
• Services actifs : Oui
• Activer la compression : Non (pas testé avec la compression activée)
• Tracer les connexions : Non (activez le si vous voulez garder une trace des connexions)
• Debug : Non (activer pour le debugging)
• Motif SQL des services : .*
• Plage d'adressage IP : définir une plage IP, dans ce cas, mettre 2 fois la même IP du serveur ou Shinken est installé
• Utilisateur: (laisser vide dans ce cas)
• Mot de passe: (laisser vide dans ce cas)
Cliquer sur le bouton ajouter. Le service web pour Shinken est bien créé et donne accès à Shinken."

Shinken

Il faut paramétrer les daemons Arbiter et Broker pour qu'il puissent, respectivement, se connecter à GLPI et se connecter à la BDD. La configuration des modules se trouve dans le fichier shinken-specefic.cfg dans .../shinken/etc/

Module Arbiter

Ici on ne modifie pas vraiment la configuration de l'arbiter mais on lui ajoute un module, lui fournissant les infos pour se connecter à GLPI. Modifiez le bloc suivant, en fonction de votre configuration

define module{
module_name GLPI
module_type glpi
uri http://localhost/glpi/plugins/webservices/xmlrpc.php
login_name glpi
login_password glpi
tag
}

"Les valeurs à modifier pour votre environnement sont :
• uri: url de GLPI, se termine toujours par /plugins/webservices/xmlrpc.php
• login_name: compte GLPI créé dans "créer des comptes GLPI"
• login_password: mot de passe du compte GLPI
• tag: défini l'étiquette si on l'utilise, sinon laisser vide"

Il faut ensuite ajouter le module a l'Arbiter. Chercher le bloc define arbiter et ajoutez GLPI à la ligne modules. L'arbiter chargera alors le module GLPI à son lancement.

modules PickleRetentionArbiter, GLPI

Module Broker

C'est la même chose qu'avec Arbiter sauf qu'on définit cette fois l'accès à la base MySql. Dans shinken-specific.cfg modifier le module glpidb

define module{
module_name glpidb
module_type glpidb
database glpi
user root
password root
host localhost
}

Les valeurs à modifier sont :
• database: nom de la base MySQL de GLPI
• user: compte MySQL créé plus haut(dans notre exemple, c'est shinkenbroker )
• password: mot de passe du compte GLPI
• host: IP ou nom du serveur où le serveur MySQL est installé.