Espressioni regolari in Checkmk

Con le espressioni regolari, si tratta sempre di verificare se un modello corrisponde a un determinato testo (ad es. il nome del servizio). L'esempio di applicazione più semplice è una sequenza di caratteri alfanumerici. Questi (e il segno meno usato come trattino) corrispondono semplicemente a se stessi in un'espressione.

Quando si effettua una ricerca nell'ambiente di monitoraggio, Checkmk di solito non fa distinzione tra maiuscole e minuscole. Nella maggior parte dei casi, l'espressione CPU load corrisponde sia al testo CPU load che a cpu LoAd. La ricerca nell'ambiente di configurazione, invece, di solito fa distinzione tra maiuscole e minuscole. Sono possibili eccezioni giustificate a queste regole, descritte nell'aiuto in linea.

Oltre alle stringhe di caratteri "in chiaro", ci sono diversi caratteri e stringhe che hanno funzioni "magiche". Il carattere più importante è il punto (.). Corrisponde esattamente a qualsiasi singolo carattere arbitrario:

Molto spesso si vorrebbe definire che possa verificarsi una sequenza di caratteri di una certa lunghezza. A questo scopo si specifica il numero di ripetizioni del carattere precedente tra parentesi graffe:

Esistono delle abbreviazioni per le ultime tre condizioni sopra indicate: *corrisponde al carattere precedente un numero qualsiasi di volte, + corrisponde ad almeno un'occorrenza e ? corrisponde al massimo a un'occorrenza.

Puoi anche usare il punto . con gli operatori di ripetizione per cercare una sequenza di caratteri arbitrari in modo più definito:

Le classi di caratteri consentono di corrispondere in determinate sezioni del set di caratteri, ad esempio "qui deve esserci una cifra". Per farlo, metti tutti i caratteri da cercare tra parentesi quadre. Con il segno meno puoi anche specificare intervalli. Nota: si applica la sequenza del set di caratteri ASCII a 7 bit.

Ad esempio, [abc] sta per esattamente uno dei caratteri a, b o c, e [0-9] per qualsiasi cifra — entrambi possono essere combinati. È possibile anche una negazione dell'insieme — con un ^ tra parentesi, [^abc] sta quindi per qualsiasi carattere tranne a, b, c.

Le classi di caratteri possono ovviamente essere combinate con altri operatori. Cominciamo con alcuni esempi astratti:

Ecco alcuni esempi pratici:

In molti casi è necessario distinguere tra corrispondenze all'inizio, alla fine o semplicemente in un punto qualsiasi all'interno di una stringa. Per una corrispondenza all'inizio di una stringa (match inizio parola (prefisso)) usa l'^o (circonflesso), per la fine (match fine parola (suffisso)) usa l'$o (segno del dollaro). Se nessuno di questi operatori è specificato, la maggior parte delle librerie di espressioni regolari usa il match parziale come impostazione predefinita — viene cercato in qualsiasi punto della stringa di caratteri. Per una corrispondenza esatta, usa sia ^ che $.

Nel monitoraggio e nella Console degli Eventi, il match parziale è lo standard. Nel monitoraggio, il match parziale è lo standard. Vengono trovate le espressioni che compaiono in qualsiasi punto del testo, ovvero la ricerca di "memory" trova anche "kernel memory". Nella GUI di Setup, invece, quando si confrontano espressioni regolari con nomi dei servizi e altre cose, Checkmk controlla fondamentalmente se l'espressione corrisponde all'inizio del testo (match inizio parola (prefisso)) — questo è solitamente ciò che stai cercando:

Se hai bisogno di un match parziale in punti in cui è previsto il match inizio parola (prefisso), basta estendere l'espressione regolare con .* all'inizio per trovare qualsiasi stringa prefissata:

Suggerimento: puoi anteporre a qualsiasi ricerca all'inizio di una stringa ^ e a qualsiasi ricerca all'interno di una stringa .* , gli interpreti delle espressioni regolari ignoreranno i simboli ridondanti.

