Pandora: Documentation es: Presentacion datos/Informes

From Pandora FMS Wiki
Jump to: navigation, search

Contents

1 Informes

Pandora FMS nos ofrece la posibilidad de presentar los datos monitorizados de manera ordenada en forma de informes.

Dentro de un informe, la información a presentar se organiza en elementos de informe. Hay muchos tipos de elementos diferentes, que realizan cálculos y presentan la información de formas muy distintas. Por ejemplo, podemos elegir un elemento de tipo "gráfica simple" que pinte gráficas individuales o un elemento de tipo "SLA" que nos muestre el grado de cumplimiento de una serie de monitores.


Aunque generalmente tienen un formulario de configuración muy similar, cada tipo de elemento se configurará de manera independiente.


Podemos tener tantos elementos como queramos, del tipo que deseemos.


1.1 Creación de un informe

Para añadir un Informe acceda a Reporting > Custom reporting.

Report menu.png

Aparecerá una lista con todos los informes creados, si desea crear un nuevo informe, haga clic en “Create Report”.

Pre18.png



Se le presentará un formulario donde indicar el nombre del informe y seleccionar el grupo al que pertenece, también si el informe es privado o no y la descripción del mismo.

Una vez cumplimentados los campos necesarios, presione "Create".

Pre19.png




Una vez hecho esto tendremos un informe vacío.

Continuaremos con su edición, agregando elementos al mismo.

1.2 Edición de un informe

Para editar un Informe acceda a Reporting > Custom Reporting. Aparece una lista con todos los informes creados, para editar un informe se pulsa en el nombre del informe.

Pre43.png



1.3 Borrar un informe

Para borrar un informe, nos iremos a 'Reporting' -> 'Custom Reporting' y 'Report Builder'. Contiene una lista en la que se enumeran todos los informes hasta el momento. Para eliminar un informe, haga clic en el icono de la papelera que se encuentra en el lado derecho del nombre del informe.

Pre44.png


1.4 Pestañas

1.4.1 Pestaña Main

En la pestaña main es la única disponible en un Informe nuevo, ya que en esta defines los datos básicos del informe (nombre, grupo de acceso y descripción). Y ya después de guardarlo correctamente tendrás acceso al resto de las pestañas.

Main tab reporting builder.png



Los campos que hay en este formulario son:

  • Nombre: donde defines el nombre del informe.
  • Grupo: donde defines el grupo de acceso que puede ver el informe.
  • Descripción: esta descripción para darle mas información a los usuarios sobre el informe, se mostrara en la lista de informes, también se mostrará en la visualización del informe como XML y como PDF.


1.4.2 Pestaña List Items

En esta pestaña tendrás una visión global de todos los items que componen el informe. Los items en la lista aparecerán con el orden en que se mostrarán en informe. Desde esta pestaña se puede:

  • modificar el item (haciendo click en la llave inglesa).
  • modificar el orden por medio de las casillas izquierdas y el desplegable inferior "ordenar elementos".
  • modificar el orden de forma automática en las celdas de la cabera con las flechas blancas, ordenando alfabéticamente por tipo de elemento, alfabéticamente por nombre del agente o alfabéticamente por el nombre del agente.
  • eliminar el item haciendo click en el aspa roja.

Si es un informe extenso con multitud de items, dispone en la parte de arriba un formulario para filtrar por distintos criterios.

List items tab reporting builder.png



Las columnas que muestra esta pestaña son:

  • P. : posición en la que aparecerán los elementos en el informe.
  • Type: columna en la que aparece el tipo de los items.
  • Agent: columna en la que aparece el nombre del agente, puede estar en blanco para tipos de items como S.L.A., Custom Graph, Import text from URL, SQL Query, Simple Graph y Text.
  • Module: columna en la que aparece el nombre del módulo que se extraerá los datos para hacer el informe, puede estar en blanco para tipos de items como Agent detailed view, Alert report agent, Custom Graph, Event report agent, Import text from URL, S.L.A., SQL query y Text.
  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Description: columna que muestra la descripción que le hayas dado al item este para facilitar su trabajo sobre el.
  • Options: columna que muestra los botones/iconos para editar el item o borrarlo.


1.4.3 Pestaña Item editor

La pestaña Item editor, es la mas compleja del resto, porque desde esta se podrá crear los items del formulario o editarlos. Además el formulario es dinámico según el tipo de item a crear. En la edición se puede editar todos los campos excepto el tipo, si necesitas cambiarle el tipo, la forma de hacerlo es eliminando el actual y crearlo de nuevo con las mismas configuraciones.

Los campos comunes a todos los tipos son:

  • Type: lista desplegable con los tipos de items para el informe, el cual al elegir el tipo habilita y deshabilita los campos necesarios para configurar este tipo de item, y los tipos disponibles son: Agents/Modules, Agent detailed view, Alert report agent, Alert report module, Avg. Value, Custom graph, Event report agent, Event report module, Import text from URL, MTBF, MTTR, Max. Value, Min. Value, Monitor report, S.L.A., SQL query, Serialize data, Simple graph, Sumatory, TTO, TTRT y Text.
  • Description: caja de texto donde describir el item de informe.



1.4.4 Tipos de items

Podemos agregar diferentes tipos de elementos (items) a nuestro informe, pudiendo encontrar los siguientes tipos:


1.4.4.1 Items de gráficas
1.4.4.1.1 Simple graph

Muestra la gráfica simple de un módulo.

Simple graph - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Time comparison (overlapped): activado te muestra solapada encima la gráfica del módulo en ese margen de tiempo, por ejemplo si la gráfica muestra un tramo de 1 mes, la gráfica solapada encima es el mes anterior.

Vista de ejemplo de este tipo de informe:

Pre39.png




1.4.4.1.2 Simple baseline graph

Con este gráfico se pueden ver futuros valores estimaciones del módulo seleccionado. Por ejemplo si se selecciona un periodo de una semana y hoy es Martes, se verán los datos reales del Lunes y el Martes y las estimaciones para los demás días.

Baseline-form.png



Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.

Vista de ejemplo de este tipo de informe:

Baseline-result.png



Template warning.png

Este tipo de gráficas pueden sobrecargar en exceso Pandora FMS si se usan muchos datos para realizar las estimaciones futuras

 



1.4.4.1.3 Custom graph

Gráfica combinada definida por el usuario. Se añade un campo con un combo para seleccionar la gráfica que se quiere añadir.

Custom graph - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Custom graph: una lista desplegable con los gráficos definidos por el usuario, estos gráficos los puedes crear desde Administration, Manage reports en Graph builder.

Vista de ejemplo de este tipo de informe:

Pre26.png





1.4.4.1.4 Gráficas definidas desde SQL

Este tipo de elemento de informe permite que se puedan definir gráficas personalizadas para usarlas en los informes. Estas graficas se crearán usando código SQL introducido por el usuario. Este código SQL deberá devolver siempre una variable llamada "label" para las etiquetas de texto o nombre de los elementos a visualizar y un campo llamado "value" para almacenar el valor numérico a representar. Este es un ejemplo de SQL usado para crear gráficas de este tipo:

SELECT a.nombre as `label`, count(st.id_agente_módulo) as `value`
FROM tagente_estado st, tagente a
WHERE a.id_agente=st.id_agente AND (unix_timestamp(now()) - st.utimestamp) > st.current_interval * 2 group by 1;

