 |
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
La tâche la plus importante lors de la mise en place d’un outil de supervision consiste à gérer les systèmes à surveiller, c’est-à-dire les ordinateurs hôtes. Il ne s’agit pas seulement de s’assurer qu’ils sont enregistrés avec les données de base correctes (par exemple, nom de domaine, adresse IP). Les paramètres de supervision (par exemple, notifications, valeurs seuil, etc.) nécessitent également une maintenance régulière.
Checkmk a été conçu dès le départ pour des environnements comportant un très grand nombre d’ordinateurs hôtes et dispose d’une approche spécifique pour rendre la configuration de ces environnements gérable pour l’utilisateur. Les principes fondamentaux de Checkmk sont les suivants :
Une hiérarchie de dossiers dans lesquels les ordinateurs hôtes sont stockés.
Des balises de l’hôte et une configuration basée sur des règles dérivée de ces balises.
Une détection automatique des services à soumettre à la supervision.
En général, il s'est avéré utile de réfléchir d'abord à un système de classement, puis de le remplir de contenu. Pour en savoir plus sur les possibilités offertes par Checkmk pour mettre de l'ordre dans vos ordinateurs hôtes, consultez l'article sur la structuration des ordinateurs hôtes.
2. Dossiers et héritage
Toute personne travaillant sur ordinateur connaît le principe des fichiers et des dossiers. Checkmk utilise un principe analogue pour l'administration des ordinateurs hôtes, qui reprennent en fait le rôle des fichiers. Comme les dossiers peuvent eux-mêmes être contenus dans d'autres dossiers, le résultat se présente sous la forme d'une arborescence.
2.1. Hiérarchie des dossiers
L'utilisateur est entièrement libre de concevoir sa propre arborescence. Toute forme de différenciation est possible. Il existe toutefois trois critères courants pour la structure de l'arborescence des ordinateurs hôtes :
Emplacement (par exemple, Munich ou Shanghai)
Type d'ordinateur hôte (par exemple, commutateur ou équilibreur de charge)
Structure organisationnelle (par exemple, groupes de bases de données ou groupes de réseaux)
Ces critères peuvent bien sûr être combinés, par exemple en classant les ordinateurs hôtes par emplacement au premier niveau de l'arborescence, puis par type d'ordinateur hôte au deuxième niveau.
Si vous appréciez la simplicité, vous devriez placer les ordinateurs hôtes uniquement dans les « feuilles » de l'arborescence (même si Checkmk autorise les ordinateurs hôtes dans les dossiers intermédiaires). L'exemple suivant montre une structure arborescente simple par type d'ordinateur hôte : Les ordinateurs hôtes A, B et C sont placés dans le dossier Serveurs, et D, E et F sont placés dans le dossier Réseau :
2.2. Héritage des attributs
Si vous construisez l’arborescence de manière judicieuse, vous pouvez l’utiliser pour hériter d’attributs de manière pertinente. Ceci est particulièrement utile pour les attributs communs à de grands groupes d’hôtes, tels que la communauté SNMP ou les balises de l’hôte que vous utilisez pour déterminer si l’hôte doit être soumis à la supervision par un agent Checkmk ou par SNMP.
L'exemple suivant illustre l'héritage des groupes de balises « Criticality » (avec les valeurs prod et test) et « Checkmk agent / API integrations » (avec les valeurs tcp et no-agent).
La balise auxiliaire « tcp » est automatiquement définie lorsque l'agent Checkmk et/ou une intégration API est sélectionné, tandis que « no-agent » est l'option à choisir en cas de supervision via SNMP.
Les attributs définis plus bas dans l'arborescence ont toujours la priorité.
Ainsi, les valeurs définies directement au niveau de l'ordinateur hôte remplacent tout ce qui provient des dossiers.
Dans l'exemple ci-dessus, cela donne prod et tcp pour l'ordinateur hôte A, prod et no-agent pour D, et test et no-agent pour l'ordinateur hôte F en raison de l'attribut explicitement attribué.
L'un des principaux avantages de ce schéma par rapport à l'approche « copier-coller » largement utilisée dans les systèmes de configuration orientés base de données est que tous les attributs spécifiés seront repris par les ordinateurs hôtes ajoutés ultérieurement. Cela facilite le travail pour vous et vos collègues : il vous suffit de déposer un nouvel ordinateur hôte dans le dossier approprié pour que tous les attributs prédéfinis soient automatiquement corrects.
2.3. Création de dossiers
La procédure de création de dossiers est expliquée dans le Guide du débutant.
3. Création et édition des ordinateurs hôtes dans le menu de configuration
Pour gérer les dossiers et les ordinateurs hôtes, rendez-vous dans «Setup > Hosts > Hosts: »
Dans la vue de la table par défaut, vous pouvez voir un aperçu des dossiers et, en dessous, sous forme de tableau, les hôtes déjà présents dans le dossier actuel.
La création d’un nouvel hôte à l’aide du bouton d’action « 
» (Créer un hôte), du bouton « Add host » (Cloner l’hôte actuel) ou de la modification d’un hôte existant via « 
» (Modifier l’hôte) vous mènera à la page « Properties of host » (Détails de l’hôte).
Cette page répertorie les attributs de l’hôte.
Ces attributs sont regroupés en plusieurs sections, dont nous présentons ici les plus importantes.
3.1. Le nom de domaine
Le champ Hostname est utilisé partout dans Checkmk pour identifier de manière unique l’ordinateur hôte. Dans la mesure du possible, vous devriez utiliser le nom DNS de l’ordinateur hôte. Si le nom DNS est trop long, un alias plus facile à reconnaître peut être attribué ultérieurement. Veuillez toutefois noter que Checkmk autorise une longueur maximale de 240 caractères pour le nom de domaine.
Les modifications du nom de domaine sont en principe également possibles ultérieurement ; toutefois, comme le nom de domaine est utilisé à de nombreux endroits dans Checkmk, les modifications ultérieures sont plus complexes et prennent plus de temps lorsque des données de supervision ont déjà été accumulées au moment où la modification doit être effectuée.
3.2. Alias et adresse IP
Vous pouvez attribuer un nom alternatif et descriptif à l'ordinateur hôte sous «Alias», qui s'affiche à de nombreux endroits dans l'interface graphique et dans les rapports. Si vous n'attribuez pas d'alias, le nom de domaine de l'ordinateur hôte sera utilisé à la place.
Vous n'êtes pas obligé de spécifier une adresse IP. Quatre options sont disponibles pour configurer l'adresse IP, qui déterminent également quand le nom est résolu :
| Option | Procédure | Quand effectuer la résolution du nom ? |
|---|---|---|
1. |
Vous ne spécifiez pas d'adresse IP. Le nom de domaine doit pouvoir être résolu par le DNS. |
Lors de l'activation des modifications. |
2. |
Vous saisissez une adresse IPv4 — dans la notation habituelle avec des points. |
Jamais |
3. |
Au lieu d'une adresse IP, vous saisissez un nom de domaine (alternatif) pouvant être résolu par le DNS. |
Lors de l'exécution des checks |
4. |
Utilisez le jeu de règles « Hosts with dynamic DNS lookup » pour spécifier les ordinateurs hôtes d'un DNS dynamique. Le résultat est similaire à celui de l'option 3, à la différence que le champ « Hostname » est désormais utilisé pour la requête DNS. |
Lors de l'exécution des checks |
Avec la première option, Checkmk utilise un fichier de cache pour éviter les requêtes DNS répétées lors de l'activation des modifications. Ce cache est très important pour accélérer le processus, et il garantit également que vous pouvez activer une configuration modifiée même si le DNS échoue lors d'une tentative.
Le hic, c’est que Checkmk ne détecte pas immédiatement le changement d’adresse IP dans le DNS.
C’est pourquoi il existe une entrée de menu « Host > Update DNS cache » dans les propriétés de l’ordinateur hôte.
Cela effacera l’intégralité du cache DNS et forcera une nouvelle résolution lors de la prochaine activation des modifications.
Le fichier correspondant se trouve sur votre instance sous ~/var/check_mk/ipaddresses.cache.
La suppression de ce fichier a le même effet que l’exécution de la commande « Update (site) DNS cache. ».
Checkmk prend également en charge la supervision via IPv6, même en double pile.
L'ordre de résolution est ici déterminé par les paramètres du système d'exploitation (/etc/gai.conf).
Dans les champs Additional IPv4 addresses et Additional IPv6 addresses, seules les adresses IP en notation par points ou par deux-points sont autorisées ; les noms DNS alternatifs ne sont donc pas autorisés.
Pour certaines applications, il est nécessaire de définir IP address family sur No IP. Cela s’applique aux ordinateurs hôtes interrogés via un agent spécial, ainsi que au mode Push de l’agent Checkmk. Vous trouverez plus d’informations à ce sujet dans la section suivante consacrée aux agents de supervision.
3.3. Agents de supervision
L'Monitoring agents vous permet de déterminer à partir de quelles sources de données la supervision est effectuée. Le paramètre par défaut prévoit l'utilisation de l'agent Checkmk. De nombreuses options de supervision alternatives ou supplémentaires sont également proposées.
En particulier, la première entrée de l'Checkmk agent / API integrationse détermine quelles données utiliser et lesquelles ignorer lorsque plusieurs sources de données sont présentes.
API integrations if configured, else Checkmk agent |
Les données de supervision sont fournies par des intégrations API, c'est-à-dire par des agents spéciaux ou par ferroutage depuis d'autres ordinateurs hôtes. Si des agents spéciaux sont configurés, tous sont exécutés. Si aucune intégration API n'est configurée, on accède à la sortie de l'agent Checkmk. Il s'agit de la valeur par défaut. |
Configured API integrations and Checkmk agent |
La sortie d'un agent Checkmk est attendue. Les données fournies par les intégrations API seront également utilisées si elles sont configurées. |
Configured API integrations, no Checkmk agent |
Seules les données fournies par les intégrations API seront utilisées pour la supervision. |
No API integrations, no Checkmk agent |
Avec ce paramètre, l'ordinateur hôte sera supervisé via SNMP ou sans agent uniquement avec des contrôles actifs. Les règles relatives aux contrôles actifs se trouvent dans Setup > Hosts > HTTP, TCP, Email, … Si vous ne définissez pas au moins un contrôle actif, Checkmk créera automatiquement un service PING. |
 |
