Outils personnels

Paramétrage de Shinken : Différence entre versions

De wikiGite

(Paramétrages de base)
 
(5 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 14 : Ligne 14 :
  
 
=== Arborescence /etc/shinken ===
 
=== Arborescence /etc/shinken ===
brokerd.ini
+
* brokerd.ini
brokerd-windows.ini
+
* brokerd-windows.ini
certs
+
* certs
commands.cfg
+
* commands.cfg
contactgroups.cfg
+
* contactgroups.cfg
contacts.cfg
+
* contacts.cfg
dependencies.cfg
+
* dependencies.cfg
discovery.cfg
+
* discovery.cfg
discovery_rules.cfg
+
* discovery_rules.cfg
discovery_runs.cfg
+
* discovery_runs.cfg
escalations.cfg
+
* escalations.cfg
hostgroups.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
 
* 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
 
* services
sample.cfg
+
* shinken-specific.cfg
schedulerd.ini
+
* shinken-specific-high-availability.cfg
schedulerd-windows.ini
+
* shinken-specific-load-balanced-only.cfg
servicegroups.cfg
+
* shinken-specific-windows.cfg
services
+
* templates.cfg
shinken-specific.cfg
+
* timeperiods.cfg
shinken-specific-high-availability.cfg
 
shinken-specific-load-balanced-only.cfg
 
shinken-specific-windows.cfg
 
templates.cfg
 
timeperiods.cfg
 
  
 
=== Principaux Fichiers de configuration ===
 
=== Principaux Fichiers de configuration ===
Ligne 72 : Ligne 72 :
 
**hosts
 
**hosts
 
**services
 
**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 ===
 
=== A faire après chaque modification du paramétrage ===
Ligne 84 : Ligne 89 :
 
*Démarrage en Mode débug :
 
*Démarrage en Mode débug :
 
  /etc/init.d/shinken -d start
 
  /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 ===
 
=== Ajouter un hôte ===

Version actuelle datée du 26 mars 2012 à 10:39

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