Création automatisée d’hôtes

Les autorisations nécessaires pour enregistrer l'agent Checkmk auprès du serveur Checkmk (pour le transfert de données crypté TLS) et pour créer des ordinateurs hôtes sont contenues dans le rôle Agent registration user. Les autorisations permettant d'enregistrer de nouveaux ordinateurs hôtes ne sont disponibles dans ce rôle que dans Checkmk Ultimate.

Ce rôle est attribué à l'utilisateur de l'automatisation « agent_registration », qui est configuré sur chaque instance Checkmk et dont les propriétés peuvent être consultées via Setup > Users > Users :

Il est judicieux d'utiliser cet utilisateur de l'automatisation pour l'enregistrement automatique, car il n'est autorisé à effectuer aucune autre action que l'enregistrement d'ordinateurs hôtes.

Les ordinateurs hôtes créés automatiquement doivent être placés dans un nouveau dossier. Vous pouvez également utiliser un dossier existant si vous le configurez comme décrit ci-dessous.

Lancez la création d’un dossier avec Setup > Hosts > Hosts > Add folder. Donnez un nom au nouveau dossier dans la case Basic settings.

La case « Network address » comprend l’option « IP address family ». Si vous souhaitez que les agents Checkmk de l’ordinateur hôte soient configurés pour utiliser le mode Pull, vous pouvez laisser la valeur par défaut « IPv4 only » inchangée. Pour le mode Push, sélectionnez la valeur « No IP ». Cela empêche la vérification de l’accessibilité de l’ordinateur hôte via Smart Ping.

Dans la case de dialogue « Monitoring agents » suivante, vous spécifiez deux options importantes pour l’enregistrement automatique. Avec « Checkmk agent connection mode », vous décidez si l’agent Checkmk doit fonctionner en mode Pull ou (comme dans l’image suivante) en mode Push. Cette option n’est disponible que dans Checkmk Ultimate. Enfin, dans « Bake agent packages », cochez la case à cocher « Bake a generic agent package for this folder ». Cela vous permet d'utiliser la boulangerie d’agents, pour créer une configuration d’agent pour un dossier et tous les ordinateurs hôtes qu’il contient, ainsi que pour tout ordinateur hôte susceptible d’être ajouté à ce dossier à l’avenir.

Terminez la création du dossier en cliquant sur «Save».

La décision concernant les ordinateurs hôtes autorisés à s’enregistrer automatiquement, les noms qui leur sont attribués et ce qui leur arrive après l’enregistrement est prise dans Checkmk — sans surprise — à l’aide de règles. Les étiquettes sous lesquelles l’agent de l’ordinateur hôte s’enregistrera jouent un rôle décisif à cet égard. Mais commençons par le commencement.

Le jeu de règles d'Agent registration n'est disponible que dans Checkmk Ultimate. Vous trouverez l'Agent registration sous Setup > Agents (si le mode Show more est activé) ou en effectuant une recherche dans le menu Setup. Commencez par Add rule la création d'une nouvelle règle et attribuez dans la première case Properties , comme d'habitude avec Checkmk, d'abord un ID et un titre.

Dans la case suivante Matching criteria, vous spécifiez quelles étiquettes doivent être acceptées lorsque le serveur Checkmk reçoit une demande d’enregistrement de la part d’un agent. Ces étiquettes de l’agent sont utilisées exclusivement pour l’enregistrement automatique et sont différentes des étiquettes habituellement utilisées dans Checkmk pour identifier les ordinateurs hôtes et les services. Deux étiquettes de l’agent sont fournies par l’agent Checkmk et peuvent être sélectionnées dans la liste : « cmk/os-family » contient le système d’exploitation de l’ordinateur hôte, qui peut être utilisé, par exemple, pour classer les ordinateurs hôtes dans différents dossiers. « cmk/hostname-simple » contient le nom de domaine de l’ordinateur hôte (d’où simple), qui est destiné à désigner un nom de domaine unique dans Checkmk. Il n'existe pas d'étiquette de l'agent avec un nom de domaine complet (FQDN), car le FQDN n'est pas une propriété de l'ordinateur hôte, mais du réseau. Vous pouvez également saisir vos propres étiquettes à l'adresse Custom label.

La paire clé-valeur séparée par des deux-points qui compose une étiquette (par exemple cmk/os-family:linux) est évaluée séparément. De cette manière, vous pouvez spécifier explicitement qu’une clé (par exemple cmk/os-family) doit exister (Exists), ne doit pas exister (Does not exist) ou n’est acceptée qu’avec une valeur donnée (Equals). Vous pouvez également saisir une expression régulière (Regex) comme valeur. Si vous définissez plusieurs étiquettes de l'agent, celles-ci seront logiquement liées par un ET. Dans l'exemple suivant, outre l'étiquette prédéfinie cmk/hostname-simple, l'étiquette personnalisée my_autoregister_label doit également être checkée :

Dans la case suivante, « Action », vous déterminez ce qui doit se passer lorsque l'évaluation des étiquettes prend effet : créer l'ordinateur hôte ou non. Si vous sélectionnez « Stop and do not create hosts », l'évaluation de la règle est alors terminée et les deux cases suivantes ne sont plus pertinentes. Dans notre exemple, cependant, des ordinateurs hôtes doivent être créés :

