Mode actif

Introduction

Shinken Enterprise est capable de superviser des hôtes et les checks de deux façons différentes:

  • activement
  • passivement

L'utilisation des checks actifs est la plus courante.

Comment sont réalisés les checks actifs ?

Les caractéristiques principales du mode actif sont les suivantes : 

  • Les checks actifs sont initiés par le Poller. 
  • Ils sont lancés à intervalle régulier

Lorsque Shinken Enterprise doit vérifier les statuts d'un hôte ou d'un check,

  • il lance une sonde
  • Le sonde va alors vérifier l'état de l'hôte et
    • il collecte les données dont il a besoin sur l'équipement,
    • Il les traite pour calculer le statut, le résultat, le résultat long, et les métriques.
  • Le Poller récupère ces 4 informations et les transmets au Scheduler.
  • Le démon Scheduler va analyser ces 4 informations et lancer les actions appropriées si nécessaire ( e.g. envoi de notifications, etc ).

Quand sont lancés les checks actifs ?

Ils sont exécutés:

  • À intervalles réguliers: Tel que défini dans le paramétrage du check ("check_interval" et "retry_interval").
    • Si un hôte est dans l'état "HARD", il sera vérifié activement selon la définition dans le "check_interval".
    • S'il est dans un état "SOFT", il sera vérifié selon la définition dans "retry_interval".
  • À la demande:
    • Le lancement à la demande peut s'effectuer sans aucune contrainte, lorsqu'on a besoin de connaître le tout dernier état d'un hôte.
    • ( via l'interface de Visualisation )

Mode passif

Introduction

Shinken Enterprise permet également de superviser les hôtes et les checks de façon passive. Les caractéristiques principales du mode passif sont les suivantes:

  • Les checks passifs attendent de recevoir de l’extérieur le statut, le résultat, le resultat long et les métriques de l’extérieur.
    • La sonde n'est donc pas lancée un Poller Shinken,
    • mais ces informations sont fourni par n'importe quel autre application / script du moment qu'elle peut communiquer vers Shinken et les fournir au format d'une sortie de sonde ( voir Les Sondes => Créer sa sonde(API) )
    • C'est le Receiver qui doit être ciblé pour envoyé ces informations
  • Une fois reçu, les informations sont traités comme si c’était Shinken qui les avaient exécuter.

La principale différence avec les checks actifs réside donc dans son lancement externe et dans le fait que les informations peuvent arriver n'importe quand ( pas forcément ordonnancées de manière régulière ).

Usages des checks passifs

Les checks passifs sont utiles dans les cas :

  • Checks asynchrones par nature, ils ne peuvent être supervisés efficacement en vérifiant leur statut à intervalles réguliers et planifiés ( comme un batch ou une sauvegarde ).
  • Des équipements derrière un firewall ne permettant pas au Poller de lancer des sondes pour les interroger.


Exemples de checks asynchrones nécessitant d'être supervisés en mode passif :

  • Traps "SNMP" et alertes de sécurité. Vous ne savez jamais combien ( si il y en a ) de traps ou d'alertes seront remontées dans un intervalle donné.
    Il est donc impossible de simplement superviser leur état toutes les X minutes.
  • Les checks agrégés tournant avec un agent.
    Il peut être nécessaire de lancer ce checks à des intervalles beaucoup plus courts.
  • Check proposant les résultats intervenant directement dans une application sans utilisation de fichier log intermédiaires ( syslog, event log, etc. ).

Comment fonctionne le mode passif

Voici le fonctionnement en détail.

  • Une application externe vérifie le statut d'un hôte ou d'un check.
  • Cette application externe écrit le résultat de ce traitement dans le webservice du receiver. Sa configuration et son API sont définies dans Module receiver-module-webservice
  • Shinken Enterprise lit le check passif et l'envoi au démon approprié .
  • Shinken Enterprise reçoit les résultats toutes les secondes et scanne la file d'attente . Chaque résultat trouvé dans la file est traité de la même façon - que le check soit actif ou passif. Shinken Enterprise peut envoyer des notifications, log alerts, etc. en fonction du contenu du résultat.

Le traitement du résultat d'un check actif ou passif est le même. Cela permet d'intégrer facilement les informations de statuts provenant d'applications tierces.

Activer le mode passif

Pour activer le mode passif dans Shinken Enterprise, vous devez réaliser les actions suivantes:

  • Activer la propriété  "Passif activé " sur votre hôte et votre check ( "passive_checks_enable" a 1 au format cfg ) .


Pour désactiver ce mode sur un ou plusieurs hôtes et checks, utilisez le paramètre "passive_checks_enabled" dans la définition de l'hôte et du check.

Soumettre les résultats de checks passifs

Pour permettre la soumission de check passif dans votre achitecture Shinken, vous devez activer un module du receiver: le webservices-reciever 

La documentation ( Module receiver-module-webservice ) du module vous décrit comment envoyer des checks externes aux Receivers.