En créant ou éditant votre fichier de configuration ,gardez à l'esprit que :
Le fichier principal de configuration est "shinken.cfg". Il est situé dans le répertoire "/etc/shinken/" .
Ci dessous, la liste des paramètres utilisés. Pour les autres paramètres (non réglés par défaut ) voir Advanced Configuration.
Format :
cfg_dir=<directory_name>
cfg_file=<file_name>
Ceux-ci sont des assertions, et non des paramètres . L'arbiter les considèrent comme des ordres pour ouvrir d'autre(s) fichier(s) de configuration.
Pour le cfg_dir one, l'arbiter lit uniquement les fichiers se terminant par ".cfg".
L'arbiter lit les directives de manière récursive pour les fichiers, mais ne considère plus les lignes à l'intérieur comme assertions.
Cela signifie que les fichiers cfg_dir ou cfg_file sont considérés comme paramètres en dehors de Shinken.cfg
L'arbiter gère le fichier principal de configuration différemment des autres fichiers.
Format:
retention_update_interval=<minutes>
Défaut:
retention_update_interval=60
Ce paramètre détermine l'intervalle (en minutes) entre chaque backup de rétention automatique de données par le scheduler en opération normale.
Si vous mettez cette valeur à 0, il ne sauvegardera pas les données de rétention à intervalle régulier, mais seulement à l'arrêt et au redémarrage.
Format:
max_service_check_spread=<minutes>
max_host_check_spread=<minutes>
Défaut:
max_service_check_spread=30
max_host_check_spread=30
Cette option détermine l'écart de temps maximum (en minutes) pour vérifier tous les hôtes/checks (qui sont planifiés pour être vérifiés régulièrement). Cette option garantira que les vérifications initiales se feront dans la période de temps définie. Par défaut, la valeur est 30 (minutes).
Format:
service_check_timeout=<seconds>
host_check_timeout=<seconds>
Défaut:
service_check_timeout=60
host_check_timeout=30
Il s'agit du nombre maximum de secondes qu'autorise Shinken Enterprise pour lancer les hôtes/checks. Si les vérifications dépassent cette limite, elles sont supprimées et un statut CRITICAL est retourné. Une erreur timeout sera également logguée.
Il y a souvent une confusion répandue, sur ce que cette option fait vraiment. Elle est destinée à être utilisée comme un mécanisme de dernier rempart, pour tuer les plugins qui se comportent mal . Elle doit être réglée sur une valeur haute (quelque chose comme 60 secondes ou plus ) , de sorte que chaque vérification soit dans ce délai . Si une vérification se fait sur longueur supérieure à cette limite , Shinken Enterprise va la tuer , pensant que c'est un processus d'emballement.
Format:
timeout_exit_status=[0,1,2,3]
Défaut:
timeout_exit_status=2
Etat défini par Shinken Enterprise en cas de timeout.
Format:
flap_history=<int>
Défaut:
flap_history=20
Cette option est utilisée pour définir la taille de l'historique gardé par le scheduler pour réaliser le calcul de l'état flapping .Par défaut, la valeur de 20 états gardés.
La taille mémoire est pour le démon scheduler : 4Bytes flap_history (nb hosts + nb checks). Pour un environnement important, il faut 4 20 (1000+10000) - 900Ko. .
Format:
max_plugins_output_length=<int>
Défaut:
max_plugins_output_length=8192
Cette option est utilisée pour définir la taille max en bytes pour les retours de plugins de checks .Si vous voyez des valeurs tronquées, comme par exemple pour des gros checks de disque, augmentez la valeur.
Format:
enable_problem_impacts_states_change=<0/1>
Défaut:
enable_problem_impacts_states_change=0
Cette option est utilisée si on applique le changement d'état lorsqu'un hôte ou un check est impacté par un problème cause. L'état sera changé à UNKNONW pour un check et UNREACHABLE pour un hôte jusqu'au lancement du prochain check. Le changement d'état ne compte pas comme une tentative, c'est juste pour la console afin que l'utilisateur sache que ces objets ont des problèmes et que leurs états précédents n'étaient pas sûrs.
Format:
disable_old_nagios_parameters_whining=<0/1>
Défaut:
disable_old_nagios_parameters_whining=0
Si 1, désactive toutes les notifications et messages à la vérification de la configuration
Format:
use_timezone=<tz from tz database>
Défaut:
use_timezone=''
Cette option permet d'outrepasser la zone de temps définie par défaut pendant laquelle l'instance Shinken Enterprise tourne . C'est très utile si vous avez plusieurs instances qui doivent tourner sur le même serveur, mais avec des plages horaires différentes . Si rien n'est spécifié, Shinken Enterprise utilisera la plage horaire du système.
Format:
enable_environment_macros=<0/1>
Default:
enable_environment_macros=0
Cette option détermine si le démon Shinken Enterprise va rendre disponibles les :ref:`macros <thebasics/macrolist>` comme variables d'environnement pour les checks, notifications, gestionnaires d'événements, etc. Dans des installations importantes, cela peut être problématique car il nécessite de la CPU supplémentaire pour calculer les valeurs des macros et les rendre disponibles . Cela rajoute également de la communication réseau entre les schedulers et les pollers.
Format:
log_initial_states=<0/1>
Défaut:
log_initial_states=1
Cette variable détermine si Shinken Enterprise tous les états initiaux des hôtes et des checks à être loggués, même si le résultat est un état OK . Les état initiaux ne sont normalement loggués que lorqu'il y a un problème sur le 1er check. Activer cette option est utile si vous avez une application qui scanne le fichier log pour définir des statistiques long terme.
Format:
no_event_handlers_during_downtimes=<0/1>
Default:
no_event_handlers_during_downtimes=1
This option determines if Shinken Enterprise will run :ref:`event handlers <advanced/eventhandlers>` when the host or check is in a scheduled downtime.
The following parameters are common to all daemons.
Format:
workdir=<directory>
Default :
workdir=/var/run/shinken/
This variable specify the working directory of the daemon.
In the arbiter case, if the value is empty, the directory name of lock_file parameter. See below
Format:
lock_file=<file_name>
Example:
lock_file=/var/lib/shinken/arbiterd.pid
This option specifies the location of the lock file that arbiter daemon should create when it runs as a daemon (when started with the "-d" command line argument). This file contains the process id (PID) number of the running arbiter process.
Format:
local_log=<filename>
Default:
local_log=/var/log/shinken/arbiterd.log'
This variable specifies the log file for the daemon.
Format:
log_level=[DEBUG,INFO,WARNING,ERROR,CRITICAL]
Default:
log_level=WARNING
This variable specifies which logs will be raised by the arbiter daemon. For others daemons, it can be defined in their local \ d.ini files.
Defined in brokerd.ini, brokerd-windows.ini, pollerd.ini, pollerd-windows.ini, reactionnerd.ini, schedulerd.ini and schedulerd-windows.ini.
Format:
shinken_user=username
Default:
shinken_user=<current user>
This is used to set the effective user. The Arbiter process (main process) will run as this effective user.
After initial program startup, Shinken Enterprise will drop its effective privileges and run as this user.
Format:
shinken_group=groupname
Default:
shinken_group=<current group>
This is used to set the effective group of the user used to launch the arbiter daemon.
Format:
modules_dir=<direname>
Default:
modules_dir=/var/lib/shinken/modules
Path to the modules directory
Format:
daemon_enabled=[0/1]
Default:
daemon_enabled=1
Set to 0 if you want to make this daemon (arbiter) NOT to run
Format:
use_ssl=[0/1]
Default:
use_ssl=0
Use SSl or not. You have to enable it on other daemons too.
Format:
ca_cert=<filename>
Default:
ca_cert=etc/certs/ca.pem
Certification Authority (CA) certificate. Put full paths for certs
Format:
server_cert=<filename>
Default:
server_cert=etc/certs/server.cert
Server certificate for SSL.Put full paths for certs
Format:
server_key=<filename>
Default:
server_key=/etc/certs/server.key
Server key for SSL. Put full paths for certs
Format:
hard_ssl_name_check=[0/1]
Default:
hard_ssl_name_check=0
Enable SSL name check.
Format:
http_backend=[auto, cherrypy, swsgiref]
Default:
http_backend=cherrypy
Specify which http_backend to use.