En este ejemplo, mostraremos una gráfica en la que mostraremos el número de módulos en estado desconocido por agente. Es bastante similar a una consula SQL, pero no utiliza cabeceras, y sólo necesita el código SQL:

Sql graph pie.png




Estos son algunos ejemplos de cada uno de los tres tipos de graficas que se pueden dibujar con esta herramienta: gráficas circulares, de barras verticales y de barras horizontales. En este ejemplo se usan varios juegos de caracteres UTF (western latin, Japanese and Arabic) simplemente para mostrar las capacidades multiidioma de Pandora FMS.


Template warning.png

Debido a restricciones de seguridad, hay algunas palabras reservadas que no se pueden usar: *, DELETE, DROP, ALTER, MODIFY, password, pass, INSERT ó UPDATE

 


Info.png

Este tipo de items han de usarse con cuidado ya que pueden sobrecargar en exceso Pandora FMS

 


1.4.4.1.5 SQL pie graph

Ejemplo gráfico circular para informes basados en consulta SQL

Report piegraph.png



1.4.4.1.6 SQL Vertical bar graph

Ejemplo gráfica de barras verticales para informes basados en consulta SQL

Report vgraph.png



1.4.4.1.7 SQL horizonal bar graph

Ejemplo gráfica de barras horizontales para informes basados en consulta SQL

Report hgraph.png


1.4.4.1.8 Availability graph

Informe de disponibilidad, muestra un informe detallado de los estados alcanzados de un módulo en un intervalo de tiempo dado.

Nos indicará toda la información relevante acerca del tiempo que este módulo ha estado disponible.

Podremos elegir el rango de tiempo del que queremos el informe (por ejemplo, el último mes) y el tiempo de trabajo si por ejemplo necesitamos indicar que sólo nos interesa el estado de nuestro módulo en un horario determinado (por ejemplo, 8x5, de 8:00 a 16:00 de lunes a viernes).

También es posible determinar un modo de priorización. Al elegir el modo de priorización del OK, si se solapan en el tiempo datos en el rango de cumplimiento del SLA y algún otro estado (como por ejemplo una parada planificada) pintará ese tramo en verde. Si se opta por la opción de modo de priorización del desconocido, siempre se mostrará el color correspondiente al otro estado .

Availability builder.png


Tras guardar los datos del elemento del informe, agregaremos los módulos que queramos en la parte inferior:

Availability builder item.png

Nota: Puede utilizar los campos SLA min. y max. (value) para indicar que el cálculos se haga en relación a los valores alcanzados por el módulo en ese rango. SLA limit % indicará el mínimo aceptable (dentro de ese rango).

Por defecto, si no especifica un mínimo ni un máximo para el valor, se utilizarán los valores de umbrales definidos en el módulo (límites dinámicos).


Visualizando el informe veremos la gráfica de disponibilidad del módulo elegido en el rango de tiempo seleccionado:

Availability graph.png

1.4.4.1.9 Module Histogram graph

Mostrará una gráfica con el histograma de estados del módulo elegido.

Ejemplo de definición de módulo:

Histogram build.png


Ejemplo de visualización:

Histogram sample.png


1.4.4.2 Items de SLA

Todos los informes de SLA muestran información sobre el cumplimiento de una métrica, es decir, nos indican el porcentaje de tiempo que el módulo ha tenido un valor válido conocido.

Todos los SLA entienden como válido los períodos desconocidos, dado que Pandora no puede garantizar el estado del módulo si no tiene datos del mismo. También se consideran válidos todos los períodos en parada planificada (ya que al estar en una situación de parada planificada asumimos que se controla y acepta la situación del módulo) y los períodos en estado de advertencia (el servicio se sigue prestando aun en un estado no óptimo).

Como se verá posteriormente, algunos de los informes de SLA presentan datos agrupados por periodos de tiempo y se calcula el estado general de estos periodos. Al tratarse de periodos largos, el módulo del que se está haciendo el informe puede haber pasado por muchos estados: irse a desconocido, pasar por una parada planificada... En estos informes, hay un parámetro de configuración llamado modo de priorización que determina qué estados tienen preferencia al efectuar el resumen. Tiene dos opciones:

  • Modo de priorización del OK: Prima el valor de cumplimiento de SLA por encima del tiempo de no funcionamiento del informe, paradas planificadas, tiempo de desconocido y no iniciado.
  • Modo de priorización de desconocido: Cualquier valor distinto de OK primará. De esta forma, se verán los tiempos de no funcionamiento del informe, paradas planificadas, tiempo de desconocido y no iniciado aunque en haya algún dato que haga que se cumpla el SLA.

Por supuesto, si en algún momento no se alcanza el valor de cumplimiento del SLA, se pintará en rojo en cualquiera de los modos.

1.4.4.2.1 S.L.A.

Permite medir el nivel de cumplimiento de un servicio (Service Level Agrement) de cualquier monitor de Pandora FMS.

S.L.A. - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Working time: el periodo de tiempo en el que el S.L.A. estará funcionando. La gráfica se mostrará completa, pero solo se calculará con los datos dentro del tiempo de trabajo. El S.L.A. será desconocido (N/A) si el intervalo a mostrar está fuera del intervalo de trabajo.
  • Mostar gráfica, tabla o ambas: Elegir si se mostrará una gráfica de SLA, un resumen de estado o mostrar ambos elementos.
  • Orden: Ordenar los items SLA según el criterio elegido.

Una vez hemos seleccionado estas opciones, agregaremos cada uno de los módulos objetivos sobre los que queramos calcular SLA:

Availability builder item.png

  • Agent: Combo donde puede indicar el agente sobre el que aplicar el informe.
  • Module: En un combo se elige el módulo del agente previamente fijado sobre el que calculará el SLA.
  • SLA min (value): opcional, establece el valor mínimo del SLA. Los valores menores de este valor harán saltar el SLA. Puede dejarlo en blanco para utilizar los valores normales aceptables mínimos del módulo.
  • SLA max (value): opcional, establece el valor máximo del SLA. Los valores mayores de este valor harán saltar el SLA. Puede dejarlo en blanco para utilizar los valores normales máximos aceptables del módulo.
  • SLA Limit (%): establece el porcentaje de tiempo correcto para el SLA. Cuando el módulo ha estado dentro de los límites de valores mínimo y máximo, durante ese porcentaje de tiempo, el SLA aparecerá como correcto, en caso contrario aparecerá como fallido.

Es posible añadir nuevos módulos al SLA para hacer SLAs combinados de módulos de la misma o de distintas máquinas.

Template warning.png

En el caso de los SLAs combinados el cumplimiento del SLA dependerá del cumplimiento de todos los SLAs que se han configurado.

 



El valor del SLA tendrá en cuenta únicamente estados críticos del módulo seleccionado se marcarán como válidos:

  • Tiempo en desconocido.
  • Tiempo en parada planificada.
  • Tiempo en estado de advertencia.
  • Tiempo en estado de OK.

¿Por qué aceptar desconocidos?

Un estado desconocido se alcanza cuando Pandora no recibe información de un objetivo. En esta situación Pandora no puede garantizar si el servicio se dio o no se dio con normalidad, por lo ante un desconocido se acepta.


