Informes

Hay varias opciones para dar un contexto a los informes, es decir, para llenarlos con los datos de hosts y servicios específicos. Como resultado, los informes tienen que llamarse de diferentes maneras para que contengan información significativa. Si falta el contexto, es decir, especificar qué hosts y servicios deben incluirse en el informe, en lugar de la salida correcta sólo recibirás mensajes de error resaltados en rojo:

La diferencia está en dónde se especifica el contexto:

Ahora piensa de nuevo en el snap-in Reporting mencionado anteriormente: éste te lleva directamente a los informes renderizados sin ninguna otra preselección / restricción, etc., por lo que sólo tienen sentido aquí los informes que tienen un contexto integrado. Por lo tanto, los informes cuyo contexto sólo se crea a través de vistas (filtradas) pueden excluirse con seguridad del menú Monitor, así como del snap-in a través de la opción Hide this report in the monitor menu.

Puedes utilizar las siguientes funciones para editar tus propios informes:

En las secciones siguientes se describen las distintas opciones disponibles.

Ahora las cosas se complican un poco más si quieres crear un informe completamente nuevo en lugar de una copia de un informe existente. A modo de ejemplo, a continuación crearás una simple vista general de todos los servicios problemáticos de tu site, es decir, todos los servicios con estado WARN, CRIT o UNKNOWN. Esta vista general se titulará 'servicios_críticos'.

Crea un nuevo informe en la página Edit Reports a través de Reports > Add report.

En el primer paso, deja el filtro Select specific object type en la selección No restrictions to specific objects y pasa directamente a la siguiente página de selección con Continue.

Al igual que al copiar un informe existente, especifica primero un Unique ID y un Title:

En la sección Context / Search Filters, bajo Service selecciona ahora el Service states, luego con un clic en Add filter puedes establecer los estados deseados:

Con Save & go to list el nuevo informe se añadirá a la sección Customized de la lista general de informes.

Si ahora llamas a este informe con alegre expectación, el resultado es aleccionador. La página del informe tiene un diseño inicial y también un encabezamiento, pero por lo demás está vacía. No es exactamente el resultado con el que impresionar a tu jefe...

Así que ahora tienes que definir el diseño del contenido del informe. El te llevará a la página para definir el contenido que se incluirá en el informe. La selección de los elementos del informe se realiza en tres etapas, cada una de ellas con un clic en Continue entre medias.

Comienza haciendo clic en Add content. Para este ejemplo, en Step 1 selecciona el tipo de elemento Availability table. Establece Step 2 en All services y Step 3 en No restrictions to specific objects. Deja por el momento sin cambios las demás opciones de la página siguiente. En su lugar, haz clic directamente en Save. Ahora visualiza la vista previa de tu informe:

A la izquierda puedes ver la vista previa, aquí para el informe de critical_services. A la derecha, se muestran los elementos del informe en una lista. Estos elementos se pueden editar, copiar, borrar y reordenar.

Ahora puedes personalizar de forma flexible este sencillo informe de creación propia con los elementos adicionales que necesites (ver más abajo) y llamarlo en cualquier momento, por ejemplo, desde la barra lateral.

En casi todos los pasos de la creación de informes existe la posibilidad de ajustar el contenido para adaptarlo a tus necesidades.

En el primer paso, al principio puedes establecer un filtro y limitar el informe a un host o fuente de datos concretos, como interfaces de red, Agregaciones BI, sensores, etc:

A continuación, introduce de nuevo el Unique ID y el Title. Para el título también puedes utilizar las macros proporcionadas (= módulos de texto). A continuación, elige un Icon con el que el informe debe ser visible en los menús. Si estableces la opción Make this report available for other users en el grupo de contacto, en el ejemplo check-mk-notify, darás a los miembros del grupo asociado la posibilidad de acceder de forma independiente al informe en cualquier momento y obtener información por su cuenta.

En la caja Context / Search Filters, como de costumbre, hay disponibles amplias opciones de filtrado, desde host específicos a contenedores Docker individuales, pasando por valores de la monitorización de Oracle.

En este ejemplo, la selección de host se limita a una carpeta y, además, a los temas de host especificados. Esta restricción acelera la recuperación de datos, especialmente en entornos más complejos.

Con Save & go to list llegas a la vista general del informe. El siguiente paso es definir el contenido del informe.

Utilizando la herramienta de edición de informes accederás al contenido del informe:

Abre la edición del contenido del informe con Reports > Add content. Utilízalo para añadir tablas, gráficos, índices o texto (también mediante macros o HTTP) al informe, por ejemplo. Estos contenidos aparecen uno tras otro y, por tanto, también determinan la longitud final del informe.

En Step 1, selecciona el elemento que desees, por ejemplo Multiple graphs. Esto te proporcionará, en función de tus otros ajustes, varios gráficos del mismo tipo dispuestos uno debajo de otro. Por ejemplo, puedes mapear una comparación directa entre los estados de varios hosts.

Continúa con Continue. Como fuente de datos para los gráficos, para este ejemplo, en el paso 2 selecciona All services, es decir, todos los servicios que se ejecutan en los hosts:

Continúa con Continue. En el paso 3, ahora podrías limitar el volumen de datos a mostrar. Esta opción no es necesaria para el ejemplo actual. De nuevo, pasa a la siguiente selección con Continue.

