Fonctionnement des sources

Explication de l'import

Lorsqu'un import est effectué par une source, les données chargées par celle-ci vont générées des éléments dans Shinken (hôtes, check, cluster, etc...). Quand un élément est créé par une source, le synchronizer va chercher parmi tout les éléments de la dernière importation de chaque source active pour vérifier si deux éléments on une clé de synchronisation commune. Si c'est le cas, il va fusionner tout les éléments qui on la même clé de synchronisations pour former un seul élément. Si plusieurs éléments avec la même clé ont des champs commun, l'élément final prendra la valeur de l'élément venant de la source avec l'ordre le plus proche de 1. Lors de la fusion de plusieurs éléments, si un champ est présent sur un seul élément mais pas sur les autre, il apparaîtra sur l'élément final quelque soit l'ordre de la source dont il provient. 

Lorsque des sources importent des éléments, ceux-ci sont fusionnés s'ils possèdent au moins une clé de synchronisation commune.

Les clés de synchronisation utilisées dépendent du type de l'élément:

• Hôtes: Nom, adresse, SE_UUID (Identifiant unique pouvant être défini dans les fichiers de configuration)
• Checks: SE_UUID
• Autres: Nom de l'élément, SE_UUID

Exemple: 2 hôtes avec la même adresse seront regroupés par le mécanisme d'import des sources en un seul hôte. :

define host {
    host_name          Hote 1
    address            localhost
    propriété_commune  valeur1
    propriété1         valeur1
}


define host {
    host_name          Hote 2
    address            localhost
    propriété_commune  valeur2
    propriété2         valeur2
}

Résultat de la fusion des 2 hôtes, le premier hôte viens de la source avec l'ordre le plus bas:

define host {
    host_name          Hote 1
    address            localhost
    propriété_commune  valeur1
    propriété1         valeur1
    propriété2         valeur2
} 

Comment faire un import

État de la source et résumé du dernier import 

États des sources

Chaque source activée possède un état qui peut être vu à trois endroits :

• Dans la page principale dans la colonne "État" de chaque source
• Dans l'onglet des résumés des dernières exécutions d'une source
• Dans la page de la source à coté du nom

Cet état correspond à celui du dernier import. Il est mis à jour pendant l'import (import en cours, calcul des différences), après l'import (ok, avertissement, erreur, non configuré) ou dynamiquement (non configuré, prêt à être importé). 

• Ok: Des éléments ont été importés, la source fonctionne correctement
• Avertissement: Les éléments ont été partiellement importés à cause d'une erreur mais la source fonctionne
• Erreur: Les éléments n'ont pas été importés, la source ne fonctionne pas 
• Non configurée: La source ne possède pas de configuration
• N'a jamais été importé: La source vient d'être créée, elle n'a jamais importé d'éléments
• Prêt à être importé: Des paramètres de la sources ont été changé, un import peut être utile pour recevoir de nouveaux éléments
• Import en cours: Import des éléments en cours
• Calcul des différences: Calculs en cours pour la fusion des sources juste après l'import  

Des informations supplémentaires concernant l'état du dernier import sont données sous la colonne résumé en face de chaque source sur la page principale ou dans le résumé des dernières exécutions.     

Résumé du dernier import

A chaque fois qu'un import est effectué, un message contenant le résultat de cet import est disponible. Il permet d'obtenir plus d'information sur le statut de la source.
Un résumé court est disponible :

• Dans la page principale dans la colonne "Résumé" de chaque source
• Dans la page de la source à coté du nom
• Dans le Résumé des dernières exécutions

Un résumé plus long et détaillé est disponible dans l'onglet des Résumé des dernières exécutions.

Utilisation des sources

Exemple d'utilisation avec la discovery