...
Shinken Enterprise s’appuie sur des programmes externes appelés "plugin de check ou sonde" pour pouvoir superviser une large variété d'éléments éléments.
...
Qu'est ce qu'un plugin?
Les sondes sont des exécutables compilés ou des scripts (scripts Perl, scripts shell scripts, etc.) qu qui peuvent être lancés par une ligne de commande afin de vérifier le statut d'un hôte ou d'un check. Shinken Enterprise utilise les retours de ces sondes pour déterminer le statut des éléments éléments.
Shinken Enterprise lancera une sonde à chaque fois que ce sera nécessaire pour vérifier un statut. La sonde fait quelque chose (terme volontairement générique) pour procéder à la vérification en retournant simplement retourner le résultat vers Shinken Enterprise qui qui prendra alors les actions nécessaires en fonction de ce retour (lancement d'événement, envoi de notifications, etc).
...
Le gros intérêt de l'approche "sonde" est que l'on peut superviser à peur peu près tout type d'élément.
Si vous pouvez automatiser le process de vérification d'un élément, alors vous pouvez le faire avec Shinken Enterprise .
Il y a plusieurs milliers de sondes (ou plugin) créées pour superviser des ressources du type charge du processeur, utilisation disque, taux de ping, etc..
Si vous souhaitez superviser quelque chose d'autre, référez vous au paragraphe Plugins API et créez le votre, c'est aussi simple !
...
Comment utiliser la sonde X?
La plupart des sondes présente présentent des informations de type utilisation en les exécutant avec l'extension "-h" ou "--help" dans la ligne de commande.
¨Par Par exemple, si vous voulez savoir comment fonctionne la sonde _http plugin works ou quelles options dont sont possibles, vous devez lancer la commande suivante :
...
Les scripts et les exécutables doivent faire au moins 2 choses :
- sortir avec avec l'un une des nombreuses valeurs possibles en retour (code retour)
...
Le fonctionnement interne de la sonde importe peu à Shinken Enterprise, c'est l'interface entre eux deux qui compte.
Votre sonde peut vérifier le statut d'un port TCP port, lancer une requête sur une base de données, ou faire tout ce qui est nécessaire pour vérifier un élément.
Les détails dépendront ce qui doit être vérifié.
...
Shinken Enterprise détermine le statut d'un hôte ou d'un check en évaluant le code retour de la sonde .
La table suivante montre la liste des valeurs possibles, avec leur correspondance possible.
| Code retour | Etat du Service | Etat de l'hôte |
|---|---|---|
| 0 | OK | UP |
| 1 | WARNING | DOWN |
| 2 | CRITICAL | DOWN |
| 3 | UNKNOWN | DOWN |
ligne de texte vers "STDOUT" [Format de sortie des données de sonde]
...
Les données de performance sont optionnelles.
Si un une sonde retourne des données de performance, elles doivent être séparées du reste du texte par le symbole pipe (|) .
...
Si cette sonde est utilisée pour réaliser une verification vérification de service, la totalité de al la ligne retour sera stockée dans $SERVICEOUTPUT$ .
...
Si cette sonde est utilisée pour vérifier un service, la partie à gauche du symbole sera stockée dans <$SERVICEOUTPUT$> et la partie à droite du séparateur seront stockées sera stockée dans $SERVICEPERFDATA$
Une donnée de performance est composée au minimum de :
| Code Block |
|---|
key=value |
Par exemple:
/var=3326
Anchor perf-data-explain perf-data-explain
Vous pouvez alors avoir en option plus d'informations :
...
Shinken Enterprise va seulement lires lire les premiers 64 KB de données qu'une sonde retourne. Cela évite de surcharger une base de données.