View Source

Rôle

Le Reactionner délivre les notifications et lance les gestionnaires d'événements. Cela permet de centraliser les canaux d'échange avec les systèmes externes afin de simplifier les autorisations SMTP ou l'alimentation des sources RSS (seulement un pour tous les hôtes/services). Il peut y avoir plusieurs Reactionners pour du load-balancing (répartition de charge) ou un rôle de spare.

Connexions avec les autres démons

Le Reactionner écoute sur son port 7769, et récupère sa configuration que lui envoie l'Arbiter.

Sa configuration lui permet de savoir suivant l'architecture, à quel Scheduler ce Reactionner doit se connecter pour récupérer les demandes d'exécution de notification ou de réaction (event hanlder).

Shinken Entreprise V02.04.00 > Le Reactionner > image2015-9-10 11:43:5.png

Visibilité du serveur mail

Le reactionner lance les plugins de notification afin de notifier les contacts sur les alertes. Les plugins de notification sont principalement basés sur le système mail, donc le reactionner a besoin d'une configuration MTA locale. Cette configuration est à la discrétion de l'administrateur système.

Données

Le reactionner reçoit les commandes des schedulers.

Il ne connait rien aux objets, il reçoit juste des commandes à exécuter (créées par les scheduler)

Résumé des connexions du reactionner

Source	Destination	Port	Protocole	Note
Reactionner	Schedulers	7768	HTTPS

Variable Descriptions

Property	Default	Description
reactionner_name	N/A	Cette variable est utilisée pour identifier le nom raccourci du reactionner auquel les données sont attachées.
address	N/A	Cette directive est utilisée pour définir l'adresse d'où l'arbiter principal peut joindre le reactionner. Cela peut être un nom DNS ou une adresse IP.
port	7769	Cette directive est utilisée pour définir le port TCP utilisé par ce démon .
spare	0	Cette variable est utilisée pour définir si le reactionner doit être géré en tant que spare (ne chargera la configuration que si le maître tombe) La valeur par défaut est 0
realm	N/A	Cette variable définie dans quel royaume sera le reactionner. Si aucun n'est sélectionné, il sera assigné à celui par défaut.
manage_sub_realms	1	Cette variable est utilisée pour définir si le poller acceptera les tâches du scheduler venant des sous-royaumes.
modules	N/A	Cette variable est utilisée pour définir tous les modules chargés par le reactionner.
reactionner_tags	None	Cette variable est utilisée pour définir les checks que peut lancer le reactionner. Si il n'y a aucun reactionner_tags spécifié, il prendra tous les checks non qualifiés. Par défaut, il n'y a aucun reactionner_tag, donc il prend tous les checks non qualifiés..

Exemple de définition

Dans le répertoire /etc/shinken/reactionners/, voici un exemple de définition qui permet la définition du reactionner (à placer dans un fichier CFG) :

#===============================================================================
# REACTIONNER
#===============================================================================
# Description: The reactionner is responsible for:
# - Executing notification actions
# - Executing event handler actions
#===============================================================================

define reactionner {

    #======== Daemon name and address =========
    # Daemon name. Must be unique
    reactionner_name          Main-reactionner

    # IP/fqdn of this daemon (note: you MUST change it by the real ip/fqdn of this server)
    address                   node1.mydomain

    # Port (HTTP/HTTPS) exposed by this daemon
    port                      7769

    # 0 = use HTTP, 1 = use HTTPS
    use_ssl                       0


    #======== Daemon performance sizing =========
    # Number of worker process to launch. 0 = 1 per CPU
    min_workers               1

    # Number of maximum commands a worker is allowed to launch in the same time
    processes_by_worker       256

    # How many seconds to wait between the poller to get jobs from the scheduler
    polling_interval          1


    #======== Daemon connection timeout and down state limit =========
    # timeout: how many seconds to consider a node don't answer
    timeout                   3

    # data_timeout: how many second to consider a configuration transfert to be failed
    # because the network brandwith is too small.
    data_timeout              120

    # max_check_attempts: how many fail check to consider this daemon as DEAD
    max_check_attempts        3

    # Check this daemon every X seconds
    check_interval            60



    #======== Modules to enable for this daemon =========
    # Available:  None for this daemon
    modules


    #======== Realm and architecture settings =========
    # Realm to set this daemon into
    realm                    All

    # manage_sub_realms 1 = take data from the daemon realm and its sub realms
    #                   0 = take data only from the daemon realm
    manage_sub_realms        1

    # Reactionner tags are managed tags. The hosts, checks and commands can have specific tags, and
    # this reactionner will only take them if the element tag is list in the reactionner
    # Reserved tag name:  None  =  untaggued element (default value)
    #reactionner_tags       None

    # passive:  0 = reactionner will connect to the scheduler to take/returs jobs
    #           1 = scheduler will connect to this reactionner to push/take back jobs
    passive                  0

    # spare: 0 = this reactionner is always active
    #        1 = this reactionner will be activated by the arbiter is another reactionner is dead
    spare                    0



    #======== Enable or not this daemon =========
    # 1 = is enabled, o = is disabled
    enabled                  1

}