Mode actif

Introduction

Shinken Enterprise est capable de superviser des hôtes et les checks de deux façons différentes: activement ou passivement. L'utilisation des checks actifs est la plus courante.

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

  • Les checks actifs sont initiés par le poller Shinken Enterprise 
  • Ils sont lancés à intervalle régulier

Comment sont réalisés les checks actifs ?

Les checks actifs sont initiés par la logique définie dans les démons dans Shinken Enterprise .

Lorsque Shinken Enterprise doit vérifier les statuts d'un hôte ou d'un check, il lance un plugin et présente les informations sur ce qui doit être vérifié.

Le plugin va alors vérifier l'état de l'hôte et remonter le résultat vers le démon Shinken Enterprise .

Le démon scheduler va traiter le résultat 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.

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 sont lancés par des applications ou process externes 
  • Les résultats sont envoyés au démon Shinken Enterprise pour traitement 

La principale différence avec les checks actifs réside donc dans son lancement externe. 

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)
  • Localisation derrière un firewall ne permettant pas de lancer les checks depuis l'hôte de supervision 

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 le paramètre "accept_passive_service_checks" à 1 (dans shinken.cfg).
  • Activer le paramètre "passive_checks_enable" à 1 dans la définition de votre hôte et votre check.

Si vous voulez l'activer globalement, activer le paramètre "accept_passive_check_checks" à 0.

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.