Qu-est ce que les sources ?
Les sources sont des modules permettant, à partir de ressources externes, d'en extraire toutes les informations possibles afin de créer automatiquement les hôtes en leur affectant un comportement adapté.
Ces modules sont gérés par le deamon Synchronizer. Ils sont utilisés pour détecter de nouveaux éléments ou des modifications sur les existants.
Ils nécessitent, avant de pouvoir être utilisés, d'être préalablement configurés (voir Configuration des sources). Cette étape franchie, les sources peuvent être activés pour pouvoir Importer des éléments.
Les éléments nouveaux apparaissent en jaune dans l'interface de configuration, avec le label , et les éléments modifiés sont en vert avec le label .
Il existe différents types de sources, permettant d'importer des éléments de différentes façons (fichiers, découverte réseau, annuaire LDAP... voir Les différents types de sources)
Comment ça fonctionne ?
What are Automatic detection modules
Automatic Detection Modules will analyse external sources and wil extract all possibles informations to create automaticaly hosts and affect them specific behaviours.
The Automatic detection modules are managed by the Synchronizer daemon. It uses sources to detect new hosts and host modifications. It presents the configuration web interface to the administrators. Here are the optional sources the daemon can use to get information:
- Active directory
- VSphere (VMWare)
- Nagios or Shinken framework configuration files
- Network scans
...
- Step Etape 1 to 4: The Sources defined in the automatic detection modules are scheduled by the Synchronizer daemon every few minutes. They will query and load various data from external application and generate partial hosts objects (step 1 to 4).
- Step 5: the synchronizer daemon merge all the partial hosts objects by detecting which part is refering to the same hosts. All detected hosts properties are merged, and if there is a conflict between partial objects, the property from the source with the lower order is used.
- Step 6: the merged objects are going through the IP tag tagger, that will try to request the host IP address, and will compare it to IP ranges configured on the IP Tag tagger. If the host IP is in the rule IP range, then a new host template is added to the host object.
- Step 7: the merged objects are going through the Name tagger, that will compare the host name to regexp rules configured on the Name tagger. If the host name match the regexp rule, then a new host template is added to the host object
- à 4: la découverte des sources définies est planifiée par le Synchronizer à intervalle configurable. Elles vont requêter et charger des données diverses depuis des applications externes et générer des éléments partiels.
- Etape 5: le Synchronizer consolide tous les éléments partiels en détectant quelles informations concernent le même élément final. Toutes les propriétés sont fusionnées. En cas de conflit entre des éléments partiels, la propriété de la source ayant le numéro d'ordre le plus bas est utilisée.
- Etape 6: les éléments fusionnés passent à travers un tagger IP, qui va essayer de récupérer l'adresse IP de l'hôte, et la comparer avec les plages configurées sur le tagger IP. Si l'adresse IP de l'hôte est dans une des règles, alors un nouveau template d'hôte est associé au nouvel objet hôte.
- Etape 7: les éléments fusionnés passent à travers un tagger de "nom", qui va comparer le nom de l'hôte avec les règles "regexp" configurée sur le tagger de "nom". Si le nom correspond à une règle, un nouveau template d'hôte est accroché à l'objet hôte.
- Etape 8: les éléments détectés sont sauvegardés dans la base de données du Synchronizer Step 8: the detected objects are saved in the mongodb database .
