Integración de Checkmk en Grafana

Tanto para Grafana Cloud como para la distribución en tu propio servidor, puedes instalar la fuente de datos de Checkmk directamente desde la GUI de Grafana.

Ve a Home > Connections > Add new connection y, a continuación, escribe «Checkmk» en el campo de búsqueda. Verás entonces una lista de resultados con una única entrada que te llevará a la página de Vista general del Plugin. Aquí volverás a ver una descripción detallada de la fuente de datos de Checkmk y podrás habilitarla en tu instancia de Grafana haciendo clic en «Install». Las opciones disponibles cambiarán ahora, y tendrás la opción de hacer clic en el nuevo enlace «Add new data source» para configurar una conexión con tu site de Checkmk.

Si ejecutas Grafana en tu propio servidor, puedes instalarlo desde la colección de Plugins de Grafana a través de la línea de comandos. Los comandos que se muestran se refieren a Grafana en Linux. Proceda de la misma manera en otras plataformas.

Reinicia el servicio del servidor de Grafana:

El Plugin estará entonces disponible en la interfaz de Grafana, por lo que podrás activarlo y configurarlo.

En la página de versiones del repositorio de GitHub encontrarás el archivo zip firmado «checkmk-cloud-datasource-X.Y.Z.zip». El esquema de nomenclatura sigue haciendo referencia a la antigua división del Plugin en dos partes (hasta la versión 3.x del Plugin), pero con la versión 4.0 se ha eliminado la restricción a Checkmk Ultimate y el Plugin firmado se puede utilizar con todas las ediciones de Checkmk.

Si ya has utilizado el Plugin de Grafana con Checkmk Community o Checkmk Pro en la versión 3.x, esto significa que, para actualizar a la 4.x, primero debes desinstalar el antiguo Plugin tribe-29-checkmk-datasource:

En lugar de usar el navegador, por supuesto también puedes cargar el archivo directamente a través de la línea de comandos. Ten en cuenta que necesitas saber la versión actual para hacer esto; en el siguiente ejemplo, escribimos la versión en la variable $plugvers. Aquí también, los comandos mostrados se refieren a Grafana en Linux. Proceda de la misma manera en otras plataformas.

Ahora descomprime el archivo zip:

Crea un directorio de Plugins si aún no existe y haz que el usuario de Linux bajo cuyo ID se ejecutan los procesos de Grafana (normalmente grafana) sea el propietario del directorio:

Mueve la carpeta resultante al directorio de Plugins de Grafana, que suele estar en /var/lib/grafana/plugins/:

Cambia el propietario al usuario de Grafana:

Ya no es posible la instalación mediante la clonación del archivo Git (tal y como se describía en versiones anteriores de este artículo). Si quieres contribuir al Plugin, lee las Notas para desarrolladores.

En «Home > Dashboards» encontrarás un menú desplegable marcado con un signo más. Haz clic en «New dashboard» para crear un nuevo dashboard:

El dashboard más sencillo muestra un único gráfico para el servicio de un host. También puede tratarse de la métrica de una local check para la que no existan gráficos ya preparados. Crea una nueva visualización en un dashboard existente o en el que acabas de crear. Primero selecciona aquí «Add visualization»:

Al crear una visualización, se te lleva a la selección de la fuente de datos. Tras seleccionar «Checkmk», te encuentras directamente en el modo de edición de la consulta para el panel recién creado. Un panel es un contenedor para una visualización.

El acceso a los datos que se van a visualizar difiere ligeramente entre Checkmk Community y las ediciones comerciales: En Checkmk Community trabajas con menús predefinidos —para sitio, nombre del host, servicio, etc. En las ediciones comerciales, tienes la opción de definir cascadas de filtros. Esto permite una selección muy detallada, utilizando también expresiones regulares. Se ha elegido el siguiente ejemplo sencillo para que puedas seguirlo con todas las ediciones.

Primero selecciona la Site y, a continuación, filtra por un Hostname en la monitorización. Para la primera prueba, utiliza cualquier host que utilice el agente de Windows o Linux. Selecciona Check_MK como Service. Establece el tipo de Aggregation en Maximum. El Graph type disponible para la selección es Single metric o Predefined graph: Predefined graphstoma métricas de Checkmk, que también pueden contener gráficos combinados. Nuestras capturas de pantalla aquí muestran el Single metric, que contiene el tiempo total de ejecución del agente (Time spent waiting for Checkmk agent).

Grafana muestra el resultado directamente. Con el botón «Apply» puedes aplicar el gráfico sin guardar el dashboard. Con «Save» se te pedirá que introduzcas un título para el nuevo Dashboard y, a continuación, podrás guardar el dashboard recién creado.

