Espressioni regolari in Checkmk

Con le espressioni regolari si tratta sempre di stabilire se un modello corrisponde a un determinato testo (ad es. il nome del servizio). L'esempio di applicazione più semplice è una catena 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 al testo CPU load così come a cpu LoAd. Laricerca nell'ambiente di configurazione, invece, di solito fa distinzione tra maiuscole e minuscole. Sono possibili eccezioni giustificate a questi standard, descritte nell'aiuto inline.

Attenzione: Nei campi di input senza espressione regolare in cui è specificata una corrispondenza esatta (soprattutto per i nomi host), le maiuscole e le minuscole sono sempre distinte!

Oltre alle stringhe di caratteri del "testo normale", esistono diversi caratteri e stringhe di caratteri che hanno funzioni "magiche". Il carattere più importante è . (punto) checorrisponde esattamente a qualsiasi carattere arbitrario:

Molto spesso si desidera definire la possibilità di ripetere una sequenza di caratteri di una certa lunghezza. A questo scopo si specifica il numero di ripetizioni del carattere precedente tra parentesi graffe:

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

Puoi anche utilizzare la periodicità . con gli operatori di ripetizione per cercare una sequenza di caratteri arbitrari in modo più definito:

Le classi di caratteri permettono di abbinare determinate sezioni del set di caratteri, ad esempio "deve arrivare una cifra". Per farlo, inserisci tutti i caratteri da abbinare tra parentesi quadre. Con il segno meno puoi anche specificare degli intervalli.Nota: si applica la sequenza del set di caratteri ASCII a 7 bit.

Ad esempio, [abc] indica esattamente uno dei caratteri a, b o c, mentre [0-9] indica qualsiasi cifra; entrambi possono essere combinati. È possibile anche la negazione dell'insieme: con ^ tra le parentesi, [^abc] indica qualsiasi carattere eccetto a, b, c.

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

Ecco alcuni esempi pratici:

Nota: se hai bisogno di uno dei caratteri -, [ o ], dovrai usare un trucco. Scrivi - (segno meno) alla fine della classe- come già mostrato nell'esempio precedente. Quando si valutano le espressioni regolari, il segno meno, se non si trova in mezzo a tre caratteri, non viene valutato come operatore, ma esattamente come questo carattere. Se necessario, inserisci una parentesi quadra di chiusura come primo carattere della classe e una parentesi di apertura come secondo carattere. Poiché non sono ammesse classi vuote, la parentesi quadra di chiusura viene interpretata come un carattere normale. Una classe con questi caratteri speciali avrebbe il seguente aspetto: []-], o rispettivamente [][-] se è necessaria anche la parentesi quadra di apertura.

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

Nota: nel monitoraggio e nella Console degli Eventi, la corrispondenza infix è lo standard. Le espressioni che si verificano in qualsiasi punto del testo vengono trovate, ad esempio la ricerca di "memoria" trova anche "memoria del kernel". Nella GUI, invece, quando si confrontano le espressioni regolari con i nomi del servizio e altri elementi, Checkmk controlla fondamentalmente se l'espressione corrisponde all'inizio parola (match prefisso) - questo è di solito ciò che stai cercando:

Se hai bisogno di un match parziale nei punti in cui è prevista la corrispondenza con il prefisso, estendi semplicemente la tua espressione regolare con .* all'inizio per far corrispondere qualsiasi stringa con prefisso:

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

Dato che il punto corrisponde a tutto, naturalmente corrisponde anche a un punto. Se vuoi corrispondere esattamente a un punto, devi mascherarlo con un \ (backslash). Questo vale analogamente per tutti gli altri caratteri speciali: \ . * + ? { } ( ) [ ] | & ^ e $. La codifica di un backslash \ fa sì che il carattere speciale che lo segue venga trattato come un carattere normale:

Attenzione a Python: Poiché in Pythonil backslash nella rappresentazione interna della stringa viene mascherato internamente con un altro backslash, questi due backslash devono essere nuovamente mascherati, il che porta a un totale di quattro backslash:

Con la linea verticale | puoi definire delle alternative, cioè utilizzare un'operazione OR:1|2|3 corrisponde a 1, 2 o 3. Se hai bisogno di tali alternative al centro di un'espressione, raggruppale tra parentesi tonde:

Igruppi di corrispondenza (o gruppi di cattura) svolgono due funzioni: la prima è il raggruppamento di alternative o di 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. Così l'espressione (/local)?/share corrisponde sia a /local/share che a /share.

Nella Console degli Eventi (EC), nella Business Intelligence (BI), nella rinominazione in blocco degli hoste nelle mappature piggyback, è possibile 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 della tabella mostra l'uso di alternative all'interno di un gruppo di corrispondenza.

L'immagine seguente mostra la ridenominazione di più host in un'unica azione: tutti i nomi host che corrispondono all'espressione regolare server-(.*)\.local saranno sostituiti da \1.servers.local, dove \1 corrisponde esattamente al testo "catturato" da .* nella 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 la strutturazione, è possibile utilizzare ?: per convertirlo in un gruppo di corrispondenza non catturante(gruppo di corrispondenza non catturante): (?:/local)?/share.

Con i flag in linea è possibile effettuare impostazioni specifiche relative alla modalità di valutazione all'interno di un'espressione regolare. Il più importante per lavorare con Checkmk è (?i), che passa alla corrispondenza senza distinzione tra maiuscole e minuscole per le espressioni altrimenti sensibili alle maiuscole e minuscole. In casi molto rari, potrai anche utilizzare (?s) e (?m) per lavorare con stringhe multilinea.

Nota che dalla versione 3.11 Python si aspetta che i flag inline siano all'inizio di un'espressione regolare - (?i)somestring- o che ne specifichino l'ambito -(?i:somestring). Poiché Checkmk in alcuni casi combina internamente le espressioni regolari per migliorare le prestazioni, ti consigliamo vivamente di non utilizzare i flag inline all'inizio di un'espressione regolare, ma di utilizzare sempre la notazione con ambito- che, in caso di dubbio, si estende all'intera espressione regolare:

(?i:somestring).

Questa è una variante del gruppo di corrispondenza non catturante.

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

Nei luoghi in cui Checkmk permette la corrispondenza con Unicode, \w è particolarmente utile quando si cercano parole dallo stesso significato in lingue diverse, ad esempio nomi propri che a volte sono scritti con e a volte senza accento.