Recuperación de datos de estado a través de Livestatus

El acceso a Livestatus se realiza a través de un socket de Unix utilizando el lenguaje de consulta Livestatus (LQL). Su sintaxis se basa en HTTP.

A través de la línea de comandos hay varias formas de acceder a la interfaz. Una posibilidad es usar los comandos printf y unixcat para enviar una instrucción al socket. La herramienta unixcat ya está incluida en Checkmk para el usuario de la instancia. Importante: todas las entradas al socket distinguen entre mayúsculas y minúsculas, así que hay que tenerlo siempre en cuenta:

La interfaz espera que todos los comandos y encabezados estén en una línea separada. Puedes marcar ese salto de línea con \n. Como alternativa al comando anterior, también puedes usar el comando de script lq, que te ahorra un poco de trabajo al autocompletar algunos campos al introducir:

O bien puedes iniciar el flujo de entrada interactivo e introducir el comando seguido del encabezado. Con una línea en blanco ejecutas el comando con su encabezado, y con otra línea más se cierra el acceso al socket. Ten en cuenta que en el ejemplo, todo lo que hay antes de la línea en blanco pertenece al comando, y todo lo que hay entre la primera y la segunda línea en blanco es la respuesta:

Los siguientes ejemplos siempre se ejecutan con el comando lq: en forma directa cuando la consulta es corta, y como flujo de entrada para consultas más largas.

Dado que Checkmk se basa en gran medida en Python, los scripts en este lenguaje resultan muy prácticos. El siguiente script puede utilizarse como base para acceder al socket de Livestatus:

Checkmk también ofrece una API para el lenguaje de programación Python, que simplifica el acceso a Livestatus. Hay código ejemplo disponible para esta API, que explica su uso. Puedes encontrar esta API en GitHub.

En los ejemplos que hemos visto hasta ahora, se ha consultado TODA la información de TODOS los hosts. Sin embargo, en la práctica, probablemente solo necesitarás columnas específicas. Con el encabezado «Columns» que ya hemos mencionado, el resultado se puede limitar a esta columna. Los nombres de las columnas individuales se separarán con un simple espacio en blanco.

Como se puede ver, en una línea los valores individuales están separados por un punto y coma.

Para limitar la consulta a líneas específicas, se pueden filtrar las columnas según el contenido especificado. Si solo se van a buscar servicios con un estado específico, esto se puede lograr con un filtro:

En el ejemplo se buscarán todos los servicios con estado «CRIT», y se mostrarán el nombre del host, la descripción del servicio y su estado. Por supuesto, estos filtros se pueden combinar y restringir a aquellos servicios con estado «CRIT» y que aún no hayan recibido el Reconocimiento:

Como puedes ver, también puedes filtrar por columnas que no están en la lista de Columns.

Puedes usar el encabezado OrderBy para ordenar la salida según el contenido de cualquier columna o incluso los valores de cualquier clave de diccionario. Esto te permite crear una lista alfabética de todos los hosts, por ejemplo:

