Reguläre Ausdrücke in Checkmk

Bei den regulären Ausdrücken geht es immer darum, ob ein Muster (der Ausdruck) auf einen bestimmten Text (z.B. einen Servicenamen) passt (matcht). Dabei darf das Muster eine Reihe von Sonderzeichen enthalten, welche dann „magische“ Bedeutungen haben. Alle normalen Zeichen im Ausdruck matchen einfach sich selbst.

Checkmk unterscheidet dabei nicht zwischen Groß- und Kleinschreibung. Der Ausdruck CPU load matcht also auf den Text CPU load genauso wie auf cpu LoAd. Achtung: Bei Eingabefeldern, wo ohne reguläre Ausdrücke ein exakter Match vorgesehen ist (meistens bei Hostnamen), wird Groß und Klein immer unterschieden!

Das wichtigste Sonderzeichen ist der . Punkt. Er matcht ein beliebiges Zeichen:

Beispiel:

Da der Punkt alles matcht, matcht er natürlich auch einen Punkt. Wenn Sie nun aber genau einen Punkt matchen wollen, so müssen Sie diesen mit einem \ Backslash maskieren (eingedeutscht: „escapen“). Das gilt analog auch für alle anderen Sonderzeichen, die Sie noch kennenlernen werden. Dies sind: \ . * + ? { } ( ) [ ] | & ^ und $. Der \ Backslash wertet das nächste Sonderzeichen als normales Zeichen:

Sehr oft möchte man definieren, dass irgendwo im Ausdruck eine beliebige Folge von Zeichen vorkommen darf. In Regexen schreiben Sie das mit .* (Punkt Stern). Eigentlich ist das aber nur ein Spezialfall. Denn Sie können den Stern einem beliebigen Zeichen nachstellen, welches dann im Suchtext beliebig oft hintereinander vorkommen darf. Dabei gilt auch eine leere Folge als Folge. Das heißt, .* matcht eine beliebige Zeichenfolge und * matcht das vorherige Zeichen beliebig oft:

Das + ist fast das Gleiche wie *, erlaubt aber keine leere Folge. Das vorangestellte Zeichen muss also mindestens einmal vorkommen:

Möchten Sie die Anzahl von Wiederholungen genauer festlegen, so gibt es dafür eine Syntax mit geschweiften Klammern, die die exakte Anzahl oder einen Bereich angibt:

Eine Abkürzung für {0,1}, also ein- oder keinmaliges Vorkommen, ist das Fragezeichen. Es markiert das vorangegangene Zeichen somit als optional:

Zeichenklassen erlauben Dinge wie „hier muss eine Ziffer kommen“. Dazu setzen Sie in eckige Klammern alle erlaubten Zeichen. Mit einem Minuszeichen können Sie auch Bereiche angeben. Achtung: Es gilt dabei die Reihenfolge im ASCII-Zeichensatz.

So steht beispielsweise [abc] für genau eines der Zeichen a, b oder c und [0-9] für eine beliebige Ziffer - beides lässt sich kombinieren. Auch eine Negation des Ganzen ist möglich: Mit einem ^ in der Klammer steht [^abc] dann für ein beliebiges Zeichen außer a, b, c.

Zeichnklassen lassen sich natürlich mit anderen Operatoren kombinieren. Zunächst mal einige abstrakte Beispiele:

Dazu einige praktische Beispiele:

Achtung: Wenn Sie eines der beiden Zeichen - oder ] brauchen, müssen Sie etwas tricksen. Den - schreiben Sie einfach direkt ans Ende der Klasse — _ wie in obigen Beispielen bereits gezeigt. Dann ist dem Regexauswerter klar, dass es keine Folge sein kann. Und die eckige Klammer platzieren Sie als _erstes Zeichen in der Klasse. Da keine leeren Klassen erlaubt sind, wird das dann als normales Zeichen gewertet. Eine Klasse mit genau diesen beiden Sonderzeichen sähe also so aus: []-].

Checkmk prüft beim Vergleichen von regulären Ausdrücken mit Servicenamen und anderen Dingen grundsätzlich, ob der Text mit dem Anfang des Ausdrucks übereinstimmt. Der Grund dafür ist, dass das meistens das ist, was Sie brauchen. Eine Regel, in der Sie bei Services die Begriffe CPU und Kernel angeben, matcht also auf alle Services, die mit einem dieser Begriffe beginnen:

Das bezeichnet man auch als Präfixmatch. Benötigen Sie einen exakten Match, so können Sie das durch Anhängen eines $ bewerkstelligen. Dieser matcht quasi auf das Ende des Texts. Genügt es, wenn der Ausdruck irgendwo im Text matcht, ein sogenannter Infixmatch, erreichen Sie das mit dem bekannten .* vorab:

Eine Ausnahme von der Regel, dass Checkmk immer einen Präfixmatch verwendet, ist die Event Console (EC), welche immer mit einem Infixmatch arbeitet — also nur auf Enthaltensein prüft. Hier können Sie durch Voranstellen von ^ ein Match für den Anfang erzwingen, also einen Präfixmatch.

Mit dem | senkrechten Balken können Sie Alternativen definieren, sprich eine ODER-Verküpfung verwenden: 1|2|3 matcht also auf 1, 2 oder 3. Wenn Sie die Alternativen inmitten eines Ausdrucks benötigen, setzen Sie diese in runde Klammern.

In der Event Console, im Business Intelligence (BI) und auch beim Massenumbenennen von Hosts besteht die Möglichkeit, dass Sie sich auf Textteile beziehen, die im Ursprungstext gefunden wurden. Dabei werden Muster in regulären Ausdrücken mit Klammern markiert. Der Textteil, der auf den ersten Klammerausdruck passt, steht dann beim Ersetzen als \1 zur Verfügung, der zweite Ausdruck als \2 usw.

Folgende Abbildung zeigt eine solche Umbenennung. Alle Hostnamen, die auf den regulären Ausdruck server-(.*)\.local passen, werden durch \1.servers.local ersetzt. Dabei steht das \1 genau für den Text, der mit dem .* in der Klammer „eingefangen“ wurde:

Im konkreten Fall wird also server-lnx02.local in lnx02.servers.local umbenannt.

Sie können Gruppen natürlich auch mit den Operatoren für Wiederholungen, *, +, ? und {…​} kombinieren. So passt etwa der Ausdruck (/local)?/share sowohl auf /local/share als auch auf /share.