Étiquettes

Il existe plusieurs façons d'attribuer des étiquettes à un ordinateur hôte.

La première méthode est simple : Sur la page des propriétés de l'hôte, qui s'affiche lorsque vous créez ou modifiez un hôte dans la Configuration, vous pouvez attribuer à un hôte autant d'étiquettes que vous le souhaitez :

Cochez la case à cocher « Activer l'Labels », puis cliquez dans le champ « Add some label », saisissez la définition de l'étiquette en respectant le format key:value et terminez en appuyant sur Entrée.

Vous pouvez modifier une étiquette existante en cliquant sur son texte, ou la supprimer à l'aide du petit « x ».

Bien entendu, les étiquettes peuvent également être héritées d’un dossier. À l’instar d’autres attributs, les étiquettes peuvent se trouver dans des sous-dossiers ou au niveau de l’ordinateur hôte, puis être réécrites si nécessaire — individuellement, en fait. Si, par exemple, l’étiquette location:munich est définie dans le dossier, celle-ci sera héritée par tous les ordinateurs hôtes de ce dossier qui ne possèdent pas déjà l’étiquette location définie. Les autres étiquettes qu’un ordinateur hôte peut posséder ne seront pas affectées.

Les étiquettes définies explicitement pour les ordinateurs hôtes ou les dossiers apparaissent en violet dans la liste des ordinateurs hôtes :

Comme d’habitude dans Checkmk, des attributs peuvent également être attribués aux hôtes et aux services par le biais de règles. Cela vous rendra indépendant de la structure des dossiers, et cela s’applique également aux étiquettes. Il existe un jeu de règles Host labels pour cette fonction, que vous pouvez trouver rapidement via une recherche dans le menu de configuration.

La règle suivante ajoute l'étiquette « hw:real » à tous les ordinateurs hôtes du dossier « Bavaria » qui possèdent la balise de l’hôte « Real Hardware » :

Vous avez peut-être remarqué que les étiquettes ne peuvent pas être utilisées dans les conditions de cette règle. Il ne s'agit pas d'une erreur, mais d'un choix délibéré, qui permet d'éviter les dépendances récursives et d'autres anomalies.

Les étiquettes ajoutées via des règles apparaissent en rouge sur l'ordinateur hôte concerné, mais n'apparaissent pas dans la liste des ordinateurs hôtes de la Configuration ; elles n'apparaissent qu'avec la vue d'état de l'ordinateur hôte.

La troisième façon de créer des étiquettes est entièrement automatique. Diverses sources de données, telles que les agents spéciaux pour la supervision des systèmes cloud et des conteneurs, génèrent automatiquement des étiquettes. Il convient notamment de mentionner ici les agents spéciaux pour AWS, Azure et Kubernetes. Ces éléments sont parfois également appelés « balises » sur les plateformes respectives et sont créés dans Checkmk en tant qu’étiquettes d’hôte ou de service. Les jeux de règles correspondants fournissent des informations suffisantes à ce sujet.

L'avantage est que vous n'avez absolument rien à configurer. Dès que ces sources de données sont actives, les étiquettes correspondantes sont générées.

Dans la section Étiquettes d'hôte générées automatiquement, vous trouverez un aperçu des étiquettes que Checkmk génère automatiquement.

Un moyen simple de manipuler directement les étiquettes consiste à ajouter un plugin d’agent qui, à l’instar des checks locaux, crée une section intitulée «labels». De cette manière, vous pouvez attribuer des étiquettes de manière plus détaillée qu’en évaluant uniquement l’inventaire matériel/logiciel — par exemple, en fonction des nuances du matériel installé (telles que les caractéristiques du processeur), ou en fonction des processus réellement en cours d’exécution (plutôt que simplement des logiciels installés).

La sortie des étiquettes doit être formatée sous la forme d’un dictionnaire Python, comme dans l’exemple suivant :

Évitez les conflits avec les étiquettes attribuées automatiquement par Checkmk lui-même et par d’autres plugins, car aucun ordre d’évaluation particulier ne peut être garanti.

Si vous avez activé le contrôle d’identification — ce qui est le cas par défaut pour les nouvelles installations —, celui-ci vous avertira lorsque de nouvelles étiquettes d’hôte seront détectées et n’auront pas encore été ajoutées aux propriétés de l’hôte dans la Configuration. Cela ressemblera par exemple à ceci :

