Expresiones regulares en Checkmk

Con las expresiones regulares, siempre se trata de saber si un patrón coincide con un texto determinado (por ejemplo, el nombre de un servicio). El ejemplo de aplicación más sencillo es una cadena de caracteres alfanuméricos. Éstos (y el signo menos utilizado como guión) simplemente coinciden entre sí en una expresión.

Cuando se busca en el entorno de monitorización, Checkmk no suele distinguir entre mayúsculas y minúsculas. En la mayoría de los casos, la expresión CPU load coincide tanto con el texto CPU load como con cpu LoAd. En cambio, cuandose busca en el entorno de configuración, sí suele distinguir entre mayúsculas y minúsculas. Existen excepciones justificadas a estas normas, que se describen en la ayuda en línea.

Atención: En los campos de entrada sin expresión regular en los que se especifica una coincidencia exacta (sobre todo con nombres del host), ¡siempre se distingue entre mayúsculas y minúsculas!

Además de las cadenas de caracteres de "texto plano", hay una serie de caracteres y cadenas de caracteres que tienen funciones "mágicas". El más importante de estos caracteres es el . (punto).Coincide exactamente con cualquier carácter arbitrario:

Muy a menudo se desea definir que puede darse una secuencia de caracteres de una longitud determinada. Para ello se especifica el número de repeticiones del carácter precedente entre llaves:

Existen abreviaturas para las tres últimas condiciones anteriores:* coincide con el carácter precedente cualquier número de veces, + coincide al menos una vez y ? coincide como máximo una vez.

También puedes utilizar el punto . con los operadores de repetición para buscar una secuencia de caracteres arbitraria de forma más definida:

Las clases de caracteres permiten hacer coincidir determinadas secciones del juego de caracteres, por ejemplo, "aquí tiene que venir un dígito". Para ello, coloca todos los caracteres a coincidir entre corchetes. Con un signo menos también puedes especificar rangos.Nota: Se aplica la secuencia del juego de caracteres ASCII de 7 bits.

Por ejemplo, [abc] representa exactamente uno de los caracteres a, b o c, y [0-9] cualquier dígito- ambos pueden combinarse. También es posible una negación del conjunto - con un ^ en el paréntesis, [^abc] representa entonces cualquier carácter excepto a, b, c.

Por supuesto, las clases de caracteres pueden combinarse con otros operadores. Empecemos con algunos ejemplos abstractos:

Aquí tienes algunos ejemplos prácticos:

Nota: Si necesitas uno de los caracteres -, [ o ], tendrás que utilizar un truco. Escribe el - (signo menos) al final de la clase, como ya se ha mostrado en el ejemplo anterior. Al evaluar las expresiones regulares, el signo menos, si no está en medio de tres caracteres, no se evalúa como un operador, sino exactamente como este carácter. Si es necesario, inserta un corchete de cierre como primer carácter de la clase, y un corchete de apertura como segundo carácter. Como no se permiten clases vacías, el corchete de cierre se interpreta entonces como un carácter normal. Una clase con estos caracteres especiales tendría el siguiente aspecto: []-], o respectivamente [][-] si también se necesita el corchete de apertura.

En muchos casos es necesario distinguir entre coincidencias al principio, al final o simplemente en algún lugar de una cadena. Para una coincidencia al principio de una cadena (coincidencia de prefijo) utiliza el ^ (circunflejo), para el final (coincidencia de sufijo) utiliza el $ (signo del dólar). Si no se especifica ninguno de estos operadores, la mayoría de las bibliotecas de expresiones regulares utilizan la coincidencia infija por defecto: se busca en cualquier lugar de la cadena de caracteres. Para coincidencias exactas, utiliza tanto ^ como $.

Nota: En la monitorización y la Consola de eventos, la concordancia infix es el estándar. Se encuentran las expresiones que aparecen en cualquier parte del texto, es decir, la búsqueda de "memoria" también encuentra "memoria del núcleo". En la GUI de configuración, por otro lado, al comparar expresiones regulares con nombres de servicios y otras cosas, Checkmk básicamente comprueba si la expresión coincide con el principio del texto (concordancia de prefijo) - esto es normalmente lo que estás buscando:

