Outils personnels

Paramétrage de Shinken : Différence entre versions

De wikiGite

Ligne 5 : Ligne 5 :
 
Les fichiers de configuration de Shinken sont identiques à ceux de Nagios, donc les documentations Nagios sont applicables à Shinken.
 
Les fichiers de configuration de Shinken sont identiques à ceux de Nagios, donc les documentations Nagios sont applicables à Shinken.
  
== Emplacement des principaux fichiers ==
+
=== Emplacement des principaux fichiers ===
 
*<u>Configuration file folder</u> : /etc/shinken
 
*<u>Configuration file folder</u> : /etc/shinken
 
*<u>Plugins Nagios</u> : cd /usr/lib/nagios/plugins
 
*<u>Plugins Nagios</u> : cd /usr/lib/nagios/plugins
Ligne 13 : Ligne 13 :
 
*<u>Thruk web interface URL</u> : http://<@IP_serveur_Shinken>:3000
 
*<u>Thruk web interface URL</u> : http://<@IP_serveur_Shinken>:3000
  
== Principaux Fichiers de configuration ==
+
=== Principaux Fichiers de configuration ===
 
*contactgroups.cfg : Définition des groupes de contacts.
 
*contactgroups.cfg : Définition des groupes de contacts.
 
*nagios.cfg : Fichier principal de configuration de Nagios.      
 
*nagios.cfg : Fichier principal de configuration de Nagios.      
Ligne 30 : Ligne 30 :
 
**services
 
**services
  
== A faire après chaque modification du paramétrage ==
+
=== A faire après chaque modification du paramétrage ===
 
*Tester la configuration.
 
*Tester la configuration.
 
  /etc/init.d/shinken check
 
  /etc/init.d/shinken check
Ligne 42 : Ligne 42 :
 
  /etc/init.d/shinken -d start
 
  /etc/init.d/shinken -d start
  
== Ajouter un hôte ==
+
=== Ajouter un hôte ===
 
*Créer un fichier <nom_hote>.cfg dans /etc/shinken/objects/host :
 
*Créer un fichier <nom_hote>.cfg dans /etc/shinken/objects/host :
 
  define host{
 
  define host{
Ligne 55 : Ligne 55 :
 
*Ajouter l'hôte dans un hostgroup (/etc/shinken/hostgroups.cfg)
 
*Ajouter l'hôte dans un hostgroup (/etc/shinken/hostgroups.cfg)
  
== Ajouter un service ==
+
=== Ajouter un service ===
 
*Créer un fichier .cfg (par exemple apache.cfg) dans /etc/shinken/objects/services :
 
*Créer un fichier .cfg (par exemple apache.cfg) dans /etc/shinken/objects/services :
 
  # Simple web check
 
  # Simple web check
Ligne 66 : Ligne 66 :
 
         }
 
         }
  
== Installation de NRPE sur les serveurs (Linux) à monitorer ==
+
=== Installation de NRPE sur les serveurs (Linux) à monitorer ===
 
Rajouter NSClient ++
 
Rajouter NSClient ++
  

Version du 22 juin 2011 à 14:48

Documentation

Les fichiers de configuration de Shinken sont identiques à ceux de Nagios, donc les documentations Nagios sont applicables à Shinken.

Emplacement des principaux fichiers

  • Configuration file folder : /etc/shinken
  • Plugins Nagios : cd /usr/lib/nagios/plugins
  • Thruk : /opt/thruk
  • Log file : /var/lib/shinken/nagios.log
  • Shinken startup script : /etc/init.d/shinken
  • Thruk web interface URL : http://<@IP_serveur_Shinken>:3000

Principaux Fichiers de configuration

  • contactgroups.cfg : Définition des groupes de contacts.
  • nagios.cfg : Fichier principal de configuration de Nagios.
  • resources.cfg : Définition des ressources externes (Variables?)
  • shinken-specific.cfg : Fichier principal de configuration de Shinken.
  • timeperiods.cfg : Définition des "périodes de temps".
  • dependencies.cfg
  • escalations.cfg
  • commands.cfg : Fichier de définition des commandes utilisées par Shinken pour "checker" les machines.
  • hostgroups.cfg : Définition des groupes d'hôtes
  • servicegroups.cfg : Définition des groupes de services.
  • templates.cfg : Définition des modèles.
  • objects (Répertoire contenant les fichiers de configuration des contacts, hôtes et services)
    • contacts
    • hosts
    • services

A faire après chaque modification du paramétrage

  • Tester la configuration.
/etc/init.d/shinken check
  • Si le check est Failed, vérifier les logs :
cat /tmp/shinken_checkconfig_result
  • Relancer les services Shinken:
/etc/init.d/shinken restart

Remarque(s) :

  • Démarrage en Mode débug :
/etc/init.d/shinken -d start

Ajouter un hôte

  • Créer un fichier <nom_hote>.cfg dans /etc/shinken/objects/host :
define host{
        use                     linux-server
        contact_groups          admins
        host_name               atlanta
        alias                   Atlanta France
        address                 atlanta.dynalias.org
        check_interval          1
        parents                 router1
        }
  • Ajouter l'hôte dans un hostgroup (/etc/shinken/hostgroups.cfg)

Ajouter un service

  • Créer un fichier .cfg (par exemple apache.cfg) dans /etc/shinken/objects/services :
# Simple web check
define service{
        use                             local-service         ; Name of service template to use
        host_name                       localhost
        service_description             Http
        check_command                   check_http
        servicegroups                   LocalServices
        }

Installation de NRPE sur les serveurs (Linux) à monitorer

Rajouter NSClient ++

Wikipedia :

NRPE (Nagios Remote Plugin Executor) est un "Addons" pour Nagios qui permet d'exécuter des greffons (plugins) sur un serveur Linux/Unix distant. Cela permet de surveiller des ressources locales (charge du processeur, utilisation de la mémoire, espace disque...) qui ne sont normalement pas disponibles depuis d'autres machines.
Afin d'interroger un client NRPE il faut utiliser le greffon "check_nrpe" sur le serveur Nagios.
apt-get install nagios-nrpe-server
vim /etc/nagios/nrpe.cfg
/etc/init.d/nagios-nrpe-server start