Expressions régulières dans Checkmk

Avec les expressions régulières, il s’agit toujours de déterminer si un motif saisit un texte donné (par exemple, le nom du service). L’exemple d’application le plus simple est une chaîne de caractères alphanumériques. Ces caractères (ainsi que le signe moins utilisé comme trait d’union) saisissent simplement eux-mêmes dans une expression.

Lors d’une recherche dans l’environnement de supervision, Checkmk ne fait généralement pas la distinction entre majuscules et minuscules. Dans la plupart des cas, l’expression CPU load saisit aussi bien le texte CPU load que cpu LoAd. En revanche, la recherche dans l’environnement de configuration tient généralement compte de la casse. Des exceptions justifiées à ces règles sont possibles et sont décrites dans l’aide en ligne.

Outre les chaînes de caractères « en texte brut », il existe un certain nombre de caractères et de chaînes de caractères dotés de fonctions « magiques ». Le caractère le plus important parmi ceux-ci est le point (.). Il saisit exactement n’importe quel caractère unique :

On souhaite très souvent définir qu’une séquence de caractères d’une certaine longueur puisse apparaître. À cette fin, on spécifie le nombre de répétitions du caractère précédent entre accolades :

Il existe des abréviations pour les trois dernières conditions ci-dessus : « *» saisit le caractère précédent un nombre indéfini de fois, « + » saisit au moins une occurrence et « ? » saisit au plus une occurrence.

Vous pouvez également utiliser l'.e du point avec les opérateurs de répétition pour rechercher une séquence de caractères arbitraires de manière plus précise :

Les classes de caractères permettent de saisir certaines sections du jeu de caractères, par exemple « il doit y avoir un chiffre ici ». Pour ce faire, placez tous les caractères à saisir entre crochets. À l'aide d'un signe moins, vous pouvez également spécifier des plages. Remarque : la séquence du jeu de caractères ASCII 7 bits s'applique.

Par exemple, [abc] représente exactement l’un des caractères a, b ou c, et [0-9] représente n’importe quel chiffre — les deux peuvent être combinés. Une négation de l’ensemble est également possible — avec un signe « - » entre parenthèses, [^abc] représente alors n’importe quel caractère sauf a, b, c.

Les classes de caractères peuvent bien sûr être combinées avec d’autres opérateurs. Commençons par quelques exemples abstraits :

Voici quelques exemples concrets :

Dans de nombreux cas, il est nécessaire de distinguer les correspondances au début, à la fin ou simplement quelque part au sein d’une chaîne. Pour une correspondance au début d’une chaîne (correspondance de préfixe), utilisez l’^ (accent circonflexe) ; pour la fin (correspondance de suffixe), utilisez l’$ (signe dollar). Si aucun de ces opérateurs n’est spécifié, la plupart des bibliothèques d’expressions régulières utilisent la correspondance d’infixe par défaut — la recherche s’effectue n’importe où dans la chaîne de caractères. Pour des correspondances exactes, utilisez à la fois ^ et $.

Dans la supervision et l'Event Console, la correspondance d'infixe est la norme. Dans la supervision, la correspondance d'infixe est la norme. Les expressions apparaissant n'importe où dans le texte sont trouvées ; par exemple, la recherche de « memory » trouve également « kernel memory ». Dans l'interface graphique de configuration, en revanche, lors de la comparaison d'expressions régulières avec les noms des services et d'autres éléments, Checkmk vérifie essentiellement si l'expression correspond au début du texte (correspondance de préfixe) — c'est généralement ce que vous recherchez :

Si vous avez besoin d’une correspondance d’infixe là où la correspondance de préfixe est proposée, il vous suffit d’étendre votre expression régulière en ajoutant «.*» au début pour qu’elle saisisse n’importe quelle chaîne préfixée :

Astuce : vous pouvez faire précéder toute recherche au début d’une chaîne par ^ et toute recherche au sein d’une chaîne par .*, les interpréteurs d’expressions régulières ignoreront les symboles redondants.