A la hora de tener en cuenta el calculo del SLA que muestra el informe podemos configurar paradas planificadas ( en el futuro o en el pasado ) para que no tenga en cuenta posibles caídas que se puedan producir en ese intervalo de la parada planificada. El valor que va a tomar en todos los intervalos en los que esté la parada planificada activa, es un valor OK, como si en ese intervalo no se hubiese producido ningún dato erróneo.

SLA 2.png



En este ejemplo lo podemos observar mejor. En la primera imagen vemos un histórico de un módulo en el que tenemos dos intervalos en estado crítico. Sin parada programada el SLA es del 93%.

SLA sinsch.png



Tras ver que la primera caída que se ha producido del módulo ha sido por problemas externos, se añade una tarea programada que abarque ese intervalo. Al añadir la tarea programada el calculo final lo tomará como si en todo ese intervalo el estado del módulo haya sido correcto.

SLA consch.png


Nota: Si olvidó crear una parada planificada, puede crear paradas planificadas en el pasado siempre que el administrador de la consola lo haya habilitado.


1.4.4.2.2 S.L.A. Mensual

Este item se encuentra en la versión Enterprise y es una variante del S.L.A., que en lugar de medir el nivel de servicio en un periodo, lo hace en cada día de los meses comprendidos en ese periodo.

Ejemplos:

  • En un informe del 5 de mayo, se hará un S.L.A. de todos los días de Mayo.
  • En un informe entre las fechas comprendias entre el 13 de Febrero y el 4 de Abril, se hará un S.L.A. de todos los días de Febrero, Marzo y Abril.

Cada módulo en cada mes tendrá los mismos datos que un S.L.A. normal, con la diferencia que el nivel de cumplimiento no será el nivel del mes, sino el porcentaje de días que lo cumplen. Además se mostrará una barra con todos los días del mes y un código de colores:

  • Verde: S.L.A. cumplido.
  • Rojo: S.L.A. no cumplido.
  • Gris: Desconocido. No hay datos suficientes en ese día.

Info.png

Los días en desconocido serán tenidos en cuenta como datos válidos para el porcentaje de días que cumplen el S.L.A.

 


Si hay días que no cumplen el S.L.A. se detallarán en una tabla resumen.

S.L.A. Monthly - view.png



1.4.4.2.3 S.L.A. Semanal

Muestra el SLA de los módulos elegidos por semanas a lo largo del período seleccionado (por defecto mes actual)

Sla weekly.png


Nos permite editar el working time por si tuviéramos un horario de servicio personalizado (p.e. 8x5)

En la parte inferior podemos agregar múltiples módulos a este ítem.

Ejemplo de visualización:

Sla weekly sample.png

1.4.4.2.4 S.L.A. Hora a hora

Muestra el SLA de los módulos elegidos por hora a lo largo del período seleccionado (por defecto mes actual)

Sla hourly.png


Nos permite editar el working time por si tuviéramos un horario de servicio personalizado (p.e. 8x5)

En la parte inferior podemos agregar múltiples módulos a este ítem.

Ejemplo de visualización:

Sla hourly sample.png

1.4.4.2.5 S.L.A. de Servicios

Permite medir el nivel de cumplimiento de servicio (Service Level Agrement - SLA) de cualquier servicio creado en Pandora FMS.

S.L.A servicios.png



Los campos de este formulario son:

  • Period: el intervalo de tiempo sobre el que se evaluará el informe desde el momento actual hacia atrás.
  • Working Time: Tiempo de validez a tener en cuenta para el cálculo del SLA (para, por ejemplo, horarios de trabajo 8x5).

Dado que los servicios en Pandora FMS incorporan sus propias lecturas SLA, el cálculo para el informe es diferente del funcionamiento estándar.

En este caso únicamente podremos elegir los servicios cuyos SLA queramos recibir de aquellos servicios que tengamos definidos en nuestra consola de Pandora. Los valores límites de validez de SLA se recuperarán de forma automática de la definición del propio servicio.

S.L.A servicios2.png



Siempre podemos definir paradas planificadas para ajustar los niveles de complimiento en el momento que necesitemos, para que no se tengan en cuenta posibles caídas que se hubieran podido producir.

Estas paradas planificadas podrán estar asignadas a los módulos que componen el servicio cuyo informe queremos, o sub servicios del mismo. En todos los intervalos a los que afecte una parada planificada configurada se obviarán los estados que el servicio hubiera podido alcanzar y no se tendrá en cuenta ese periodo para el cálculo del SLA final.

S.L.A total.png

En este ejemplo podemos observar un esquema del calculo final del servicio dependiendo de las paradas planificadas (naranja) y los estados críticos (rojo) de los módulos de los que depende el estado del servicio final para su calculo de SLA.

Si observamos la imagen, cuando en alguno de los módulos tenemos una parada afecta directamente al servicio final y se omite este intervalo para su calculo final.


1.4.4.3 Items de predicción
1.4.4.3.1 Prediction date

Este tipo de ítem permite, utilizando una proyección de los datos de un módulo a futuro,s devolver la fecha en la cual el módulo tomará un valor entre un rango.

Para realizar el cálculo, se utiliza el método de los mínimos cuadrados [1].

Para configurar este tipo de ítem se deben proporcionar los siguientes datos:

  • Period: El periodo de tiempo que se tomará de base para la estimación.
  • Data Range: El intervalo dentro del que deberán estar los datos del módulo para devolver la fecha.

Por ejemplo, para comprobar en qué momento se alcanzará un valor entre 60 y 100% de uso de disco para el punto de montaje /var usaremos la siguiente definición

Projection graph5.png




Lo que, en nuestro caso, nos generará la siguiente salida:

Projection graph3.png


1.4.4.3.2 Projection graph

Este tipo de ítem permite realizar una estimación de los valores que tomará un módulo en un futuro.

Esta estimación se basa en una regresión lineal [2], implementada siguiendo el método de los mínimos cuadrados [3].

Deberá configurar los siguientes parámetros con exactitud para poder recibir resultados relevantes:

  • Period: El periodo de tiempo que se tomará de base para la estimación.
  • Projection period: El periodo de tiempo a futuro en el cual se proyectarán los datos.

Projection graph periods.png

En la imagen de ejemplo, vemos que la zona marcada period representa la evolución de los datos del módulo durante el intervalo de tiempo que hemos seleccionado.

Por contra, projection period muestra la probable evolución del módulo en el tiempo seleccionado.

Un ejemplo de definición, como complemento al caso anterior, es el de la evolución de uso de disco montado en /var

Projection graph6.png


Obteniendo los siguientes resultados:

Projection graphs.png

1.4.4.4 Items de módulo
1.4.4.4.1 Avg. Value

Valor medio de un módulo en el periodo definido. Este periodo se calcula en el momento de ver el informe. En el menú de configuración se añaden los campos Source Agent, donde se elige el Agente y Module y, después, el módulo del que se muestran el valor medio.

Avg value - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: el periodo de tiempo que cogerá hacia atrás en el punto temporal en que se genere el informe.
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Calculate for custom intervals: Mostar los datos de promedo en interalos personalizados.
  • Table / Graph options: Mostar tabla, gráfica o ambos.

Y en la versión del informe en Html se genera un item de este tipo por ejemplo:

ReportAVGExample.png






1.4.4.4.2 Max. Value

Valor máximo un módulo en el periodo definido, este periodo se calcula en el momento de ver el informe.

Max. Value - item editor tab - reporting builder.png


Los campos de este formulario son:

  • Period: el periodo de tiempo que cogerá hacia atrás en el punto temporal en que se genere el informe.
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Calculate for custom intervals: Habilita la posibilidad de mostrar el informe en múltiples sub intervalos.
  • Time lapse intervals: Duración de cada sub intervalo.
  • Table | graph | both: Mostrar los datos de cada valor de cada sub intervalo en una tabla o una gráfica o ambos elementos.


Ejemplo de visualización:

Pre29.png





1.4.4.4.3 Min. Value

Valor mínimo un módulo en el periodo definido, este periodo se calcula en el momento de ver el informe.

Min. Value - item editor tab - reporting builder.png


Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Calculate for custom intervals: Habilita la posibilidad de mostrar el informe en múltiples sub intervalos.
  • Time lapse intervals: Duración de cada sub intervalo.
  • Table | graph | both: Mostrar los datos de cada valor de cada sub intervalo en una tabla o una gráfica o ambos elementos.


Ejemplo de visualización:

Pre30.png





1.4.4.4.4 Monitor report

Muestra el porcentaje de tiempo que un módulo ha estado mal y ha estado bien en el periodo definido.

Monitor report - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.

Y en la versión del informe en Html se genera un item de este tipo por ejemplo:

Pre32.png





1.4.4.4.5 Serialize data

Muestra un item en el informe en formato tabla a partir de los datos guardados en la tabla tagente_datos_string en la base de datos de Pandora. El agente para ello deber serializar los datos separandolos con un carácter separador linea y otro separador de campo, y todas las líneas deben contener todos los campos. Este tipo de item por ejemplo se usa para el agente que extrae datos de gestión de la plataforma SAP (http://en.wikipedia.org/wiki/SAP_AG).

Serialize data - item editor tab - reporting builder.png


Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Serialized header: campo de texto donde poner separados por | para definir las cabeceras de la tabla que se mostrará en el informe, por cada columna que saliera al separar el campo compactado.
  • Field separator: separador en distintos campos la cadena de texto serializada.
  • Line separator: separador en distintas lineas (compuestas por campos) de la cadena de texto serializada.


El módulo que genera el informe siguiente devuelve líneas con el siguiente contenido:

Some text sample|some value#this is a new row|and another value

Cuando generamos un informe a partir de este contenido tenemos la siguiente salida:

Serialize sample.png


1.4.4.4.6 Sumatory

Muestra la suma de los valores de un módulo en un periodo determinado.

Sumatory - item editor tab - reporting builder.png


Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.

A continuación se muestra un ejemplo de visualización:

Pre40.png

1.4.4.4.7 Historical Data

Este tipo de elemento nos servirá para recibir un volcado de los datos almacenados del módulo que indiquemos en la configuración del informe.

Configuraremos los siguientes campos:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.

Historical.png


Ejemplo de visualización del informe:

Historical sample.png

1.4.4.4.8 Increment

Utilizaremos este tipo de elemento de informe para mostrar un breve análisis en el que se nos indicará la variación de valor del módulo indicado.

Configuraremos los siguientes campos:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.

Increment.png


Ejemplo de visualización del informe:

Increment sample.png

1.4.4.5 Items agrupados
1.4.4.5.1 General

Muestra valores de diferentes módulos ordenados (ascendentemente, descendentemente o por nombre de agente) o/y agrupados por agente.

Configuraremos los siguientes campos:

  • Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Last value: Mostrar únicamente la última lectura de los módulos elegidos.
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Group by agent: Agrupar las métricas del informe por agente.
  • Order: Orden en el que mostrar las métricas.
  • Show summary: Mostrar un resumen final con los valores promedio, máximos y mínimos.
  • Show in the same row: Mostrar todas las operaciones (max,min,avg o sum) en la misma fila.

Grouped general.png


Ejemplo de visualización del informe:

Grouped general sample.png



1.4.4.5.2 Group report

Muestra una tabla con la siguiente información de un grupo determinado:

  • Agentes
    • Número total
    • Número de agentes en estado desconocido
  • módulos
    • Número total
    • Número de módulos en estado normal
    • Número de módulos en estado crítico
    • Número de módulos en estado de advertencia
    • Número de módulos en estado desconocido
    • Número de módulos no iniciados
  • Alertas
    • Número de alertas definidas
    • Número de alertas disparadas
  • Eventos
    • Número de eventos en ese grupo de las últimas 8 horas

Group-report-from.png


Los campos de este formulario son:

  • Grupo: combo para seleccionar el grupo.
  • Recurse: Analizar recursivamente los grupos hijos del grupo seleccionado.

Ejemplo de visualización del informe:

Group-report-result.png


1.4.4.5.3 Exception

Muestra valores de diversos módulos que cumplen operaciones lógicas (mayor o igual, menor, OK o No OK).

Report last value exc.png

Podremos configurar los siguientes campos:

  • Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Last value: Mostrar únicamente la última lectura de los módulos elegidos.
  • Order: Orden en el que mostrar las métricas.
  • Value: valor que se considerará con la condición elegida.
  • Condition: Condición con la que cribar los datos del informe, everything ignora el cribado.
  • Show summary: Mostrar un resumen final con los valores promedio, máximos y mínimos.
  • Show in the same row: Mostrar todas las operaciones (max,min,avg o sum) en la misma fila.

En la parte inferior podremos agregar tantos módulos como necesitemos una vez guardado el elemento de informe:

  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.

Ejemplo de visualización del informe:

Exception - item editor tab - reporting builder.png



1.4.4.5.4 Agents/Modules

Muestra una matriz de agentes y modules de un determinado grupo de módulos con su estado asociado.

Agents-modules - item editor tab - reporting builder.png






1.4.4.5.5 Consultas SQL

Este item muestra en los informes datos de la BD de datos de Pandora de en tabla para disponer en el informe de datos personalizados extraidos directamente de la BD.

Template warning.png

Este tipo de items han de usarse con cuidado ya que pueden sobrecargar en exceso Pandora FMS

 



Los campos de este formulario son:

  • Query SQL: caja de texto donde escribir la consulta SQL para extraer los datos de la BD de Pandora.
  • Serialized header: campo de texto donde poner separados por | para definir las cabeceras de la tabla que se mostrará en el informe, por cada columna que saliera de resultado en la consulta SQL.
  • Custom SQL template: lista desplegable que contiene las plantillas de SQL de consultas guardadas para su fácil uso. Estas se pueden gestionar por medio de Administration, Manage reports en Custom SQL.
  • Query History Database: Casilla de chequeo que al ser marcada hará que la consulta sql editada recoja también los datos de la base de datos histórica.

Podemos personalizar las consultas que aparecerán en informe eligiendo una opción de las siguientes:

  • Escribir manualmente en el campo de texto la consulta a realizar.

Nota: Debido a restricciones de seguridad, hay algunas palabras reservadas que no se pueden usar: *, DELETE, DROP, ALTER, MODIFY, password, pass, INSERT ó UPDATE.


Custom sql report.png


  • O bien, podemos seleccionar una consulta de la lista utilizando el desplegable Custom SQL template:

Custom sql template report.png


Ejemplo de visualización de informe:

Custom sql report sample.png



Nota: Puede definir sus propias plantillas en el menú Reporting > Custom SQL

Custom sql menu.png


En la vista de la lista de consultas, puede crear su nueva consulta almacenada pulsando el botón Create custom SQL:

Custom sql list.png


Defina su consulta y un nombre para identificarla y presione "save" para que aparezca en la lista:

Custom sql new.png





1.4.4.5.6 Top N

Muestra N valores discriminados por máximo, mínimo o media sobre el total de módulos añadidos, ordenados ascendente, descendentemente o por nombre de agente.

Report topn.png

Ejemplo de visualización de informe:

Report topn sample.png



1.4.4.5.7 Network interfaces

Este tipo de elemento de informe nos generará las gráficas de interfaces de todos aquellos dispositivos que pertenecen al grupo seleccionado.

Report net interfaces.png


Podemos indicar:

  • Time lapse: Rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Group: Grupo donde se buscarán agentes con módulos de tráfico de interfaz.
  • Full resolution graph (TIP): Usar el sistema de pintado de datos reales TIP en vez del motor estándar.


Nota: Se considerará que un agente tiene datos de tráfico de interfaz cuando tenga módulos con el siguiente formato:

  • Nombre de interfaz_ifInOctects
  • Nombre de interfaz_ifOutOctects
  • Nombre de interfaz_ifOperStatus

Nota: Los contadores de octetos de entrada/ salida también pueden recogerse de los contadores HC (hcOctets).


Ejemplo de visualización de informe:

Report net interfaces sample.png




1.4.4.5.8 Disponibilidad

Se ha mejorado enormemente la funcionalidad de este tipo de informe, logrando que los datos representados en él ya no sean aproximaciones, sino reflejo exacto de la situación de los módulos a lo largo del período seleccionado.

Este ítem muestra un tabla con los datos de disponibilidad de una lista de agentes y módulos seleccionada.

También ofrece la posibilidad de mostrar un resumen en el que mostrarán aquellos módulos con mayor y menor disponibilidad, así como un análisis del promedio.

Report availability.png


Puede personalizar los siguientes campos:

Los campos de este formulario son:

  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Working time: el periodo de tiempo en el que el módulo debería haber estado funcionando. La gráfica se mostrará completa, pero solo se calculará con los datos dentro del tiempo de trabajo. La disponibilidad será desconocida (N/A) si el intervalo a mostrar está fuera del intervalo de trabajo.
  • Show address instead of module name.Show the agent's main address.: Mostrará la IP principal del agente en vez del nombre.
  • Show summary: Mostrar un resumen final.
  • Orden: Ordenar los items disponibilidad según el criterio elegido.
  • Hide not init agents: Ocultar de la vista aquellos agentes no iniciados.


Una vez hemos seleccionado estas opciones, agregaremos cada uno de los módulos objetivos sobre los que queramos calcular SLA:

Report availability add module.png

  • Agent: Combo donde puede indicar el agente sobre el que aplicar el informe.
  • Module: En un combo se elige el módulo del agente previamente fijado sobre el que calculará el SLA.


Ejemplo de visualización de informe:

Report availability sample.png


Muestra la siguiente información:

  • Agente: agente.
  • Module / Dirección IP: al configurar el item puedes elegir que muestre la dirección ip primaria del agente en vez módulo, muy útil para informes que pongan una lista agentes e ips en vez de por agentes y módulos ping.
  • Total time: Tiempo total a analizar.
  • Time failed: Tiempo en estado crítico.
  • Time OK: Tiempo en estado OK o advertencia.
  • Time Unknown: Tiempo en estado desconocido.
  • Time Not init: Tiempo no iniciado.
  • Time downtime: Tiempo en parada planificada.
  • %OK: Porcentaje de tiempo en estado correcto.
  • Total checks: número de chequeos totales realizados durante el lapso de tiempo configurado para el informe.
  • Checks failed: número de chequeos que han fallado (críticos).
  • Checks OK: número de chequeos correctos.
  • Checks Unknown: Aproximación basada en eventos y la lógica de Pandora FMS que permite indicar el número de chequeos que deberían haberse realizado, pero de los que no consta una respuesta.



1.4.4.6 Items de texto/ HTML
1.4.4.6.1 Text

Este item muestra en los informes un texto formateado, para por ejemplo añadir mas información de la empresa al informe.

Text report module - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Text: caja de texto enriquecida que permite formatear el texto, e incluso añadir links e imágenes desde un servidor remoto.

Captura de ejemplo de la ventana para añadir link:

Edit link - report builder.png



Captura de ejemplo de la ventana para añadir imagen:

Edit image - report builder.png




Puede agregar cualquier contenido html a este elemento.

Ejemplo de visualización de informe:

Html text sample.png



1.4.4.6.2 Import text from URL

Este item muestra el texto extraído desde un servidor externo al que tenga acceso Pandora Console, hay que tener en cuenta que en formato informe Html lo mostrará tal cual, pero en la versión en PDF informe solo mostrara el texto en formato plano.

Import text from URL - item editor tab - reporting builder.png



Los campos de este formulario son:

  • URL: campo de texto donde introducir la dirección del server externo a extraer el texto.


Ejemplo de visualización del informe:

Html url sample.png


1.4.4.7 Items de alertas
1.4.4.7.1 Alert report agent

Muestra un listado con las alertas lanzadas por los agentes del grupo del informe en el periodo definido.

Alert report agent - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: el rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Agent: un control inteligente para seleccionar el agente para este item.

Ejemplo de informe:

Pre23.png





1.4.4.7.2 Alert report module

Muestra un listado con las alertas lanzadas por el módulo en el informe en el periodo definido.

Alert report module - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: el rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.

ReportModuleAlert.png




1.4.4.7.3 Alert report group

Muestra un listado con las alertas lanzadas en cualquier elemento del grupo definido en el informe en el periodo definido.

ReportGroupAlert.png



Los campos de este formulario son:

  • 'Time lapse: el rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Group: Grupo sobre el que se analizará la información de disparo de alertas.
  • Recursion: Analizar los grupos hijo del grupo definido de manera recursiva.

ReportGroupAlertExample.png




1.4.4.8 Items de eventos
1.4.4.8.1 Event report agent

Muestra un listado con los eventos ocurridos en el agentes en el periodo definido

Event report agent - item editor tab - reporting builder.png



Los campos de este formulario son:

  • Period: el rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Agent: el control inteligente para elegir el agente para este item.
  • Severity, event type, event status: Seleccione los tipos de evento que desee visualizar.
  • Event graphs: Mostrar gráficas de resumen de eventos.


Ejemplo de visualización de este tipo de informe:

Pre27.png



1.4.4.8.2 Event report module

Muestra un listado con los eventos ocurridos en el módulo de un agente en el informe en el periodo definido.

Event report module - item editor tab - reporting builder.png


Los campos de este formulario son:

  • Period: el rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Agent: el control inteligente para elegir el agente para este item.
  • Module: lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Severity, event type, event status: Seleccione los tipos de evento que desee visualizar.
  • Event graphs: Mostrar gráficas de resumen de eventos.


Ejemplo de visualización de este tipo de informe:

Report module events sample.png



1.4.4.8.3 Event report group

Muestra un listado con los eventos ocurridos en los agentes del grupo del informe en el periodo definido

Event-report-group-from.png



Los campos de este formulario son:

  • Period: el rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Grupo: combo para seleccionar el grupo.
  • Severity, event type, event status: Seleccione los tipos de evento que desee visualizar.
  • Event graphs: Mostrar gráficas de resumen de eventos.


Y en la versión del informe en Html se genera un item de este tipo por ejemplo:

Event-report-group-result.png





1.4.4.9 Items de inventario
1.4.4.9.1 Inventory

Este item se encuentra en la versión Enterprise y muestra el inventario seleccionado de una o varias máquinas correspondiente a un momento concreto o bien el último conocido.

Inventory item form.png

Los campos de este formulario son:

  • Descripción: Campo de texto con descripción del item
  • Grupo: Combo que filtra los agentes que aparecen en el siguiente campo. No se refleja en el informe, es solo una utilidad del formulario.
  • Agentes: Agentes de las máquinas de las que se tomará el inventario. Solo aparecerán los agentes con módulos de inventario.
  • módulos: Los módulos de inventario comunes a los agentes seleccionados.
  • Fecha: Fecha de los datos mostrados. Si se escoge Último, se tomarán los últimos datos de inventario conocido de los módulos seleccionados.

Inventory report sample.png



1.4.4.9.2 Inventory changes

Este item muestra los cambios de inventario registrados en una o varias máquinas dentro de un periodo seleccionado.

Inventory changes form.png



Los campos de este formulario son:

  • Descripción: Campo de texto con descripción del item
  • Periodo: Periodo en el que se registraron los cambios
  • Grupo: Combo que filtra los agentes que aparecen en el siguiente campo. No se refleja en el informe, es solo una utilidad del formulario.
  • Agentes: Agentes de las máquinas de las que se tomará el inventario. Solo aparecerán los agentes con módulos de inventario.
  • módulos: Los módulos de inventario comunes a los agentes seleccionados.

Info.png

Los datos para este item son recogidos de los eventos de cambios en el inventario. Si el item fuese demasiado grande, puedes eliminar algunos de esos eventos manualmente para reducirlo.

 



Ejemplo de visualización de este tipo de informe:

Inventory changes report sample.png



1.4.4.10 Items de configuración
1.4.4.10.1 Configuración de agente

Este tipo de informe nos mostrará una fotografía del estado del agente:

Agent configuration report.png


Ejemplo de visualización

Agent configuration report sample.png




1.4.4.10.2 Opciones de grupo

Este tipo de informe nos mostrará una fotografía del estado de los agentes que pertenecen al grupo seleccionado:

Group configuration report.png


Ejemplo de visualización:

Group configuration report sample.png



1.4.4.11 Items de Netflow
1.4.4.11.1 Netflow area chart

Este elemento de informe mostrará una gráfica con el análisis del tráfico utilizando filtros ya creados en la vista de Netflow.

Netflow area.png


Ejemplo de visualización de este tipo de informe:

Netflow area sample.png



1.4.4.11.2 Netflow pie chart

Este elemento muestra un gráfico circular con los resultados de aplicar el filtro indicado por el usuario.

Netflow pie.png


Ejemplo de visualización de este tipo de informe:

Netflow pie sample.png



1.4.4.11.3 Netflow data chart

Este elemento muestra los datos obtenidos al aplicar el filtro indicado por el usuario en una tabla ordenando por fecha y origen.

Netflow datachart.png


Ejemplo de visualización de este tipo de informe:

Netflow datachart sample.png



1.4.4.11.4 Netflow statistics chart

Este elemento de informe mostrará una tabla con el valor agrupado del tráfico, utilizando filtros ya creados en la vista de Netflow.

Netflow statistics.png


Ejemplo de visualización de este tipo de informe:

Netflow statistics sample.png



1.4.4.11.5 Netflow summary chart

Este elemento de informe mostrará una tabla con información resumida del tráfico que coincida con el filtro de Netflow indicado en el parametro "Filter".

Netflow summary.png


Ejemplo de visualización de este tipo de informe:

Netflow summary sample.png



1.4.4.12 Items de log
1.4.4.12.1 Informe de log

Este tipo de informe mostrará las entradas de log en el período seleccionado.

Log report build.png

  • Search: Cadena de texto a buscar.
  • Log number: Máximo número de entradas de bloque de logs que se mostrarán al generar este informe.
  • Time lapse: el rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).
  • Source: Origen de logs.
  • Agents: Agentes para el filtrado.


Ejemplo de visualización de informe:

Log report.png





1.4.5 Wizard general

Esta pestaña nos permite realizar un informe completo de forma automática, con unos pocos clic. Aplicando configuraciones comunes, puede generar elementos aplicados a multitud de agentes y o módulos. Es una característica enterprise.

Una vez elegido el tipo, el periodo, los agentes y si fuera necesario los módulos, al pulsar el botón add se generarán tantos ítems en el informe como agentes y/ o módulos hayamos seleccionado.

Wizard-tab-reporting builder.png


Los campos que componen el formulario de la pestaña:

  • Type: lista desplegable donde eligir el tipo de ítem que se generará de forma masiva, se excluyen aquellos ítems de informe que requieren de una configuración más explícita. Los tipos de items disponibles son: Alert Report Agent, Alert Report Module, AVG Module, Event Report Agent, Event Report Module, Monitor Report, Simple Graph y Disponibilidad
  • Period: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Filter group: permite filtrar los agentes por grupo.
  • Agents: Multi selector con el listado de agentes disponible para el usuario.
  • Modules: Multi selector con el listado de módulos comunes a los agentes seleccionados.
  • Elements to apply: lista de módulos ya seleccionada. Se agregarán los ítems de informe sobre los elementos de esta lista.


Ejemplo de visualización de informe (disponibilidad):

Wizard report availability sample.png



1.4.6 Wizard SLA

Este asistente nos permite crear ítems de informe SLA de manera automática.

Podemos elegir diferentes análisis de SLA:

  • SLA: mostrará un elemento de informe SLA estándar, indicando el % de cumplimiento en el período seleccionado.
  • Monthly SLA: mostrará un análisis día a día del mes seleccionado, indicando el % de cumplimiento.
  • Weekly SLA: mostrará un análisis del % de cumplimiento semana a seamana, indicando en todo momento el valor diario.
  • Hourly SLA: mostrará un análisis hora a hora del período seleccionado.
  • Availability graph: se generará una gráfica con los datos de disponibilidad de los módulos seleccionados.
  • SLA services: se creará un nuevo elemento de informe que representa el cálculo de los SLA de los servicios seleccionados.


Podrá elegir los rangos de validez de valor de los módulos a seleccionar. Esta característica le permitirá comprobar el % de tiempo que un módulo ha mantenido valores dentro de rangos específicos.

Si no define umbrales, estos se ajustarán dinámicamente a los umbrales de criticidad de cada módulo.


Puede encontrar otras opciones:

  • Hide not init agents: sólo SLA básico, ocultará los elementos no iniciados del informe.
  • Show graph: sólo SLA básico, permite elegir si mostrar una tabla con los datos, una gráfica, o ambos.


Wizard sla skel.png



Ejemplo de visualización de informe:

Report avail1.png




1.4.7 Global

En este apartado del informe, podremos crear elementos de tipo Exception, General o Top N de una manera sencilla mediante el uso de un asistente.

De esta forma podremos añadir diferentes módulos de diferentes agentes, pudiendo elegir además la operación a realizar en cada módulo: sumatorio, media, mínimo, máximo.

Global2.jpg


Ejemplo de visualización de informe:

Wizard global sample.png






1.4.8 Opciones avanzadas de informe

En la pestaña de configuración avanzada del informe, podremos editar varios aspectos visuales del mismo:

  • Personalizar el tipo de fuente.
  • Seleccionar un logo a usar en las cabeceras de los ficheros en formato PDF.
  • Editar el texto de cabecera y del pie de cada página.
  • Editar la portada del informe

Advance options-tab-reporting builder.png

Family Font
La fuente por defecto es Times Roman. Para personalizar el tipo de fuente, seleccione la fuente deseada de la lista desplegable.

Nota: Esta lista se construye a partir de los archivos 'ttf' contenidos en el directorio

/var/www/html/pandora_console/enterprise/include/mpdf50b/ttfonts

Puede agregar los archivos de fuentes en formato TTF a este directorio. Deberán tener los permisos correctos para que el usuario bajo el que se proporciona el servicio web tenga acceso a estos archivos, por defecto apache:apache en sistemas basados en CentOS. Pandora FMS incluye la fuente "code" que visualiza todos los caracteres existentes en UTF8.


Custom logo
Por defecto se utilizará pandora_log.jpg. Puede seleccionar de la lista desplegable cualquiera de los posibles logos para decorar la cabecera de cada página PDF.

Nota: Esta lista se construye a partir de los archivos de imagen contenidos en el directorio:

/var/www/html/pandora_console/images/custom_logo/

Puede agregar los archivos de imagenes a este directorio. Deberán tener los permisos correctos para que el usuario bajo el que se proporciona el servicio web tenga acceso a estos archivos, por defecto apache:apache en sistemas basados en CentOS.

Header
Un editor de texto enriquecido en el que copiar y pegar texto formateado desde una aplicación ofimática o realizar la edición in situ. Será este texto el que mostrará en la cabecera de cada página PDF.
First page
Otro campo de edición de texto enriquecido, en esta caso nos permite editar la página de la portada PDF.
Footer
Campo con editor de texto enriquecido, nos permitirá editar los pies de página PDF.




1.4.8.1 Macros

Para reutilizar plantillas de edición, puede utilizar las siguientes macros en los campos de texto enriquecido:

  • (_DATETIME_): se sustituirá por la fecha del momento en que se genera el informe, en el formato de fecha configurado en las opciones generales de Pandora FMS Console.
  • (_REPORT_NAME_): Se sustituirá por el nombre del informe.



1.4.9 Pestaña Preview

Esta pestaña muestra el informe tal como se cuando se genera en formato Html, para poder ir viendo los resultados de una forma cómoda. El informe se ve tal cual lo vería un usuario en la seccion de ver informe.


1.5 Visualización de un informe

Puede consultar la lista de informes a través del menú Reporting > Custom Reporting:

Report menu.png

Dentro de esta página podrá acceder a los informes ya definidos o crear nuevos.

Report list.png


Puede visualizar los informes en HTML, XML, PDF o CSV.

A través de esta vista también puede enviarlos por e-mail. Para ello, indicaremos la dirección destino donde recibir el informe en formato PDF. Si necesitáramos enviar a varios destinatarios, indicaríamos las direcciones separadas por comas:

Send email.png



Para mostrar una versión en HTML del informe, haremos clic en el iconoPre46.png.

Siempre se generará la vista programada para el informe. Podrá seleccionar otros períodos de tiempo una vez se haya generado el informe en HTML.

Pre47.png



Para ver un informe en XML se pincha en el icono Pre48.png

Pre49.png



Para ver un informe en PDF se pincha en el icono Pre50.png

Pre51.png




1.6 Programación automática de informes

En la versión Enterprise de Pandora FMS dispone de la extensión CRON. Esta extensión nos permite programar diferentes tipos de acciones para ser ejecutadas con una periodicidad configurable.

Entre las múltiples opciones que ofrece, nos permite configurar el envío de informes en formato PDF a través de correos electrónicos.

Encontraremos esta funcionalidad en la entrada de menú Servers > Cron Jobs.


Cron menu.png


1.6.1 Envío automático de un informe por correo electrónico

Para enviar un informe a través de correo electrónico de forma programada, utilizaremos la extensión de consola enterprise CRON con las siguientes opciones:

Task
Seleccionaremos send custom report by e-mail. Nos permitirá programar la generación y envío de un informe ya existente.
Scheduled
En este campo especificaremos la frecuencia con que se enviara el informe.
First Execution
En este campo estableceremos la fecha y hora de la primera ejecución.
Report build
En este campo seleccionaremos el informe que se quiere enviar
Send to mail
En este campo se pone la dirección de mail a la que se enviará el informe.

Pre52.png

Una vez se han rellenado los datos se pulsa en create y aparece la tarea en la lista de tareas programadas.

Pre53.png


Una vez se ha creado la tarea, es posible forzar su ejecución pulsando en el icono circular que hay a la izquierda de la tarea programada. También podremos editar o borrar la tarea programada utilizando los botones situados a la derecha.




1.6.2 Aplicación y envío de plantilla de informe por correo electrónico

Para aplicar una plantilla y enviar el resultado a través de correo electrónico de forma programada, utilizaremos la extensión de consola enterprise CRON con las siguientes opciones:

Task
Seleccionaremos Send custom report (from template) by e-mail: Nos permitirá aplicar una plantilla de informe sobre agentes a nuestra elección, y programar su generación y envío.
Scheduled
En este campo especificaremos la frecuencia con que se enviara el informe.
Next Execution
En este campo estableceremos la fecha y hora de la siguiente ejecución.
Template to build
En este campo seleccionaremos la plantilla del informe que se quiere generar.
Agents
Seleccionaremos los agentes sobre los que aplicar la plantilla.
Send to mail
En este campo se pone la dirección de mail a la que se enviará el informe.

Cron report template.png



1.6.3 Configuración

Para que funcione el envío del email, debe configurarse previamente en las opciones de Pandora FMS.

Para editar esta configuración acceda a Configuration > Setup > Enterprise

Menu config enterprise.png

Deberá configurar correctamente la sección del correo electrónico situada al final de la página:

Menu config enterprise mail.png



2 Plantillas de informes

Las plantillas de informes son componentes que permiten parametrizar la creación de informes que más tarde se podrán aplicar sobre un conjunto de agentes y de forma sencilla y rápida crear un gran número de informes independientes sobre diferentes grupos de agentes.

Cada elemento de las plantillas buscará la coincidencia con un agente y/o módulo mediante una expresión regular o una sub cadena, haciendo este sistema muy flexible.

Templates1.png

Como podemos observar en la imagen anterior, crearemos una plantilla de informe en la que definiremos una serie de elementos.

