Labels

Las etiquetas se pueden asignar a un host de varias formas.

La primera de ellas es sencilla: En la página de propiedades del host, que se muestra cuando creas o editas un host en la configuración, puedes asignarle tantas etiquetas como quieras:

Marca la checkbox «Labels» (Label de host), luego haz clic en el campo «Add some label» (Label de host), introduce la definición de la etiqueta siguiendo el esquema «key:value» y termina pulsando Intro.

Puedes editar una etiqueta existente haciendo clic en su texto, o eliminarla con la pequeña «x».

Por supuesto, las etiquetas también se pueden heredar de una carpeta. Al igual que otros atributos, las etiquetas pueden estar en subcarpetas o en el host, y luego, según sea necesario, se pueden sobrescribir de nuevo —de hecho, de forma individual. Si, por ejemplo, la etiqueta location:munich está configurada en la carpeta, esta será heredada por todos los hosts de esta carpeta que no tengan ya definida la etiqueta location. Las demás etiquetas que pueda tener un host no se verán afectadas.

Las etiquetas definidas explícitamente para hosts o carpetas aparecen en color violeta en la lista de hosts:

Como es habitual en Checkmk, también se pueden asignar atributos a hosts y servicios mediante reglas. Esto te hará independiente de la estructura de carpetas, y también se aplica a las etiquetas. Hay un conjunto de reglas Host labels para esta función, que puedes encontrar rápidamente mediante una búsqueda en el Menú de configuración.

La siguiente regla añade la etiqueta «hw:real» a todos los hosts de la carpeta «Bavaria» que tengan el tag del host «Real Hardware»:

Quizás hayas notado que no se pueden usar etiquetas en las condiciones de esta regla. No es un error, sino algo intencionado, y evita dependencias recursivas y otras anomalías.

Las etiquetas añadidas mediante reglas aparecen en rojo en el host mostrado, pero no aparecen en la lista de hosts de la configuración, sino que solo aparecen en la vista de tabla del estado del host.

La tercera forma de crear etiquetas es de forma totalmente automática. Varias fuentes de datos, como los agentes especiales para la monitorización de sistemas en la nube y de contenedores, generan etiquetas automáticamente. En particular, cabe mencionar aquí los agentes especiales para AWS, Azure y Kubernetes. A veces, estos elementos también se denominan «tags» en las respectivas plataformas y se crean en Checkmk como etiquetas de host o de servicio. Los respectivos conjuntos de reglas proporcionan información suficiente al respecto.

Lo bueno es que no tienes que configurar nada en absoluto. En cuanto estas fuentes de datos estén activas, se generarán las etiquetas correspondientes.

En la sección Host labels generadas automáticamente encontrarás una vista general de las etiquetas que Checkmk genera automáticamente.

Una forma sencilla de manipular las etiquetas directamente es añadir un plugin de agente que, de forma análoga a las local checks, crea una sección llamada «labels». De esta manera, puedes asignar etiquetas con más detalle que evaluando únicamente el inventario de HW/SW; por ejemplo, según los matices del hardware instalado (como las características de la CPU) o en función de los procesos que se estén ejecutando realmente (en lugar de simplemente el software instalado).

La salida de la etiqueta debe tener el formato de un diccionario de Python, como en el siguiente ejemplo:

Evita conflictos con las etiquetas asignadas automáticamente por el propio Checkmk y otros Plugins, ya que no se puede garantizar un orden de evaluación concreto.

Si ha habilitado la comprobación de descubrimiento —que es la opción predeterminada para las nuevas instalaciones—, te avisará cuando se encuentren nuevas host labels que aún no se hayan añadido a las propiedades del host en la configuración. Esto tendrá un aspecto similar al siguiente, por ejemplo:

Tienes dos opciones para responder a esta advertencia. La primera es añadir las nuevas etiquetas accediendo a la configuración del servicio del host en la configuración y actualizando la configuración de las etiquetas con el elemento de menú «Hosts > Update host labels». La comprobación de descubrimiento volverá a ser «OK» la próxima vez que se ejecute (con un retraso de hasta dos horas), incluso si aún no has activado los cambios. Si no quieres esperar tanto tiempo, también puedes actualizar el servicio manualmente de inmediato seleccionando «Reschedule check» en el menú de acción del servicio.

Si esto afecta a muchos hosts a la vez, seguramente no querrás visitar la configuración del servicio de cada host. Lo mejor que puedes hacer aquí es ejecutar la acción masiva «Run bulk service discovery» y seleccionar «Only discover new host labels» como modo —o, alternativamente, «Add unmonitored services and new host labels» si también quieres aprovechar para añadir nuevos servicios.

La segunda forma de hacer que el check de descubrimiento pase a verde es reconfigurarlo para que ya no te avise de nuevas etiquetas. Para ello, ve al conjunto de reglas «Periodic service discovery» y edita la regla existente; allí encontrarás la opción «Severity of new host labels»:

Esta está configurada en «Warning» por defecto. Elige «OK - do not alert, just display» y la check dejará de mostrar avisos.

Las etiquetas encontradas mediante el proceso de descubrimiento se muestran en amarillo ocre.

En teoría, una misma etiqueta puede definirse con valores diferentes en varias fuentes a la vez. Por eso existe el siguiente orden de prioridad:

Estas reglas de prioridad te dan el control total sobre las etiquetas.

Una función importante de las etiquetas es la misma que la de las características de host: Es decir, su uso como condición en las reglas. Esto resulta especialmente útil para las etiquetas generadas automáticamente, ya que puedes adaptar tu monitorización de forma totalmente automática basándote en la información de AWS, Azure, Kubernetes y demás.

Añade condiciones con Add to condition para las etiquetas de host o servicio. Ahora selecciona is o not para formular una condición positiva o negativa y, a continuación, introduce la etiqueta en el formato habitual key:value. Presta atención a la ortografía exacta aquí, incluyendo las mayúsculas. Como las etiquetas se pueden definir sin especificaciones, Checkmk no puede reconocer errores tipográficos. No obstante: cuando escribes una etiqueta, Checkmk sugiere etiquetas existentes si hay coincidencia con tu entrada anterior. En las sugerencias no se distingue entre etiquetas de host y de servicio: se ofrecen todas las etiquetas que coinciden. Presta atención a la ortografía correcta, ya que los errores ortográficos, el uso incorrecto de mayúsculas, etc., harán que la regla deje de funcionar.

Sin embargo, la definición de la condición va un paso más allá: Para refinar aún más la condición, también tienes a tu disposición los operadores booleanos Not, And y Or. Aquí, Not es la abreviatura de And Not.

Por ejemplo, para encontrar hosts con la etiqueta cmk/site:today pero sin la etiqueta cmk/piggyback_source_today:yes, la condición podría ser así:

Puedes refinar esta condición con is o not con cualquier otra especificación. O puedes añadir un nuevo grupo de condiciones con Add to condition, lo que hace que la condición, ahora más compleja, sea más fácil de leer, pero no cambia la evaluación del álgebra booleana:

Puedes usar tanto etiquetas como tags del host en una regla. Estas se enlazan automáticamente con un «Y». Por lo tanto, la regla solo se aplica si ambas condiciones se cumplen al mismo tiempo.

También puedes usar etiquetas como condiciones en las reglas de notificación. El uso es el mismo que en otras condiciones, así que no necesitas volver a aprender a usarlas. Selecciona «Match host labels» y simplemente introduce qué etiquetas debe tener un host o servicio, lo que activará una notificación a través de esta regla. De nuevo, las etiquetas múltiples se conectan mediante la operación «AND».