Dans la case « Host name computation », vous spécifiez maintenant le nom que l’ordinateur hôte doit recevoir. Dans la case « Host name template », saisissez le modèle. Vous pouvez ici utiliser des macros pour lire les valeurs réelles à partir des étiquettes de l’agent que vous avez sélectionnées dans la case « Matching criteria » ci-dessus — avec « $cmk/hostname-simple$ », par exemple, le nom de domaine simple fourni par l’agent Checkmk. Vous pouvez ensuite modifier le modèle, si vous le souhaitez, en convertissant les caractères en minuscules ou en majuscules, et en effectuant des substitutions à l’aide d’expressions régulières et de noms de domaine explicites. Il s’agit d’ailleurs des mêmes options que celles disponibles pour la personnalisation des noms des hôtes ferroutés. Vous trouverez également plus d’informations dans l’aide en ligne.

Enfin, dans la case « Host creation », sélectionnez le dossier prédéfini dans lequel les nouveaux ordinateurs hôtes doivent être placés. De plus, vous pouvez spécifier les attributs à attribuer à l’ordinateur hôte. Vous trouverez plus d’informations sur ces attributs dans l’article consacré à l’administration des ordinateurs hôtes.

Après avoir enregistré la règle, revenez à la page « Agent registration ». Vous y trouverez l’Agent labels simulator. Si vous avez défini de nombreuses règles, le simulateur vous aidera à en garder une trace. Vous pouvez saisir des étiquettes de l'agent et, à l’aide de l’Try out, simuler si et quelle règle s’applique lorsqu’une étiquette de l'agent est envoyée. Les résultats vous montreront les symboles de feux tricolores, comme décrit dans l’article sur les règles.

Après avoir configuré l’instance Checkmk dans la section précédente, nous allons maintenant nous intéresser au Checkmk Agent Controller. Pour cela, vous utilisez l’ensemble de règles « Agent controller auto-registration » dans la boulangerie d’agents, qui n’est disponible que dans Checkmk Ultimate. Vous trouverez cet ensemble de règles dans la boulangerie d’agents sous « Agent rules » ; le moyen le plus rapide consiste toutefois à le rechercher dans le menu « Setup ». Créez une nouvelle règle.

Dans la zone « Agent controller auto-registration », fournissez à l’Agent Controller toutes les informations dont il a besoin pour envoyer une demande d’enregistrement à l’Agent Receiver : le serveur Checkmk (Monitoring server address), le cas échéant, le numéro de port de l’Agent Receiver (Agent receiver port), l’utilisateur de l’automatisation pour l’enregistrement automatique (Authorization) et le site Checkmk (Site to register with) chargé de surveiller l’ordinateur hôte. Dans le cadre d’une supervision distribuée, il s’agira généralement d’une instance distante.

Vous pouvez également définir vos propres étiquettes ici, à l'option « Additional agent labels to send during registration ». Pour que l'enregistrement automatique fonctionne, ces étiquettes doivent correspondre à celles que vous avez saisies sous « Custom label » dans la règle de l'instance Checkmk : dans l'exemple, l'étiquette personnalisée créée précédemment avec la clé « my_autoregister_label ».

Avec l'option finale « Keep existing connections », vous déterminez si l'Agent Controller doit supprimer (no) ou conserver (yes) les connexions déjà existantes. Si vous avez configuré des connexions manuelles vers d'autres instances Checkmk en plus de l'enregistrement automatique d'une connexion, et que vous souhaitez les conserver même après un redémarrage de l'Agent Controller cmk-agent-ctl , vous devez définir cette option sur « yes ».

Important : pour la dernière case de cette règle, Conditions, sélectionnez à nouveau le dossier prédéfini Folder.

Poursuivez maintenant dans la boulangerie d’agents avec Setup > Agents > Windows, Linux, Solaris, AIX. Cliquez sur et générez vous-même un nouvel agent. En conséquence, en plus de la configuration de l’agent Vanilla (factory settings), vous obtiendrez une nouvelle ligne pour la configuration dans laquelle la règle créée dans la section précédente a été intégrée :

Le paquet de l’agent doit maintenant être installé sur chaque ordinateur hôte devant démarrer l’enregistrement automatique. Téléchargez le paquet de l’agent adapté au système d’exploitation de l’ordinateur hôte et installez-le sur l’ordinateur hôte. La procédure est la même que d’habitude dans la boulangerie d’agents. Pour en savoir plus, consultez les articles sur les agents de supervision, l’agent Linux et l’agent Windows.

Après l'installation du paquet d'agent, l'Agent Controller évalue le fichier d'pre_configured_connections.jsons sur l'ordinateur hôte et émet l'instruction d'enregistrement pour une connexion qu'il contient. Si l'Agent Receiver accepte cette instruction, la connexion sera établie et l'ordinateur hôte créé dans l'instance Checkmk.

Une reconnaissance du service est alors effectuée et les modifications activées, afin que l’ordinateur hôte soit également visible dans la supervision. Notez que lors de l’activation automatique, toutes les autres modifications accumulées — y compris celles provenant d’autres utilisateurs — seront également activées.

Ce processus peut prendre plusieurs minutes (jusqu’à 5) entre l’installation du paquet de l’agent et l’apparition de l’ordinateur hôte dans la supervision. Vous pouvez suivre les différentes étapes de ce processus dans Setup > General > Audit log après avoir sélectionné le fichier « wato_audit.log ».

Sur l’ordinateur hôte, vous pouvez utiliser une instruction pour afficher l’état de connexion de l’Agent Controller, qui se présente comme suit après un enregistrement réussi en mode Push :

Les ordinateurs hôtes créés automatiquement peuvent également être supprimés automatiquement. Checkmk Ultimate fournit ainsi les deux composants les plus importants pour le lifecycle management des ordinateurs hôtes. À noter que la suppression automatique fonctionne également pour les ordinateurs hôtes créés manuellement — et dans toutes les éditions.