Labels

Las etiquetas pueden asignarse a un host de varias formas.

La primera de ellas es sencilla: en la página de propiedades del host, que aparece cuando creas o editas un host en la Configuración, puedes asignar a un host tantas etiquetas como quieras:

Activa Labels con el checkbox, luego haz clic en el campo Add some label, introduce la definición de la etiqueta siguiendo el esquema key:value y termina con Intro.

Puedes editar una etiqueta existente haciendo clic en su texto, o borrarla 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, sobrescribirse de nuevo, de hecho,individualmente. Si, por ejemplo, se define la etiqueta location:munich en la carpeta, ésta será heredada por todos los hosts de esta carpeta que no tengan ya definida la etiqueta location. Otras 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 independizará de la estructura de carpetas, y también se aplica a las etiquetas. Existe 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 host de la carpeta Bavaria que tengan el tag del host Real Hardware:

Te habrás dado cuenta de que las etiquetas no se pueden utilizar en las condiciones de esta regla. Esto no es un error, sino 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 host de la Configuración, sino que sólo aparecen en la vista de estado del host.

La tercera forma de crear etiquetas es 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 concreto, cabe mencionar aquí los agentes especiales para AWS, Azure y Kubernetes. A veces, en las respectivas plataformas también se denominan tags y se crean en Checkmk como etiquetas del host o del servicio. Los respectivos conjuntos de reglas proporcionan suficiente información 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 Etiquetas de host 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 los checks locales, crea una sección llamada labels. De esta forma puedes asignar etiquetas con más detalle que evaluando sólo el inventario de HW/SW - por ejemplo, según matices del hardware instalado (como las características de la CPU), o relevantes para los procesos que se están ejecutando realmente (en lugar de simplemente el software instalado).

La salida de etiquetas debe formatearse como un diccionario Python, como en el siguiente ejemplo:

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

Si has activado el check de descubrimiento-que es el predeterminado 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. Por ejemplo, esto tendrá el siguiente aspecto:

Tienes dos opciones para responder a este aviso. La primera es añadir las nuevas etiquetas llamando a la configuración del servicio para el host en la Configuración y actualizando la configuración de las etiquetas con el elemento de menú Hosts > Update host labels. El check de descubrimiento volverá a estar OK la próxima vez que se ejecute (con un retraso de hasta dos horas), aunque aún no hayas activado los cambios. Si no quieres esperar tanto, también puedes actualizar manualmente el servicio de forma inmediata seleccionando Reschedule check en el menú de acción del servicio.

Si esto afecta a muchos host a la vez, seguramente no querrás visitar la configuración del servicio para cada host. Lo mejor en este caso es ejecutar la acción masiva para 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 poner verde el check de descubrimiento es reconfigurarlo para que ya no te avise de las 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:

Por defecto está configurada como Warning. Elige OK - do not alert, just display y el check se silenciará.

Las etiquetas encontradas mediante el Discovery Check se muestran en amarillo.

Teóricamente, una misma label puede estar definida con valores distintos en varias fuentes simultáneamente, por eso existe el siguiente orden de prioridad:

Estas reglas de precedencia te dan el máximo control sobre las etiquetas.

Una función importante de las etiquetas es la misma que para las características del host: a saber, su uso como condición en las reglas. Esto es especialmente útil para las etiquetas generadas automáticamente, porque 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 de la forma habitual key:value. Presta atención a la ortografía exacta aquí, incluidas las mayúsculas. Como las etiquetas pueden definirse sin especificaciones, Checkmk no puede reconocer los errores tipográficos. No obstante: Cuando escribes una etiqueta, Checkmk sugiere etiquetas existentes si coinciden con lo que has introducido anteriormente. En las sugerencias no se distingue entre host y etiquetas de servicio: se ofrecen todas las etiquetas que coincidan. Presta atención a la ortografía correcta, ya que las faltas de ortografía, las mayúsculas incorrectas, 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 facilita la lectura de la condición, ahora más compleja, pero no cambia la evaluación del álgebra booleana:

Puedes utilizar tanto etiquetas como tags del host en una regla. Éstas se vinculan automáticamente mediante AND. Por tanto, la regla sólo se aplica si se cumplen ambas condiciones a la vez.

También puedes utilizar etiquetas como condiciones en las reglas de notificación. La carga es la misma que en otras condiciones, por lo que no necesitas reeducarte para utilizarlas. Selecciona Match host labels e introduce simplemente qué etiquetas debe tener un host o un servicio, para activar así una notificación mediante esta regla. De nuevo, las etiquetas múltiples se conectan mediante la operación Y.