Para el informe de ejemplo, en Graph layout, en la caja Properties, especifica que quieres proporcionar un título para cada uno de los gráficos, compuesto por el título del gráfico, el nombre del host y la descripción del servicio. Además, establece el intervalo de tiempo mostrado en cuatro horas en Graph time range.

En la caja Context / Search Filters, limitas el informe a las características especificadas del host o del servicio. Aquí seleccionas CPU utilization para Service en este ejemplo.

Al hacer clic en Save has completado el primer elemento del informe.

Para el segundo gráfico de este ejercicio, empieza de nuevo con Reports > Add content y en Step 1 selecciona Metrics graph of a single service. Pasa a Step 2 con Continue y restringe los filtros de búsqueda al nombre del host y a la descripción del servicio:

Haciendo clic en Save también estará listo el segundo elemento del informe.

El tercer elemento que hay que crear es una vista general de las alertas actuales. El procedimiento sigue siendo el mismo:

Con un clic en Save también se finaliza este elemento del informe.

Para que la visualización sea más clara, añade encabezados:

Abre Reports > Add content para editar el contenido del informe. En Step 1 selecciona Heading como tipo de elemento. Cambia a Step 2 con Continue. Opcionalmente, especifica un nivel jerárquico para el encabezamiento. Introduce el encabezamiento en The text.

Haz clic en Save para volver a la vista general. Sin embargo, el nuevo encabezamiento se situará ahora por debajo de los gráficos de la lista. Por tanto, en la lista de elementos de contenido, utiliza el icono para arrastrar el encabezamiento a la posición deseada en la lista.

Consejo: En la vista previa, puede que veas líneas rojas y mensajes de error en lugar de datos reales, porque en estos lugares el informe en el editor carece de contexto, aquí, por ejemplo, la especificación de un host que sólo se revelaría llamando al informe desde una vista apropiada. Si quieres ver una vista previa utilizable, simplemente filtra por un host específico en la configuración del informe en el área Context / Search Filters. Esto facilita mucho el diseño del informe.

Hay elementos de diseño complementarios disponibles para estructurar la apariencia del informe, como la línea horizontal, la imagen, el marco de página y una sola línea de texto. Puedes mostrar estos elementos básicos en todas las páginas de tu informe o en páginas específicas.

Para el informe de ejemplo, inserta un marco alrededor del informe. De nuevo, la definición se realiza paso a paso, cada uno continuado haciendo clic en . Comienza con Reports > Add page element.

Como el marco debe ser visible en todas las páginas, el siguiente paso no requiere cambios:

El nuevo marco de página se muestra ahora en la vista general, tanto en la vista previa de la izquierda como en la tabla de elementos de página estáticos de la derecha.

Consejo: También puedes utilizar las macros (=módulos de texto) disponibles en Checkmk, por ejemplo, para crear otro pie de página con los números de página y el nombre del informe. Para ello, selecciona el elemento de página One line of text y, en el segundo paso, especifica la posición en la parte inferior de la página, así como el texto que incluye las macros deseadas:

De inmediato, los informes tienen un aspecto más atractivo y de mayor calidad, por ejemplo, con el logotipo de la empresa añadido.

Abre la configuración de los informes con Reports > Edit properties:

En la segunda caja, encontrarás la dirección Report Properties. Aquí es donde configuras los valores para la fuente, el formato de página, los ajustes de fecha y hora, el diseño del informe y el nombre del archivo para las descargas.

Copia el logotipo de tu empresa en el directorio ~/local/share/check_mk/reporting/images/ y guárdalo como archivo logo_mk.png. A partir de ahora, este logotipo se mostrará en todos los informes.

Nota: Actualmente, puedes personalizar la plantilla de informes existente para adaptarla a tus necesidades. También puedes crear una plantilla de informes nueva y completa según las especificaciones de tu empresa, para reflejar el diseño corporativo de la empresa (CI/CD), por ejemplo.

Abre una nueva programación utilizando Scheduled reports > Add schedule, luego selecciona el informe y haz clic en Continue.

En la caja General Options, especifica los ajustes básicos como el título, la hora de creación, el periodo de informes, etc:

En Context / Search Filters encontrarás las opciones de filtro habituales, en función del informe seleccionado. A continuación, guarda el programa para volver a la lista de tus informes programados.

En la lista también encontrarás información sobre la última vez que se generó/envió el informe, si hubo algún error, cuándo se generará/enviará la próxima vez y alguna información más (que aquí se muestra ligeramente abreviada):

Las entradas de la lista se gestionan mediante los cinco iconos que aparecen al principio de una entrada:

Nota: Los informes enviados no se almacenan en el site.

En lugar de enviar el informe, también puedes almacenarlo localmente. Para ello, selecciona Action - Store locally:

A continuación, especifica un nombre de archivo y, opcionalmente, un título para el informe. Para poder crear un historial de informes, Checkmk proporciona varias macros (= módulos de texto) en lugar de sobrescribir la versión anterior del informe cada vez que se crea uno nuevo.

Se puede acceder a la vista general de todos los informes almacenados localmente en la ventana Edit Reports a través del elemento de menú Reports > Stored reports:

Los elementos de contenido aparecen en una lista cuando seleccionas Reports > Add content al editar un informe.

Los elementos de página aparecen en una lista cuando seleccionas Reports > Add page element al editar un informe.