| Table of Contents |
|---|
Utilité des sources
Les sources permettent de récupérer des informations via des ressources externes et de transformer ces informations en éléments shinken. Elles sont personnalisable et programmable enfin de pouvoir automatiser l'import de nouveaux éléments de différentes façons. Il existe trois types de sources dans shinken, les analyseurs, les écouteurs et les collecteurs.
Les Analyseurs
Les analyseurs
Les Écouteurs
Les Collecteurs
Fonctionnement des sources
Explication de l'import
Merges des sources
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. :
| Code Block |
|---|
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:
| Code Block |
|---|
define host {
host_name Hote 1
address localhost
propriété_commune valeur1
propriété1 valeur1
propriété2 valeur2
} |
Le résultat est comparé à la base de Staging, pour faire apparaître les éléments en Nouveau et Différence. Ces éléments sont prêts à être importés dans Staging.
Mise à jour de Staging
Les éléments en Nouveau et Différence sont affichés dans les Liste des éléments. Il est possible de les filtrer pour n'afficher que ces objets.
Dans la page principale, les compteurs sont des raccourcis pour afficher ces listes déjà filtrées.
| Panel |
|---|
|
Les objets en "Nouveau" sont affichés tels qu'ils seraient importés dans Staging, dans la liste des éléments et dans la Page Eléments.
Les objets en "Différence" sont affichés tels qu'ils sont dans Staging, mais avec la liste des valeurs qui seront modifiés par application des différences.
Ces modifications apparaissent au survol du label vert de Différence dans la liste des éléments, ou dans l'onglet de différence des objets dans la page éléments.
| Panel |
|---|
|
Pour appliquer ces différences dans Staging, il suffit alors de sélectionner les éléments en Nouveau ou en Différence, puis de sélectionner l'Action de masse adéquat.
Alternativement, dans la page d'édition d'un objet, un onglet Différences liste ces différences et un bouton bleu "Différences" permet de les appliquer dans Staging.
Les éléments en Nouveau sont affichés tel qu'ils seront importés dans Staging, et le bouton "Import" permet de les importer dans Staging.
| Panel |
|---|
|
Comment faire un import
Pour obtenir des éléments d'une source configurée, fonctionnelle et activée, un import peut être nécessaire.
Il existe 2 moyens pour cela :
- Un import peut s'effectuer à intervalles réguliers. Cet intervalle est défini dans le fichier de configuration de votre source.
Vous pouvez savoir quand le prochain import aura lieu en allant dans la zone des modules de détection et qualification, en face de votre source sous la colonne "Prochain import" vous pouvez voir le temps restant avant le prochain import
| Panel |
|---|
|
- Vous pouvez forcer un import si l'import à intervalles réguliers n'est pas activé ou si vous voulez faire un import sans devoir attendre le prochain.
Pour cela aller dans la zone des modules de détection et cliquez sur la flèche en face de votre source, sous la colonne "Forcer l'import". La source doit être activée.
Un autre moyen est de vous rendre sur la page de votre source en cliquant sur son nom dans la zone des modules de détections et qualification, puis cliquez sur la flèche en haut à droite de la page.
| Panel |
|---|
|
| Panel |
|---|
|
É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é).
| Statut | Description |
|---|---|
| Les éléments ont été importés, la source fonctionne correctement |
| Les éléments ont été partiellement importés à cause d'une erreur mais la source fonctionne |
| Les éléments n'ont pas été importés, la source ne fonctionne pas |
| La source ne possède pas de configuration |
| La source vient d'être créée, elle n'a jamais importé d'éléments | |
| Des paramètres de la sources ont été changé, un import peut être utile pour recevoir de nouveaux éléments |
| Import des éléments en cours |
| 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.
Lorsqu’un import est effectué (Collecteur) ou bien qu’une exécution est lancée (Écouteurs et Analyseurs), son rapport est stocké dans le résumé des dernières exécutions vous permettant d’avoir un récapitulatif détaillé.
Cet onglet est disponible de deux manières :
- Depuis la page de la source en cliquant sur l’onglet concerné
- Depuis la page principale en cliquant sur le lien à côté du résultat
| Panel |
|---|
|
| Panel |
|---|
|
Lorsque vous arrivez sur l’onglet, vous serez directement redirigé vers la dernière exécution. Pour voir le résumé d’une autre exécution, il suffit de cliquer sur la ligne correspondant à sa date (1)
Votre résumé sera composé d’un maximum de 6 sections, les erreurs et avertissement sont présent qu'en cas de problème :
- Le résultat (2)
- Les erreurs liées à la source (3)
- Les erreurs liées au mélange des sources (3)
- Les avertissements liés à la source (3)
- Les avertissements liés aux mélanges des sources (3)
- Les éléments ajoutés/modifiés suite à l’import/exécution (4)
Utilisation des sources
Exemple d'utilisation avec la discovery
On va suivre dans cet exemple comment utiliser la source discovery pour importer des éléments grâce à une adresse ip.
Pour commencer, il faut activer la source (discovery dans notre exemple) pour qu'elle puis fonctionner et importer des éléments un fois qu'elle sera configuré.
| Panel |
|---|
|
Pour configurer la source, il faut se rendre sur la page de la discovery. Pour ça, il suffit de cliquer sur son nom.
| Panel |
|---|
|
Pour pouvoir trouver des éléments grâce à cette source, il faut ajouter des plages ip qui vont être scanner par la suite. Il faut donc se rendre dans l'onglet "Listes de plages réseaux définies".
| Panel |
|---|
|
Une fois rendu dans cette onglet, il faut ajouter notre plage ip en cliquant sur le bouton ajouter en haut à droite de la page.
| Panel |
|---|
|
Il faut maintenant rentrer les informations nécessaire enfin de trouver les éléments voulus. On va chercher dans cet exemple la machine qui se trouve sur l'adresse ip 172.16.0.7 .
| Panel |
|---|
|
On a maintenant le choix d'attendre le prochain import si il a était défini dans le fichier de configuration de la source discovery ou de lancer un import directement en appuyant sur la flèche en haut de l'écran.
| Panel |
|---|
|
Le résumé du résultat de cet import est disponible dans l'onglet "Résumé des dernières exécutions". Le dernier import effectué est directement visible en arrivant dans la page. On peut voir qu'il c'est bien effectué et qu'un hôte à bien été importé.
En cliquant sur un type dans le tableaux "Résultat d'exécution", on va être redirigé dans l'onglet "Détails du dernier lancement".
| Panel |
|---|
|
L'onglet "Détails du dernier lancement" permet d'avoir plus de détails sur les éléments importés. On a cliqué sur "hosts" lors de l'étape précédente ce qui a appliqué un filtre qui permet de nous montrer que les hôtes lors du dernier import.
On peut aussi accéder à cet onglet en cliquant sur celui-ci, aucun filtre ne sera donc appliqué.
Cliquer sur l’œil à droite de chaque éléments importés permet de donner plus de détails à leur sujet.
| Panel |
|---|
|
