%{font-size:18pt}Nagios%

Issue #20

Nagios est un système de surveillance (monitoring) d’ordinateurs, imprimantes, routeurs et de services logiciels.
Il existe en version payante (Nagios IX) et « open source » (Nagios Open Source).
C’est cette dernière version qui seras discutée ici.
Ce guide est une introduction et ne ce veux en aucun cas une formation complète.
Pour plus d’informations, consulter le site http://www.nagios.org/
Les explications suivantes sont pour une installation sous openSUSE avec les « packages » de YaST.
Les répertoires d’installation sont différents de ceux par défaut.

{{TOC}}

h1. Installation

h2. Requis

• Un serveur GNU/Linux,
• Apache installé et configuré,
• Postfix installé et configuré,
• Une adresse IP fixe,
• Une entré DNS (enregistrement A ou CNAME).

h3. Installation de Nagios

A partir de la ligne de commande, avec l’utilisateur root :

zypper install nagios-plugins-nrpe

h1. Configuration

h2. Création du fichier de mot de passe Web

Pour l’utilisation de la page Web disponible a l’adresse http://serveur/nagios.
L’utilisateur seras nagiosadmin.
A la ligne de commande, en tant que root :

htpasswd2 −c /etc/nagios/htpasswd.users nagiosadmin
service apache gracefu

h3. Démarrage automatique

chkconfig −−add nagios
service nagios start

Renommer le fichier localhost.cfg pour linux.cfg.
Modifier le fichier nagios.cfg pour refléter ce changement.
Vérifier la configuration avec rcnagios check.
Si il n’y pas d’erreurs, relancer le service avec rcnagios start.
Sinon, vérifier le log avec tail -20 /var/log/nagios/config.err.

h3. Fichiers

Les fichiers de configuration sont situés dans /etc/nagios
Les principaux sont :

• nagios.cfg : configuration de Nagios lui-même
• ressources.cfg : liste des macros, usagers et mots de passe

h1. Utilisation

Typographie dans les fichiers

• Un commentaire sur une ligne complète commence par un croisillon (#).
• Un commentaire à la fin d’une ligne commence par un point-virgule (;).
• Une exclusion est exprimé par un point d’exclamation (!) précédant l’item.
• Les items d’une liste sont séparés par une virgule (,).

h2. Fichiers

Les fichiers de configuration sont situés dans /etc/nagios/objects
Les principaux sont :

• templates.cfg
• commands.cfg : commandes, scripts a exécuter
• contacts.cfg : contacts pour les alarmes
• timeperiods.cfg : les périodes de vérifications

L’utilisation de gabarits (« templates ») est fortement recommandée.
Un item dans un gabarit peux être redéfinis.
Ceci permet d’avoir des gabarits ayant les options par défaut et seulement les exceptions sont à définir dans les sections hôtes, groupe et services.

Les explications suivantes prennent pour acquis l’utilisation des gabarits fournis avec Nagios.

h2. Hosts

"Liste complète des paramètres pour hôte":http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#host
Liste des items :

• use : le nom du gabarit, contenu dans template.cfg
• host_name : nom de l’hôte, seras utilisé dans le reste de la configuration.
• alias : description du hôte.
• address : l’adresse IP ou le FQDN du hôte.
• icon_image (facultatif) : une image représentant le serveur. Situé à /usr/share/nagios/images/logos.
• action_url (facultatif) :

Exemple :

define host {
    use      linux−server
    hostname linux1
    alias    Serveur Linux 1
    address  linux1.mydomain.com
}

h2. Groups

"Liste complète des paramètres pour les groupes d’hôtes":http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#hostgroup

Liste des items minimum :

• hostgroup_name : nom du groupe.
• alias : description du groupe.
• members : liste des hôtes dans ce groupe.

Exemple :

define hostgroup {
    hostgroup_name linux−servers
    alias          Linux servers
    members        linux1
}

h2. Services

"Liste complète des paramètres pour les services":http://nagios.sourceforge.net/docs/3_0/objectdefinitions.html#service

Liste des items minimum :

• use : le nom du gabarit.
• host_name : noms des hôtes utilisant ce service.
• service_description : description du service.
• check_command : commande à effectuer. Définis dans commands.cfg.

Exemple :

define service{
    use                    local−service
    host_name              localhost
    service_description    PING
    check_command          check_ping!100.0,20%!500.0,60%
}

h1. NRPE