Les écouteurs

Présentation

Les écouteurs sont des sources passives comme par exemple une API sur laquelle il est possible de faire des appels pour ajouter des éléments à superviser.

Shinken livre deux types d'écouteurs :

• listener-rest : Une API de type "REST" permettant à une application tierce d'importer des hôtes dans Shinken grâce à des requêtes HTTP.
• listener-shinken : Cet écouteur est utilisé pour importer l'architecture de Shinken à chaque modification de celle-ci et pour les collecteurs de type synchronizer-collector-linker.
  • ( Voir la page Collecteur de type ( synchronizer-collector-linker ) - Import depuis un autre Synchronizer )

Affichage des écouteurs dans la page principale

Les écouteurs sont regroupés dans la page principal sous la partie "Écouteur"

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

1. Son ordre à l'import des sources
2. Si la source est activée ou pas
3.  Son nom  : un clic sur ce champ donne accès à la Configuration d'un écouteur ( Voir la page Voir la configuration du module ( type listener-rest ) )
4. L’état de la source ( si source activée ) ( Voir la page Concept général et utilisation des sources )
   
   • OK : Tout va bien ;
   • Avertissement : L'import s'est correctement déroulé, mais certains éléments possèdent des propriétés incorrectes ou mal formées ;
   • Erreur : La source est en erreur ;
   • ...
5. Le nombre d’éléments trouvés ( si source activée )
   
   • Les nombres sont cliquables et permettent de voir les éléments en question filtrés par statut ( le statut filtré correspondra à la couleur décrite ci-dessous ) :
     • 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 ) ;
6. Le résultat de la la dernière réception de données ( c.a.d. la dernière requête reçu ) ;
7. Depuis quand la dernière réception de données a eu lieu ( si source activée ) ;

Interactions possible de l'utilisateur

• Activé : Le clic permet d'activer la source ou de la désactiver ;
• Le nom:  Le clic sur le nom ouvre l'espace spécifique de l'écouteur ;
  • L'onglet affiché sera "Liste des éléments enregistrés dans la base de données"
• les nombres ( en vert les élements normaux / en Orange, ceux avec des avertissements / en Rouge, ceux avec des erreurs ) :
  • le clic sur un des nombres ouvre aussi la page de l'écouteur sur l'onglet "Liste des éléments enregistrés dans la base de données"
  • La liste sera trié en fonction de la couleur choisi ( Vert => Ok, Orange => Attention, Rouge => Erreur )
• Le bouton permet d'ouvrir votre source sur l'onglet "Dernières requêtes reçues" ;