Étant donné que le point correspond à tout, il correspond naturellement aussi à un point. Si vous souhaitez désormais faire correspondre exactement un point, vous devez le masquer avec un \ (barre oblique inversée). Cela s'applique de manière analogue à tous les autres caractères spéciaux. Il s'agit de : \ . * + ? { } ( ) [ ] | & ^ et $. Le codage d'une barre oblique inversée \ a pour effet que le caractère spécial qui la suit est traité comme un caractère normal :

Attention Python : Étant donné qu'en Python, la barre oblique inversée dans la représentation interne de la chaîne est masquée en interne par une autre barre oblique inversée, ces deux barres obliques inversées doivent être masquées à nouveau, ce qui conduit à un total de quatre barres obliques inversées :

Avec la barre verticale |, vous pouvez définir des alternatives, c'est-à-dire utiliser un opérateur OU : 1|2|3saisit 1, 2 ou 3. Si vous avez besoin de telles alternatives au milieu d'une expression, regroupez-les entre parenthèses :

Les groupes de correspondance (ou groupes de capture) remplissent deux fonctions : La première fonction consiste à regrouper des alternatives ou des correspondances partielles, comme le montre l'exemple précédent. Des regroupements imbriqués sont également possibles. De plus, les opérateurs de répétition *, +, ? et {…​} peuvent être utilisés précédés de parenthèses. Ainsi, l'expression (/local)?/share correspond à la fois à /local/share et à /share.

La deuxième fonction consiste à « capturer » les groupes de correspondance de caractères dans des variables. Dans l’ Event Console (EC), l’informatique décisionnelle (BI), lors du renommage en masse d’ordinateurs hôtes et dans les affectations de ferroutage, il est possible d’utiliser la partie de texte correspondant à l’expression régulière dans la première parenthèse comme \1 , la partie correspondant à la deuxième parenthèse comme \2 , et ainsi de suite. Le dernier exemple du tableau illustre l'utilisation d'alternatives au sein d'un groupe de correspondance.

L'image suivante illustre un tel renommage de plusieurs ordinateurs hôtes en une seule opération. Tous les noms de domaine correspondant à l'expression régulière server-(.*)\.local seront remplacés par \1.servers.local. Où l'\1e correspond exactement au texte « capturé » par l'.*e entre parenthèses :

Dans l'exemple concret, server-lnx02.local est donc converti en lnx02.servers.local.

Si un groupe de correspondance n'est pas censé « capturer » des groupes de caractères, par exemple s'il est uniquement utilisé à des fins de structuration, ?: peut être utilisé pour le convertir en un groupe de correspondance sans capture (non-capturing match group) : (?:/local)?/share.

Les indicateurs en ligne permettent de définir des paramètres spécifiques concernant le mode d’évaluation au sein d’une expression régulière. Le plus pertinent pour l’utilisation de Checkmk est (?i), qui active la correspondance insensible à la casse pour les expressions qui, autrement, seraient sensibles à la casse. Dans de très rares cas, vous souhaiterez également utiliser (?s) et (?m) pour travailler avec des chaînes multilignes.

Notez que depuis la version 3.11, Python attend des indicateurs en ligne soit au début d'une expression régulière — (?i)somestring — soit en spécifiant la portée — (?i:somestring). Étant donné que Checkmk combine dans certains cas les expressions régulières en interne pour améliorer les performances, nous vous recommandons vivement de ne pas utiliser d'indicateurs en ligne au début d'une expression régulière. Utilisez plutôt toujours la notation avec la portée — qui, en cas de doute, s'étend à l'ensemble de l'expression régulière :

(?i:somestring).

Il s'agit d'une variante du groupe de correspondance sans capture.

En particulier, si des noms propres dans des commentaires ou des textes descriptifs ont été copiés-collés, et que par conséquent des caractères Unicode ou différents types d’espaces apparaissent dans le texte, les classes étendues de Python sont très utiles :

Dans les cas où Checkmk autorise la saisie Unicode, l'\w est particulièrement utile pour rechercher des mots s'écrivant de manière similaire dans différentes langues, par exemple des noms propres qui s'écrivent parfois avec et parfois sans accent.