This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved. |
1. Introduction
L'agent Checkmk ne peut pas être installé sur certains systèmes, et le protocole SNMP n'est pas — de manière satisfaisante — disponible. Néanmoins, Checkmk peut tout de même surveiller un tel système — à condition qu'il existe une interface de programmation d'application (API) grâce à laquelle Checkmk peut récupérer les données de supervision. Une telle API repose généralement sur Telnet, SSH ou HTTP/XML.
Vous n’avez pas à vous soucier d’interroger vous-même ces API, car Checkmk fournit les programmes dits « de source de données » nécessaires pour les systèmes couramment mis en œuvre, par exemple pour Amazon Web Services (AWS), Microsoft Azure et Google Cloud Platform (GCP), mais aussi pour NetApp, VMware ESXi, Prometheus, Elasticsearch, Cisco Meraki et bien d’autres encore. Ces programmes génèrent des sorties d'agent en interrogeant le matériel ou les logiciels via une API de gestion. Ils sont également appelés « agents spéciaux », car ils constituent une alternative particulière à l'agent Checkmk standard.
2. Agents spéciaux dans l'interface Checkmk
Étant donné que les agents spéciaux nécessitent parfois des paramètres assez complexes, nous avons défini des jeux de règles spécifiques dans l'interface graphique de configuration qui vous permettent de les configurer directement. Vous trouverez ces jeux de règles regroupés par cas d'utilisation sous Setup > Agents > VM, cloud, container et Setup > Agents > Other integrations :


3. Utilisation d'agents spéciaux
Les agents spéciaux sont installés sous ~/share/check_mk/agents/special/.
Si vous souhaitez modifier un tel agent, copiez d'abord le fichier portant le même nom vers ~/local/share/check_mk/agents/special/ et effectuez vos modifications dans cette nouvelle version.
Prenons, à titre d'exemple, la supervision des filers NetApp. Ceux-ci ne permettent pas l'installation d'agents Checkmk. L'interface SNMP est lente, imparfaite et incomplète. Il existe cependant une interface HTTP spéciale qui donne accès au système d'exploitation NetApp Ontap et à toutes ses données de supervision.
L'agent spécial agent_netapp_ontap accède à cette interface via une API REST et est configuré comme programme source de données à l'aide du jeu de règles NetApp via Ontap REST API.
Les données requises par l'agent spécial peuvent ensuite être saisies dans le contenu de la règle.
Il s'agit presque toujours d'une sorte de données d'accès.
Avec l'agent spécial NetApp, il existe également une option supplémentaire permettant de sélectionner les ressources à collecter :

Il est important de laisser l'ordinateur hôte défini sur « API integrations if configured, else Checkmk agent » dans l'interface graphique de configuration.
Dans certains cas, il est souhaitable d’interroger à la fois un agent spécial et l’agent standard. La supervision de VMware ESXi via vCenter en est un exemple. Ce dernier est installé sur une machine Windows (généralement virtuelle), sur laquelle, comme on peut s’y attendre, un agent Checkmk est également en cours d’exécution :

La configuration des agents spéciaux importants est décrite dans des articles distincts de ce guide de l'utilisateur, par exemple pour AWS, Microsoft Azure, GCP, Kubernetes, Prometheus, VMware ESXi et Datadog. |
4. Fichiers et répertoires
| Chemin d'accès | Fonction |
|---|---|
|
Les agents spéciaux fournis avec Checkmk sont installés ici. |
|
Le référentiel pour vos propres agents spéciaux modifiés. |
