Diagnostics de soutien

Après avoir cliqué sur Setup > Maintenance > Support diagnostics, vous verrez s'afficher l'écran suivant :

Si vous utilisez la supervision distribuée, vous pouvez indiquer dans le premier champ l'Site à partir de laquelle vous souhaitez sélectionner les données à collecter.

Sous « General information », vous ne trouverez en principe qu’une remarque indiquant que les informations relatives à la version de Checkmk et au système d’exploitation utilisé seront dans tous les cas incluses. Si vous en restez là — c’est-à-dire si vous ne sélectionnez aucune des options — et que vous lancez la collection des données via Collect diagnostics, vous obtiendrez un fichier contenant uniquement les données suivantes :

En plus du fichier general.json, Checkmk génère, dans cette configuration standard, d’autres fichiers contenant des données de performance telles que le nombre d’ordinateurs hôtes et de services, le matériel du serveur Checkmk, les variables d’environnement définies sur l’instance, les noms et tailles des fichiers présents sur l’instance ainsi que les modules Python qui y sont installés avec leurs versions. La page Background job details, qui s’ouvre après avoir cliqué sur Collect diagnostics, indique précisément quelles données sont compilées.

Sous Optional general information, vous trouverez ensuite des options que vous pouvez compiler à l’avance en fonction de votre demande, ou qui peuvent être explicitement demandées par le personnel d’assistance.

Si vous sélectionnez ici « Local Files and MKPs », Checkmk créera également un aperçu de tous les fichiers présents dans le répertoire ~/local/ de votre instance. Cela peut parfois s’avérer utile si vos personnalisations locales sont incompatibles avec une mise à jour récente de Checkmk. Tous les MKP installés sont également inclus ici.

En sélectionnant « OMD Config », vous pouvez ajouter les informations relatives à votre configuration d’OMD au dump. Celles-ci correspondent exactement à ce que vous obtiendriez en ligne de commande avec l’instruction « omd config show ».

Si vous cochez la case à cocher « Checkmk Overview », des informations générales sur toutes les instances fonctionnant sur votre serveur Checkmk seront incluses. Cela crée également une liste de toutes les versions de Checkmk installées. Et si l’instance sélectionnée ci-dessus est le nœud d’un cluster, cette information sera également enregistrée ici.

Avec l'option « Crash Reports », vous pouvez ajouter les derniers rapports de plantage des différentes catégories — par exemple base, check, gui ou rest_api — au dump. Vous trouverez de plus amples informations sur les rapports de plantage dans l'article consacré à la programmation des plugins de supervision basés sur des agents. Dans Checkmk, vous pouvez trouver les rapports de plantage sous Monitor > System > Crash reports.

Après avoir activé Checkmk Log files ou Checkmk Configuration files, vous avez la possibilité de supprimer toutes les données confidentielles de cette partie du paquet — via la sélection « Pack only Low sensitivity files ». Tous les fichiers que vous pouvez sélectionner ici proviennent des répertoires ~/var/log/ ou ~/etc/checkmk/ et de leurs sous-répertoires. Vous pouvez consulter une liste détaillée juste en dessous du menu déroulant. Avec l’option « Select individual files from list », vous avez même la possibilité de n’inclure que des fichiers spécifiques dans le dump.

Cette option vous permet également de voir quels fichiers ont l'un des niveaux de confidentialité « Élevé » (H), par exemple les fichiers contenant des mots de passe, « Moyen » (M), s'ils contiennent des adresses ou des noms d'utilisateur par exemple, ou enfin « Faible » (L).

Vous avez ensuite la possibilité d’ajouter des diagnostics de support (Performance Graphs of Checkmk Server) au dump. Ces rapports sont presque toujours demandés, en particulier en cas de problèmes de performances d’une instance Checkmk ; il est donc judicieux de les inclure lorsque de tels problèmes surviennent. Les diagnostics de support se chargeront pour vous de générer manuellement un certain nombre de rapports sous forme de fichiers PDF. Entre autres, les rapports du service de surveillance de l’OMD mysite performance pour les 25 dernières heures et les 35 derniers jours sont générés.

La section « Component specific information » vous permet à nouveau de choisir de manière très détaillée quelles informations issues de vos paramètres Checkmk globaux, de vos ordinateurs hôtes et dossiers, ainsi que de vos paramètres de notification doivent être incluses dans le dump.

Dans l'élément « Global Settings », vous trouverez tous les fichiers d'global.mks des composants individuels de votre instance Checkmk, tels que le Dynamic Configuration Daemon (DCD) ou le Livestatus Proxy Daemon.

Les informations pouvant être sélectionnées via le sous-menu « Hosts and Folders » peuvent, entre autres, aider à détecter des jeux de règles inappropriés et des erreurs dans la configuration de l'ordinateur hôte.

Dans la section « Notifications », vous trouverez, en plus des fichiers de configuration correspondants, une option permettant de sélectionner les fichiers journaux. En cas de difficultés avec vos notifications, vous — ou, en dernier recours, le support Checkmk — pouvez souvent trouver la source du problème dans ces journaux.

Utilisez l’option « Business Intelligence » pour sélectionner les fichiers de configuration destinés à l’informatique décisionnelle. Après avoir activé l’une des options « CMC (Checkmk Microcore) » ou « Licensing information », vous avez à nouveau la possibilité de supprimer les données plus ou moins confidentielles de la partie correspondante du package — via la sélection « Pack only Medium and Low sensitivity files » ou « Pack only Low sensitivity files ».

Pour pouvoir générer des informations complètes dans les diagnostics de support, vous devez vous assurer que l'agent installé sur les serveurs Checkmk porte le même numéro de version que le serveur Checkmk. En particulier, les informations provenant de l'inventaire matériel/logiciel du serveur Checkmk peuvent ne pas encore être fournies par les anciennes versions de l'agent.

Les diagnostics de support dépendent du fait que les serveurs Checkmk de votre environnement soient correctement étiquetés. Si certaines données manquent dans un dump, vérifiez si vos serveurs Checkmk sont étiquetés avec l'étiquette « cmk/check_mk_server:yes ».