Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Suppression de paramètres inutiles.

Paramètres de données de Performance  

Performance Data Processor Command Timeout

Format:

perfdata_timeout=<seconds>

Exemple:

...

 

...

Option de gestion des données de performance 

Format:

process_performance_data=<0/1>

...

  • 1 = gère les données de performance (défaut)

 

Host/Service Performance Data Processing Command

Format:

host_perfdata_command=<configobjects/command>
service_perfdata_command=<configobjects/command>

Exemple:

...

Paramètres avancés de planification 

Hôte orphelin

 

Advanced scheduling parameters

...

/Service Check Option 

Format: 

check_for_orphaned_services=<0/1>
check_for_orphaned_hosts=<0/1>

ExampleExemple: 

check_for_orphaned_services=1
check_for_orphaned_hosts=1
This option allows you to enable or disable checks for orphaned host/check. Orphaned checks are checks which have been launched to pollers but did not get any results reported for a long time.

Since there is no results back, it is not rescheduled in the event queue. This can cause checks to stop being executed. Normally it should happen very rarely - it might happen if an external user or a process killed off the process that was being used to execute a check.

If this option is enabled and Shinken Enterprise does not find results back for a particular check, it will log an error message and reschedule the check. If you see checks that never seem to get rescheduled, enable this option and see if you notice any log messages about orphaned services.

  • 0 = Don't check for orphaned service checks
  • 1 = Check for orphaned service checks (default)

 

 

Performance tuning

...


Cette option permet d'activer ou désactiver les checks sur les hôtes/checks orphelins. Les checks orphelins sont ceux lancés par le poller mais qui n'ont jamais renvoyés de résultats depuis longtemps.  

Sachant qu'ils n'ont rien renvoyé, ils ne sont pas replanifiés dans la file d'événements.  

Si cette option est activée, et Shinken Enterprise ne trouve aucun résultats pour un check en particulier, un message d'erreur sera loggué et le check sera replanifié. Si vous voyez des checks qui ne sont jamais replanifiés, activez cette option et regardez si vous voyez des messages d'erreur loggués à propos de services orphelins.

  • 0 = ne pas vérifier les services orphelins 
  • 1 =vérifier les services orphelins (défaut)

Réglage des performances 

Hôtes en cache/Service Check Horizon 

Format:

 

cached_host_check_horizon=<seconds>
cached_service_check_horizon=<seconds>

ExampleExemple:

 

cached_host_check_horizon=0
cached_service_check_horizon=0
This option determines the maximum time (in seconds) the state of a previous host check is considered current. Cached host states (from host/check that were performed more recently than the time specified by this value) can hugely improve host check performance. If the value is too high for this option it may result in (temporarily) inaccurate host/check states. A low value may result in a performance hit for host/check. Use a value of 0 if you want to disable host/check caching.

 

Flapping parameters 

Flap Detection Option

Format:


Cette option détermine le temps maximum (en secondes) pendant lequel le dernier état d'un check est considéré comme son état courant. L'état géré en cache (venant d'hôtes/check ayant été exécutés plus récemment que le temps spécifié par cette valeur) peut grandement amélioré la performance des checks. Si cette valeur est trop élevée pour cette option, cela peut se traduire par un état (temporaire) inapproprié. Une valeur plus basse peut générer un pic de performance . Utiliser la valeur 0 si vous souhaitez désactiver la mise en cache des hôtes/checks.

 

Paramètres de Flapping  

Option de détection de Flap 

Format: 

enable_flap_detection=<0/1>

Example: 

enable_flap_detection=1
This option determines whether or not Shinken Enterprise will try and detect hosts and checks that are
Cette option détermine si Shinken Enterprise va tenter de détecter les hôtes et checks en état “flapping". Flapping occurs when a host or check changes between states too frequently, resulting in a barrage of notifications being sent out. When Shinken Enterprise detects a flapping host or check, it will temporarily suppress notifications for that host/check until it stops flapping.Cet état Flapping apparaît quand un hôte ou un check passent d'un état à un autre très fréquemment, bloquant l'envoi de notifications. Quand Shinken Enterprise détecte un hôte ou un check en flapping,  il supprimera temporairement les notifications jusqu'à la fin du flapping.

Vous trouverez plus d'information sur la détection du flapping dans le paragraphe More information on how flap detection and handling works can be found here <advanced/flapping>`.

  • 0 = Don't enable flap detection (defaultne pas activer la détection du flapping (défaut)
  • 1 = Enable flap detection

...

  • activer la détection du flapping 

 

Seuil bas Service/Host

...

Flap 

Format:

 

low_service_flap_threshold=<percent>
low_host_flap_threshold=<percent>

ExampleExemple: 

low_service_flap_threshold=25.0
low_host_flap_threshold=25.0
This option is used to set the low threshold for detection of host/check flapping. For more information on how flap detection and handling works (and how this option affects things) read this
Cette option est utilisée pour définir le seuil bas de détection du flapping.Pour plus d'information, suivre ce lien flapping.

 

...

Seuil haut Service/Host

...

Flap 

Format:

 

high_service_flap_threshold=<percent>
high_host_flap_threshold=<percent>

ExampleExemple: 

high_service_flap_threshold=50.0
high_host_flap_threshold=50.0
This option is used to set the high threshold for detection of host/check flapping. For more information on how flap detection and handling works (and how this option affects things) read this.

 

Various commands Timeouts

Format:

 


Cette option est utilisée pour définir le seuil haut de détection du flapping. Pourplus d'informations, suivre ce lien flapping.

Diverses commandes en timeout

Format:

event_handler_timeout=<seconds> # default: 30s
notification_timeout=<seconds> # default: 30s

ExampleExemple:

 

event_handler_timeout=60
notification_timeout=60
This is the maximum number of seconds to run event handlers & notification. If a command exceeds this time limit it will be killed and a warning will be logged.

There is often widespread confusion as to what this option really does. It is meant to be used as a last ditch mechanism to kill off commands which are misbehaving and not exiting in a timely manner. It should be set to something high (like 60 seconds or more for notification), so that each event handler command normally finishes executing within this time limit. If an event handler runs longer than this limit, Shinken Enterprise will kill it off thinking it is a runaway process.

 

Freshness check 

Host/Service Freshness Checking Option

Format:

 



Il s'agit du nombre maximum en secondes pour lancer le gestionnaire d'événements & notification. Si une commande dépasse cette limite de temps, elle sera supprimée et une alerte sera logguée.  

Il y a souvent une large confusion sur ce que fait réellement cette option. Elle a été conçue pour être utilisée en dernier recours comme un mécanisme de suppression d'une commande qui se comporte mal dans le temps. Elle devrait être définie à une valeur élevée (comme 60 secondes ou plus pour une notification), de façon à ce que chaque gestionnaire d’événements puisse terminer d’exécuter sa tâche dans les temps. 

Rafraîchissement des checks 

Option de rafraîchissement des Hôtes/Service 

Format:

check_service_freshness=<0/1>
check_host_freshness=<0/1>

ExampleExemple: 

check_service_freshness=0
check_host_freshness=0
This
Cette option determines if Shinken Enterprise will periodically check the “freshness" of host/check. Enabling this option is useful for helping to ensure that passive checks are received in a timely manner. More information on freshness checking can be found here.

  • 0 = Don't check host/check freshness
  • 1 = Check host/check freshness (default)

 

Host/Service Freshness Check Interval

Format:

détermine si Shinken Enterprise va vérifier régulièrement le rafraîchissement des hôtes/services. Activer cette option est très utile pour permettre de vérifier que les checks passifs se déroulent bien dans le temps.  Vous trouverez plus d'informations ici.

  • 0 = ne pas vérifier le rafraîchissement des hôtes/services
  • 1 = vérifier le rafraîchissement des hôtes/services (défaut)

 

Intervalle de rafraîchissement 

Format: 

service_freshness_check_interval=<seconds>
host_freshness_check_interval=<seconds>

ExampleExemple:

 

service_freshness_check_interval=60
host_freshness_check_interval=60
This setting determines how often (in seconds) Shinken will periodically check the “freshness" of host/check results. If you have disabled host/check freshness checking (with the check_service_freshness option), this option has no effect. More information on freshness checking can be found here.

 

Resource File

Format

 

resource_file=<file_name>

Example:

 

resource_file=/etc/shinken/resource.cfg

This is used to specify an optional resource file that can contain "$USERn$" Understanding Macros/Data and How They Work definitions. "$USERn$" macros are useful for storing usernames, passwords, and items commonly used in command definitions (like directory paths).
A classical variable used is $USER1$, used to store the plugins path, "/usr/lib/nagios/plugins" on a classic installation.

 

Notifications Option

Format:

 


Ce paramètre définit la fréquence (en secondes) à laquelle Shinken Enterprise va vérifier le rafraîchissement d'un hôte/service. Vous trouverez plus d’informations  ici.

 

 

Option de notification 

Format:

enable_notifications=<0/1>

Example: 

enable_notifications=1

This Cette option determines if détermine si Shinken Enterprise will send out va envoyer des notifications. If this option is disabled, Shinken will not send out notifications for any host or check.Si cette option est désactivée, Shinken Enterprise n'enverra aucune notification pour aucun des hôtes/services. 

Les valeurs sont les suivantes Values are as follows :

  • 0 = Disable Désactives les notifications
  • 1 = Enable notifications (default)

 

Log Rotation Method (Not fully implemented)

Format:

 

log_rotation_method=<d>

Example:

 

log_rotation_method=d

This is the rotation method used by Shinken Enterprise for your log file on the broker server . Values are as follows:

  • d = Daily (rotate the log at midnight each day)
  • Active les notifications (défaut

 

 

...

Option de commande externe 

Format:

 

check_external_commands=<0/1>

Example:

 

check_external_commands=1This

Cette option determines if Shinken Enterprise will check the External Command File for commands that should be executed with the arbiter daemon .

  • 0 = Don't check external commands
  • 1 = Check external commands (default)

 

Scheduling parameters

Service/Host Check Execution Option

Format:

détermine si Shinken Enterprise va vérifier le fichier de commande externe pour les commandes devant être exécutées depuis le démon arbiter.  

  • 0 = ne pas vérifier les commandes externes
  • 1 = vérifier les commandes externe (défaut)

 

Paramètres de planification 

Option d'exécution d'un hôte/service 

Format: 

execute_service_checks=<0/1>
execute_host_checks=<0/1>

ExampleExemple: 

execute_service_checks=1
execute_host_checks=1

This Cette option determines if détermine si Shinken Enterprise will execute host/check. Do not change this option unless you use a old school distributed architecture. And even if you do this, please change your architecture with a cool new one far more efficient.va exécuter les checks. 

  • 0 = ne pas exécuter les 0 = Don't execute checks
  • 1 = Execute exécuter les checks (defaultdéfaut)

...



Option d'acceptation de check/service passifs 

Format:

 

accept_passive_service_checks=<0/1>
accept_passive_host_checks=<0/1>

ExampleExemple:

 

accept_passive_service_checks=1

accept_passive_host_checks=1This

Cette option determines if Shinken will accept passive hostdétermine si Shinken Enterprise acceptera les hôtes/checks passifs . If this option is disabled, Nagios will not accept any passive host/checksSi cette option est désactivée, Shinken Enterprise n'acceptera aucun check passif.  .

  • 0 = Don't accept passive host/checksN'accepte pas les checks passifs 
  • 1 = Accept passive host/checks (default)Accepte les checks passifs  

 

...

Option du gestionnaire d'événements 

Format:

 

enable_event_handlers=<0/1>

ExampleExemple:

 

enable_event_handlers=1

This Cette option determines if Shinken Enterprise will run event handlersdétermine si Shinken Enterprise va lancer le gestionnaire d'événements.

  • 0 = Disable event handlersDésactive le gestionnaire d'événement
  • 1 = Enable event handlers (defaultActive le gestionnaire d'événement (défaut)

 

...

Option de log des notifications

Format:

 

log_notifications=<0/1>

ExampleExemple: 

log_notifications=1

This variable determines if notification messages are logged. If you have a lot of contacts or regular check failures your log file will grow (let say some Mo by day for a huge configuration, so it's quite OK for nearly every one to log them). Use this option to keep contact notifications from being logged.

  • 0 = Don't log notifications
  • 1 = Log notifications

 

Event Handler Logging Option

Format:

Cette variable détermine si un message de notification est loggué. Utilisez cette option pour garder une trace des notifications de vos contacts. 

  • 0 = ne pas logguer de notifications
  • 1 = logguer des notifications

 

Option de log du gestionnaire d'événements 

Format: 

log_event_handlers=<0/1>

ExampleExemple: 

log_event_handlers=1

This variable determines if check and host event handlers are logged. Event handlers are optional commands that can be run whenever a check or hosts changes state. Logging event handlers is most useful when debugging Shinken Enterprise or first trying out your event handler scripts.

  • 0 = Don't log event handlers
  • 1 = Log event handlers

 

External Command Logging Option

Format:

 

Cette variable détermine si vous allez logguer les événements. Le gestionnaire d'événements est une commande optionnelle qui peut être lancée dès que l'état d'un hôte ou d'un service change. Il peut être très utile de les logguer lorsque vous êtes en mode debug, ou lorsque vous essayez pour la 1ère fois les scripts du gestionnaire d'événements. 

  • 0 = ne log pas d'événements 
  • 1 = Log des événements 

 

Option de log de commandes externes 

Format:

log_external_commands=<0/1>

ExampleExemple:

 

log_external_commands=1This

Cette variable determines if Shinken Enterprise will log external commands that it receivesdétermine si Shinken Enterprise va logguer les commandes externes reçues .

  • 0 = Don't log external commandsne loggue pas les commandes externes 
  • 1 = Log external commands (defaultloggue les commandes externes (défaut)

 

...

Option de log des checks passifs (pas encore implémenté)

Format: 

log_passive_checks=<0/1>

ExampleExemple:

 

log_passive_checks=1This

Cette variable determines if détermine si Shinken Enterprise will log passive host/checks that it receives from the external commandsva logguer les checks passifs reçus des commandes externes.

  • 0 = Don't log passive checks
  • 1 = Log passive checks (default)

...

Temps d'intervalle 

Format:

 

interval_length=<seconds>

ExampleExemple: 

interval_length=60

This is the number of seconds per “unit interval" used for timing in the scheduling queueIl s'agit du nombre de secondes par "unité d'intervalle" utilisé pour calculer le temps dans la liste de replanification, re-notifications, etc. " Units intervals" are used in the object configuration file to determine how often to run a service check, how often to re-notify a les unités d'intervalle" sont utilisées dans le fichier de configuration de l'objet pour déterminer à quelle fréquence lancer un service, renotifier un contact, etc.

The default value for this is set to 60, which means that a "unit value" of 1 in the object configuration file will mean 60 seconds (1 minute).

Note that set this option top 1 is not a good thing with Shinken Enterprise. It's not design to be a hard real time (<5seconds) monitoring system.

 

 

Others

Illegal Object Name Characters

Format:

 

..

La valeur par défaut est à 60 secondes, ce qui signifie qu'une "unité d'intervalle" définie à 1 correspond à 60 secondes. 

 

Autres

Caractères illégaux dans le nom d'objet 

Format:

illegal_object_name_chars=<chars...>

ExampleExemple: 

illegal_object_name_chars=`-!$%^&*"|'<>?,()=
This option allows you to specify illegal characters that cannot be used in host names, service descriptions, or names of other object types. Shinken Enterprise will allow you to use most characters in object definitions, but we recommend not using the characters shown in the example above. Doing may give you problems in the web interface, notification commands, etc.
Cette option autorise l'utilisation de caractères spéciaux qui ne sont pas autorisés dans le nom des hôtes, services.... Shinken Enterprise peut autoriser tout type de caractères, mais nous recommandons de ne pas utiliser ceux spécifiés plus haut dans l'exemple.