La sélection de « Configured API integrations, no Checkmk agent » garantit que les deux services « Check_MK » et « Check_MK Discovery » ont toujours l'état « OK ». Si vous n'avez pas saisi d'adresse IP pour l'ordinateur hôte, celui-ci prendra l'état « DOWN » car aucun ping ne peut être effectué. Dans ce cas, vous devez utiliser la règle « Setup > Hosts > Host monitoring rules > Host check command » pour déterminer comment vérifier si l'ordinateur hôte doit être évalué comme « UP ». |
L'option « Checkmk agent connection mode » vous permet de choisir si l'agent Checkmk doit fonctionner en mode « Pull » ou en mode « Push ».
Cette option n'est disponible que dans 
Checkmk Ultimate, car le mode « Push » n'est pris en charge que dans cette édition.
À noter que cette option est également disponible dans Checkmk Ultimate dans les propriétés d'un dossier et sert à permettre la création automatique d'ordinateurs hôtes via l'enregistrement automatique.
Si vous sélectionnez ici « Push - Checkmk agent contacts the server », définissez également « IP address family » sur « No IP » dans le champ « Network address ».
Cela empêche la vérification de l'accessibilité de l'ordinateur hôte via Smart Ping.
Dans toutes les autres éditions, l'agent fonctionne en mode Pull.
Utilisez le paramètre « SNMP » suivant pour configurer la supervision via SNMP.
Après avoir activé « SNMP » et sélectionné la version SNMP, le champ « SNMP credentials » apparaît, ce qui vous permet de spécifier la communauté SNMP.
Cependant, comme celle-ci est généralement la même pour de nombreux ordinateurs hôtes, il est plus judicieux d’enregistrer ce paramètre dans le dossier.
Si vous ne spécifiez rien, « public » est automatiquement utilisé.
Le dernier champ, « Piggyback », fait référence à l'utilisation de données ferroutées, qui sont transmises par d'autres ordinateurs hôtes et attribuées à cet ordinateur hôte en tant que sortie de l'agent. Notez que le paramètre défini ici doit correspondre aux paramètres de la première option « Checkmk agent / API integrations », sinon l'absence de données de supervision attendues pourrait passer inaperçue. C'est pourquoi une entrée est explicitement définie sur « Always use and expect piggyback data. ».
3.4. Attributs personnalisés
Dans la case « Custom attributes », vous pouvez afficher tous les champs de texte librement codés que vous avez précédemment créés en tant qu’attributs personnalisés. Par défaut, « Labels » et les deux groupes de balises de l’hôte prédéfinis « Criticality » et « Networking Segment » sont présents ici :
Vous pouvez définir des attributs personnalisés à l'aide de Setup > Hosts > Custom host attributes.
Les attributs personnalisés peuvent être, par exemple, un contact sur site, un numéro de succursale, des informations matérielles, des numéros d'inventaire ou des coordonnées géographiques. Les valeurs des attributs personnalisés doivent avant tout aider les utilisateurs à assurer le suivi, mais peuvent également être utilisées dans des règles et des filtres lorsque, par exemple, les étiquettes ou les balises de l’hôte sont trop rigides.
Les attributs personnalisés peuvent être attribués à n'importe quelle case dans les propriétés d'un ordinateur hôte en sélectionnant « Topic » (thème).
3.5. Carte de gestion de la gestion
Le terme « carte de gestion » désigne des cartes enfichables distinctes ou des fonctionnalités BIOS étendues (telles que Baseboard Management Controller/BMC, Management Engine/ME, Lights Out Management/LOM) permettant la supervision et la gestion du matériel en plus du système d’exploitation installé. Outre les fonctions de contrôle et de maintenance à distance (par exemple pour le déploiement de systèmes d’exploitation), ce matériel est généralement équipé d’une interface IPMI ou SNMP, via laquelle il est possible de consulter des valeurs de « santé » (par exemple les températures et les vitesses des ventilateurs).
Saisissez ici l’adresse IP et la méthode d’accès si l’ordinateur hôte dispose d’une carte de gestion :
|
Les cartes de gestion ne seront plus prises en charge en tant que propriété d'hôte dans une future version de Checkmk. Nous vous recommandons donc de créer des cartes de gestion en tant qu'hôtes SNMP distincts ou, si possible, de les surveiller à l'aide d'agents spéciaux. |
3.6. Création / Verrouillage
Alors que la plupart des informations décrites jusqu’à présent peuvent être modifiées, la case de dialogue « Creation / Locking » contient des informations qui, à ce stade, sont fournies à titre indicatif uniquement.
L'heure de création (Created at) et le créateur (Created by) sont déterminés par Checkmk. Il existe trois options principales pour le nom du créateur :
Nom d'utilisateur, par exemple cmkadmin : l'ordinateur hôte a été créé manuellement par un utilisateur, par exemple dans la Configuration.
Nom d'utilisateur d'automatisation (dans l'image ci-dessus automation) : l'ordinateur hôte a été créé par un utilisateur de l'automatisation, par exemple à l'aide de l'API REST.
Analyse du réseau : l'ordinateur hôte a été détecté lors d'une analyse automatique du réseau.
Si l'ordinateur hôte a été créé par un utilisateur de l'automatisation, il sera verrouillé par son instance correspondante (Locked by). Ces informations peuvent également être utilisées lors de la recherche d'ordinateurs hôtes dans la configuration.
Locked attributes ne peut plus être éditée dans les propriétés de l'ordinateur hôte.
3.7. Enregistrement et poursuite
Lors de la création ou du clonage d’un ordinateur hôte, après avoir défini les propriétés, l’étape logique suivante est « Save & run service discovery. » Cela vous mènera à la reconnaissance automatique du service, que nous expliquerons dans le chapitre suivant.
En revanche, l’option « Save & run connection tests » vous amène au test de connexion. Cela vous permet de vérifier d’abord si vous recevez des données de l’ordinateur hôte avec les paramètres que vous avez spécifiés, que ce soit via un agent ou tout autre moyen que vous avez précédemment configuré. Pour plus de détails sur le test de connexion, consultez l’article sur les agents de supervision.
3.8. Actions Bulk
Vous souhaiterez peut-être parfois effectuer des opérations telles que la suppression, le déplacement, la modification ou la reconnaissance du service pour plusieurs ordinateurs hôtes à la fois. Checkmk propose à cet effet ce que l’on appelle des « actions Bulk ».
Vous trouverez ces actions dans la page de menu «Hosts» d’un dossier ouvert, dans la section «On selected hosts» :
Ces actions s’appliquent toujours aux ordinateurs hôtes qui se trouvent directement dans le dossier affiché — et que vous avez sélectionnés. Les cases à cocher de la première colonne de la liste des ordinateurs hôtes servent à cet effet. Si vous cliquez sur la croix dans le titre de la colonne, tous les ordinateurs hôtes seront sélectionnés — et désélectionnés en cliquant à nouveau dessus.
Voici quelques remarques concernant les actions disponibles :
-
Edit attributes: Modifie un ou plusieurs attributs des ordinateurs hôtes. L'attribut est ainsi explicitement renseigné dans les ordinateurs hôtes.
Attention : il existe une différence entre un ordinateur hôte héritant d’un attribut d’un dossier et un ordinateur hôte pour lequel cet attribut est explicitement défini, comme c’est le cas avec cette action. Pourquoi ? Dans ce dernier cas, la modification des attributs dans le dossier n’aura aucun effet, car les valeurs définies directement au niveau de l’ordinateur hôte auront toujours la priorité. C’est pour cette raison qu’il existe également l’action suivante.
Run bulk service discovery: Effectuer la reconnaissance du service pour plusieurs ordinateurs hôtes simultanément.
Move to other folder: Déplacer les ordinateurs hôtes vers un autre dossier. Après avoir sélectionné cette entrée, les dossiers existants sont proposés comme cibles possibles.
Detect network parent hosts: Créer des parents à l'issue d'une analyse.
-
Remove explicit attribute settings: Supprime les attributs explicites des ordinateurs hôtes et rétablit l'héritage. Vous obtiendriez le même résultat en sélectionnant chaque ordinateur hôte individuellement et en décochant les cases correspondant aux attributs concernés.
En général, il est recommandé d'utiliser le moins d'attributs explicites possible. Si tout est correctement hérité via les dossiers, cela évite les erreurs et facilite l'ajout de nouveaux ordinateurs hôtes.
Remove TLS registration: Supprime l'enregistrement pour la communication chiffrée via Transport Layer Security (TLS). Vous trouverez plus d'informations sur ce thème dans les articles consacrés à l'agent Linux et à l'agent Windows.
Delete hosts: Supprime les ordinateurs hôtes — après confirmation de la demande.
4. Suppression automatique des ordinateurs hôtes
Vous pouvez faire en sorte que les ordinateurs hôtes qui n'existent plus soient automatiquement supprimés de l'environnement de configuration et de l'environnement de supervision. Lors de la suppression automatique, la relation de confiance mutuelle (mTLS) est également supprimée, ce qui signifie qu'en cas de réapparition d'un ordinateur hôte, la procédure d'enregistrement doit être effectuée à nouveau.
Le critère utilisé pour déterminer si un ordinateur hôte est toujours présent est l’état du service Check_MK. Ce service est responsable de l’état de l’agent de supervision s’exécutant sur l’ordinateur hôte pendant le fonctionnement. S’il n’y a plus de connexion avec l’agent — et donc pas de données de supervision actuelles —, le service passe à l’état « CRIT ».
Les ordinateurs hôtes dont le service d’Check_MK a été en état « CRIT » pendant une période de temps spécifiée peuvent être supprimés automatiquement. Cette opération s’effectue à l’aide de la règle « Automatic host removal rule, », accessible sous Setup > Hosts > Host monitoring rules. Cette règle est simple. Il vous suffit de définir la période de temps pendant laquelle le service d’Check_MK doit rester en état « CRIT » avant que l’ordinateur hôte associé ne soit supprimé :
Pour supprimer les ordinateurs hôtes non seulement de la Configuration, mais également de la supervision, les modifications sont activées automatiquement. Notez que lors de l’activation automatique, toutes les autres modifications en attente seront également activées.
|
Cette règle est disponible dans toutes les éditions de Checkmk.
Elle s’avère toutefois particulièrement bien adaptée en complément de l’option de création automatique d’ordinateurs hôtes, qui fait partie des fonctionnalités de Checkmk Ultimate.
Si vous souhaitez que les ordinateurs hôtes créés automatiquement soient à nouveau supprimés automatiquement,
vous pouvez limiter la condition de la règle aux ordinateurs hôtes portant l’étiquette « |
Notez que la gestion dynamique des hôtes offre également la possibilité de supprimer automatiquement les hôtes. Ces deux options de lifecycle management fonctionnent indépendamment l’une de l’autre, c’est-à-dire qu’un hôte sera supprimé si l’une des deux conditions est remplie.
5. Configuration des services
Une fois l'ordinateur hôte créé, l'étape suivante consiste à configurer les services à superviser sur celui-ci. Vous trouverez tous les détails concernant l'identification et la configuration automatiques des services dans l'article Comprendre et configurer les services. Nous ne décrirons ici que les points les plus importants.
Vous pouvez accéder à la liste des services configurés d’un ordinateur hôte de la manière suivante :
Dans la Configuration, via la liste des ordinateurs hôtes :
Sélectionnez «Setup > Hosts > Hosts.» (Configuration > Hôtes). Dans la liste des ordinateurs hôtes, cliquez sur «
» (Configurer les services).Dans la configuration, via les propriétés d’un hôte :
Sélectionnez « Setup > Hosts > Hosts. » (Configuration > Hôtes). Dans la liste des hôtes, cliquez sur l’hôte souhaité. Sur la page « Properties of host » (Configuration de l’hôte), sélectionnez « Host > Save & run service discovery. » (Configuration des services). Si vous sélectionnez plutôt « Host > Run service discovery » (Configuration de l’hôte) dans le menu, vous accéderez également à la liste des services, mais sans enregistrer les propriétés de l’hôte.Dans la supervision, via la liste des services d’un ordinateur hôte :
Sélectionnez le menu « Host », puis, dans la section « Setup », sélectionnez l’entrée « Run service discovery ». Une petite icône en forme d’engrenage à côté de l’icône indique que cette entrée de menu mène à une page de la Configuration. Cela vous mènera directement à la configuration du service.
Quelle que soit la méthode choisie, le résultat devrait ressembler à ceci :
Les actions les plus importantes sont disponibles dans la barre d'action, les autres se trouvent dans le menu « Actions ». Quelques remarques sur les actions possibles :
Le bouton « Accept all » (Configurer le service) est généralement la meilleure option pour un nouvel hôte. C'est également le bon choix pour les hôtes existants sur lesquels se trouvent des services qui ne sont pas actuellement sous supervision. Ceux-ci peuvent être trouvés dans la section « Undecided services (currently not monitored) section » (Configuration de l'hôte). « Accept all » (Configurer le service) ajoute les services manquants, supprime les services disparus et accepte toutes les étiquettes d'hôte trouvées.
Le bouton « Rescan » garantit que des données récentes et complètes sont récupérées depuis l’appareil cible. Pour accélérer le chargement des pages, Checkmk utilise des fichiers mis en cache qui sont enregistrés lors de la supervision normale. Pour les périphériques SNMP, ce bouton déclenche donc une recherche active de nouveaux plugins de supervision et peut également détecter des services supplémentaires.
Le bouton « Monitor undecided services » transfère les services correspondants vers la supervision, mais sans transférer les étiquettes d'hôte.
Remove vanished services supprime les services qui n’existent plus. Ceci est utile pour les services qui mémorisent un état actuel lors de l’identification (par exemple, l’état actuel des ports du switch ou des systèmes de fichiers et de leurs points de montage).
Après chaque modification, il faut activer les modifications pour que celles-ci prennent effet.
6. Importation d'ordinateurs hôtes à partir d'un fichier CSV
Si vous souhaitez ajouter un grand nombre d'ordinateurs hôtes à Checkmk en une seule opération, vous pouvez vous faciliter la tâche en important les ordinateurs hôtes à partir d'un fichier CSV. Cela s'avère particulièrement utile dans deux cas de figure :
Vous souhaitez importer des ordinateurs hôtes depuis un autre système de supervision prenant en charge l'exportation dans des formats de données structurés. Vous pouvez créer un fichier CSV à partir de ce système source et utiliser ce fichier pour l'importation vers le système Checkmk cible.
Vous souhaitez créer de nombreux nouveaux ordinateurs hôtes en même temps. Dans ce cas, saisissez les ordinateurs hôtes dans une feuille de calcul Excel, puis importez simplement cette liste sous forme de fichier CSV.
Checkmk offre une grande flexibilité lors de l'importation de données CSV. Dans le cas le plus simple, chaque ligne du fichier CSV contient simplement un nom de domaine résolvable par DNS :
myserver01
myserver02Vous pouvez également transmettre des attributs supplémentaires en même temps lors d'une importation. Vous trouverez un aperçu de tous les attributs possibles dans la section suivante. Si le fichier CSV contient les noms des attributs dans la première ligne, Checkmk peut même les attribuer automatiquement. Checkmk tolère, dans la mesure du possible, les orthographes non exactes (il tente d'interpréter les variations mineures). Par exemple, dans le fichier suivant, Checkmk peut automatiquement effectuer l'affectation de toutes les colonnes :
hostname;ip address;alias;agent;snmp_ds
lnx17.example.com;192.168.178.48;Webserver;cmk-agent;
lnx18.exmpl.com;192.168.178.55;Backupserver;cmk-agent;
switch47-11;;Switch47;no-agent;snmp-v2La procédure est la suivante :
Sélectionnez ou créez un dossier dans lequel l'importation doit avoir lieu.
Accédez à ce dossier (Setup > Hosts > …) et, dans le menu Hosts, sélectionnez l'entrée 
Import hosts via CSV file.
Sur la page suivante, utilisez « Upload CSV File » pour télécharger le fichier. Vous pouvez également sélectionner « Content of CSV File » et copier le contenu du fichier dans la zone de texte située sous la liste. Vous pouvez immédiatement lancer une reconnaissance automatique du service sur les ordinateurs hôtes nouvellement importés. Pour ce faire, sélectionnez l'option « Perform automatic service discovery ».
En cliquant sur 
Upload, vous accéderez à la page suivante :
La sélection d’un délimiteur (Set field delimiter) n’est pas nécessaire dans cet exemple, car le point-virgule a déjà été interprété correctement. Checkmk reconnaît automatiquement les délimiteurs courants, tels que la tabulation ou le point-virgule. Sélectionnez ici l’option « Has title line » pour reconnaître les en-têtes. Sous « Preview », vous pouvez voir un aperçu du nouveau tableau.
Si la détection automatique d'une colonne ne fonctionne pas correctement, vous pouvez également sélectionner manuellement l'attribut à attribuer.
Utilisez la liste correspondante à cet effet.
Pour les balises de l’hôte (les entrées commençant par Tag), le fichier CSV doit contenir l'ID interne de la balise (ici, par exemple, cmk-agent et non son titre Checkmk agent / API integrations visible dans l'interface graphique).
Vous pouvez voir exactement quels sont les ID internes des balises de l’hôte dans Setup > Hosts > Tags.
Pour les identifiants des balises prédéfinies (builtin), consultez le tableau figurant dans l'article décrivant les balises de l’hôte.
Lancez l'importation en cliquant sur « » (Import).
Si vous avez sélectionné l'option « Perform automatic service discovery », vous serez redirigé vers la page « Bulk discovery » et devrez encore la modifier.
Une fois la reconnaissance du service terminée, il ne vous reste plus qu'à activer les modifications comme d'habitude, après quoi tous les nouveaux ordinateurs hôtes seront pris en compte dans la supervision.
6.1. Aperçu des attributs à importer
| Attribut | Description |
|---|---|
|
Nom de l'ordinateur hôte (240 caractères maximum) |
|
Nom d'alias de l'ordinateur hôte |
|
Instance sur laquelle cet ordinateur hôte est supervisé |
|
Adresse IPv4 |
|
Adresse IPv6 |
|
Communauté SNMP |
|
Balise : Criticité |
|
Balise : Segment de réseau |
|
Balise : Agent Checkmk / Intégration API |
|
Balise : ferroutage |
|
Balise : SNMP |
|
Balise : Famille d'adresses IP |
7. Recherche de dossiers sur le réseau
7.1. Le principe
Checkmk offre la possibilité d’analyser automatiquement et régulièrement votre réseau — ou seulement certaines parties de celui-ci — à la recherche de (nouveaux) ordinateurs hôtes. Cette analyse du réseau est configurée au niveau des dossiers dans l’administration des ordinateurs hôtes de Checkmk. Une tâche cron s’exécute en arrière-plan toutes les minutes. Elle checke tous les dossiers pour voir si un autre scan est prévu. La tâche cron checke les deux paramètres Scan interval et Time allowed. Si cet intervalle de temps est écoulé et que le serveur se trouve dans la plage horaire autorisée pour le scan, celui-ci sera lancé. Ainsi, un scan réseau nouvellement configuré démarrerait dans la minute qui suit le clic sur Save, à condition que vous n’ayez pas modifié l’Time allowed.
Une fois l'analyse lancée, trois choses se produisent essentiellement :
Checkmk détermine d'abord les adresses IP à analyser. À partir des plages d'adresses configurées, il supprime toutes les adresses déjà utilisées dans n'importe quel dossier de la configuration de vos ordinateurs hôtes.
Les adresses identifiées feront alors l'objet d'un ping. Si une réponse à ce ping est reçue pour une adresse, le système tente de déterminer un nom de domaine.
Enfin, les ordinateurs hôtes du dossier sont créés. Tous les ordinateurs hôtes dont le nom existe déjà sur l’instance seront omis.
7.2. Configuration d'un scan réseau
Comme mentionné ci-dessus, l'analyse du réseau est configurée au niveau du dossier. Ouvrez d'abord Setup > Hosts > Hosts. Accédez ensuite à n'importe quel dossier ou restez dans le dossier Main.. Dans le menu Folder > Properties, vous trouverez la case Network Scan.
Activez l'analyse du réseau à l'aide de la case à cocher correspondante.
Ensuite, dans IP ranges to scan, indiquez les adresses IP que Checkmk doit surveiller automatiquement pour vous.
Pour cette définition, vous avez le choix entre des adresses IP individuelles, des plages d'adresses IP et des réseaux entiers.
Nous vous recommandons de ne pas sélectionner une plage d'adresses trop large, sinon la supervision du réseau pourrait prendre beaucoup de temps.
Lorsque vous choisissez un réseau, nous vous recommandons également de ne pas dépasser le masque de réseau de /21, ce qui correspond à 2 048 adresses IP.
Vous ne devez pas dépasser le nombre de 2 048 adresses IP, même lorsque vous effectuez une sélection via IP-Range.
Bien entendu, il ne s'agit là que d'une recommandation approximative, car le réseau de votre organisation est peut-être capable de gérer des plages d'adresses plus étendues sans aucun problème.
L'option suivante IP ranges to exclude vous permet d'exclure certaines parties de la plage d'adresses configurée ci-dessus. Cette option est également utile pour exclure des ordinateurs hôtes ou adresses IP déjà connus et sous supervision. De cette manière, vous pouvez éviter la création d'ordinateurs hôtes en double.
Les deux options suivantes, « Scan interval » et « Time allowed », vous permettent de spécifier la fréquence à laquelle l'analyse doit s'exécuter et à quel moment vous souhaitez l'autoriser.
L'un des aspects les plus importants à prendre en compte lors de la configuration de l'analyse du réseau est la manière dont vous souhaitez traiter les ordinateurs hôtes détectés. L'option « Set criticality host tag » joue ici un rôle central :
Par défaut, l’option « Do not monitor this host » est sélectionnée. Cela signifie que les ordinateurs hôtes détectés sont uniquement inclus dans l’administration des ordinateurs hôtes pour le moment. Aucune supervision effective n’est effectuée. Une approche possible consiste à déplacer manuellement les ordinateurs hôtes détectés vers votre structure d’ordinateurs hôtes existante, par exemple à l’aide de la fonction « Move this host to another folder ». Une fois le déplacement effectué, vous devrez alors personnaliser ou supprimer la balise de l’hôte « Criticality ». Si vous disposez d’un grand nombre d’ordinateurs hôtes, vous pouvez utiliser la fonction « Remove explicit attribute settings » dans « Setup > Hosts > Hosts ».
Si vous sélectionnez plutôt Productive system comme balise de l’hôte ici, les ordinateurs hôtes détectés — s’ils sont correctement configurés avec le jeu de règles Periodic service discovery — seront également inclus directement dans la supervision.
Avant d'utiliser l'analyse du réseau, veuillez également tenir compte des considérations de base suivantes :
L'analyse s'effectue via un ping. Cela signifie également que les appareils qui ne peuvent être supervisés que via SNMP peuvent être détectés, mais ne seront pas automatiquement supervisés car l'SNMP credentials n'aura pas été configurée.
Pour les nouveaux ordinateurs hôtes Windows, la fonction dite « Echo Request » sera désactivée dans le pare-feu, sauf si une configuration correspondante a été définie, par exemple au moyen de directives de groupe. Ces ordinateurs hôtes Windows ne répondront donc pas à l'analyse et ne seront par conséquent pas détectés.
Checkmk ne peut vous fournir des données fiables pour les ordinateurs hôtes qu’il détecte que si votre réseau et votre instance Checkmk sont configurés en conséquence. Des entrées contradictoires dans le DNS et sur votre instance Checkmk peuvent entraîner des doublons. Un doublon est créé lorsqu’un ordinateur hôte portant un nom (mais sans adresse IP) a déjà été configuré dans Checkmk et qu’il est désormais détecté sous un nom différent via son adresse IP.
8. Recherche d'ordinateurs hôtes dans la Configuration
Checkmk offre un moyen pratique d'effectuer des recherches dans l'environnement de supervision (dans le menu « Monitor ») et dans l'environnement de configuration (dans le menu « Setup »). Les résultats de ces recherches peuvent différer, car les ordinateurs hôtes présents dans l'environnement de supervision ne sont pas nécessairement les mêmes que ceux de l'environnement de configuration. Par exemple, si vous avez créé un ordinateur hôte dans la configuration sans activer cette modification, il n'existera pas (encore) dans l'environnement de supervision.
Il existe une autre façon de rechercher des ordinateurs hôtes dans l'environnement de configuration, qui présente les avantages suivants :
Vous pouvez rechercher des ordinateurs hôtes selon divers critères.
Les ordinateurs hôtes trouvés sont répertoriés sur une page de résultats à partir de laquelle vous pouvez lancer les actions Bulk, comme décrit précédemment dans cet article.
Vous trouverez cette recherche sous « Setup > Hosts > Hosts » (Recherche dans l'environnement de configuration) sur la page d'un dossier ouvert dans le menu « Display > Search hosts » (Environnement de configuration). Une telle recherche commence toujours à partir du dossier actuel, puis se poursuit de manière récursive dans tous ses sous-dossiers. Pour effectuer une recherche globale, il suffit de lancer la recherche à partir du dossier « Main » (Environnement de configuration) :
Pour le champ Host name, une recherche par mot partiel (recherche infixée) est utilisée : le texte saisi est recherché, à n'importe quelle position, dans le nom de domaine. De plus, vous pouvez limiter la recherche à l'aide d'autres attributs. Toutes les conditions sont liées par un ET. Ainsi, l'exemple de la capture d'écran ci-dessus recherche tous les ordinateurs hôtes dont le nom contient my et qui possèdent également la balise Test system.
Vous lancez la recherche avec Submit. La page de résultats peut être traitée presque comme un dossier normal. Cela signifie que vous pouvez ici utiliser les actions Bulk disponibles dans le menu Hosts de la section On selected hosts, par exemple pour déplacer tous les ordinateurs hôtes trouvés vers un dossier spécifique.
Vous pouvez personnaliser et affiner davantage la recherche sur la page de résultats à l'aide de Refine search.
9. Renommer des ordinateurs hôtes
Le renommage des ordinateurs hôtes peut sembler une tâche simple à première vue, mais à y regarder de plus près, il s’avère être une opération complexe. La raison en est que Checkmk utilise le nom de l’ordinateur hôte comme clé unique pour celui-ci — et ce, à de nombreux endroits. Cela inclut les noms de fichiers, les données de journal, les règles, les tableaux de bord, les rapports, les agrégations BI, et bien plus encore. Le nom d’un ordinateur hôte apparaît également dans les URL.
Checkmk propose deux fonctions dans l’Setup pour renommer proprement un ordinateur hôte dans toutes ses occurrences. Vous pouvez soit renommer un seul ordinateur hôte (dans les propriétés de l’ordinateur hôte, dans le menu « Host > Rename »), soit renommer simultanément plusieurs ordinateurs hôtes d’un dossier (dans le menu « Hosts > Rename multiple hosts »).
|
Lorsque vous apportez des modifications à plusieurs ordinateurs hôtes et à plusieurs endroits, il est toujours possible que quelque chose tourne mal. Par conséquent, assurez-vous de disposer d’une sauvegarde à jour de votre instance avant de lancer l’opération de renommage. |
Le champ « Bulk renaming of hosts » permet de saisir simultanément et systématiquement les noms pour plusieurs ordinateurs hôtes :
Dans le champ « Host name matching », spécifiez d’abord, si vous le souhaitez, une expression régulière pour saisir le début des noms de domaines que vous souhaitez renommer — ici, dans l’exemple, tous les ordinateurs hôtes dont le nom commence par lnx.
Ajoutez ensuite une ou plusieurs opérations à l’aide de « Add renaming ». Celles-ci sont appliquées séquentiellement aux noms de domaines.
Dans l’exemple ci-dessus, l’opération « Drop Domain Suffix » tronque tout ce qui suit le premier . de tous les noms de domaines, puis l’opération « Add Suffix » ajoute le suffixe -linuxserver aux noms.
D'autres opérations sont disponibles, dont la plupart sont intuitives. Sinon, vous pouvez obtenir plus d'informations via l'aide en ligne.
Après avoir lancé la procédure de renommage avec Bulk rename et confirmé la question obligatoire « Êtes-vous sûr…? » …
… la finalisation du processus peut prendre un certain temps. Pendant le processus de renommage, la supervision sera complètement interrompue ! Cette mesure est nécessaire pour maintenir la cohérence de l'ensemble du système. À la fin du processus, vous obtiendrez un aperçu précis des emplacements où les renomages ont été effectués :
10. Requêtes API REST pour les ordinateurs hôtes et les dossiers
Vous pouvez également effectuer bon nombre des actions décrites dans cet article à l’aide de l’API REST de Checkmk. Cela s’avère particulièrement intéressant si vous avez de nombreux objets à gérer sur votre instance et que vous souhaitez automatiser certaines actions. Par exemple, vous pouvez créer de nombreux ordinateurs hôtes à l’aide de l’API REST et éviter ainsi les erreurs potentielles qui peuvent toujours survenir lors de leur saisie manuelle via l’interface graphique.
Si la ligne de commande, les scripts et les API ne font pas partie de vos outils de prédilection, il suffit pour l’instant de savoir que cette API existe. Cela vous offre un outil puissant sur lequel vous pouvez vous appuyer en cas de besoin, comme alternative à la gestion via l’interface web.
Consultez l’article sur l’API REST pour une introduction à l’utilisation de cette API. Vous trouverez la documentation de référence dans l’interface web de votre instance Checkmk. Vous pourrez y vous familiariser avec la syntaxe des requêtes et la structure des réponses. Vous pouvez accéder à toutes les entrées importantes de l’API REST dans l’interface web de Checkmk via la barre de navigation dans le menu «Help > Developer resources».
Enfin, consultez l'article sur l'API REST pour obtenir des exemples expliquant comment effectuer des actions sur des ordinateurs hôtes et des dossiers via la ligne de commande, telles que l'affichage de la structure des dossiers et des ordinateurs hôtes contenus dans un dossier, la création d'un ordinateur hôte dans un dossier spécifique, et bien plus encore.
11. Fichiers et répertoires
| Chemin d'accès au fichier | Fonction |
|---|---|
|
Dans ce répertoire, la structure des dossiers de la Configuration située sous le dossier « Main » est affectée par une structure de sous-répertoires. Si un dossier est créé dans l'interface graphique, un nouveau répertoire est également créé dans le système de fichiers. Ici, Checkmk veille à ce que les noms des répertoires soient uniques et à ce que seuls les caractères autorisés dans le système de fichiers soient utilisés. Par exemple, un espace est remplacé par un trait de soulignement. |
|
Fichier de configuration pour tous les ordinateurs hôtes dans le dossier Main. Pour les ordinateurs hôtes situés dans les sous-dossiers de Main, il existe un fichier portant le même nom dans chaque sous-répertoire. |
|
Ce fichier caché contient le nom d'affichage dans l'interface graphique (Main) ainsi que toutes les autres propriétés de ce répertoire.
Un fichier |