Table of Contents

Nagios

Documentation sur Nagios seul avec une configuration et une architecture complète ainsi que la mise en place de NDOUtils et Nagvis.

Version utilisées dans cette documentation

Généralités

Nagios (anciennement appelé Netsaint) est une application permettant la surveillance système et réseau. Elle surveille les hôtes et services spécifiés, alertant lorsque les systèmes vont mal et quand ils vont mieux. C'est un logiciel libre sous licence GPL. C'est un programme modulaire qui se décompose en trois parties :

Installation de Nagios

Cf. documentation gestionnaire_paquets_gnu_linux pour connaître la liste des possibilités de gestion de paquets sous Linux.

Les RPM installés manuellement (fichier avec l'extension .rpm) sont à récupérer sur les sites de création de paquets comme dagwieers.com, rpm.pbone.net et rpmfind.net. Essayer d'obtenir la dernière version du logiciel.

La totalité des paquets qui n'était pas présent dans les paquets fournit avec le dépôt EPEL a été récupérée sur le site rpm.pbone.net. On ne peut pas installer Nagios en faisant un yum install nagios car Nagios n'est pas intégré par Red Hat dans Red Hat Network. Par contre avec le dépôt EPEL, Nagios est présent mais en version 2. Or il est plus intéressant de disposer de la dernière version car elle contient des améliorations importantes par rapport à la 2 et Centreon 2 ne supporte que Nagios version 3.

Donc, pour l'installation, la méthode du dépôt EPEL, et des paquets RPM récupérés manuellement sur Internet a été utilisée.

Remarque : remplacer les noms de paquets par les versions adéquates. Récupérer le dossier nagios avec tout les RPM téléchargés avec WinSCP et le positionner dans /root par exemple. Il faudra après installation supprimer le dossier.

Étapes d'installation de Nagios

Dépendances dont a besoin nagios pour fonctionner. 

yum install httpd gcc glibc glibc-common gd gd-devel
yum install libtool-ltdl

Décommenter la directive ServerName du fichier /etc/httpd/conf/httpd.conf.

Les deux paquets principaux de nagios. 

rpm -ivh nagios-3.0.6-1.el5.rf.i386.rpm
rpm -ivh nagios-plugins-1.4.13-4.el5.i386.rpm

Deux dépendances nécessaires à net-snmp 

yum install fping
yum install qstat

Installer les paquets SNMP suivants nécessaires au fonctionnement de nagios avec SNMP. Essayer de les installer avec yum ou utiliser les paquets téléchargés. Faire attention, certains paquets sont peut-être déjà présent sur le système. 

yum install net-snmp net-snmp-libs net-snmp-utils php-snmp
yum install nagios-plugins-all
vi /etc/nagios/objects/contacts.cfg

changer nagioasadmin@localhost par votre boite mail de supervision par exemple.

Attribuer un mot de passe pour nagios. 

passwd nagios

Créer le mot de passe de connexion à l'interface web de supervision. 

htpasswd -c /etc/nagios/htpasswd.users nagiosadmin

C'est la même commande pour changer le mot de passe.

Redémarrer le service. 

service httpd restart

Vérifier la syntaxe du fichier de configuration de nagios. 

nagios -v /etc/nagios/nagios.cfg

Démarrer le service nagios. 

/etc/init.d/nagios start

Vérifier qu'il est bien lancé. 

ps -ef | grep nagios

Vérifier qu'il est lancé au démarrage de la machine. 

chkconfig --list | grep nagi

Accéder à l'interface web de nagios. 

http://serveur.domaine.local/nagios/

Entrer nagiosadmin et son mot de passe. On accède à l'interface de nagios.

Configuration de Nagios

Documentations

Architecture utilisée

Nous avons le fichier /etc/nagios/nagios.cfg qui inclus la plupart des fichiers qui suivent.

Le dossier qui contient la configuration (/etc/nagios/objects), dispose des fichiers suivants par défaut.

Général

Déclaration des éléments à superviser

Ceci est la configuration par défaut. Nous allons considérablement la modifier.

Pour clarifier le plus possible les fichiers de configuration et faire en sorte qu'ils restent lisibles (pas un fichier de 400 lignes), on va découper la configuration. Pour une structure qui dispose d'environ 200 serveurs et d'environ 100 éléments réseaux. A raison de sept lignes par définition d'hôtes dans le fichier de configuration, cela représente finalement 300*7 = 2100 lignes de configuration.

Pour conserver la lisibilité des fichiers, nous allons adopter la configuration qui suit.

Supervision locale du serveur de supervision

Supervision des systèmes Windows

Supervision des systèmes Linux

Supervision des systèmes VMware ESX

Fichier de déclaration de tous les groupes de systèmes (Windows, Linux, ESX)

Supervision des routeurs

Supervision des switchs

Supervision des bornes wifi

Supervision des faisceaux hertziens

Pour les routeurs, les switchs, les bornes wifi et les faisceaux hertziens

A chaque fois qu'un nouveau fichier est créé, vérifier que le propriétaire et le groupe est bien nagios et que ses permissions sont -rw-rw-r– (664). 

chown nagios:nagios hst-rt.cfg
chmod 664 hst-rt.cfg

L'ajout des fichiers décrit précédemment se décrit dans le fichier de configuration principal /etc/nagios/nagios.cfg.

Visionner le schéma ci-après pour avoir une meilleure idée. 

######################## System ##########################
###### Local Linux config ######
# Definitions for monitoring the local (Linux) host
cfg_file=/etc/nagios/objects/localhost.cfg

# Definitions for all hosts
cfg_dir=/etc/nagios/objects/hst

# Definition for all groups
cfg_dir=/etc/nagios/objects/grp

# Definition for all services and service groups
cfg_dir=/etc/nagios/objects/ser

J'ai donc créé une arborescence de dossier simple.

Remarque : tous les fichiers présents doivent obligatoirement avoir l'extension .cfg pour être pris en compte par Nagios.

Il faut savoir que tout peut être regroupé dans encore moins de fichiers mais c'est plus clair comme cela.

Pour connaître les erreurs de tout les fichiers qui sont ajoutés dans /etc/nagios/nagios.cfg, exécuter la commande suivante. 

nagios -v /etc/nagios/nagios.cfg

Important

L'architecture que nous utilisons est simple. Des hôtes sont membres d'un groupe. Sur ce groupe nous allons appliquer différents services. J'ai séparé les machines virtuelles des machines physiques car des différences les opposent au niveau réseau. Les machines physiques ont des Bonding actif-passif avec leurs deux cartes et les serveurs virtuels ont une seule carte réseau sans configuration particulière.

Groupe de serveurs Windows

grp-win

Groupe de serveurs Linux

grp-lin

grp-esx

Groupe de services Windows de base

ser-win-base

Groupe de services Linux de base

ser-lin-base

Groupe de services ESX de base

ser-esx-base

Exemple : les hôtes Linux appartiennent à un groupe d'hôtes Linux (grp-lin) et les services associés ont été définie comme appartenant au groupe Linux. De cette manière toutes les nouvelles machines Linux ajoutées membre de ce même groupe d'hôtes (grp-lin) auront les mêmes services supervisés. De cette manière on applique des services à un groupe d'hôtes.

Cas d'exemple concret faisant intervenir tout les types de fichiers.

/etc/nagios/nagios.cfg 

######################## System ##########################
# Definitions for all hosts
cfg_dir=/etc/nagios/objects/hst

# Definition for all groups
cfg_dir=/etc/nagios/objects/grp

# Definition for all services and service groups
cfg_dir=/etc/nagios/objects/ser
<code>

''/etc/nagios/objects/hst-win.cfg''
<code>
define host{
        use             windows-server  ; Inherit default values from a template
        host_name       srv-w2k3-sup    ; The name we're giving to this host
        address         172.20.50.30    ; IP address of the host
        hostgroups      grp-win-vm      ; Host belong group
        }

/etc/nagios/objects/grp-srv.cfg 

define hostgroup{
        hostgroup_name  grp-win                 ; The name of the hostgroup
        alias           Global Windows Servers Group    ; Long name of the group
        #This group contain all the other Windows groups
        hostgroup_members       grp-win-vm, grp-win-ph
        }

define hostgroup{
        hostgroup_name  grp-win-vm              ; The name of the hostgroup
        alias           VM Windows Servers Group        ; Long name of the group
        }

/etc/nagios/objects/ser-win.cfg 

# Create a service for monitoring Windows CPU load with SNMP
define service{
        use                     generic-service         ;Use generic-service template
        hostgroup_name          grp-win           ;Apply this service to hostgroup
        service_description     chk-win-load            ;Description of service
        check_command           check_win_load!COMMUNAUTE_SERVEUR!--v2c!stand!85!95 ;Command
        servicegroups           ser-win-base            ;Service belong servicegroup
        }

Un hôte créé dans hst-win.cfg (srv-w2k3-sup = machine virtuelle) est membre d'un groupe de machine (grp-win-vm) créé dans grp-srv.cfg lui-même membre du groupe grp-win. Les services créés dans ser-win.cfg sont associés au groupe de machine globale (grp-win) sauf dans le cas où ils sont spécifiques. Dans ce cas, il sont attaché au groupe grp-win-vm . C'est pour cette raison que lors de l'ajout d'une nouvelle machine à un groupe, elles disposent directement de tous les services associés sans modification.

Il faut juste savoir si la machine est physique ou virtuelle. Les modifications ne sont à prévoir que lors d'arrivée de nouveau matériel. Il faudra peut-être dans ce cas mettre à jour la configuration pour les prendre en compte.

Supervision serveur/réseau avec agent

Cf. documentation Supervision Nagios agent.

Supervision serveur/réseau avec le protocole SNMP sans installation d'agent

Cf. documentation Supervision Nagios SNMP.

Supervision locale du serveur Nagios

Il faut que le serveur s'auto supervise un minimum pour éviter que le serveur sur lequel on se base pour obtenir des informations soit perdu à cause d'un système de fichiers plein ou une autre chose du même genre.

La totalité de la configuration de la supervision de l'hôte local (le serveur Nagios) se situe dans /etc/nagios/localhost.cfg. L'hôte, le groupe et les services sont définies dans le même fichier localhost.cfg. Comme une seule machine est déclarée, il n'est pas nécessaire de séparer la configuration.

Par défaut une configuration spécifique est créé pour la supervision locale du serveur. J'ai fait le choix de conserver exactement le même type de supervision que les autres serveurs Linux en utilisant SNMP en local. Néanmoins, j'ai séparé le serveur dans un groupe dédié car cela permet d'ajouter des services uniquement à ce serveur dans les ajouter aux autres.

J'ai modifié la définition de l'hôte local afin de l'intégrer au groupe grp-local dans lequel il est seul. 

define host{
        use                     linux-server            ; Name of host template to use
                                                        ; This host definition will inherit all variables that are defined
                                                        ; in (or inherited by) the linux-server host template definition.
        host_name               localhost
        alias                   Serveur de supervision
        address                 127.0.0.1
        hostgroups              grp-local
        }

# Define an optional hostgroup for Linux machines

define hostgroup{
        hostgroup_name  grp-local ; The name of the hostgroup
        alias           Groupe Machine locale ; Long name of the group
        }

# Define a service to "ping" the local machine
define service{
        use                             local-service         ; Name of service template to use
        host_name                       localhost
        service_description             Ping
        check_command                   check_ping!3.0,20%!6.0,60%
        }

# Create a service for monitoring Linux partitions levels with SNMP
# Checks that "/", "/tmp", "/usr", "/var" mountpoints usage is < 85 and 95%
define service{
        use                     generic-service         ;Use generic-service template
        host_name               localhost
        service_description     chk-lin-disk            ;Description of service
        check_command           check_lin_storage!COMMUNAUTE_SERVEUR!--v2c!"^/$|tmp|usr|var|data"!85!95   ;Command
        servicegroups           ser-local            ;Service belong servicegroup
        }

# Create a service for monitoring Linux load (CPU + processus + disk charge confondu) with SNMP
define service{
        use                     generic-service         ;Use generic-service template
        host_name               localhost
        service_description     chk-lin-load            ;Description of service
        check_command           check_lin_load!COMMUNAUTE_SERVEUR!--v2c!netsl!4,3,3!8,5,5 ;Command
        servicegroups           ser-local            ;Service belong servicegroup
        }

# Create a service for monitoring Linux memory (RAM + Swap) with SNMP
# Linux_memory : warning at 95% memory used and 20% swap used, critical at 99% mem and 70% swap
define service {
        use                     generic-service         ;Use generic-service template
        host_name               localhost
        service_description     chk-lin-mem            ;Description of service
        check_command           check_lin_mem!COMMUNAUTE_SERVEUR!--v2c!-N!95,20!99,70             ;Command
        servicegroups           ser-local            ;Service belong servicegroup
        }

define service{
        use                     generic-service ; Inherit values from a template
        host_name               localhost
        service_description     chk-lin-up
        check_command           check_snmp!-C COMMUNAUTE_SERVEUR -P 2c -o sysUpTime.0
        servicegroups           ser-local     ; Service belong servicegroup
        }

# Network interfaces checks
define service {
        use                     generic-service         ;Use generic-service template
        host_name               localhost
        service_description     chk-lin-int            ;Description of service
        #warning to 15 Mo/s (input) and 15 Mo/s (output) and critical to 25 Mo/s (input) and 25 Mo/s (output)
        check_command           check_lin_int!COMMUNAUTE_SERVEUR!--v2c!"eth0"!15,15!25,25
        servicegroups           ser-local            ;Service belong servicegroup
        }

# Nagios process check if > 50% CPU utilisation warning and if 100% critical
define service {
        use                     generic-service         ;Use generic-service template
        host_name               localhost
        service_description     chk-lin-procs            ;Description of service
        check_command           check_lin_procs!nagios!CPU!50!100
        servicegroups           ser-local            ;Service belong servicegroup
        }


Définition du groupe de service
define servicegroup{
        servicegroup_name       ser-local
        alias                   Supervision serveur de supervision
       }

Vérifier la configuration pour éliminer les éventuelles erreurs. 

nagios -v /etc/nagios/nagios.cfg

Redémarrer le service Nagios. 

/etc/init.d/nagios restart

Accéder à l'interface web de nagios : http://srv-supervision.domaine.local/nagios/

Notifications

J'ai paramétré tout les templates définit dans templates.cfg afin que les notifications mails ne soient envoyé qu'une seule fois. C'est l'option notification_interval 0 qui permet de régler cette possibilité.

La boîte mail mailsupervis a bénéficié de règles Exchange serveur afin de séparer les différents types de mail envoyé par Nagios dans différents dossiers.

Cette mise en place a été faite sur une boîte au lettre Outlook basé sur un serveur Exchange. On peut réaliser le même chose avec d'autres serveurs de messagerie afin de créer des règles serveurs associées à la boîte. C'est plus intéressant que des règles associées à un profil parce qu'il faut que ce profil soit actif pour que les règles soient exécutées.

Ainsi, si on veut obtenir les informations critiques, on n'a uniquement à consulter le dossier CRITICAL et DOWN sans se poser de questions. Pour plus d'information, se reporter à la documentation de gestion de la boîte mail de supervision : gestion-mailsupervis.

Paramétrage des intervalles de check

Les services que nous avons définies s'appuient tous sur le template generic-service déclaré dans /etc/nagios/objects/templates.cfg.

J'ai modifié l'intervalle de vérification à 3 minutes (normal_check_interval) et j'ai laissé la valeur par défaut à 2 minutes pour les services qui ont été déclarés en difficultés (retry_check_interval). J'ai aussi passé les renotifications (notification_interval) à 0 afin de désactiver celles-ci. 

define service{
        name                            generic-service         ; The 'name' of this service template
        active_checks_enabled           1                       ; Active service checks are enabled
        passive_checks_enabled          1                       ; Passive service checks are enabled/accepted
        parallelize_check               1                       ; Active service checks should be parallelized (disabling this can lead to major performance problems)
        obsess_over_service             1                       ; We should obsess over this service (if necessary)
        check_freshness                 0                       ; Default is to NOT check service 'freshness'
        notifications_enabled           1                       ; Service notifications are enabled
        event_handler_enabled           1                       ; Service event handler is enabled
        flap_detection_enabled          1                       ; Flap detection is enabled
        failure_prediction_enabled      1                       ; Failure prediction is enabled
        process_perf_data               1                       ; Process performance data
        retain_status_information       1                       ; Retain status information across program restarts
        retain_nonstatus_information    1                       ; Retain non-status information across program restarts
        is_volatile                     0                       ; The service is not volatile
        check_period                    24x7                    ; The service can be checked at any time of the day
        max_check_attempts              3                       ; Re-check the service up to 3 times in order to determine its final (hard) state
        normal_check_interval           3                       ; Check the service every 10 minutes under normal conditions
        retry_check_interval            2                       ; Re-check the service every two minutes until a hard state can be determined
        contact_groups                  admins                  ; Notifications get sent out to everyone in the 'admins' group
        notification_options            w,u,c,r                 ; Send notifications about warning, unknown, critical, and recovery events
        notification_interval           0                       ; not Re-notify about service problems
        notification_period             24x7                    ; Notifications can be sent out at any time
         register                        0                      ; DONT REGISTER THIS DEFINITION - ITS NOT A REAL SERVICE, JUST A TEMPLATE!
        }

Changer aussi les intervalles de renotifications dans chaque template appliqués à un groupe de machines (host templates). Il faut réaliser cela pour linux-server, windows-server, generic-printer, generic-switch. Voici un exemple avec windows-server. 

define host{
        name                    windows-server  ; The name of this host template
        use                     generic-host    ; Inherit default values from the generic-host template
        check_period            24x7            ; By default, Windows servers are monitored round the clock
        check_interval          3               ; Actively check the server every 5 minutes
        retry_interval          1               ; Schedule host check retries at 1 minute intervals
        max_check_attempts      10              ; Check each server 10 times (max)
        check_command           check-host-alive        ; Default command to check if servers are "alive"
        notification_period     24x7            ; Send notification out at any time - day or night
        notification_interval   0               ; Not Resend notifications
        notification_options    d,r             ; Only send notifications for specific host states
        contact_groups          admins          ; Notifications get sent to the admins by default
        hostgroups              windows-servers ; Host groups that Windows servers should be a member of
        register                0               ; DONT REGISTER THIS - ITS JUST A TEMPLATE
        }

Vérifier la configuration pour éliminer les éventuelles erreurs avec nagios -v /etc/nagios/nagios.cfg.

Redémarrer le service Nagios. 

/etc/init.d/nagios restart

Accéder à l'interface web de nagios : http://srv-supervision.domaine.local/nagios/

Extension Mozilla Firefox : Nagios Checker

Cf. documentation Nagios-Checker qui traite de cette extension.

Erreures connues

no usable data on file

Classique lors de l'ajout d'un élément. Il faut attendre un peu que le fichier situé dans /tmp soit créé. Il y a un fichier par interface. Il faut qu'ils disposent des bonnes permissions. Par défaut elles sont bien appliquées mais si on fait le test de la commande en root, le fichier est créé avec ces propriétés. Du coup, le compte nagios n'accède pas au fichier en émettant une erreur. Pour remédier à cela utiliser chown. 

chown nagios:nagios tmp_Nagios_int.172.20.50.126.Ethernet1_0

NDOUtils

Prérequis

Nagios et MySQL.

Installation MySQL

Une documentation nommée MySQL permet d'installer MySQL. 

yum install mysql

Configurer MySQL

Commencer par créer un disque supplémentaire (ici de 6Go de taille) afin d'isoler la base de données du système.

J'ai suivi la documentation Manipulations_disques_simple_lvm prévue à cet effet.

J'ai donc un point de montage /data qui pointe sur le deuxième disque nouvellement ajouté.

J'ai supprimé le fichier /etc/my.cnf par défaut (copie de sauvegarde au début quand même) et j'ai copié le fichier /usr/share/mysql/my-large.cnf à la place. 

cp /usr/share/mysql/my-large.cnf /etc

Plusieurs gabarit sont fournit par défaut pour adapter la configuration en fonction de la taille de la machine (my-huge.cnf, my-large.cnf, my-medium.cnf…).

J'ai créé un dossier /data/sgbd qui remplacera le dossier par défaut /var/lib/mysql. 

chown mysql:mysql /data/sgbd

Arrêter le serveur. 

/etc/init.d/mysqld stop

Supprimer le dossier /var/lib/mysql.

Créér un lien symbolique nommé mysql dans /var/lib qui pointe sur le dossier /data/sgbd. 

cd /var/lib
ln -s /data/sgbd mysql

Options modifiés de my.cnf en partant à l'origine de my-large.cnf. 

[client]
socket          = /data/sgbd/mysql.sock

# The MySQL server
[mysqld]
datadir         = /data/sgbd
socket          = /data/sgbd/mysql.sock

# Try number of CPU's*2 for thread_concurrency
thread_concurrency = 4
max_connections=200

Très important la directive qui active ou désactive les logs binaires de MySQL. L'activation de ces logs est obligatoire dans les cas de serveur maître et esclave ce qui n'est pas le cas pour nous. Les logs binaires contiennent toutes les requêtes qui modifie la BD. Le problème est la taille que prennent ces logs. On ne peut que les purger sur une durée d'un jour ce qui n'est pas assez fin. La rotation est impossible ce qui m'a conduit à les désactiver. 

# binary logging - not required for slaves, but recommended
#log-bin=mysql-bin

Toujours dans la section mysqld, j'ai décommenté et modifié la configuration concernant Innodb car c'est le type de table que nous allons utiliser. 

# Uncomment the following if you are using InnoDB tables
#innodb_data_home_dir = /data/sgbd/
#innodb_data_file_path = ibdata1:10M:autoextend

#innodb_log_group_home_dir = /data/sgbd/
#innodb_log_arch_dir = /data/sgbd/

# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 256M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 64M
#innodb_log_buffer_size = 8M
#innodb_flush_log_at_trx_commit = 1
#innodb_lock_wait_timeout = 50

# un fichier par table innodb
innodb_file_per_table

# Gestion des logs binaires (mysql-bin.0000X avec index mysql-bin.index)
#Default 1G = 1073741824
#150Mo * 1024 * 1024 = 157286400 octets
#60Mo * 1024 * 1024 = 62914560 octets

#max_binlog_size=62914560

#Default 4Go = 4294967295 octets
#1073741824 = 1Go
#max_binlog_cache_size=1073741824
#expire_logs_days=1

Redémarrer la base de données (/etc/init.d/mysqld restart) et lancer le script de sécurisation qui permet au passage d'attribuer un mot de passe à root. 

[root@srv-supervis mysql]# mysql_secure_installation
NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MySQL
      SERVERS IN PRODUCTION USE!  PLEASE READ EACH STEP CAREFULLY!

In order to log into MySQL to secure it, we'll need the current
password for the root user.  If you've just installed MySQL, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.

Enter current password for root (enter for none):
OK, successfully used password, moving on...

Setting the root password ensures that nobody can log into the MySQL
root user without the proper authorisation.

Set root password? [Y/n] Y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
 ... Success!


By default, a MySQL installation has an anonymous user, allowing anyone
to log into MySQL without having to have a user account created for
them.  This is intended only for testing, and to make the installation
go a bit smoother.  You should remove them before moving into a
production environment.

Remove anonymous users? [Y/n] Y
 ... Success!

Normally, root should only be allowed to connect from 'localhost'.  This
ensures that someone cannot guess at the root password from the network.

Disallow root login remotely? [Y/n] n
 ... skipping.

By default, MySQL comes with a database named 'test' that anyone can
access.  This is also intended only for testing, and should be removed
before moving into a production environment.

Remove test database and access to it? [Y/n] Y
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!

Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.

Reload privilege tables now? [Y/n] Y
 ... Success!
Cleaning up...

All done!  If you've completed all of the above steps, your MySQL
installation should now be secure.

Thanks for using MySQL!

Installer NDOUtils

Installation des dépendances dont NDOUtils a besoin. 

yum install postgresql

car NDOUtils intègre un début de support de la base de données PostgreSQL. Ceci n'installe pas PostgreSQL serveur, seulement le client.

Installer NDOUtils, il ne devrait pas demander d'autres dépendances. 

rpm -ivh ndoutils-1.4-0.beta7.3.el5.rf.i386.rpm
cd /etc/nagios
chown nagios:nagios ndo2db.cfg ndomod.cfg

Créer une base de données nommé nagios avec un nom d'utilisateur et un mot de passe que NDOUtils va utiliser. 

mysql -u root -p
mysql> create database if not exists `nagios`;
mysql> create user 'nagios'@'localhost' identified by 'MotDePasse';
mysql> grant usage on *.* to 'nagios'@'localhost' identified by 'MotDePasse' with max_queries_per_hour 0 max_connections_per_hour 0 max_updates_per_hour 0 max_user_connections 0;
mysql> grant select, insert, update, delete on `nagios`.* to 'nagios'@'localhost';

Pour créer la structure de la base de données, utiliser le script prévu à cet effet. 

cd /usr/share/ndoutils/
./installdb -u root -p MDProot -h localhost -d nagios

Ce script créé les tables de type Innodb. Ce mode de table permet une gestion des clés étrangères et des transactions. L'inconvénient est que nous ne pouvons pas sauvegarder la base à chaud.

Pour vérifier. 

mysql -u root -p
mysql> use nagios
mysql> show table status;

On voit que les tables sont de type Innodb et non MyISAM. Les fichiers de la base de données sont dans le dossier /data/sgbd/nagios et sont des fichiers .frm et .ibd mais pas des fichiers .myd.

Configuration Nagios

Vérifier que la valeur suivante est à -1 pour que Nagios transmette les informations à NDOUtils. Cela se situe dans /etc/nagios/nagios.cfg. C'est normalement appliqué par défaut. 

event_broker_options=-1

Ajouter le module qui gère l'interception des actions à positionner dans la base de données. 

broker_module=/usr/libexec/ndomod-3x.o config_file=/etc/nagios/ndomod.cfg

= utilise le module ndomod avec le fichier de configuration passé en paramètre.

Attention tout tient sur une seule ligne.

Configuration NDOUtils

Dans /etc/nagios/ndomod.cfg. 

#rotation pour 3h
file_rotation_interval=10800

Dans /etc/nagios/ndo2db.cfg. 

db_name=nagios
db_user=nagios
db_pass=MotDePasse

Pour obtenir plus d'informations dans le log /var/log/nagios/ndo2db.debug, il faut jouer avec les valeurs suivantes. 

debug_level=1
debug_verbosity=1
max_debug_file_size=1000000 = limite à 1 Mo le fichier de debug.

La rotation des données dans la base est géré par les valeurs suivantes. 

# Keep timed events for 24 hours
max_timedevents_age=1440

# Keep system commands for 1 week
max_systemcommands_age=10080

# Keep service checks for 1 week
max_servicechecks_age=10080

# Keep host checks for 1 week
max_hostchecks_age=10080

# Keep event handlers for 31 days
max_eventhandlers_age=44640

A partir de maintenant, NDOUtils récupère les informations et les positionne dans la base de données de manière structuré mais il n'est pas possible de les visionner actuellement. Remarque : une documentation est livrée sur le site de Nagios/NDOutils pour expliquer le schéma de la base de données. Cela peut-être utile si on veut obtenir des informations.

Nous allons utiliser Nagvis pour visualiser les informations.

Nagvis

Prérequis

Graphviz

On installe les modules PHP avec la commande yum. 

yum install php php-gd php-mysql php-mbstring php-xml php-common

php-session n'est pas présent dans les dépôts, mais ce paquet est compris dans le paquet php-common déjà installé normalement mais on le remet pour être sûr.

Aller dans le dossier et installer graphviz via les rpm téléchargés. Il est demandé une version supérieur à 2.14 de graphviz (pour Nagvis 1.4) or dans le dépôt epel, ce sont les version 2.12 qui sont fournit. 

rpm -ivh graphviz-2.22.2-1.el5.i386.rpm
rpm -ivh graphviz-doc-2.22.2-1.el5.i386.rpm
rpm -ivh graphviz-gd-2.22.2-1.el5.i386.rpm
rpm -ivh graphviz-graphs-2.22.2-1.el5.i386.rpm
rpm -ivh graphviz-perl-2.22.2-1.el5.i386.rpm

Redémarrer Apache pour prendre en compte les nouveaux modules.

Télécharger Nagvis (tar.gz) sur le site et positionner le dossier décompressé dans /usr/share/nagios/. 

tar zxvf navis-1.4.tar.gz
mv nagvis-1.4 /usr/share/nagios/nagvis

On a donc un dossier nommé /usr/share/nagios/nagvis qui contient l'intégralité de Nagvis. Nagvis est une application web, il n'y a aucune compilation à faire. C'est une succession de fichiers PHP à positionner dans un répertoire.

Remarque

Pour ce logiciel, j'ai utilisé directement les sources et non le RPM car une nouvelle version venait de sortir (1.4), c'est une application web donc qui ne demande pas de compilation et le rpm de la version 1.3 demandait une dépendance mystérieuse nommée rpmlib(PayloadIsLzma) que je n'ai jamais réussi à trouver. Pour information le rpm ne fait ni plus ni moins de copier les fichiers dans l'arborescence de fichiers, c'est tout.

Mettre en place le fichier de configuration principal. 

cd /usr/share/nagios/nagvis/etc
cp nagvis.ini.php-sample nagvis.ini.php

Connaître l'utilisateur et le groupe du serveur web Apache sous Red Hat. 

grep -e '^User' /etc/httpd/conf/*.conf
grep -e '^Group' /etc/httpd/conf/*.conf

Ceci est important pour ce qui suit : l'application des permissions sur les dossiers.

Application des permissions sur le dossier nagvis (dossier qui contient tout) 

chown apache:apache /usr/share/nagios/nagvis -R
chmod 664 /usr/share/nagios/nagvis/etc/nagvis.ini.php
chmod 775 /usr/share/nagios/nagvis/nagvis/images/maps
chmod 664 /usr/share/nagios/nagvis/nagvis/images/maps/*
chmod 775 /usr/share/nagios/nagvis/etc/maps
chmod 664 /usr/share/nagios/nagvis/etc/maps/*
chmod 775 /usr/share/nagios/nagvis/var
chmod 664 /usr/share/nagios/nagvis/var/*

Accès à la page d'accueil qui liste les cartes définies : http://srv-supervision.domaine.local/nagios/nagvis/nagvis/index.php

La page d'accueil est aussi accessible à cette URL : http://srv-supervision.domaine.local/nagios/nagvis/

Accès à la page de configuration web : http://srv-supervision.domaine.local/nagios/nagvis/config.php

Configuration Nagvis

Le fichier de configuration général est à l'origine une copie du fichier example. 

cd /usr/share/nagios/nagvis/etc/
cp nagvis.ini.php-sample nagvis.ini.php

Par défaut tout est en commentaire, Il faut simplement décommenter ce dont on a besoin. Je n'ai pas mis les sections pour laquelle il n'y a aucune directive de décommenté pour plus de clarté. 

vi /usr/share/nagios/nagvis/etc/nagvis.ini.php
; General options which affect the whole NagVis installation
[global]
; Dateformat of the time/dates shown in nagvis (For valid format see PHP docs)
dateformat="Y-m-d H:i:s"
; Select language (Available by default: en_US, de_DE)
language="fr_FR"
; Refresh time of pages
refreshtime=15

; Path definitions
[paths]
; absolute physical NagVis path
base="/usr/share/nagios/nagvis/"
; absolute html NagVis path
htmlbase="/nagios/nagvis"
; absolute html NagVis cgi path
htmlcgi="/nagios/cgi-bin"


; Path definitions
[paths]
; absolute physical NagVis path
base="/usr/share/nagios/nagvis/"
; absolute html NagVis path
htmlbase="/nagios/nagvis"
; absolute html NagVis cgi path
htmlcgi="/nagios/cgi-bin"

[defaults]
; default backend (id of the default backend)
backend="ndomy_1"
[...]

; ----------------------------
; Backend definitions
; ----------------------------

; in this example the ID of the Backend is "ndomy_1" you can define another ID.
[backend_ndomy_1]
; type of backend - MUST be set
backendtype="ndomy"
; hostname for NDO-db
dbhost="localhost"
; portname for NDO-db
dbport=3306
; database name for NDO-db
dbname="nagios"
; username for NDO-db
dbuser="nagios"
; password for NDO-db
dbpass="PWSAFE"
; prefix for tables in NDO-db
dbprefix="nagios_"
; instance name for tables in NDO-db
dbinstancename="default"
; maximum delay of the NDO Database in seconds
maxtimewithoutupdate=180
; path to the cgi-bin of this backend
htmlcgi="/nagios/cgi-bin"


; ----------------------------
; Rotation pool definitions
; ----------------------------

; in this example the browser switches between the maps demo and demo2 every 15
; seconds, the rotation is enabled by url: index.php?rotation=demo
[rotation_demo]
; These steps are rotated. The "Demo2:" is a label which is being displayed in
; the index pages rotation list.
maps="demo,Demo2:demo2"
; rotation interval (seconds)
interval=15

Type de carte

Pour la carte des serveurs, nous allons utiliser l'automap et pour la carte des routeurs, on va utiliser une carte dédiée sur laquelle on va positionner les éléments que l'on souhaite directement sur l'interface web.

Pour que l'automap fonctionne, il faut mettre en place une relation de dépendance entre les éléments au niveau de la configuration Nagios comme expliqué ici : http://nagios.sourceforge.net/docs/3_0/networkreachability.html

Concrètement, j'ai positionné tout les serveurs en tant que fils de localhost (le serveur nagios). Pour cela, il faut utiliser la directive parents qui permet de spécifier qu'un serveur dépend d'un autre ou d'un élément réseau. Nagvis reproduit la hiérarchie Nagios ni plus ni moins. Si on veut changer l'aspect hiérarchique, il faut changer la configuration dans Nagios elle sera automatiquement reportée dans Nagvis puisqu'il se base dessus.

J'ai réutilisé un fichier de demo pour avoir une base de départ. 

cd /usr/share/nagios/nagvis/etc/maps
cp demo-map.cfg carte-routeur.cfg

On peut directement rafraichir dans l'interface, la nouvelle carte est directement accessible sans redémarrer aucun service.

Copier le fichier image de fond de carte de la saône et loire dans le dossier des images dans le dossier suivant. 

/usr/share/nagios/nagvis/nagvis/images/maps/dep_routeurs1024x768.png

Éditer la configuration de la carte. 

vi /usr/share/nagios/nagvis/etc/maps/__automap.cfg

Changer le mot clé suivant dans la section global avec le nom de l'image. 

map_image=dep_routeurs1024x768.png

J'ai utilisé plusieurs fichiers images avec différentes résolutions pour s'adapter aux tailles des écrans. J'ai conservé les images de tailles supérieures. A l'origine, c'est la même image que celle utilisée dans l'ancien serveur de supervision. Néanmoins la qualité est meilleure. Je suis repartis du fichier source pour retailler les images.

Voici un exemple de carte qu'on peut obtenir à l'aide de Nagvis (image d'exemple du site officiel de Nagvis : http://www.nagvis.org/).

Restaurer la base de données nagios

Reprendre les dumps sauvegardés

gunzip dmpinfo20090618.sql.gz dmpmysql20090618.sql.gz dmpnagios20090618.sql.gz
mysql -u root -p < dmpmysql20090618.sql
mysql -u root -p < dmpinfo20090618.sql
cd /usr/share/ndoutils/
./installdb -u root -p MDProot -h localhost -d nagios
mysql -u root -p < dmpnagios20090618.sql

Rotation des logs

/etc/logrotate.d/services-nagios. 

/var/log/nagios/ndo2db.debug {
    daily
    rotate 1
    size=1M
    compress
    dateext
    missingok
    notifempty
}