Le Synchronizer

Rôle

Le Synchronizer met à disposition une interface web pour gérer les éléments ( hôtes, checks, ... ) en supervision et la politique de supervision.

Il permet aussi d'automatiser collecte information pour mettre en supervision plus rapidement des équipements, ou détecter des modifications sur les existants.

Les modules sources qui permettent de "collecter" ces informations sont réparties en 3 types:

Les Collecteurs
- Interroge une source et collecte les informations des éléments
Les Ecouteurs
- Reçoivent des messages venant de l’extérieur pour ajouter de nouveau élément ou modifier des éléments existants.
Les Analyseurs
- Interroge directement élément par élément pour récupérer des informations.

Les collecteurs

Active Directory / OpenLDAP

La découverte de l'Active Directory ou OpenLDAP se fait avec un compte domaine et ne nécessite qu'un accès en lecture. La connexion peut être faite dans LDAPS pour être sûr que la connexion est sécurisée.

Il est possible de définir un niveau haut d'organisation (OU = Organizational Unit) afin de lister les éléments seulement sous ce niveau.

Les informations que ce module récupère sont les noms de serveurs, FDQN, l'OS du serveur, et si il est défini, son entrée LDAP et son emplacement. La configuration pour la source Active Directory est située ici et OpenLDAP ici.

VSphere de VMWare

La découverte VSphere est faite pour trouver les serveurs physiques (ESX) et leurs serveurs virtuels. Elle va également récupérer leur OS et leur adresse IP, mais seulement si les outils VMware sont activés et tournent sur le serveur virtuel.

La connexion du Synchronizer vers VMware connexion se fait toujours via le serveur VSphere, et ne nécessite qu'un accès en lecture. Le serveur Shinken Enterprise ne nécessite pas un accès direct aux serveurs ESX.

La communication de Shinken Enterprise vers VSphere se fait via une API SOAP de VMWare, à travers une connexion HTTPS. La configuration pour cette source est située dans une autre page.

Fichiers de configuration Nagios ou Shinken Framework

Shinken Enterprise est capable de charger des fichiers de configuration Nagios ou Shinken Framework. Il va automatiquement charger les objets définis. La configuration pour cette source est située dans une autre page.

Scan réseau

La découverte via scan réseau est optionnelle. Elle se fait via une commande nmap, lancée par le Synchronizer.

Les scans sont faits sur les ports TCP et UDP. Il va également essayer de récupérer des données complémentaires depuis les serveurs ou les services qui tournent dessus (il utilise l'option -O dans la commande nmap). La configuration pour cette source est située dans une autre page.

Les écouteurs

Un écouteur est une source qui reçoit des informations à partir d'une application tierce. Cette source est donc à l'écoute de nouveaux éléments grâce à des appels réseaux (par exemple une API Rest)

Les Analyseurs

Les Analyseurs permettent de remonter des informations depuis les hôtes après avoir exécuté des scripts d'analyses.

Les Analyses peuvent être lancés depuis des hôtes déjà présent dans Shinken, afin d'enrichir les données présentes ou bien depuis une plage réseau.

Stockage de données dans la configuration

Toutes les données découvertes par le Synchronizer sont stockées dans une base Mongodb. Si possible, il est préférable que la base soit sur le même serveur que le Synchronizer ; elle n'est pas partagée avec d'autres démons, donc ses communications doivent être limitées au serveur local.

Configuration

Configuration de l'interface et de ses accès

L'interface de configuration est stockée par le Synchronizer, et utilise un autre port TCP pour l'UI de visualisation. Vous pouvez utiliser 2 systèmes d’accréditation:

gestion directe dans l'interface de configuration
gestion des droits avec les comptes Active directory ou OpenLDAP. Le démon va alors utiliser les connexions LDAP pour vérifier les autorisations. La procédure est ici.

Les utilisateurs non-admin auront une visibilité restreinte sur les hôtes auxquels ils sont attachés directement, ou au groupe auquel ils sont rattachés.

Cette interface utilise la même base Mongodb que le Synchronizer. Le port par défaut est le 7766.

Interface	Démon	Port
Configuration	Synchronizer	7766

Plus d'information sur le paramétrage de l'interface de configuration ici.

Résumé des connexions du Synchonizer

Source	Destination	Port	Protocole	Note
Arbiter	Synchronizer	7765	HTTP/HTTPS
Synchronizer	Synchronizer	27017	TCP/IP	Accès à la base Mongo

Connexions possibles liées aux différentes sources :

Source	Connexion à	Port	Protocole	Note
Synchronizer	Active Directory ou OpenLDAP	389	LDAP
Synchronizer	Active Directory ou OpenLDAP	636	LDAPS	Accès en lecture seule
Synchronizer	VSphere	443	HTTPS	Accès en lecture seule
Synchronizer	Scan Réseau	x	TCP/IP

Descriptions des variables

Property	Default	Description
synchronizer_name	N/A	Cette variable est utilisée pour identifier le nom court du Synchronizer auquel les données sont attachées.
address	N/A	Cette directive est utilisée pour définir l'adresse permettant à ce que l'Arbiter joigne ce Synchronizer. Par défaut "localhost", changez le par un nom DNS ou une adresse IP.
port	7765	Cette directive est utilisée pour définir le port TCP utilisé par le démon.
spare	0	Cette variable est utilisée pour définir si le Synchronizer doit être géré en tant que spare (chargera la configuration seulement si le master est en erreur). La valeur par défaut est 0 (master).
modules	N/A	Cette variable est utilisée pour définir tous les modules que le synchronizer va charger.
use_ssl	0	Cette variable est utilisée pour définir si le Synchronizer doit être contacté en HTTPS (1) ou HTTP (0). La valeur par défaut est 0 (HTTP).
sources	N/A	Liste des sources que le synchronizer va charger.
taggers	N/A	Liste des taggers que le synchronizer va charger.
enabled	N/A	Cette variable est utilisée pour définir si le Synchronizer est activé ou non.

Exemple de définition d'un synchronizer

#===============================================================================
# SYNCHRONIZER
#===============================================================================
# Description: The Synchronizer is responsible for:
# - Hosting the Configuration UI
#===============================================================================
define synchronizer {

    synchronizer_name    synchronizer-master
    #host_name       node1       ; CHANGE THIS if you have several Arbiters
    address         node1.mydomain   ; DNS name or IP
    port            7765
    spare           0           ; 1 = is a spare, 0 = is not a spare

    modules      Cfg_password

    use_ssl          0

    ## Uncomment these lines in a HA architecture so the master and slaves know
    ## how long they may wait for each other.
    #timeout              3   ; Ping timeout
    #data_timeout         120 ; Data send timeout
    #max_check_attempts   3   ; If ping fails N or more, then the node is dead
    #check_interval       60  ; Ping node every N seconds

    sources               syncui,cfg-file-shinken,active-dir-example,sync-vmware,cfg-file-nagios,discovery,openldap-example
    taggers               ip-tags,regexp-tags


    enabled    1 ;   If you set enabled 0, Don't forget to disable daemon on distant host
}

Page tree