Si necesitas una concordancia infix en lugares donde se proporciona concordancia de prefijo, simplemente amplía tu expresión regular con .* al principio para que coincida con cualquier cadena prefijada:

Consejo: Puedes prefijar cualquier búsqueda al principio de una cadena con ^ y cualquier búsqueda dentro de una cadena con .*, los intérpretes de expresiones regulares ignorarán los símbolos redundantes.

Como el punto coincide con todo, naturalmente también coincide con un punto. Si ahora quieres que coincida exactamente con un punto, tienes que enmascararlo con una \ (barra invertida). Esto se aplica análogamente a todos los demás caracteres especiales, que son: \ . * + ? { } ( ) [ ] | & ^ y $. Si codificas una \ barra invertida , el carácter especial que le sigue se tratará como un carácter normal:

Atención Python: Como en Pythonla barra invertida en la representación interna de la cadena se enmascara internamente con otra barra invertida, estas dos barras invertidas deben enmascararse de nuevo, lo que lleva a un total de cuatro barras invertidas:

Con la línea vertical | puedes definir alternativas, es decir, utilizar una operación OR:1|2|3 coincide con 1, 2 ó 3. Si necesitas este tipo de alternativas en medio de una expresión, agrúpalas entre corchetes:

Losgrupos de concordancia (o grupos de captura) cumplen dos funciones: La primera función es la agrupación de coincidencias alternativas o parciales, como se muestra en el ejemplo anterior. También son posibles las agrupaciones anidadas. Además, se pueden utilizar los operadores de repetición *, +, ? y {...} precedidos de corchetes. Así, la expresión (/local)?/share coincide tanto con /local/share como con /share.

La segunda función es "capturar" grupos de caracteres coincidentes en variables. En la Consola de eventos (CE), Business Intelligence (BI), en el renombramiento masivo de hosty en los mapeos piggyback, existe la posibilidad de utilizar la parte de texto correspondiente a la expresión regular del primer paréntesis como \1, la parte correspondiente al segundo paréntesis como \2, etc. El último ejemplo de la tabla muestra el uso de alternativas dentro de un grupo de coincidencia.

La siguiente imagen muestra un cambio de nombre de varios host en una sola acción. Todos los nombres del host que coincidan con la expresión regular server-(.*)\.local se sustituirán por \1.servers.local. Donde \1 corresponde exactamente al texto "capturado" por .* en el paréntesis:

En el ejemplo concreto, server-lnx02.local se convierte así en lnx02.servers.local.

Si no es necesario que un grupo de concordancia "capture" grupos de caracteres, por ejemplo si sólo se utiliza para estructurar, se puede utilizar ?: para convertirlo en un grupo de concordancia queno capture: (?:/local)?/share.

Con las banderas en línea, se pueden realizar ajustes específicos relativos al modo de evaluación dentro de una expresión regular. La más relevante para trabajar con Checkmk es (?i), que cambia a coincidencia insensible a mayúsculas/minúsculas para expresiones que, de otro modo, distinguirían entre mayúsculas y minúsculas. En casos muy raros, también querrás utilizar (?s) y (?m) para trabajar con cadenas de varias líneas.

Ten en cuenta que, desde la versión 3.11, Python espera los indicadores en línea al principio de una expresión regular ( (?i)somestring) o especificando el ámbito((?i:somestring)). Dado que, en algunos casos, Checkmk combina internamente las expresiones regulares para mejorar el rendimiento, te recomendamos encarecidamente que no utilices indicadores en línea al principio de una expresión regular, sino que utilices siempre la notación con ámbito, que, en caso de duda, se extiende a toda la expresión regular:

(?i:somestring).

Se trata de una variante del grupo de concordancia sin alcance.

En particular, si se han copiado y pegado nombres propios en comentarios o textos descriptivos, y por tanto aparecen en el texto caracteres Unicode o diferentes tipos de espacios, las clases extendidas de Python son muy útiles:

En los lugares en los que Checkmk permite la coincidencia Unicode, \w es especialmente útil cuando se buscan palabras escritas de forma similar en distintos idiomas, por ejemplo nombres propios que a veces se escriben con acento y a veces sin acento.