Outils personnels

Paramétrage de Shinken

De wikiGite

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

Arborescence /etc/shinken

  • brokerd.ini
  • brokerd-windows.ini
  • certs
  • commands.cfg
  • contactgroups.cfg
  • contacts.cfg
  • dependencies.cfg
  • discovery.cfg
  • discovery_rules.cfg
  • discovery_runs.cfg
  • escalations.cfg
  • hostgroups.cfg
  • hosts
    • .cfg
  • htpasswd.users
  • nagios.cfg
  • nagios-windows.cfg
  • objects
    • contacts
    • discovery
  • pollerd.ini
  • pollerd-windows.ini
  • reactionnerd.ini
  • reactionnerd-windows.ini
  • receiverd.ini
  • receiverd-windows.ini
  • resource.cfg
  • sample
    • hosts
    • services
  • sample.cfg
  • schedulerd.ini
  • schedulerd-windows.ini
  • servicegroups.cfg
  • services
  • shinken-specific.cfg
  • shinken-specific-high-availability.cfg
  • shinken-specific-load-balanced-only.cfg
  • shinken-specific-windows.cfg
  • templates.cfg
  • timeperiods.cfg

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

Paramétrages de base, paramètres utiles

Seront listés ici les paramètres qu'il peut être intéressant de modifier.

  • service_check_timeout dans /etc/shinken/nagios.cfg

Si certains tests prennent plus de 10 secondes (valeur par défaut), augmenter cette valeur pour éviter les erreurs de timeout

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 template

dans templates.cfg

define host{
       name                            linux-server    ; The name of this host template
       use                             generic-host    ; This template inherits other values from the generic-host template
       check_period                    24x7            ; By default, Linux hosts are checked round the clock
       check_interval                  5               ; Actively check the host every 5 minutes
       retry_interval                  5               ; Schedule host check retries at 1 minute intervals
       max_check_attempts              2               ; Check each Linux host 10 times (max)
       check_command                   check_dummy!1   ; by default down
       notification_period             24x7
                                                       ; Note that the notification_period variable is being overridden from
                                                       ; the value that is inherited from the generic-host template!
       notification_interval           1               ; Resend notifications every 2 hours
       notification_options            d,u,r           ; Only send notifications for specific host states
#       contact_groups                  admins          ; Notifications get sent to the admins by default
       register                        0               ; DONT REGISTER THIS DEFINITION - ITS NOT A REAL HOST, JUST A TEMPLATE!
#        hostgroups              ServeursRedHat
       }

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