Nagios¶
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/
{{lastupdated_at}} {{lastupdated_by}}
- Contenu
- Nagios
Installation¶
Requis¶
Un serveur
Apache fonctionnel avec
- mod_version,
- mod_php5,
Un serveur de courriel (Postfix ou Exim) fonctionnel,
Une adresse IP fixe,
Une entré DNS (enregistrement A ou CNAME).
Un ordinateur physique est fortement recommandé.
Installation de Nagios¶
Nouvelle méthode¶
Fonctionne pour openSUSE et Debian/Ubuntu
Modification de l'adresse d’envoi¶
Par défaut, les alertes vont provenir de nagios@nagios.domain.tld.
Certains système de courriel peuvent bloquer ces messages si le sous-domaine nagios.domain.tld n'existe pas.
Pour changer l'adresse « from », modifier le fichier etc/objects/command.cfg pour les commandes :
- notify-host-by-email
- notify-service-by-email
Ajouter à la fin de la ligne de commande (command_line) :
-- -f nagios@domain.tld
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 (,).
Fichiers de configuration¶
L'emplacement des fichiers dépend de la méthode l’installation précédente
- openSUSE (YaST) : /etc/nagios
- sources : /usr/local/nagios
Les principaux fichiers de configuration général sont :
- nagios.cfg : configuration de Nagios lui-même
- ressources.cfg : liste des macros, usagers et mots de passe
Fichiers d'objets¶
Les fichiers de configuration sont situés dans le répertoire objects.
Les principaux sont :
- templates.cfg
- commands.cfg : commandes, scripts à 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.
Hosts¶
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.
- action_url (facultatif) :
Exemple :
define host {
use linux−server
hostname linux1
alias Serveur Linux 1
address linux1.mydomain.com
}
Groups¶
Liste complète des paramètres pour les groupes d’hôtes
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
}
Services¶
Liste complète des paramètres pour les services
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%
}
NRPE¶
Modules supplémentaires¶
Agents¶
GNU/Linux¶
Installer nagios-nrpe
Version déjà compilée¶
opensSUSE
wget http://download.opensuse.org/repositories/openSUSE:/Leap:/42.2/standard/x86_64/nrpe-2.15-9.1.x86_64.rpm
rpm -Uhv nrpe-2.15-9.1.x86_64.rpm
À partir des sources¶
Voir NRPE
Windows¶
À venir ...
Modules supplémentaires¶
UPS¶
USP de la compagnie APC avec apcupsd.
Pre-requis : UPS sous openSUSE
Installation¶
wget -O check_apcupsd "http://exchange.nagios.org/directory/Plugins/Hardware/UPS/APC/check_apcupsd/visit"
chmod +x check_apcupsd
mkdir /usr/local/nagios/libexec/
mv check_apcupsd /usr/local/nagios/libexec/
Faire un test avec
/usr/local/nagios/libexec/check_apcupsd -w 50 -c 25 bcharge
Si le message d'erreur suivant apparait Error: /sbin/apcaccess must exist and be executable!, exécuter
# Creer un lien symbolique vers l'executable apcaccess
ln -s /usr/sbin/apcaccess /sbin/apcaccess
Configuration¶
Ajouter dans le fichier nagios/etc/objetcs/commands.cfg :
# Définis la commande check_apcupsd
define command{
command_name check_apcupsd
command_line $USER1$/check_apcupsd -h $HOSTADDRESS$ -w $ARG1$ -c $ARG2$ $ARG3$
}
Les arguments sont
- $ARG1$ : le seuil d'avertissement (warning)
- $ARG2$ : le seuil critique (critical)
- $ARG3$ : un des test suivants (liste complète avec apcupsd sans arguments): ** bcharge : charge des batteries, en pourcent ** itemp : température interne, en Celsius ** loadpct : charge en pourcent ** timeleft : : temps restant selon la charge actuelle
Dans le fichier nagios/etc/objects/localhost.cfg, inscrire les test à effectuer.
Ex. : Vérification de la charge restante, 50% étant un avertissement et 25% critique.
# Définis le service de charge restante du UPS
define service{
use local-service
host_name localhost
service_description UPS charge left
check_command check_apcupsd!50!25!charge
}
Nagstatmon¶
Logiciel de notification Nagios pour poste de travail.
Télécharger à partir de https://nagstamon.ifw-dresden.de/download
GNU/Linux¶
openSUSE¶
Utilisé la version disponible à http://software.opensuse.org/package/nagstamon?search_term=nagstamon
sudo zypper install nagstamon-1.0.1-1.1.noarch.rpm
Plugins maison¶
Mis à jour par Patrice Nadeau il y a plus de 5 ans · 127 révisions