De forma implícita, la salida se ordena en orden ascendente (asc), tal y como se espera. Sin embargo, también puedes especificar explícitamente el orden deseado e invertirlo indicando desc`:

Con consultas un poco más largas y ordenando, por ejemplo, por datos de rendimiento, se pueden crear listas de clasificación interesantes. En el siguiente ejemplo, los hosts se muestran en orden descendente según su tiempo de actividad:

Algunas columnas de una tabla no devuelven un solo valor, sino toda una lista de ellos. Para que esa lista se pueda buscar de forma eficaz, en estos casos los operadores tienen otra función. Puedes encontrar una lista completa de los operadores en Operadores para listas. Por ejemplo, el operador >= tiene la función «contiene». Con esto podrías, por ejemplo, buscar contactos específicos:

Como se puede ver en el ejemplo anterior, los contactos aparecerán en una lista, separados por comas, en la columna contacts. Esto permite distinguirlos claramente para que no se confundan con el inicio de otra columna. Una característica especial del operador de igualdad es que checkea si una lista está vacía:

Ya se han combinado varios filtros anteriormente. Parecería intuitivo que los datos deban pasar por todos los filtros para que se muestren. Los filtros se enlazarán así mediante la operación lógica «y». Para enlazar filtros concretos con un «o» lógico, al final de la cadena de código del filtro escribe «o:» seguido de un número entero. El contador especifica cuántas de las últimas líneas se pueden combinar con un «o». De esta forma se pueden formar grupos y combinarlos según sea necesario. A continuación tienes un ejemplo sencillo. Aquí se combinan dos filtros para que se muestren todos los servicios que tengan el estado « WARN» o «UNKNOWN»:

El resultado de una combinación también se puede invertir, o los grupos se pueden a su vez combinar en otros grupos. En el ejemplo, se muestran todos los servicios cuyo estado no sea «OK», y cuya descripción empiece por «Filesystem», o que tengan un estado distinto de «UNKNOWN»:

El formato de salida se puede especificar de dos maneras. Un método consiste en redefinir los separadores utilizados en la salida estándar. El otro método consiste en generar una salida conforme a los formatos Python o JSON.

Habrá situaciones en las que no te interese el estado de un servicio concreto o de un grupo de servicios. Mucho más importante es el número de servicios con un estado «WARN» (en funcionamiento), o el número de bases de datos sujetas a la monitorización. Livestatus es capaz de generar y mostrar estadísticas con Stats.

El Overview recibe sus datos recuperando estadísticas de hosts, servicios y eventos a través de Livestatus y mostrándolas en la interfaz de Checkmk. Con acceso directo a Livestatus puedes crear tu propio resumen:

Por cierto, estas estadísticas se pueden combinar con todos los filtros.

Las estadísticas también se pueden combinar con and/or. Los encabezados se llaman entonces StatsAnd o StatsOr. Usa StatsNegate si quieres que el resultado se invierta. En el ejemplo, se mostrará el número total de hosts (el Stats inicial) y, además, el resultado incluirá el recuento de hosts marcados como stale y que tampoco aparecen en una lista de tiempo de mantenimiento (las estadísticas 2 y 3 están enlazadas con un «Y» lógico):

No te confundas con las diversas opciones para combinar los resultados de los filtros y las estadísticas. Aunque todos los hosts que cumplan las condiciones se mostrarán con el encabezado « Filter», con las estadísticas el resultado será la suma de la frecuencia con la que se aplica el filtro «Stats».

También es posible realizar cálculos con los valores y, por ejemplo, mostrar un valor medio o un valor máximo. Aquí puedes encontrar una lista completa de todos los operadores posibles.

En el siguiente ejemplo, la lista mostrará el promedio, el mínimo y el máximo de tiempo que los check plugins de un host necesitan para calcular un estado:

Los cálculos con métricas se manejan de una forma un poco especial. Aquí también están disponibles todas las funciones del encabezado «Stats». Sin embargo, estas se aplican individualmente a todas las métricas de un servicio. Por ejemplo, en el siguiente ejemplo se sumarán las métricas de carga de CPU de un grupo del host:

Con la tabla log en Livestatus tienes acceso directo al historial de monitorización del core, de modo que, utilizando el LQL, puedes filtrar fácilmente eventos concretos. Las tablas de disponibilidad, por ejemplo, se generarán con la ayuda de estas tablas. Para mejorar la Vista general y restringir una consulta por temas, tienes acceso a las siguientes clases de registros:

Con solo usar estas clases de registro ya puedes restringir muy bien qué tipo de entrada debe mostrarse. El intervalo de tiempo que se tiene en cuenta en la consulta se restringirá adicionalmente. Esto es importante, ya que, de lo contrario, se buscaría en todo el historial de la instancia , lo que lógicamente podría ralentizar mucho el sistema debido a la avalancha de información.

Otra restricción útil de la salida son los (Columns) que se mostrarán para una entrada. En el ejemplo siguiente buscaremos todas las notificaciones que se hayan registrado en la última hora:

Es posible influir en la rotación de los archivos y en sus tamaños máximos. Además, puedes especificar cuántas líneas de un archivo deben leerse antes de que Checkmk interrumpa. Todo esto puede afectar al rendimiento de tus consultas, dependiendo de la configuración de la instancia. Hay disponibles los tres parámetros siguientes, que puedes encontrar y personalizar en Setup > General > Global Settings > Monitoring Core:

Para acceder a Livestatus a través de la red, puedes establecer una conexión entre el socket Unix del proceso de estado en vivo y un puerto TCP. De esta forma, puedes ejecutar scripts en máquinas remotas y recopilar los datos directamente desde donde deben procesarse.

Cuando un site está desactivado, se puede habilitar el acceso a través de TCP con el comando « omd»:

Una vez que se ha iniciado el site, Livestatus a través de TCP suele estar activo en el puerto predeterminado 6557. Para servidores Checkmk con varios sitios que utilizan Livestatus a través de TCP, se elige el siguiente puerto sin usar más alto.

Todos los ajustes, como el puerto y las direcciones IP autorizadas, se pueden configurar mediante omd config. También puedes realizar estos ajustes en la configuración. En Checkmk, el cifrado SSL de la comunicación de Livestatus está habilitado por defecto:

Si necesitas acceder a Livestatus desde fuera de tu red local, la protección de acceso basada únicamente en direcciones IP puede no ser práctica. La forma más fácil de obtener acceso autenticado en este caso es utilizar Secure Shell.

Con SSH, tienes la posibilidad de pasar un comando que se ejecutará en el servidor remoto:

Como alternativa, puedes reenviar el puerto de Livestatus al host en el que estás trabajando actualmente a través de un túnel SSH:

Si se ha establecido la conexión, en una segunda sesión de consola puedes comprobar si es posible acceder con openssl s_client:

Si esta prueba tiene éxito, cualquier script que hayas escrito para el acceso directo a la red de Livestatus se puede usar en localhost.

Livestatus no solo se puede usar para consultar datos, sino también para enviar comandos directamente al core (CMC o Nagios). Un comando correcto siempre incluye una marca de tiempo; de hecho, esta puede ser cualquier cosa que se necesite. Sin embargo, como también se utilizará en los registros para rastrear la hora del proceso, es recomendable introducir la hora con la mayor precisión posible. Los comandos a los que les falte la marca de tiempo se descartarán, sin generar un mensaje de error , y solo aparecerá una simple entrada en el archivo cmc.log!

Para que la marca de tiempo sea lo más precisa posible, se recomienda no establecer el comando en el flujo de entrada, sino ejecutarlo directamente. En tal situación también hay acceso a variables y se puede proporcionar la hora actual real:

Este formato funciona tanto con el Nagios-Core de Checkmk Community como con el CMC de las ediciones comerciales. Sin embargo, en los dos núcleos los comandos solo se solapan parcialmente. Puedes encontrar una lista completa de los comandos para el Nagios-Core directamente en el sitio web de Nagios. Los comandos disponibles para el CMC se pueden encontrar en la Referencia de comandos.

En la lista de comandos, la sintaxis tiene el siguiente formato:

Como ya sabes, Checkmk utiliza un formato mucho más sencillo para ejecutar comandos. Para que el formato de Nagios sea compatible con Checkmk, solo necesitas el comando, la marca de tiempo y, cuando sea aplicable, las variables: