L'inventaire matériel et logiciel

Comme toujours, si vous souhaitez configurer quelque chose pour des hôtes spécifiques, cela est également possible à l’aide d’une règle. Cet ensemble de règles se trouve sous « Setup > Hosts > HW/SW Inventory rules > Do HW/SW Inventory ». Bien sûr, il est encore plus simple d’utiliser la recherche de règles avec le mot-clé « inventory ». Ne confondez pas cet ensemble de règles avec celui intitulé « HW/SW Inventory (Linux, Windows, Solaris, AIX) », qui concerne le plug-in de l’agent, comme nous le verrons plus tard.

Dans l'ensemble de règles « Do HW/SW Inventory », certaines règles faisant référence aux étiquettes d'hôte sont déjà actives par défaut. Si les hôtes que vous souhaitez ont une telle étiquette, le service d'inventaire matériel/logiciel est déjà configuré. Si ce n'est pas le cas, vous devez créer une nouvelle règle.

Utilisez Add rule pour créer une nouvelle règle pour les hôtes pour lesquels vous souhaitez activer l'inventaire. Vous y trouverez plusieurs paramètres :

Pour l'instant, laissez simplement tout tel quel. Les différentes options que vous verrez ici sont décrites ci-dessous.

Lors de la prochaine activation des modifications, la règle que vous venez de créer générera, pour chaque hôte, une vérification active qui collectera toutes les données d'inventaire de cet hôte, qu'il s'agisse des données reçues d'un agent Checkmk normal ou de requêtes SNMP supplémentaires. Le nouveau service Check_MK HW/SW Inventory est disponible sur les hôtes dans la liste des services et se présente comme suit :

Ne vous inquiétez pas si le contrôle n'a trouvé que quelques éléments — cela s'explique par le fait que nous n'avons pas encore déployé le plug-in.

Les données d'inventaire changent rarement, et la détection d'un changement n'est généralement pas urgente de toute façon. C'est pourquoi il est judicieux d'utiliser un intervalle ajusté pendant lequel la vérification de l'inventaire est effectuée, plutôt que de simplement utiliser l'intervalle habituel d'une minute — principalement parce que le traitement des données d'inventaire dans la vérification active nécessite un temps de calcul nettement plus important que celui requis pour un service normal.

Les sites Checkmk disposent par défaut d’une règle dans le jeu de règles « Setup > Service monitoring rules > Service Checks > Normal check interval for service checks » qui définit l’intervalle à un jour pour tous les services portant le nom « Check_MK HW/SW Inventory » :

Bien sûr, si vous estimez qu’une fois par jour est insuffisant, vous pouvez également personnaliser cette règle — par exemple, pour quatre ou huit heures. Il est bien sûr toujours possible de définir des paramètres différents en utilisant plusieurs règles pour différents hôtes.

Pour une installation manuelle, vous devez d’abord disposer du plug-in. Vous le trouverez dans les éditions commerciales via la page Setup > Agents > Windows, Linux, Solaris, AIX > Related, et dans Checkmk Community directement sous Setup > Agents. Dans toutes les éditions, vous y trouverez des entrées de menu pour les différents systèmes d’exploitation.

En fonction du système d'exploitation, utilisez le plug-in suivant dans la boîte de dialogue « Plug-ins » :

Vous pouvez également trouver ces fichiers sur la ligne de commande du site Checkmk, dans le sous-répertoire ~/share/check_mk/agents/plugins(Linux/Unix) ou dans ~/share/check_mk/agents/windows/plugins (Windows).

Copiez le plug-in sur les hôtes cibles dans le répertoire approprié pour les plug-ins. Pour l'agent Windows, il s'agit de C:\ProgramData\checkmk\agent\plugins. Pour plus de détails, consultez l'article sur l'agent Windows. Pour Linux et Unix, le répertoire est /usr/lib/check_mk_agent/plugins. Veuillez vous assurer que le fichier est exécutable (chmod +x). Pour plus de détails, consultez les articles sur l'agent Linux.

L'important est que l'agent soit appelé par Checkmk, généralement une fois par minute. Le plug-in de l'agent d'inventaire nécessite toutefois plus de temps de traitement que les plug-ins normaux car, par exemple, il doit rechercher les logiciels installés dans de nombreux répertoires. Il génère également des volumes de données nettement plus importants. C'est pourquoi il a été conçu pour ne générer et ne fournir de nouvelles données que toutes les quatre heures (14 400 secondes).

Ainsi, si pour une raison importante, vous avez spécifié un intervalle inférieur à quatre heures pour votre vérification d'inventaire, vous n'obtiendrez en réalité de nouvelles données que toutes les quatre heures. Si vous souhaitez vraiment collecter davantage de données, vous devrez dans ce cas modifier l'intervalle de calcul par défaut.

Sous Windows, remplacez le nombre directement dans le fichier du plug-in. Recherchez le nombre « 14400 » et remplacez-le par un autre nombre de secondes. L'emplacement où se trouve ce nombre ressemble à ceci (détail) :

Sous Linux et Unix, cela fonctionne un peu différemment. À cette fin, créez un fichier de configuration /etc/check_mk/mk_inventory.cfg contenant la ligne suivante (ici, dans l'exemple, avec 7200 secondes) :

Une remarque supplémentaire : Le plug-in de l'agent d'inventaire est configuré pour ne s'exécuter que toutes les quatre heures. Par conséquent, n'utilisez pas le mécanisme de l'agent pour exécuter des plug-ins de manière asynchrone à des intervalles plus longs. Installez le plug-in de la manière simple et habituelle pour une exécution directe.

Bien sûr, si vous utilisez Agent Bakery dans les éditions commerciales pour configurer vos agents, les choses sont beaucoup plus simples. Il n'existe qu'un seul ensemble de règles nommé «HW/SW Inventory (Linux, Windows, Solaris, AIX)», indépendant du système d'exploitation. Cet ensemble de règles contrôle le déploiement du plug-in nécessaire ainsi que sa configuration. Vous le trouverez à l'adresse Setup > Agents > Windows, Linux, Solaris, AIX > Agents > Agent rules :

Sous Windows, en plus de l'intervalle, vous pouvez également spécifier des chemins dans lesquels rechercher des fichiers exécutables .EXE lorsqu'il s'agit de trouver les logiciels installés sur le système. Vous pouvez également configurer les chemins dans le registre Windows, qui doit être pris en compte comme indicateur des logiciels installés.

Vous pouvez également interroger les données d'inventaire matériel/logiciel de plusieurs hôtes dans une seule sortie. Pour ce faire, étendez la requête à tous les hôtes requis :

http://myserver/mysite/check_mk/host_inv_api.py?request={"hosts":["myhost","myhost2"]}&output_format=json

Le résultat de cette requête ressemblera presque exactement à la sortie ci-dessus. Cependant, au niveau supérieur, les noms des hôtes sont utilisés comme clés. Les informations relatives aux hôtes suivent ensuite dans les arborescences de répertoires :

Si aucune donnée d'inventaire n'est trouvée pour un hôte, celui-ci aura une entrée d'inventaire vide au lieu du message d'erreur.

Vous ne souhaitez peut-être pas interroger toutes les données d'inventaire, mais uniquement rechercher des informations spécifiques. Si tel est le cas, spécifiez ce que l'on appelle des chemins d'inventaire pour cibler les informations souhaitées. Vous ne recevrez alors que les informations provenant des hôtes qui disposent de ces chemins / informations.

Par exemple, pour afficher uniquement les informations relatives à l'espace de stockage total et à l'espace d'échange de l'hôte myhost, utilisez cette URL :

http://myserver/mysite/check_mk/host_inv_api.py?host=myhost&request={"paths":[".hardware.memory.total_ram_usable",".hardware.memory.total_swap"]}&output_format=json

Vous recevrez les informations demandées :