Los desarrolladores de Checkmk ya han recopilado muchas métricas relacionadas en gráficos comunes para facilitar a los usuarios la obtención de una vista general de los distintos aspectos de un único recurso. Puedes mostrar las métricas de uno de estos gráficos ya preparados directamente en Grafana.

El procedimiento es inicialmente el mismo que se explica en la sección anterior. Sin embargo, para completar el proceso, selecciona la entrada «Graph type» (Predefined graph) y el «Predefined graph» del servicio que se va a utilizar.

Si recibes un mensaje de error indicando que no se permite la selección de métricas combinadas con más de 200 elementos, utiliza filtros adicionales para restringir la selección. En caso de duda, coloca los filtros que limiten significativamente el resultado al principio del conjunto.

Una vez que estés satisfecho con tu selección, haz clic en el botón «Apply». El gráfico estará ahora disponible en el dashboard seleccionado.

Especialmente en un clúster dinámico, a menudo querrás poder seguir todo el progreso de una métrica en todos los hosts participantes sin tener que personalizar un gráfico definido por el usuario cada vez que se añade o se elimina un nuevo nodo. Para lograrlo, hay varias opciones para adaptar dinámicamente los gráficos.

La primera opción es filtrar por «Host Labels» o «Host Tags» en lugar de seleccionar hosts individuales. Otra opción es utilizar expresiones regulares. Puedes aplicar expresiones regulares a hosts o servicios. En el siguiente ejemplo, «filesystem» produce una coincidencia con todos los servicios que contengan «filesystem», independientemente del número de sistemas de archivos que tenga montados un host.

Con filesystem.*nvme restringirías la selección a todos los sistemas de archivos en unidades NVMe, independientemente del tipo de sistema de archivos que utilicen, ya que la parte de la cadena entre filesystem y nvme puede ser arbitraria.

Además de las opciones de filtro ampliadas, usa Aggregation para determinar la visualización de las métricas en el gráfico y Graph para determinar qué gráfico se va a utilizar como referencia. Ten en cuenta que las métricas de un host/servicio solo se muestran si también tiene el gráfico seleccionado. Un gráfico podría tener este aspecto, por ejemplo:

En el modo de edición de cada panel, encontrarás una pestaña «Transform». Puedes usar el item «Rename by regex» disponible aquí para reordenar los nombres de las métricas u ocultar la información que no sea necesaria. En el siguiente ejemplo se buscan dos grupos de caracteres separados por una coma seguida de un espacio, se intercambian y se colocan explícitamente «Service» y «Host» al principio:

Las variables $1 y $2 corresponden a las cadenas «capturadas» en la línea anterior (grupos de concordancia o grupos de captura). Grafana también permite grupos de concordancia anidados. La sección correspondiente del artículo sobre expresiones regulares ofrece una vista general de las posibilidades disponibles para estos.

Cada variable es una propiedad de un dashboard. Debe crearse en la configuración del dashboard y, a continuación, solo puede utilizarse dentro de ese dashboard. Dado que la consulta requiere la configuración más extensa, mostraremos su uso en nuestro ejemplo.

Las propiedades relevantes para una variable son su tipo y su nombre; todas las demás propiedades solo se utilizan con fines de claridad en el dashboard. El nombre debe diferenciar entre variables. Así que, si tienes pensado utilizar varias variables para seleccionar hosts de diferentes subconjuntos, utiliza un nombre que haga referencia a este conjunto en lugar de «host» como en el ejemplo, por ejemplo, «host_from_linuxservers».

Al seleccionar una fuente de datos, asegúrate de que se haya seleccionado una conexión Checkmk. Puedes restringir aún más el tipo de objeto seleccionado, por ejemplo, con expresiones regulares. Los filtros utilizados se evalúan en el servidor Checkmk. Por el contrario, los siguientes campos Regex y Sort son evaluados por Grafana.

Las dos checkboxes de Selection options, situadas en la parte inferior de la página, se pueden utilizar opcionalmente más adelante, según sea necesario. Puedes modificar esta configuración en cualquier momento si es necesario; para la primera prueba, deja ambas en la configuración predeterminada (vacía). Guarda las variables utilizando Save dashboard cuando hayas completado toda la configuración.

Ahora puedes introducir las variables asignadas en los campos correspondientes para crear un gráfico flexible. Las variables también se pueden utilizar en el título del gráfico.

En el dashboard se muestra un menú desplegable para cada variable, que puedes utilizar para establecer los valores de las variables (hosts, servicios…) que deseas mostrar en el dashboard. Si has activado la selección múltiple, puedes configurar la opción «Repeat by variable» en los ajustes del dashboard para que se muestre el dashboard para cada valor de variable seleccionado.