Estos elementos que definiremos, son los mismos ítems de informe que podríamos definir para un informe. La diferencia reside en que cada uno de estos ítems de plantilla generará uno o más ítems de informe siempre que al aplicar la plantilla, exista una coincidencia con algún agente/módulo de los elegidos en dicha aplicación.

En el siguiente punto veremos un ejemplo práctico de una plantilla de informes, con ejemplos de tres ítems de plantillas diferentes.

2.1 Ejemplo

Accederemos a la pantalla de informes siguiendo el enlace del menú: Reporting > Custom reports

Report menu.png

Una vez dentro haremos clic en la pestaña de plantillas:


List templates.png


En esta página, podremos ver la lista completa de plantillas definidas en nuestra consola de Pandora FMS y



Template main.png



Este ejemplo de plantilla contendrá tres items de plantilla:

  • Una gráfica combinada automática que permitirá crear gráficos sobre los módulos que coincidan en la aplicación.
  • Un informe Top N.
  • Un informe de eventos de agentes.



Templates list items1.jpeg



2.2 Ejemplo 1: Automatic combined graph

Este elemento generará gráficas que mostrarán la latencia de escritura y lectura de disco de los agentes seleccionados.

Para ello creará gráficas combinadas por cada agente que cuyo nombre de módulo sea igual a "Disk Read Latency" y "Disk Write Latency".

Una vez cree las gráficas combinadas, las agregará al informe generado.

Template automatic graph.png


En este ejemplo se ha optado por elegir de un control los módulos objetivo pero también se podría seleccionar los módulos mediante una expresión regular rellenando el campo Modules to match (Free text). Por ejemplo la expresión regular .*cpu.* se aplicaría sobre módulos como: cpu_user, total_cpu_usage, cpu, etc.

Dispondremos de la opción de agregar una etiqueta label dinámica al futuro ítem de informe. En este campo podremos usar macros predefinidas para identificar el ítem que se generará. Muy útil cuando imprimimos en PDF ya que identificaremos inequívocamente el ítem de informe que estamos buscando en el menú.

Otro campo importante del formulario para este tipo de ítem de plantilla es Create a graph for each agent. Una vez activado, nos permitirá crear una gráfica combinada por cada agente. Si está deshabilitado, el sistema combinará todos los datos en una única gráfica combinada donde incorporará información de todos los agentes y módulos que coincidan.




2.3 Ejemplo 2 Top N

Este elemento generará un informe de tipo Top N mostrando los 10 valores de uso de CPU de usuario más elevados en el último día. Para ello este elemento aplicará sobre todos los agentes con módulos que contenga el literal "cpu_user".



Template topn.png



Como se puede observar en la imagen no se buscan los módulos de forma literal si no que se usará una expresión regular. Este comportamiento se selecciona desactivando la casilla de verificación exact match junto al nombre del agente.

Si dejáramos en blanco el nombre del agente, este ítem de plantilla coincidirá con todos los agentes seleccionados durante la aplicación de la plantilla.

2.4 Ejemplo 3 Eventos del agente

Este elemento generará un informe de los eventos generados en el último día para los agentes seleccionados.



Template agentevent.png



Como se puede observar en el campo Agent se ha utilizado la expresión regular .* que simboliza cualquier cadena alfanumérica por lo que aplicará sobre cualquier agente seleccionado.

2.5 Aplicando una plantilla

Una vez hayamos definido todos los ítems de plantilla que necesitemos podemos aplicar o instanciar esta plantilla a través de dos métodos:

2.5.1 Aplicación directa.

Podremos aplicar y visualizar directamente un informe de plantilla haciendo clic en cualquiera de los iconos de formato que aparecen en la fila que ocupa nuestra plantilla:

Template direct.png

Se nos mostrará un pop-up donde podremos elegir los agentes sobre los que se aplicará esta plantilla de informe:

Template direct2.png

2.5.2 Asistente de plantillas

Podemos hacer uso del asistente de plantillas - Template Wizard si necesitamos instanciar nuestra plantilla de informe en un informe real para tenerlo disponible en la lista de informes de Pandora FMS.


Template application.png


Podremos activar la casilla de verificación Create report per agent si queremos que se genere un informe por cada agente seleccionado. Si no lo activamos, se generará un informe general con toda la información.

  • En caso de que se genere un informe por agente el título del informe será de la forma: [título de la plantilla] - [nombre agente] ([nombre agente])
  • En caso de que se genere un informe total el título será de la forma: [título del informe] - agents ([número de agentes]) - [fecha]


Template application1.png


Para la gráfica combinada automática se creó un elemento de tipo "custom_graph". Esta gráfica tiene dos elementos para los módulos "Read Disk Latency" y "Write Disk Latency".



Template application custom graph1.png



Editando la gráfica personalizada se ve que tiene los dos módulos:



Template application custom graph.png



Para el informe Top N se creó un elemento con una expresión basada en el texto cpu

Template topn.png

Visualizando el informe renderizado se ven las diez CPUs con mayor carga:



Template application top n1.png



Para el informe de eventos del agente se crearán tres elementos (recordemos que se seleccionaron todos los agentes mediante .*):



Template application eventagent.png



2.6 Editar plantilla

Dentro de una plantilla se puede modificar los parámetros generales de la plantilla:



Template general.png



2.7 Lista de plantillas

Accederemos a la pantalla de informes siguiendo el enlace del menú: Reporting > Custom reports

Report menu.png

Una vez dentro haremos clic en la pestaña de plantillas:


List templates.png


En esta página, podremos ver la lista completa de plantillas definidas en nuestra consola de Pandora FMS y

Template main.png

2.8 Lista de items

En la sección de lista de items se pueden ver y editar los items creados dentro de la plantilla y modificar su orden además de borrarlos.

Template list item.png



2.9 Editor de items

En la sección del editor de items se podrán crear nuevos items dentro del template.

Los tipos de ítems son los mismos que los de los informes, con la diferencia que, al a hora de aplicarse a un agente o módulo, este se buscará como una expresión regular. Por ejemplo, oracle_agent.* podrá corresponders con los agentes: oracle_agent_1, oracle_agent_2, oracle_agent_producción, etc.


En caso de dejar vacío el campo, ítem de la plantilla se aplicaría sobre todos los agentes que se seleccione a la hora de aplicar la plantilla de informe:

Aplicando una plantilla

Cuando se especifique un módulo, este podrá interpretarse de forma literal activando la casilla de verificación Module exact match. Si no lo activamos, utilizará el método estándar de macheo por expresión regular.

Template agentevent.png



2.10 Opciones avanzadas

En esta sección podremos configurar aspectos visuales del informe resultante como la fuente, el logo, la cabecera, la primera página o el pie de informe, tal como haríamos con un informe estándar.

Template advance.png



2.11 Wizard

Puede seguir las instrucciones ya detalladas en este punto:

Aplicando una plantilla

Template application.png



2.12 Limpieza de informes

Para borrar los informes creados en aplicaciones anteriores de una plantilla desde el Wizard se puede seleccionar una plantilla y hacer clic en el botón para borrar (botón de la escoba).

Template wizard cleanup.png



Esta acción eliminará todos los informes creados basados en esta plantilla automáticamente.

Volver a Indice de Documentacion Pandora FMS