Dato che il punto corrisponde a tutto, ovviamente corrisponde anche a un punto. Se ora vuoi trovare esattamente un punto, devi mascherarlo con una barra rovesciata (\). Questo vale in modo analogo per tutti gli altri caratteri speciali. Questi sono: \ . * + ? { } ( ) [ ] | & ^ e $. Scrivere una barra rovesciata \ fa sì che il carattere speciale che la segue venga trattato come un carattere normale:

Attenzione Python: poiché in Python la barra rovesciata nella rappresentazione interna della stringa viene mascherata internamente con un'altra barra rovesciata, queste due barre rovesciate devono essere mascherate nuovamente, il che porta a un totale di quattro barre rovesciate:

Con la barra verticale | puoi definire delle alternative, ovvero usare un'operazione OR: 1|2|3corrisponde a 1, 2 o 3. Se hai bisogno di tali alternative nel mezzo di un'espressione, raggruppale tra parentesi tonde:

I gruppi di corrispondenza (o gruppi di cattura) svolgono due funzioni: La prima funzione è il raggruppamento di alternative o corrispondenze parziali, come mostrato nell'esempio precedente. Sono possibili anche raggruppamenti annidati. Inoltre, gli operatori di ripetizione *, +, ? e {…​} possono essere utilizzati preceduti da parentesi tonde. Pertanto, l'espressione (/local)?/share corrisponde sia a /local/share che a /share.

La seconda funzione è quella di "catturare" i gruppi di corrispondenza in variabili. Nella Console degli Eventi (EC), nella Business Intelligence (BI), nella ridenominazione massiva degli host e nelle mappature piggyback, c'è la possibilità di utilizzare la parte di testo corrispondente all'espressione regolare nella prima parentesi come \1 , la parte corrispondente alla seconda parentesi come \2 , e così via. L'ultimo esempio nella tabella mostra l'uso delle alternative all'interno di un gruppo di corrispondenza.

L'immagine seguente mostra come rinominare più host in un'unica operazione. Tutti i nomi host che corrispondono all'espressione regolare server-(.*)\.local verranno sostituiti con \1.servers.local. Dove \1 sta esattamente per il testo "catturato" dall'.*e tra parentesi:

Nell'esempio concreto, server-lnx02.local viene quindi convertito in lnx02.servers.local.

Se un gruppo di corrispondenza non deve "catturare" gruppi di caratteri, ad esempio se viene utilizzato solo per strutturare, puoi usare ?: per convertirlo in un gruppo di corrispondenza non catturante (non-capturing match group): (?:/local)?/share.

Con i flag inline, è possibile effettuare impostazioni specifiche relative alla modalità di valutazione all'interno di un'espressione regolare. Il più rilevante per lavorare con Checkmk è (?i), che switcha alla corrispondenza insensibile alle maiuscole/minuscole per le espressioni che altrimenti sarebbero sensibili alle maiuscole/minuscole. In casi molto rari, potresti voler utilizzare anche (?s) e (?m) per lavorare con stringhe su più righe.

Tieni presente che dalla versione 3.11 Python si aspetta che i flag inline siano all'inizio di un'espressione regolare - (?i)somestring — oppure che specifichino l'ambito — (?i:somestring). Dato che Checkmk in alcuni casi combina internamente le espressioni regolari per migliorare la performance, ti consigliamo vivamente di non usare i flag inline all'inizio di un'espressione regolare. Usa invece sempre la notazione con l'ambito — che, in caso di dubbio, si estende all'intera espressione regolare:

(?i:somestring).

Questa è una variante del gruppo di corrispondenza senza cattura.

In particolare, se sono stati copiati e incollati nomi propri nei commenti o nei testi descrittivi, e quindi nel testo compaiono caratteri Unicode o diversi tipi di spazi, le classi estese di Python sono molto utili:

Nei casi in cui Checkmk consente di corrispondere con Unicode, l'\w è particolarmente utile quando si cercano parole con ortografia simile in lingue diverse, ad esempio nomi propri che a volte sono scritti con l'accento e a volte senza.