Page History

Présentation

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

Définition

Ce type de source permettra d'ajouter de nouveau élément dans la configuration de Shinken grâce à des appels réseaux.

Nous pouvons configurer l'authentification pour l'API
Par défaut il n'y aura pas d'authentification.
Les admins de Shinken pourrons activer l'authentification simple & ssl
La configuration de cette source se fera via l'interface, comme la source discovery.
Les mots de passe devront être chiffrés.

Pour utiliser un écouteur, il faut tout d'abord créer la source, puis la configurer

réseau.

La description des différents appels réseau à utiliser se trouve dans cette page.

Cette source est configurable dans la Configuration d'un écouteur.

Il il y a 2 écouteurs disponibles par défaut :

• listener-rest : Une API rest de type "REST" permettant à une application tierce d'importer des hôtes dans Shinken grâce à des requêtes HTTP.
• listener-shinken : Cet écouteur permet d'importer l'architecture de shinken.de Shinken à chaque modification de celle ci.

Il peut être intéressant de rajouter des écouteurs pour différencier l'origine des informations reçus. Chaque source utilisera le même format d'API REST, mais chaque écouteur aura sa propre base de stockage.

Affichage des écouteurs

Pour chaque écouteur, il est présenté :

• Son ordre à l'import des sources

• Son nom : un clic sur ce champs donne accès à la Configuration d'un écouteur

La table Sources affiche, pour chacune des sources connues: 

• Le nom.

• Si la source est activée ou pas.

• L'état de la source (si elle est activée).

  • Vert :
tout
• • Tout va bien.
  • Orange :
l
• • L'import ne s'est pas déroulé correctement, il faudra une vérification des éléments importés.
  • Rouge: La source est en erreur.
• Gris: La source requiert une importation manuelle (pas d'intervalle automatique pour l'import par exemple).
• Violet: La source demande une configuration de l'utilisateur (par exemple les identifiants pour se connecter à l'annuaire LDAP dans le cas de la source OpenLDAP).
• Le nombre d’éléments trouvés (si la source est activée):
  • Les nombres sont cliquables et permettent de voir les éléments en question filtrés par statut :
    • en vert, le nombre d'éléments importés correctement
    • en orange, le nombre d'éléments qui requiert votre attention (si au moins un élément est dans cet état)
    • en rouge, le nombre d'éléments non importés à cause d'une erreur (si au moins un élément est dans cet état)
• Le résultat de la dernière écoute.
• Depuis quand la dernière réception de données a
• Délai du prochain import ( si un import récurent est prévu ).
• Le nombre d’éléments trouvées lors du dernier import.
• Le résultat du dernier import.
• Depuis quand le précédent import à eu lieu.

Les boutons:

• Activé : Permet d'activer la source ou de la désactivé
• Forcer l'import Image Removed:  Déclenche l'exécution de l'import de la source
• Nettoyer l'import Image Removed :  Enlève les éléments découverts lors du précédent importsdésactiver.