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
State set by Shinken Enterprise in case of timeout.
Format:
flap_history=<int>
Défaut:
flap_history=20
This option is used to set the history size of states kept by the scheduler to make the flapping calculation. By default, the value is 20 states kept.
The size in memory is for the scheduler daemon : 4Bytes flap_history (nb hosts + nb checks). For a big environment, it costs 4 20 (1000+10000) - 900Ko. So you can raise it to higher value if you want.
Format:
max_plugins_output_length=<int>
Default:
max_plugins_output_length=8192
This option is used to set the max size in bytes for the checks plugins output. So if you saw truncated output like for huge disk check when you have a lot of partitions, raise this value.
Format:
enable_problem_impacts_states_change=<0/1>
Default:
enable_problem_impacts_states_change=0
This option is used to know if we apply or not the state change when a host or check is impacted by a root problem (like the check's host going down or a host's parent being down too). The state will be changed by UNKNONW for a check and UNREACHABLE for a host until their next schedule check. This state change does not count as an attempt, it's just for console so the user knows that these objects got problems and the previous states are not sure.
Format:
disable_old_nagios_parameters_whining=<0/1>
Default:
disable_old_nagios_parameters_whining=0
If 1, disable all notice and warning messages at configuration checking
Format:
use_timezone=<tz from tz database>
Default:
use_timezone=''
This option allows you to override the default timezone in which an instance of Shinken Enterprise runs. Useful if you have multiple instances of Shinken Enterprise which need to run from the same server, but have different local times associated with them. If not specified, Shinken Enterprise will use the system configured timezone.
Format:
enable_environment_macros=<0/1>
Default:
enable_environment_macros=0
This option determines if the Shinken Enterprise daemon will make all standard :ref:`macros <thebasics/macrolist>` available as environment variables to your check, notification, event hander, etc. commands. In large installations this can be problematic because it takes additional CPU to compute the values of all macros and make them available to the environment. It also cost a increase network communication between schedulers and pollers.
Format:
log_initial_states=<0/1>
Default:
log_initial_states=1
This variable determines if Shinken Enterprise will force all initial host and check states to be logged, even if they result in an OK state. Initial check and host states are normally only logged when there is a problem on the first check. Enabling this option is useful if you are using an application that scans the log file to determine long-term state statistics for checks and hosts.
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.