Informes

Hay varias opciones para dar contexto a los informes, es decir, para rellenarlos con datos de hosts y servicios específicos. Por eso, hay que llamar a los informes de diferentes maneras para que contengan información útil. Si falta el contexto, es decir, si no se especifica qué hosts y servicios deben incluirse en el informe, en lugar del resultado correcto solo recibirás mensajes de error resaltados en rojo:

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

Ahora vuelve a pensar en el snap-in «Reporting» mencionado anteriormente: esto te lleva directamente a los informes generados sin ninguna preselección o restricción adicional, etc., por lo que solo aquellos informes que tienen un contexto integrado tienen sentido aquí. Los informes cuyo contexto solo se crea a través de vistas de tabla (filtradas) pueden, por lo tanto, excluirse con seguridad del menú «Monitor», así como del snap-in mediante la opción «Hide this report in the monitor menu».

Puedes utilizar las siguientes funciones para realizar la edición de tus propios informes:

En las secciones siguientes se describen las distintas opciones disponibles.

Las cosas se complican un poco más si quieres crear un informe completamente nuevo en lugar de una copia de uno ya existente. A modo de ejemplo, a continuación crearás una vista general sencilla 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á «critical_services».

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 ve directamente a la siguiente página de selección con Continue.

Al igual que al copiar un informe existente, primero especifica 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 «» y «Save & go to list», el nuevo informe se añadirá a la sección «Customized» de la lista de informes de Vista general.

Si ahora abres este informe con gran expectación, el resultado es decepcionante. La página del informe tiene un diseño inicial y también un encabezado, pero por lo demás está vacía. No es precisamente el resultado con el que impresionar a tu jefe…​

Así que ahora tienes que definir el diseño del contenido del informe. El enlace 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 pasos, cada uno de ellos con un clic en Continue entre ellos.

Empieza 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 las demás opciones de la página siguiente sin cambiar por el momento. En su lugar, haz clic directamente en Save. Ahora visualiza la vista de tabla de tu informe:

A la izquierda puedes ver la vista previa, en este caso del informe de critical_services. A la derecha, los elementos del informe se muestran en una lista. Estos elementos se pueden editar, copiar, eliminar y reordenar.

Ahora puedes personalizar de forma flexible este sencillo informe creado por ti mismo con elementos adicionales según sea necesario (ver más abajo) y abrirlo en cualquier momento, por ejemplo, desde la barra lateral.

En casi todos los pasos de la creación del informe existe la posibilidad de ajustar el contenido a tus necesidades.

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

A continuación, vuelve a introducir el título del informe (Unique ID) y el subtítulo (Title). Para el título, también puedes utilizar las macros proporcionadas (= módulos de texto). A continuación, elige una vista de grupo (Icon) con la que el informe deba aparecer en los menús. Al establecer la opción «Make this report available for other users» en el grupo de contacto, en el ejemplo check-mk-notify, concedes a los miembros del grupo asociado la posibilidad de acceder al informe de forma independiente 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 hosts específicos hasta contenedores Docker individuales, pasando por valores de la monitorización de Oracle.

En este ejemplo, la selección de hosts se limita a una carpeta y, además, a problemas de hosts específicos. Esta restricción agiliza la recuperación de datos, especialmente en entornos más complejos.

Con «Save & go to list» (Seleccionar informe) se accede a la vista general del informe. El siguiente paso es definir el contenido del informe.

Con el accedes al contenido del informe:

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

En Step 1, selecciona el elemento que desees; para este ejemplo, Multiple graphs. Esto te mostrará, dependiendo de tus demás ajustes, varios gráficos del mismo tipo dispuestos uno debajo del otro. Por ejemplo, puedes realizar un mapeo directo entre los estados de varios hosts.

Continúa con Continue. Como fuente de datos para los gráficos, en 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 que se van a mostrar. Esta opción no es necesaria para el ejemplo actual. De nuevo, switch 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, que incluya 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», limita el informe a las características de host o servicio especificadas. Aquí seleccionas «CPU utilization» para «Service» en este ejemplo.

Al hacer clic en «» y «Save», habrás completado el primer elemento del informe.

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

Al hacer clic en Save, el segundo elemento del informe también estará listo.

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

Con un clic en Save, este elemento del informe también queda terminado.

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. Switcha a Step 2 con Continue. Si quieres, especifica un nivel jerárquico para el encabezado. Introduce el encabezado en The text.

Haz clic en Save para volver a la Vista general. Sin embargo, el nuevo encabezado aparecerá ahora debajo de los gráficos de la lista. Por lo tanto, en la lista de items de contenido, usa el icono para arrastrar el encabezado a la posición deseada en la lista.

Consejo: En la vista previa, es posible que veas líneas rojas y mensajes de error en lugar de datos reales, ya que en estos lugares el informe en el editor carece de contexto, aquí, por ejemplo, la especificación de un host que solo se revelaría al llamar al informe desde una vista de tabla adecuada. Si quieres ver una vista previa útil, simplemente filtra por un host específico en la configuración del informe en el área Context / Search Filters mientras tanto. Esto facilita mucho el diseño del informe.

Hay elementos de diseño complementarios disponibles para estructurar la apariencia del informe, como líneas horizontales, imágenes, marcos de página y una sola línea de texto. Puedes mostrar estos elementos en todas las páginas o en páginas específicas de tu informe.

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

Dado que el marco debe estar 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 usar 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 incluya las macros deseadas:

Los informes lucen más atractivos de inmediato con una apariencia de mayor calidad, por ejemplo, al añadir el logotipo de la empresa.

Abre la configuración del informe con Reports > Edit properties:

En la segunda caja, encontrarás el Report Properties. Aquí es donde configuras los valores de fuente, formato de página, ajustes de hora y fecha, diseño del informe y 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 un archivo «logo_mk.png». A partir de ahora, este logotipo aparecerá en todos los informes.

Nota: Actualmente, personalizas la plantilla de informe existente para adaptarla a tus necesidades. Como alternativa, puedes crear una plantilla de informe nueva y completa según las especificaciones de tu empresa, para reflejar, por ejemplo, la identidad corporativa (CI/CD) de la empresa.

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

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

En «Context / Search Filters» encontrarás las opciones de filtro habituales, dependiendo del informe seleccionado. A continuación, guarda la programación 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 algo más de información (que aquí se muestra ligeramente abreviada):

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

Nota: Los informes que se han enviado no se guardan en el site.

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

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

Puedes 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 cuando seleccionas «Reports > Add content» al realizar la edición de un informe.

Los elementos de página aparecen cuando seleccionas «Reports > Add page element» al realizar la edición de un informe.