Checkmk
to checkmk.com
Important

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

Dans Checkmk, vous pouvez enregistrer des notes personnalisées pour tous les ordinateurs hôtes et services, de manière individuelle et spécifique, ou pour des groupes entiers. Ces notes s’affichent dans des colonnes distinctes intitulées « Custom services notes » et « Custom host notes ». Par défaut, ces colonnes s’affichent déjà dans les vues détaillées des ordinateurs hôtes (Status of Host myhost) et des services (Service myservice, myhost). Comme il s’agit de colonnes standard, elles peuvent également être insérées dans de nombreuses autres vues de Checkmk.

2. Création de notes

Les notes peuvent être créées directement dans le répertoire de configuration de votre instance Checkmk. Pour ce faire, créez d'abord le répertoire « notes » dans « ~/etc/check_mk/ ».

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

2.1. Notes d'hôte

Pour créer ensuite des notes pour les ordinateurs hôtes, créez le répertoire hosts dans le répertoire notes.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/hosts
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

Si vous souhaitez maintenant créer une note pour un ordinateur hôte spécifique, créez un fichier dont le nom correspond exactement au nom de cet ordinateur hôte dans Checkmk. Utilisez l'éditeur de votre choix ou la redirection de shell, comme dans l'exemple suivant :

OMD[mysite]:~$ echo "My custom host note for myhost" > ~/etc/check_mk/notes/hosts/myhost
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

Située tout en bas de la vue de la table «Status of Host», cette note se présentera comme suit :

A note in the 'Status of Host' view.

Si vous souhaitez qu’un seul fichier de ce type fasse référence à plusieurs ordinateurs hôtes et s’affiche simultanément sur ceux-ci, vous pouvez utiliser des motifs de shell tels que l’astérisque, le point d’interrogation, ainsi que des classes de caractères. Pour ce faire, le nom du fichier dans le répertoire correspondant doit effectivement contenir ces caractères. Ainsi, un fichier nommé « '*' » dans le répertoire « ~/etc/check_notes/hosts/ » ferait référence à tous les ordinateurs hôtes. Le contenu du fichier « '*' » s’afficherait alors sur chaque ordinateur hôte individuel de votre instance.

Important : les noms de ces fichiers doivent être placés entre guillemets simples.

Si, pour une raison quelconque, vous souhaitez afficher une note spécifique sur tous les ordinateurs hôtes dont le nom se termine par t, créez alors un fichier nommé '*t'.

OMD[mysite]:~$ echo "The name auf this host ends with t" > ~/etc/check_mk/notes/hosts/'*t'
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

Si plusieurs fichiers correspondent au nom d'un ordinateur hôte, le champ Custom host notes affichera également toutes les notes correspondantes. Les différentes notes sont séparées par une ligne horizontale :

Notes from different source files are separated by a horizontal line.

2.2. Notes de service

Pour pouvoir créer de telles notes pour les services également, vous aurez besoin du répertoire « services » dans « ~/etc/check_mk/notes/ ».

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

Contrairement aux ordinateurs hôtes, vous ne pouvez pas commencer directement dans ce répertoire avec les fichiers de vos notes. Ici, vous avez besoin d’un niveau de répertoire supplémentaire, qui définit pour quels ordinateurs hôtes une note de service doit s’afficher.

Créez donc ensuite un répertoire qui désigne un ordinateur hôte — ou, en suivant les modèles indiqués ci-dessus — plusieurs ordinateurs hôtes.

Ainsi, un répertoire nommé « '*' » ferait à nouveau référence à tous les ordinateurs hôtes.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'*'
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

Dans un répertoire correspondant exactement au nom de domaine, vous pouvez alors créer des notes uniquement pour les services de cet ordinateur hôte.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/myhost
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

Ainsi, si vous souhaitez créer des notes pour les services de tous les ordinateurs hôtes commençant par my, vous devrez créer un répertoire nommé 'my*'.

OMD[mysite]:~$ mkdir ~/etc/check_mk/notes/services/'my*'
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

Veillez à nouveau à placer les noms de répertoires entre guillemets simples.

Une fois que vous avez créé le niveau d'ordinateur hôte conformément à vos besoins, vous pouvez — de la même manière que pour les notes d'ordinateur hôte — créer à nouveau des fichiers, qui doivent cette fois correspondre à l'Service description souhaitée. De même, vous pouvez utiliser des astérisques, des points d'interrogation et des classes de caractères.

L'exemple suivant crée une note pour le service Check_MK sur chacun des ordinateurs hôtes de votre instance.

OMD[mysite]:~$ echo "Note about service Check_MK for all hosts" > ~/etc/check_mk/notes/services/'*'/Check_MK
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

3. Macros pouvant être utilisées

Dans les notes, vous pouvez utiliser des macros, qui seront ensuite remplacées de manière appropriée dans la vue de la table. Les macros suivantes sont disponibles ici :

$HOSTNAME$

Nom de domaine

$HOSTNAME_LOWER$

Nom de domaine en minuscules

$HOSTNAME_UPPER$

Nom de domaine en majuscules

$HOSTNAME_TITLE$

Nom de domaine avec la première lettre en majuscule et le reste en minuscules

$HOSTADDRESS$

L'adresse IP de l'ordinateur hôte sur lequel la supervision est effectuée.

$SERVICEDESC$

Description du service (uniquement pour les notes de service)

$SITE$

ID de l'instance Checkmk

$URL_PREFIX$

Préfixe URL de l'instance

$HOSTOUTPUT$

Résultat du plugin de supervision (pour les notes d'ordinateur hôte uniquement)

$SERVICEOUTPUT$

Sortie du plugin de supervision (pour les notes de service uniquement)

Par exemple, vous pourriez utiliser un seul fichier pour faire référence à différentes entrées de votre wiki interne, chacune saisissant toujours l'ordinateur hôte actuellement ouvert.

~/etc/check_mk/notes/ordinateurs hôtes/'*'
Additional information about <a href="http://mywiki.local/page.php?host=$HOSTNAME$" target="_blank">this host in our wiki</a>

Last modified: Tue, 02 Sep 2025 13:03:55 GMT via commit eb27aea06
Sur cette page