Vous disposez de deux options pour répondre à cet avertissement. La première consiste à ajouter les nouvelles étiquettes en appelant la configuration du service pour l’ordinateur hôte dans la configuration et en mettant à jour la configuration des étiquettes via l’entrée « Hosts > Update host labels » du menu de configuration. Le contrôle de découverte sera alors à nouveau en mode « OK » lors de sa prochaine exécution (avec un délai pouvant aller jusqu’à deux heures), même si vous n’avez pas encore activé les modifications. Si vous ne souhaitez pas attendre aussi longtemps, vous pouvez également mettre à jour manuellement le service immédiatement en sélectionnant « Reschedule check » dans le menu d'action du service.

Si cela concerne plusieurs ordinateurs hôtes à la fois, vous ne souhaiterez certainement pas accéder à la configuration du service pour chaque ordinateur hôte. La meilleure solution consiste alors à exécuter l’action Bulk « Run bulk service discovery » et à sélectionner « Only discover new host labels » comme mode — ou bien « Add unmonitored services and new host labels » si vous souhaitez également profiter de l’occasion pour ajouter de nouveaux services.

La deuxième façon de faire passer le check d’identification au vert consiste à le reconfigurer afin qu’il ne vous avertisse plus de la présence de nouvelles étiquettes. Pour ce faire, accédez au jeu de règles « Periodic service discovery » et modifiez la règle existante — vous y trouverez l’option « Severity of new host labels » :

Cette option est définie par défaut sur « Warning ». Sélectionnez « OK - do not alert, just display » et le check ne s'affichera plus.

Les étiquettes détectées lors de la check-list d’identification s’affichent en jaune-ocre.

En théorie, une même étiquette peut être définie avec des valeurs différentes dans plusieurs sources simultanément. C'est pourquoi l'ordre de priorité suivant s'applique :

Ces règles de priorité vous offrent un contrôle total sur les étiquettes.

Une fonction importante des étiquettes est identique à celle des caractéristiques d'hôte : à savoir, leur utilisation comme condition dans les règles. Ceci est particulièrement utile pour les étiquettes générées automatiquement, car vous pouvez adapter votre supervision de manière entièrement automatique en fonction des informations provenant d'AWS, d'Azure, de Kubernetes et autres.

Ajoutez des conditions avec Add to condition pour les étiquettes d'hôte ou de service. Sélectionnez ensuite soit is soit not pour formuler une condition positive ou négative, puis saisissez l'étiquette sous la forme habituelle key:value. Veillez à respecter l'orthographe exacte, y compris les majuscules. Comme les étiquettes peuvent être définies sans spécifications, Checkmk ne peut pas détecter les fautes de frappe. Néanmoins : lorsque vous saisissez une étiquette, Checkmk vous propose des étiquettes existantes si elles correspondent à votre saisie précédente. Aucune distinction n'est faite entre les étiquettes d'hôte et de service dans les suggestions : toutes les étiquettes correspondantes sont proposées. Veillez à respecter l'orthographe, car les fautes de frappe, les majuscules incorrectes, etc. entraîneront le dysfonctionnement de la règle.

Cependant, la définition de la condition va encore plus loin : Pour affiner davantage la condition, vous disposez également des opérateurs booléens Not, And et Or. Ici, Not est l'abréviation de « And Not ».

Par exemple, pour trouver les ordinateurs hôtes portant l'étiquette cmk/site:today mais ne portant pas l'étiquette cmk/piggyback_source_today:yes, la condition pourrait se présenter ainsi :

Vous pouvez affiner cette condition avec is ou not en y ajoutant d’autres spécifications. Vous pouvez également ajouter un nouveau groupe de conditions avec Add to condition, ce qui rend la condition désormais plus complexe plus facile à lire, sans pour autant modifier l’évaluation de l’algèbre booléenne :

Vous pouvez utiliser à la fois des étiquettes et des balises de l’hôte dans une règle. Celles-ci sont automatiquement liées par un opérateur ET. La règle ne s'applique donc que si les deux conditions sont remplies simultanément.

Vous pouvez également utiliser des étiquettes comme conditions dans les règles de notification. Leur utilisation est identique à celle des autres conditions ; vous n’avez donc pas besoin de vous familiariser à nouveau avec leur utilisation. Sélectionnez « Match host labels » (Conditions de notification) et indiquez simplement les étiquettes qu’un ordinateur hôte ou un service doit posséder pour déclencher une notification via cette règle. Là encore, les étiquettes multiples sont reliées par l’opération « ET ».