Programmes de collecte de données

L'écriture et l'installation d'un programme source de données ne sont pas difficiles. Tout langage de script et de programmation pris en charge par Linux peut être utilisé. Il est préférable de stocker le programme dans le répertoire ~/local/bin/, où il sera toujours trouvé automatiquement sans qu'il soit nécessaire de spécifier un chemin d'accès aux données.

Le premier exemple très basique suivant s’appelle myds et génère des données de supervision simples et fictives. Au lieu d’intégrer un nouveau chemin d’accès, il génère lui-même les données de supervision. Celles-ci se composent d’une section <<<df>>>, qui contient les informations relatives à un seul système de fichiers, et qui a une taille de 100 ko et le nom My_Disk. Il est codé sous la forme d’un script shell de trois lignes :

N'oubliez pas de rendre le programme exécutable :

Créez maintenant un hôte de test dans la Configuration – par exemple, myserver125. Cela ne nécessite pas d'adresse IP. Afin d'éviter que Checkmk ne tente de résoudre myserver125 via le DNS, saisissez ce nom de domaine en tant qu'« adresse IP » explicite.

Ajoutez ensuite une règle dans le jeu de règles Setup > Agents > Other integrations > Individual program call instead of agent access qui s'applique à cet ordinateur hôte, et saisissez myds en tant que programme exécutable :

Lorsque vous accédez à la configuration des services de l'ordinateur hôte dans l'interface graphique de configuration de la configuration, une seule liste de services prêts à être supervisés devrait apparaître :

Ajoutez ce service à la supervision, activez les modifications, et votre premier programme source de données sera en cours d'exécution. À titre de test, dès que vous modifiez les données générées par le programme, le prochain check du système de fichiers d'My_Disk le signalera immédiatement.

Si quelque chose ne fonctionne pas correctement, vous pouvez vérifier la configuration de l'ordinateur hôte en saisissant « cmk -D » dans la ligne de commande et en vérifiant si votre règle prend effet :

Avec une commande « cmk -d », vous pouvez déclencher la récupération des données de l'agent ainsi que l'exécution de votre programme :

Une commande « -v » répétée devrait générer un message indiquant que votre programme sera lancé :

Le programme de notre exemple fonctionne bel et bien, mais il n’est pas très utile car il produit toujours les mêmes données, quel que soit l’ordinateur hôte pour lequel il est appelé.

Un véritable programme qui, par exemple, récupère des données via HTTP depuis un emplacement donné, nécessite au moins le nom de domaine de l'ordinateur hôte à partir duquel il doit récupérer les données. En codant $HOSTNAME$ comme espace réservé dans la ligne de commande, vous pouvez permettre ce transfert :

Dans cet exemple, le programme myds reçoit le nom de domaine comme premier argument. L’exemple de programme suivant génère cela à des fins de test sous la forme d’une check local. Via $1, il récupère le premier argument et l’enregistre dans la variable $HOST_NAME afin de l’utiliser comme aperçu. Celui-ci sera ensuite inséré dans la sortie du plugin de la check local :

La reconnaissance du service trouvera alors un nouveau service de type local, dans la sortie duquel le nom de domaine sera visible :

De là, il n'y a qu'un pas vers un véritable programme source de données qui, par exemple, récupère des données via HTTP à l'aide de l'instruction curl. Les espaces réservés suivants sont autorisés dans la ligne de commande d'un programme source de données :

Si vous disposez d'une double supervision utilisant IPv4 et IPv6, les macros suivantes pourraient vous intéresser :

Quelle que soit votre fonction dans le domaine de l’informatique, vous passerez une grande partie de votre temps à gérer des erreurs et des problèmes. Les programmes source de données n’y échappent pas. Il est particulièrement irréaliste d’attendre des programmes fournissant des données via des réseaux qu’ils soient exempts d’erreurs.

Afin que Checkmk puisse signaler une erreur à votre programme de manière ordonnée, les règles suivantes s’appliquent :

Si un programme source de données échoue,

Nous pouvons modifier l’exemple ci-dessus afin qu’il simule une erreur. Avec la redirection >&2, le texte sera redirigé vers stderr, et exit 1 définit le code de sortie du programme sur 1 :

En tant que service Check_MK, cela ressemblera à ceci :

Si vous écrivez votre programme sous forme de script shell, vous pouvez coder l'option d'set -e dès le début :

Dès qu'une instruction génère une erreur (c'est-à-dire que le code de sortie n'est pas 0), le shell s'arrête immédiatement et renvoie le code de sortie 1. Vous disposez ainsi d'une gestion générique des erreurs et n'avez pas besoin de checker la réussite de chaque instruction individuellement.