...
Rôle
Le démon arbiter Arbiter lit la configuration du synchronizer. Il la divise en N parts (N schedulers = N parts), et les distribue au démon Shinken Enterprise approprié. Il gère également la notion de haute disponibilité : si un démon en particulier meurt, il renvoie la configuration gérée par le démon mort à son spare défini qui reçoit les informations des utilisateurs ou . Il route également les résultats de checks passifs et les routent vers le démon approprié. Les résultats de checks passifs sont renvoyés au Scheduler responsable du check.
| Info | ||
|---|---|---|
| ||
| Il ne peut y avoir qu'un seul Arbiter master et un seul |
...
| Arbiter spare maximum par infrastructure. |
Connexion avec le
...
Synchronizer
La communication entre l'arbiter Arbiter et le synchronizer Synchronizer est faite sur le port standard du synchronizer Synchronizer (7765).
Connexion avec les autres démons
Ce démon est utilisé pour vérifier et distribuer la configuration aux autres démons, sauf au Synchronizer. Il se connecte sur le port standard des autres démons, et utilise une connexion HTTP ou HTTPS si ceux-ci l'ont prévuprévue.
| Info | ||
|---|---|---|
| ||
L'Arbiter est capable de rendre inactif les démons distants désactivés (lorsque la propriété "enabled" est mise 0 dans leurs fichiers cfg) Exemple: Depuis le serveur central, je décide de désactiver un Poller distant en passant la propriété "enabled" à 0 dans son fichier de définition. Je redémarre l'Arbiter. Le Poller distant sera affiché comme "désactivé" depuis son shinken-healthcheck local. Il n'est donc pas nécessaire d'éteindre un démon qui n'est plus utilisé sur un machine distante. |
Données
Ce démon stocke la totalité du système de configuration en mémoire. Il a accès à tous les noms de serveurs, adresses, types et commande définis pour les vérifier.
...
| Propriété | Défaut | Description | |
|---|---|---|---|
| arbiter_name | N/A | Cette variable est utilisée pour identifier le *nom réduit* de l'arbiter auquel les données sont associées. | |
| host_name | N/A | Cette variable est utilisée par les démons arbiters Arbiters pour définir quel objet 'arbiterArbiter' ils sont : (de type Maitre ou Spare). En effet, tous ces démons sur différents serveurs utilisent la même configuration, donc la seule différence entre eux est le nom du serveur. Cette valeur doit être égale au nom du serveur (comme avec la commande du hostname ). Si aucun rien n'est défini pour cette propréité, le démon arbiter Arbiter va utiliser le nom du serveur où il est lancé, mais cela ne sera possible qu'avec un seul arbiter Arbiter dans l'architecture Shinken. | |
| address | N/A | Cette directive permet de définir l'adresse d'où l'arbiter principal peut contacter cet arbiter (qui peut être lui même). Ça peut être un nom DNS ou une adresse IP. | |
| port | 7770 | Cette directive est utilisée pour définir le port TCP utilisé par ce démon. | |
| use_ssl | 0 | Cette variable permet d'indiquer est utilisée pour définir si l'arbiter utilise un protocole chiffré (HTTPS) ou non (HTTP). Par défaut à 0 Arbiter doit être contacté en HTTPS (*1*) ou HTTP (*0*). La valeur par défaut est *0* (HTTP). | |
| timeout | 3 | Cette variable définit est utilisée pour définir le temps ( en secondes ) avant que l'arbiter de spare devra attendre si l'arbiter principal ne répond pas, avant de le considérer Arbiter ne considére ce démon comme à l'arrêt. | |
| spare | 0 | Cette variable permet de savoir si le démon correspondant à la définition de l'arbiter est un spare ou pas. La valeur par défaut est *0* (maître/non-spare). | |
| modules | N/A | Cette variable définit tous les modules chargés par l'arbiter qui correspond à cette définitionSi ce démon est joignable en HTTPS (use_ssl à 1) avec une latence élevée, nous vous conseillons alors d'augmenter cette valeur de timout (l'Arbiter aura besoin de plus d'allers/retours pour le contacter). | |
| data_timeout | 120 | Utilisé lors d'envoi de données à un autre process (en secondes)Cette variable est utilisée pour définir le temps en secondes avant de considérer un transfert de configuration ou de données comme échoué. | |
| max_check_attempts | 3 | Si le ping permettant de détecter la disponibilité réseau du nœud est en échec N fois ou plus, alors le nœud est considéré comme mort. (par défaut, 3 tentatives) | |
| check_interval | 60 | Intervalle de Ping toutes les N secondes.accept_passive_unknown_check_results | |
| spare | 0 | Cette variable permet de savoir si le démon correspondant à la définition de l'arbiter est un spare ou pas. La valeur par défaut est *0* (maître/non-spare). | |
| modules | N/A | Cette variable définit tous les modules chargés par l'arbiter qui correspond à cette définition. | |
| enabled | N/A | Cette variable est utilisée pour définir si l'arbiter est activé ou non | Si c'est activé, l'arbiter acceptera les retours de checks passifs pour les hôtes non configurés et générera un retour hôte/service inconnu. |
Exemple de définition
Dans le répertoire /etc/shinken/arbiters/, voici un exemple de définition qui permet la définition de l'Arbiter (à placer dans un fichier CFG) :
| Code Block |
|---|
#=============================================================================== # ARBITER #=============================================================================== # Description: The Arbiter is responsible for: # - Loading, manipulating and dispatching the configuration # - Validating the health of all other Shinken daemons #=============================================================================== # IMPORTANT: If you use a spare arbiter you MUST set the host_name on each # servers to its real DNS name ('hostname' command). #=============================================================================== define arbiter { #======== Daemon name and address ========= # Daemon name. Must be unique arbiter_name Main-arbiter # hostname used by the arbiter daemon to know which arbiter address node1.mydomain host_name node1 port 7770 spare 0 modules module1,module2 } definition it must use as # the same configuration with two arbiter definition is set on both master and slave # arbiter host_name node1 # IP/fqdn of this daemon address node1.mydomain ; DNS name or IP # Port (HTTP/HTTPS) exposed by this daemon port 7770 # 0 = use HTTP, 1 = use HTTPS use_ssl 0 #======== Daemon connection timeout and down state limit ========= # The arbiter connection timeout and down state limit are useful for another arbiter to # know when to consider this arbiter as DEAD so the spare can take the lead. # timeout: how many second 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 #======== Master or spare selection ========= # 1 = is a spare, 0 = is not a spare spare 0 #======== Modules to enable for this daemon ========= # Available: # - synchronizer-import : [mandatory] will allow to get configuration from the synchronizer modules synchronizer-import #======== Enable or not this daemon ========= # 1 = is enabled, o = is disabled enabled 1 } |