Expresiones regulares en Checkmk

Con las expresiones regulares, siempre se trata de ver si un patrón coincide con un texto determinado (por ejemplo, el nombre del servicio). El ejemplo de aplicación más sencillo es una cadena de caracteres alfanuméricos. Estos (y el signo menos usado como guión) simplemente producen una coincidencia consigo mismos en una expresión.

Al buscar 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 tiene una coincidencia con el texto CPU load y con cpu LoAd. Por otro lado, las búsquedas en el entorno de configuración suelen distinguir entre mayúsculas y minúsculas. Es posible que haya excepciones justificadas a estas normas, que se describen en la ayuda en línea.

Además de las cadenas de caracteres de «texto sin formato», hay una serie de caracteres y cadenas de caracteres que tienen funciones «mágicas». El carácter más importante de este tipo es el punto (.). Realiza una coincidencia exacta con cualquier carácter arbitrario:

A menudo te interesa definir que pueda aparecer una secuencia de caracteres de una longitud determinada. Para ello, se especifica el número de repeticiones del carácter anterior entre llaves:

Hay abreviaturas para las tres últimas condiciones anteriores: « *» produce una coincidencia con el carácter anterior cualquier número de veces, «+» produce una coincidencia con al menos una aparición y «?» produce una coincidencia con como mucho una aparición.

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

Las clases de caracteres permiten que se realicen coincidencias en ciertas secciones del conjunto de caracteres, por ejemplo, «aquí debe ir un dígito». Para ello, coloca todos los caracteres que se deben coincidir entre corchetes. Con un signo menos también puedes especificar rangos. Nota: Se aplica la secuencia del conjunto de caracteres ASCII de 7 bits.

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

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

Aquí tienes algunos ejemplos prácticos:

En muchos casos es necesario distinguir entre coincidencias al principio, al final o simplemente en algún punto dentro de una cadena. Para una concordancia al principio de una cadena (concordancia de prefijo), usa el ^ (circunflejo); para el final (concordancia de sufijo), usa el $ (signo de dólar). Si no se especifica ninguno de estos operadores, la mayoría de las bibliotecas de expresiones regulares usan la concordancia infix como valor predeterminado: se busca en cualquier parte de la cadena de caracteres. Para concordancias exactas, usa tanto ^ como $.

En la monitorización y en la Consola de eventos, la concordancia infix es el estándar. En la monitorización, la concordancia infix es el estándar. Se encuentran las expresiones que aparecen en cualquier parte del texto, es decir, la búsqueda de «memory» también encuentra «kernel memory». 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 buscas:

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

Consejo: Puedes anteponer «^» al inicio de una cadena y «.*» dentro de una cadena, los intérpretes de expresiones regulares ignorarán los símbolos redundantes.

Dado que 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 de forma análoga a todos los demás caracteres especiales. Estos son: \ . * + ? { } ( ) [ ] | & ^ y $. Al escribir una barra invertida \, el carácter especial que le sigue se trata como un carácter normal:

Atención, Python: dado que en Python la 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 da un total de cuatro barras invertidas:

Con la barra vertical | puedes definir alternativas, es decir, usar una operación OR: 1|2|3coincide con 1, 2 o 3. Si necesitas esas alternativas en medio de una expresión, agrúpalas entre paréntesis:

Los grupos de concordancia (o grupos de captura) cumplen dos funciones: La primera función es agrupar alternativas o coincidencias parciales, como se muestra en el ejemplo anterior. También es posible anidar grupos. Además, se pueden usar los operadores de repetición *, +, ? y {…​} precedidos de paréntesis. Así, la expresión (/local)?/share coincide tanto con /local/share como con /share.

La segunda función es «capturar» los grupos de concordancia en variables. En la Consola de eventos (EC), en Business Intelligence (BI), en el renombramiento masivo de hosts y 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 , y así sucesivamente. El último ejemplo de la tabla muestra el uso de alternativas dentro de un grupo de concordancia.

La siguiente imagen muestra cómo renombrar varios hosts de una sola vez. Todos los nombres del host que tengan una coincidencia con la expresión regular server-(.*)\.local se sustituirán por \1.servers.local. Donde \1 representa exactamente el texto «capturado» por .* entre 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 solo se utiliza para estructurar, se puede usar ?: para convertirlo en un grupo de concordancia sin captura (grupo de concordancia sin captura): (?:/local)?/share.

Con los indicadores en línea, se pueden establecer configuraciones específicas relativas al modo de evaluación dentro de una expresión regular. El más relevante para trabajar con Checkmk es (?i), que switcha a la coincidencia sin distinción de mayúsculas y minúsculas para expresiones que, de otro modo, serían sensibles a las mayúsculas y minúsculas. En casos muy raros, también querrás usar (?s) y (?m) para trabajar con cadenas de varias líneas.

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

(?i:somestring).

Esta es una variante del grupo de concordancia sin captura.

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

En los casos en los que Checkmk permite la coincidencia Unicode, «\w» resulta especialmente útil a la hora de buscar palabras con ortografía similar en diferentes idiomas, por ejemplo, nombres propios que a veces se escriben con acento y otras sin él.