Ce tutorial vise à mettre en place l'outils de supervision Centreon.
1 - Installation de Centreon sur une VM
Nous allons récupérer l'iso de Centreon CES 3.0 basée sur une Centos 6.5 :
Nous allons créer notre VM dans VirtualBox et installer l'iso de Centreon que l'on aura récupérée à l'adresse suivante :
http://download.centreon.com/index.php?id=4311
Ne pas oublier de configurer l'interface réseau en mode bridge à la création de la VM, sinon l'interface ne sera pas reconnue après l'installation.
Une fois que la VM a démarré sur l'iso, un choix d'installation va nous être proposé et on choisira une installation par défaut en appuyant sur enter.
Ensuite l'assistant d'installation va nous demander de configurer les paramètres suivants :
- - Langue du système : Français
- - Choix du clavier : Français
- - What type of devices will your installation involve ? : Basic Storage Device
- - Confirmation d'initialisation de la partition disque : Yes, discard any data
- - le mot de passe de compte root
- - Configuration réseau :
- - Hostname : centreon
- - Cliquer sur "Configure Network" et paramétrer une IP statique :
- - Connection name : System eth0
- - IPv4 Settings :
- - Method : manual
- - Address : 192.168.0.101
- - Netmask : 24
- - Gateway : 192.168.0.1
- - DNS servers : 192.168.0.1
- - Search domains : domain.local
- - Timezone : Europe/Paris + cochez "System clock uses UTC"
- - What type of installation would you like ? : Replace Existing Linux System(s)
- - Which server type would you like to install ? : Central server with database
- - Wich monitoring engine and broker would you like to install ? : Centreon Engine and Centreon Broker
Une fois cette liste de config effectué, l'installation commence.
A la fin de l'installation un reboot sera demandé.
Une fois la VM démarrée, on va se connecter sur l'interface web à l'adresse suivante :
http://192.168.0.101/centreon
Un assistant d'installation va poursuivre le paramétrage depuis l'interface web avec les étapes d'installation suivantes :
- 1 - Welcome to Centreon Setup : Cliquer sur Next
- 2 - Dependency check up : Cliquer sur Next
- 3 - Monitoring engine information : Choisir "centreon-engine", laisser les valeurs par défaut et cliquer sur Next. et cliquer sur Next
- 4 - Broker Module information : Choisir "centreon-broker" et cliquer sur Next.
- 5 - Admin information :
- - Login : admin
- - Password : PASSWORD
- - Confirm password : PASSWORD
- - First name : FIRSTNAME
- - Last name : LASTNAME
- - Email : EMAIL
- 6 - Database information :
- - Database Host Address (default : localhost) : Laisser vide
- - Database Port (default : 3306) : 3306
- - Root password : Laisser vide
- - Configuration database name : centreon
- - Storage database name : centreon_storage
- - Utils database name : centreon_status
- - Database user name : centreon
- - Database user password : PASSWORD
- - Confirm user password : PASSWORD
- 7 - Installation : Cliquer sur Next
- 8 - Installation finished : Cliquer sur Finish
On va pouvoir se loguer à l'interface avec les identifiants suivants :
- - Login : admin
- - Password : PASSWORD
Génération de la configuration et démarrage du Monitoring-Engine :
Ensuite on va se rendre dans la partie "Configuration" de la barre de navigation puis cliquer sur l'onglet "Monitoring Engines".
Dans la partie "Actions", on va cocher les cases suivantes :
- - Generate Configuration Files
- - Run monitoring engine debug (-v)
Cliquer sur "Export".
Ensuite on va décocher les options précédemment cochées et cocher les options suivantes :
- - Move Export Files
- - Restart Monitoring Engine
On se logue en ssh en tant que root et démarre le service "cbd" :
/etc/init.d/cbd start
Notre serveur est démarré et l'on va pouvoir vérifier son état et celui de sa configuration dans l'onglet "Centreon" à droite de "Monitoring Engines".
On pourra voir que notre serveur est actif si l'on voit : "Is running - YES".
2 - Installation et paramétrage de ssmtp
Ssmtp va permettre à notre serveur d'envoyer des mails ce qui permettra à Centreon de pouvoir nous faire parvenir ses alertes par email.
Pour l'exemple on va utiliser le smtp de gmail pour l'envoi des messages.
Installation et téléchargement de ssmtp :
cd /tmp
wget http://www.mgroup.fr/public/downloads/rpm/ssmtp-2.61-19.el6.x86_64.rpm
rpm -ivh ssmtp-2.61-19.el6.x86_64.rpm
Installation de nano (Editeur de texte) :
yum install nano
Changement du MTA (Mail Transfert Agent) :
alternatives --config mta
Et choisir le numéro correspondant à ssmtp.
Sauvegarde du fichier de configuration original de ssmtp :
mv /etc/ssmtp/ssmtp.conf /etc/ssmtp/ssmtp.conf.back
Création du nouveau fichier de configuration :
nano /etc/ssmtp/ssmtp.conf
## exemple ssmtp by mgroup ##
## Serveur SMTP et port vers lequel on envoie les mails
## Pour Gmail : mailhub=smtp.gmail.com:465
## Pour Orange : mailhub=smtp-msa.orange.fr:587
MailHub=smtp.gmail.com:465
## Optionnel
## le domaine depuis lequel est envoye le mail
## laissez vide si vous n en avez pas
RewriteDomain=
## nom du serveur
Hostname=centreon
## forcer re ecriture expéditeur (le champ expediteur du mail)
#FromLineOverride=yes
## destinataire auquel le serveur renvoie
## les messages
## peut etre different du compte gmail
## ou orange
Root=USER@gmail.com
## authentification sur le relais smtp ##
## securite ssl
## yes pour gmail
## commenter la ligne avec diese pour orange
## mais moins secure
UseTLS=yes
## votre compte gmail ou orange
## exemple : USER@gmail.fr
AuthUser=USER@gmail.com
## le mot de passe associe au compte
AuthPass=PASSWORD
Test de configuration de ssmtp :
mail user@domain.tld
Subject: test ssmtp
Contenu du message de test
.
[enter]
On va pouvoir suivre l'envoi d'email dans le log /var/log/maillog.
3 - Paramétrage de l'utilisateur Admin
Toujours dans le menu "Configuration", on va cliquer sur l'onglet "Users" et choisir "Supervisor" et modifier quelques propriétés pour permettre de recevoir les notifications.
Général Information :
- - Email : votre email
Notification :
- - Enable notifications : Yes
Host :
- - Host Notification Options : décocher "none" et cocher toutes les autres.
- - Host Notification Period : 24x7
- - Host Notification Commands : host-notify-by-email
Service :
- - Service Notification Options : décocher "none" et cocher toutes les autres.
- - Service Notification Period : 24x7
- - Service Notification Commands : service-notify-by-email
5 - Configuration d'un nouvel hôte à superviser
Toujours dans le menu "Configuration", on va cliquer sur l'onglet "Hosts" et y ajouter le serveur que l'on souhaite surveiller.
Dans cette exemple on va superviser un serveur LAMP via une sonde ping.
On va cliquer sur "Add" et configurer les paramètres de la façon suivante :
Général Information :
- - Host Name : HOSTNAME
- - Alias : Description machine
- - IP : IP_HOST
- - Host Templates : Cliquer sur add a template et choisir "Linux-Servers"
Notification :
- - Notification Enabled : yes
- - Implied Contacts : add Admin
- - Implied Contact Groups : add Supervisors
- - Notification Interval : 1
- - Notification Period : 24*7
- - Notification Type : Warning + Unknown + Critical + Flapping
- - First notification delay : 1
Cliquer sur "Save".
Si on clique dans la barre des menus dans Configuration > Services, on va pouvoir voir un certain nombre de sonde système affectées à notre nouvel hôte. En ayant choisi le template d'hôte "Linux-Servers", on hérite de sonde configurée pour le nouvel hôte crée.
6 - Paramétrage de la sonde ping
On souhaite que la sonde ping se lance toute les minutes et envoie une alerte si l'hôte est indisponible.
On va cliquer sur l'onglet "Service", on va cliquer sur le service ping de l'hôte crée et modifier les valeurs suivantes :
Service State :
- - Check Period : 24*7
- - Max Check Attempts : 1
- - Normal Check Interval : 1
- - Retry Check Interval : 1
Notification :
- - Notification Enabled : yes
- - Implied Contacts : add Admin
- - Implied Contact Groups : add Supervisors
- - Notification Interval : 1
- - Notification Period : 24*7
- - Notification Type : Warning + Unknown + Critical + Flapping
- - First notification delay : 1
Cliquer sur "Save".
7 - Application des changements de la configuration
On retourne dans l'onglet "Monitoring Engines" du menu "Configuration" et on va générer la nouvelle configuration qui sera prise en compte après redémarrage du Monitoring Engines.
Dans la partie "Actions", on va cocher les cases suivantes :
- - Generate Configuration Files
- - Run monitoring engine debug (-v)
- - Move Export Files
Et cliquer sur "Export".
Ensuite on va décocher ces options et juste cocher l'option : Restart Monitoring Engine et laisser la méthode sur restart. Puis on va de nouveau cliquer sur "Export".
On va pouvoir voir notre service Apache dans la liste des services dans le menu "Monitoring" > "Services" > "All Services". Si on stop apache sur la machine supervisée, on verra le service passer en « critical » et on recevra une alerte par mail.
PS : Préférer le navigateur Firefox pour l'interface de gestion. Si aucun des services n’apparaissent lors du premier démarrage, faire un reboot.
8 - Procédure réinitialisation en cas de décrochage du poller :
Si les indicateurs « Poller States » (en haut à gauche de l’interface web) sont en rouges et indiquent un blocage de ce dernier lors du redémarrage de la VM, effectuer les opérations suivantes :
ntpdate europe.pool.ntp.org service cbd restart service centcore restart reboot
Relancer le poller dans le menu configuration > monitoring engine en cochant les cases « Generate Configuration Files » et « Run monitoring engine debug » puis en cliquant sur « Export ».
Ensuite cochez « Move Export Files » et « Restart Monitoring Engine » puis cliquer sur « Export ».
Puis redémarrer la machine.
Vérifier le log : /var/log/centreon-broker/central-module-master.log et s’assurer que la table « logs » de la db centreon_storage.
Réparation de la table centstorage/logs :
cd /var/lib/mysql/centreon_storage/
myisamchk -o ./logs.MYI
Commande de diagnostic de la config Centreon :
cbd -D centreon-broker.xml
Sources :
http://documentation.centreon.com/docs/centreon/en/2.5.x/user/01a.html http://www.mgroup.fr/index.php?post/2013/03/12/centos_ssmtp