Pandora: Documentation es: Presentacion datos/Informes

From Pandora FMS Wiki
Jump to: navigation, search

Contents

1 Tipografía e idiomas

Pandora FMS incluye una colección de fuentes utilizables en gráficas, mapas e informes. Entre las fuentes incluídas, por defecto se utiliza (smallfont.ttf), la cual soporta juegos de caracteres tales como latino, arábigo, hiragana, katakana y muchos más.

Las fuentes están contenidas en /include/fonts, donde se podrían copiar nuevas fuentes en caso de necesitarlo.

2 Gráficas

Las gráficas muestran los datos recogidos por Pandora FMS durante un umbral de tiempo definido por el usuario. Las gráficas de Pandora FMS muestran datos a petición, siendo generadas cada vez que el operador requiere una de ellas, mostrando los datos más recientes.


2.1 Interpretar las gráficas en Pandora FMS

Las gráficas en Pandora representan los valores que un módulo ha tenido a lo largo de un período.

Debido a la gran cantidad de datos que Pandora FMS almacena, se ofrecen dos tipos diferentes de funcionalidad, las gráficas normales y las gráficas de escala completa o TIP.


2.1.1 Gráficas normales

Características generales

Son gráficas que representan la información almacenada por el módulo a un nivel básico.

Nos permite ver una aproximación de los valores en los que oscila nuestro módulo.

Dividen los datos del módulo en cajas de tal manera que se representa una muestra de los valores del módulo.

No se pintan todos los valores, lo que se complementa dividiendo la vista en tres gráficas:

  • Max (valores máximos),
  • min (valores mínimos)
  • avg (valores promedios)


  • Ventajas: Se generan muy rápidamente, sin consumir apenas recursos.
  • Inconvenientes: La información que proveen es aproximada. Los estados de los monitores que representan se calculan en base a eventos.

Graphs normal.png




2.1.2 Gráficas TIP

Características generales

Son gráficas que representan datos reales.

Nos muestra una representación veraz de los datos reportados por nuestro módulo.

Al ser datos reales no será necesario complementar la información con gráficas extra (avg,min,max).

El cálculo de períodos en estado desconocido se apoya en eventos, tal y como funcionan las gráficas normales, pero se complementa con una detección extra para los casos en que los eventos hayan sido purgados (por una optimización para el rendimiento, por ejemplo).


  • Ventajas: Los datos representados son datos reales. Es la forma más realista de revisar los datos de un módulo.
  • Inconvenientes: Su procesado es más lento que en las gráficas normales. Dependiendo del rango de tiempo y el volumen de datos a mostrar es posible que su visualización sea menos fluída.

Graphs tip.png




Tras haber visto cómo Pandora FMS interpreta las gráficas, entraremos a detallar los diferentes tipos de gráficas disponibles en función del origen de los datos:

  • Gráficas de módulo.
  • Gráficas de interfaces.
  • Gráficas personalizadas.


2.2 Gráficas de módulo

2.2.1 Introducción

Las gráficas de módulos representan los datos reportados por módulos concretos.

Puede definir en la configuración visual las gráficas interactivas o estáticas. En el caso de las gráficas interactivas, posicionando el ratón en algún punto de la parte posterior de la gráfica, se mostrará el dato concreto de ese punto.

Las gráficas no interactivas generarán una ismagen estática con la que no podrá interactuar.

Disponen de modos normal y TIP para su pintado.

En modo normal, es posible ajustar la resolución de la gráfica para mejorar la visualización, como puede ver en la siguiente imagen de ejemplo. Los valores entre los que se puede configurar la resolución son 1 (más baja) y 5 (más alta).

Comparativa resolucion graficas2.jpg

Baja resolución (1)


Comparativa resolucion graficas.jpg

Alta resolución (5)


Comparativa resolucion graficas3.jpg

Datos puros TIP


Nota: Puede configurar todos los aspectos de las gráficas en el menú Setup > Setup > Visual Style.


2.2.2 ¿Dónde encontrar las gráficas de módulo?

Las gráficas de los módulos son accesibles a través del detalle de módulos Monitoring > Views > Monitor detail.

Monitor detail.png



También puede encontrarlas en la vista de agente (listado de módulos). Para acceder a estas gráficas se debe elegir un agente desde Monitoring > Views > Agents Detail:

Pre1.png



Después de filtrar se pulsa en el nombre del agente, por ejemplo localhost.localdomain, para acceder al menu de operación del agente.

Pre2.png



En esta pantalla tenemos una lista con todos los módulos del agente. En la vista de tabla de módulos, aparecen dos iconos bajo la leyenda "Graph", uno nos mostrará los datos en bruto (derecha) y el otro un enlace para acceder a la gráfica del módulo (izquierda).

Pre3.png



Si se pulsa en el icono de la gráfica se accede a una nueva ventana donde se pueden personalizar los datos del módulo que se quieren mostrar.

Quick graph.png




Las gráficas tienen un menú de configuración que permite (pasando el ratón por encima de la solapa a la izquierda de la ventana de la gráfica), reconfigurar la vista de la gráfica actual. En la leyenda podrá ver datos estadísticos (Último valor, Media, Máximo y Mínimo) para cada una de las series mostradas.

Pre4.png



En la configuración rápida de gráficas puede ajustar los siguientes parámetros:

2.2.3 Opciones de visualización

Tiempo de refresco

Tiempo en que se pintará la gráfica de nuevo.


Avg. Only

Solo se pintará la gráfica de promedios.


Fecha de inicio

Fecha hasta la que se pintará la gráfica.


Tiempo de inicio

Hora minutos y segundos hasta los que se pintará la gráfica.


Factor de zoom

Tamaño del visor de la gráfica, multiplicativo.


Rango de tiempo

Establece el período de tiempo desde el que se recogerán los datos.


Mostrar eventos

Muestra puntos indicadores con la información de eventos en la parte superior.


Mostrar alertas

Muestra puntos indicadores con la información de alertas disparadas en la parte superior.


Mostrar percentil

Agrega una gráfica que indica la línea del percentil (configurable en opciones visuales generales de Pandora).


Comparación de tiempo (superpuesto)

Muestra superpuesta la misma gráfica, pero en el período anterior al seleccionado. Por ejemplo, si solicitamos un período de una semana y activamos esta opción, la semana anterior a la elegida también se mostrará superpuesta.


Comparación de tiempo (independiente)

Muestra la misma gráfica, pero en el período anterior al seleccionado, en un area independiente. Por ejemplo, si solicitamos un período de una semana y activamos esta opción, la semana anterior a la elegida también se mostrará.


Mostrar gráfica de desconocidos

Muestra cajas en sombreado gris cubriendo los períodos en que Pandora FMS no puede garantizar el estado del módulo, ya sea por pérdida de datos, desconexión de un agente software, etc.


Mostrar gráfica de escala completa (TIP)

Cambia el modo de pintado de "normal" a "TIP". En este modo, las gráficas mostrarán datos reales en vez de aproximaciones, por lo que el tiempo que emplearán para su generación será mayor.


Una vez se han cambiado los valores, se pincha en “Reload” para que estos se apliquen.


2.3 Gráficas de interfaces

Las gráficas de interfaces son una especialización de las gráficas combinadas que nos permiten analizar el rendimiento de una interfaz de red.

Se muestran automáticamente siempre que existan los siguientes módulos en el agente:

  • interfaz_ifOperStatus
  • interfaz_ifInOctets
  • interfaz_ifOutOctets

Octetos de entrada y de salida también pueden aparecer como sus alternativas HC (ifHCInOctects, ifHCOutOctects).


Cuando el sistema detecte la existencia de estos módulos, automáticamente generará la sección de análisis de interfaces y las gráficas siguientes:

Interface charts1.png

Vista general de agente con datos de tráfico de red


Interface charts2.png

Detalle de gráfica de interfaz



Estas gráficas también permiten la selección rápida de opciones opciones, como en las gráficas de módulos, con la particularidad que insertan en la misma vista la información de diferentes orígenes (octetos de entrada y de salida) y la variedad de opciones de pintado es menor.



2.4 Gráficas Personalizadas

Las gráficas personalizadas permiten combinar información de múltiples módulos en una única gráfica de tamaño variable. De esta forma se puede comparar visualmente información proveniente de varias fuentes.


2.4.1 Crear Gráficas combinadas

Para añadir una gráfica combinada acceda a Reporting > Custom graphs

Cg menu.png



Y haga clic en "Create graph".

Graph builder.png



En el formulario de creación podrá especificar los siguientes campos:

Nombre

El nombre que queremos asignarle a la gráfica.

Grupo

Aquí se puede asignar la gráfica a un grupo específico.

Descripción

En este campo se puede escribir la información que se desee.

Anchura

Se pone el valor que tendrá el ancho de la gráfica.

Altura

Se pone el valor que tendrá el alto de la gráfica.

Periodo

Mediante un combo se define el periodo temporal usado para crear la gráfica.

Tipo de gráfica

Mediante un combo se marca el tipo de gráfica eligiendo entre Barras horizontales, Barras verticales, Gráfico bala, Gráfico circular, Línea, Línea apilada, Medidor, Área, y Área apilada

Ecualizar umbrales

Indica si deben ajustarse los umbrales máximos y mínimos generales, para realizar comparativas de valores, en las gráficas de tipo bala (bullet chart).

Percentil

Muestra el percentil de los datos (valor configurable en las opciones visuales de la consola Pandora FMS).

Agregar serie sumatoria

Muestra el sumatorio de todos los datos.

Agregar serie promedio

Muestra la media de todos los datos.

Módulos y series

Este campo solo será editable si se selecciona agregar serie sumatoria y/o serie promedio. En ese caso, en la gráfica aparecerá los datos de los módulos junto a su sumatorio y promedio. En caso contrario, solo mostrarán las series seleccionadas.

Mostrar gráfica TIP

Se utilizará el sistema de pintado TIP para mostrar los valores reales de cada origen de datos seleccionado en la configuración de elementos.


2.4.2 Agregar elementos a gráficas combinadas

Para añadir nuevos módulos haga clic en el botón Graph Editor, se le presentará un formulario donde podrá añadir nuevos módulos de cualquier agente.

Pre8.png



La opción peso permite ajustar los datos para poder comparar gráficas de magnitudes diferentes. Este campo multiplica los datos por el peso definido.


Por ejemplo si queremos poner en la misma gráfica CPU con valores entre 0 y 100 y número de conexiones con valores entre 1000 y 10000, es conveniente multiplicar la CPU por 10.


No hay límite en el número de elementos a visualizar, pero a partir de cinco la cantidad de información mostrada hace difícil interpretarla, a no ser que se usen gráficos de gran tamaño (800x600, etc).


Ejemplo de gráfica personalizada:

Pre7.png




Puede ajustar ciertas visualizaciones dentro de la pantalla de vista:

Cg view.png



2.4.3 Ver gráficas combinadas

Para ver una gráfica combinada, se va a Reporting > Custom Graph donde aparece una lista con todas las gráficas guardadas. Para ver una gráfica haga clic sobre el nombre de la misma.

Pre12.png



Al acceder a la gráfica se pintará con los valores más recientes para el umbral de tiempo seleccionado.

Pre13.png



Desde esta página es posible modificar ciertos parámetros de visualización como son el periodo de tiempo, el tipo de gráfica y el zoom (Graph defines, Zoom x1, Zoom x2 y Zoom x3).

A continuación se ven un ejemplo con los diferentes tipos de gráfica (El tipo area esta en la imagen anterior). Area, Horizontal bars, Vertical bars, Bullet charts, Gauge, Pie, Line, Stacked line y Stacked area.

  • Tipo Area

Area.png



  • Tipo Horizontal bars

Horbars.png



  • Tipo Vertical bars

Vertbars.png



  • Tipo Bullet chart (Tenga en cuenta que esta gráfica no admite valores negativos.)

Bullchart.png



  • Tipo Gauge

Gauge.png



  • Tipo Pie

Pie.png



  • Tipo Line

Pre14.png



  • Tipo Stacked area

Pre15.png



  • Tipo Stacked line

Pre16.png



2.4.4 Borrar gráficas combinadas que se han guardado

Para borrar una gráfica combinada que se ha guardado, se va a Reporting > Custom Graphs donde aparece una lista con todas las gráficas guardadas. Se pulsa en el icono papelera que hay en la columna Op.

Cg list2.png




2.4.5 Contenedores de gráficas

A partir de Pandora FMS 7.0NG.710 aparece el concepto de "Graph container" o contenedor de gráficas.

Este concepto permite:

  • Definir tantos contenedores como queramos.
  • Anidar contenedores
  • Crear gráficas simples de módulo.
  • Referenciar gráficas personalizadas
  • Crear gráficas usando reglas dinámicas


2.4.5.1 Crear un contenedor

Para crear un contenedor de gráficas, acceda a la pestaña de contenedores desde la página principal de gráficas personalizadas:

Cg container.png


Haga clic en "Create container"

Cg container2.png

Accederá al formulario de creación:

Cg container3.png

En el formulario de creación, puede indicar campos como:

Nombre

Nombre del contenedor

Grupo

Grupo propietario de este contenedor.

Descripción

Descripción personalizada para el contenedor.

Contenedor padre

Dónde guardar este contenedor.


2.4.5.2 Agregar gráficas a un contenedor

Existen tres opciones para agregar gráficas a un contenedor:


Gráfica simple de módulo

Permite agregar una gráfica simple de módulo, seleccione el agente y el módulo a pintar, así como el umbral de tiempo.

Dispone además de las siguientes opciones:

Solo promedio: Muestra solo la gráfica correspondiente al promedio de valores (sistema normal).

Mostrar gráfica TIP: Muestra datos reales del módulo.

Cg container add1.png


Gráfica personalizada

Permite seleccionar una gráfica personalizada existente y agregarla a la lista de gráficas del contenedor.

Permite seleccionar el umbral de tiempo y si deseamos datos reales o no.

Cg container add2.png


Gráficas simples de módulo basada en reglas dinámicas

Permite agregar varias gráficas simples de módulos usando selectores basados en expresiones regulares.

Indique las expresiones regulares que deben cumplir los agentes y los módulos para ser agregados a la lista de gráficas a generar.

Por ejemplo, si tenemos los agentes oficina1,oficina2,sala1,sala2 con los módulos inOctects, y quisieramos solamente representar los módulos de los agentes oficina, lo especificaríamos como sigue:

agente: oficina.* modulo: inOctects

Automáticamente el sistema crearía 2 gráficas, una para el agente oficina1 módulo inOctects, y otra para el agente oficina2 módulo inOctects.

Dispone además de las siguientes opciones:

Solo promedio: Muestra solo la gráfica correspondiente al promedio de valores (sistema normal).

Mostrar gráfica TIP: Muestra datos reales del módulo.

Cg container add3.png



2.4.5.3 Listar y administrar gráficas de un contenedor

En la parte inferior de la página de edición del contenedor, podrá ver la lista de gráficas registradas en este contenedor, pudiendo eliminarlas pulsando en el icono de la papelera.

No es posible la edición de gráficas de contenedores, deberá crearla de nuevo con las modificaciones que requiera y posteriormente eliminarla.

Cg container edit list.png



2.4.5.4 Vista de contenedores

Pulsando en la pestaña de contenedores, podrá acceder a la lista de contenedores y sus gráficas:

Cg container list.png

En esta pestaña verá anidados aquellos contenedores así definidos.

Para ver las gráficas almacenadas en un contenedor, haga clic en el título del mismo.



3 Vista de agente / modulo

Esta sección muestra una matriz con los módulos y los agentes y el estado de cada módulo.

Se accede a la extensión desde Monitoring > Views > Agents/Modules view.



Ex4c.png



4 Vista de grupos de módulos

Esta pequeña sección permite tener una visión total en una tabla de los modulos por su estado, en función del module group y el grupo.

Se accede a la extensión desde Monitoring > Module groups.

Ex4.png


Como se ve en la imagen, se ve una matriz con el número de módulos por grupo de agentes y con diferentes colores según haya módulos en estado Critical, Warning o OK.



5 Vista de árbol

Esta vista permite la visualización de los monitores de los agentes en forma de árbol. Se accede a través de Monitoring > Views > Tree view.

Tree.jpg

Es posible elegir la vista de árbol para clasificar la información por:

  • Módulos
  • Políticas
  • Grupo de Módulos
  • Grupo
  • Sistema Operativo.

La vista por defecto es la ordenada por grupo. En este nivel, se muestra un recuento del número de agentes en estado normal (color verde), critical (color rojo), warning (color amarillo) y unknown (color gris).


Se puede filtrar por estado del módulo (Critical, Normal, Warning y Unknown) y realizar búsquedas por nombre de agente.


Pinchando sobre el nombre del agente, aparecerá un pop-up dentro de esta vista, en la parte inferior derecha de la pantalla, con información sobre el agente seleccionado: nombre, ip, fecha de la última actualización, sistema operativo, etc. así como una gráfica de eventos y otra de accesos.

Tree agent.png



6 Consola en el Teléfono Móvil

Pandora FMS incorpora el acceso a la consola desde un teléfono inteligente o una tablet. Es una versión "especial" de la consola normal de Pandora, y funciona en cualquier dispositivo capaz de navegar por internet, y que tenga que tenga al menos 600x280px de resolución. Con él, se tiene acceso a toda la información que proporciona Pandora FMS: agentes, vista del monitor, alertas, detalles del agente (gráficas incluidas), vista de grupo, últimos eventos, etc.

La interfaz para telefonía móvil está en /mobile. Así pues, suponiendo que su consola está en http://firefly.artica.es/pandora_demo su consola para móvil está en http://firefly.artica.es/pandora_demo/mobile/

Esta consola móvil es compatible con cualquier dispositivo moderno, ha sido probada en iPhone y diversos modelos basados en Android, asi como con tablets Android y iPad.



Mobile1.png

Pantalla de login





Mobile2.png

Vista táctica





Mobile3.png

Vista detallada de eventos.





Mobile4.png

Vista de una gráfica de un módulo.





Mobile5.png

Opciones generales del menu





Mobile6.png

Vista detallada del agente.



Mobile7.png

Vista detallada de modulos.

7 Informes

Pandora FMS le 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.


7.1 Creación de un informe

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

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.


7.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




7.3 Pestañas

El nuevo formulario para crear informes se ha dividido para su facilidad en las siguientes pestañas.


7.3.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.


7.3.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 modulo 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: el periodo de tiempo que cogerá hacia atrás en el punto temporal en que se genere el informe.
  • 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.


7.3.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.




7.3.3.1 Tipos de items
7.3.3.1.1 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





7.3.3.1.2 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 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.

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

Pre23.png





7.3.3.1.3 Alert report module

Muestra un listado con las alertas lanzadas por el modulo en el informe en el periodo definido.

Alert report module - 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 modulos del agente seleccionado en el control previo.



7.3.3.1.4 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 modulos 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:

Pre24.png





7.3.3.1.5 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: el periodo de tiempo que cogerá hacia atrás en el punto temporal en que se genere el informe.
  • 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.

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

Pre26.png





7.3.3.1.6 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 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.

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

Pre27.png





7.3.3.1.7 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 periodo de tiempo que cogerá hacia atrás en el punto temporal en que se genere el informe.
  • Grupo: combo para seleccionar el grupo.

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

Event-report-group-result.png





7.3.3.1.8 Event report module

Muestra un listado con los eventos ocurridos en el modulo 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 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 modulos del agente seleccionado en el control previo.



7.3.3.1.9 Exception

Muestra valores de diversos módulos que cumplen operaciones lógicas (mayor o igual, menor, OK o No OK) ordenado ascendentemente, descendentemente o por nombre de módulo dentro del periodo dado.

Exception - item editor tab - reporting builder.png



Este tipo de elemento también permite mostrar en el informe el último valor. Para ello hay que marcar la opción Last value como vemos en la siguiente imagen.

Report last value exc.png





7.3.3.1.10 Disponibilidad

Esta característica es para Pandora FMS versión (5.1SP3 y superiores).


El item de disponibilidad muestra un tabla con los datos de disponibilidad de una lista de agentes y módulos, además de un resumen con el agente y módulo con mayor disponibilidad, la disponibilidad media y la mínima. Realiza un calculo aproximado dividiendo el tiempo que ha estado el módulo en estado no normal, entre el intervalo del módulo para calcular el número de chequeos que han fallado. Es un calculo aproximado y no tiene en cuenta posibles estados desconocidos por lo que puede variar bastante del resultado obtenido por un informe SLA.

Las columnas de la tabla son:

  • 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.
  • # Chequeos: número de chequeos o muestras de datos que ha cogido el módulo en el periodo definido en el informe.
  • # Fallos: número de chequeos que han fallado (han dado valor 0) en el periodo de tiempos del informe.
  • % Fallo: el porcentaje de fallos en el periodo del informe.
  • Tiempo de chequeo: tiempo que se ha recogido datos, porque algunas veces el módulo ha sido creado o ha empezado a reportar en un punto temporal dentro del periodo definido en el informe.
  • Tiempo no disponible: tiempo que ha estado en un estado de fallo el módulo.
  • % OK: el porcentaje de correcto que ha estado el módulo en el periodo de informe.

Avaliability html view.png

Y el editor es muy parecido al editores de item General o SLA.

Avaliability editor.png


7.3.3.1.11 General

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

General - item editor tab - reporting builder.png



Info.png

Tenga en cuenta que si un módulo cambia de intervalo a lo largo de su vida útil, las cuentas del sumatorio pueden no ser correctas

 


Este tipo de elemento también permite mostrar en el informe el último valor. Para ello hay que marcar la opción Last value como vemos en la siguiente imagen.

Report last value.png





7.3.3.1.12 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.

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

Group-report-result.png





7.3.3.1.13 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.



7.3.3.1.14 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.



7.3.3.1.15 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.

 




7.3.3.1.16 MTBF

Tiempo medio entre fallas

  • Se calcula: MTBF= TTO / #F
  • Donde:
TTO=Tiempo total de operación en el periodo.
#F= número total de fallas.
  • Proporciona el tiempo promedio de operación normal entre fallas
  • Indicador de CONFIABILIDAD.

MTBF - 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 modulos del agente seleccionado en el control previo.



7.3.3.1.17 MTTR

Es el tiempo promedio para restaurar la función de un equipo, maquinaria, línea o proceso después de un fallo funcional.

  • Incluye tiempo para analizar y diagnosticar el error, tiempo para conseguir la refacción, tiempo de planeación, etc.
  • Es una medición de la mantenibilidad de un equipo.
  • Es el intervalo de tiempo obtenido dividiendo el tiempo total de las reparaciones entre el número total de fallos en un sistema.

MTTR - 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.



7.3.3.1.18 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 modulos 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:

Pre29.png





7.3.3.1.19 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: 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 modulos 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:

Pre30.png





7.3.3.1.20 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: 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 modulos 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





7.3.3.1.21 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: el periodo de tiempo que cogerá hacia atrás en el punto temporal en que se genere el informe.
  • 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.

Este formulario es mas complejo y además de los campos comunes mas o menos en los otros items, tiene abajo una lista de los subitems de modulos a calcular el S.L.A. con las siguientes columnas:

  • Agent: En un combo se elige el agente que se va a utilizar en el SLA.
  • Module: En un combo se elige el módulo que se va a utilizar en el SLA.
  • SLA min (value): Se 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): Se 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 (%): Se 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.

 


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 modulo haya sido correcto.

SLA consch.png




7.3.3.1.22 S.L.A. de Servicios

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

S.L.A servicios.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.
  • Working Time: Tiempo que se va a tener en cuenta para el cálculo del SLA

Este formulario es diferente al del cálculo del SLA normal. En este caso únicamente nos permitirá coger el Servicio que queramos mostrar dentro de los servicios que tengamos creados. El SLA limit lo extraerá directamente de la configuración del servicio.

S.L.A servicios2.png



A la hora de tener en cuenta el calculo del SLA del servicio 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. Estas paradas planificadas podran estar asignadas a los módulos de los que depende el servicio elegido, o los servicios inferiores. En todos los intervalos en los que haya parada planificada configurada se obviarán los estados que se haya dentro de ese servicio y no se tendrá en cuenta ese periodo para el cálculo del SLA final.

En este ejemplo podemos observar un esquema del calculo final del servicio dependiendo de las paradas planificadas ( blanco ) 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.

S.L.A total.png





7.3.3.1.23 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 no serán tenidos en cuenta 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



En el screenshot observamos un S.L.A. Mensual para dos módulos. En el primero se cumple en el 100% de los días con datos, y en el segundo 3 de 22 no lo cumplen por lo que se obtiene un cumplimiento del 86.36%. A partir del día 23 no hay datos porque es la fecha actual, y esos días no afectan a los cálculos.



7.3.3.1.24 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.

Hay dos formas de describir la consulta SQL:

  • una escrita a mano en la caja de texto:

SQL query custom SQL template - item editor tab - reporting builder.png



  • la otra seleccionada por medio del desplegable de Custom SQL template, que solo por medio de la versión Enterprise se puede editar de forma comoda:

SQL query custom SQL sql editor - item editor tab - reporting builder.png



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.

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


Template warning.png

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

 





7.3.3.1.25 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 representarl. Este es un ejemplo de SQL usado para crear gráficas de este tipo:

SELECT tagente.nombre AS label, datos AS value FROM tagente, tagente_estado, tagente_modulo 
WHERE tagente_estado.id_agente_modulo = tagente_modulo.id_agente_modulo AND tagente_modulo.nombre = "module_1" AND
tagente_modulo.id_agente = tagente.id_agente

Este es un ejemplo de como se definiría una gráfica de este tipo. 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.

Report vgraph.png



Report hgraph.png



Report piegraph.png



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

 




7.3.3.1.26 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: 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 modulos 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:

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

 



7.3.3.1.27 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: 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 modulos 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.


7.3.3.1.28 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: 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 modulos 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.

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

Pre39.png




7.3.3.1.29 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: 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 modulos 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:

Pre40.png




7.3.3.1.30 TTO

TTO es el tiempo total de operación (la suma de tiempo que el monitor ha estado OK).

TTO - 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 modulos del agente seleccionado en el control previo.


7.3.3.1.31 TTRT

Es la suma de todos los tiempos donde el monitor no ha estado OK.

TTRT - 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 modulos del agente seleccionado en el control previo.


7.3.3.1.32 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





7.3.3.1.33 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.

Top n - item editor tab - reporting builder.png





7.3.3.1.34 Projection graph

Este tipo de ítem permite proyectar en el futuro una estimación de los valores que tomará un módulo. Esta estimación se basa en una regresión lineal [1] y está implementada siguiendo el método de los mínimos cuadrados [2].

Projection graphs.png



Para configurar este tipo de ítem se debe completar los siguientes parámetros:

Projection graph6.png



  • 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




7.3.3.1.35 Prediction date

Este tipo de ítem permite utilizando una proyección de los datos de un módulo a futuro, devolver la fecha en la cual el módulo tomará un valor entre un rango. Al igual que el Projection graph utiliza el método de los mínimos cuadrados [3].

Projection graph3.png



Para configurar este tipo de ítem se debe completar los siguientes parámetros:

Projection graph5.png



  • 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 el módulo FreeDisk_SpoolDir y eligiendo un periodo de 15 días si se busca la fecha en la que el módulo alcanzará el intervalo [3200-0] el resultado será 03 Nov 2013 19:07:18. Visto de una manera gráfica sería:

Prediction date.png




7.3.4 Pestaña Wizard

Esta pestaña pertenece a la versión Enterprise de Pandora, esta pestaña nos permite realizar de una forma automática con unos pocos click, y de una vez multitud de items para un informe, con configuraciones comunes pero aplicadas a multitud de agentes y o módulos.

Una vez elegido el tipo, el periodo, los agentes y si es necesario los modulos, cuando se pulsa en el botón de add se generaran tantos items en el informe como agentes y o módulos seleccionados.

Wizard-tab-reporting builder.png



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

  • Type: lista desplegable donde eliges el tipo de item que se generada de forma masiva, no están todos por razones obvias ya que hay tipos de items que necesitan una configuración mas fina, pero de los tipos disponibles que tienes son: Alert report agent, Alert report module, AVG Module, Event report agent, Event report module, Monitor report y Simple graph.

Loss tipos de items disponibles son:

  • Alert Report Agent
  • Alert Report Module
  • AVG Module
  • Event Report Agent
  • Event Report Module
  • Monitor Report
  • Simple Graph
  • Availability (since 5.1SP3)


  • Period: control inteligente para darle el periodo de tiempo o segmento de tiempo de datos a representar en el item del informe desde el momento que se genera, es decir si el periodo es un mes, y generas el informe para el momento actual, los items sacaran sus datos desde un mes hacia atras.
  • Filter group: permite filtrar los agentes por grupo.
  • Agents: la lista de agentes que tienes accesible según tu grupo de permisos, de esta lista se puede seleccionar uno o varios agentes, y por cada selección, en el control de módulos aparecerán los comunes a los seleccionados.
  • Modules: esta lista de módulos comunes de los agentes seleccionados también es seleccionable uno o varios.
  • Elements to apply: esta lista de módulos son los seleccionados para ser añadidos.


7.3.4.1 Informes Availability

Este informe es solo accesible mediante la pestaña Wizard, es un informe espcial usado para detallar la disponibilidad a traves del tiempo de los módulos seleccionados, mostrando en % el tiempo que el módulo esta activo o caido.

Report avail1.png



Usando el Wizard puedes seleccionar agentes y módulos para luego ser añadidos al informe. Opcionalmente puedes elegir mostrar solo la dirección IP, en lugar del nombre del módulo(Esto es útil para esconder la terminilogía de los módulos de pandora al usuario final).

Report avail2.png




7.3.5 Pestaña Wizard SLA

Esta pestaña pertenece a la versión Enterprise de Pandora FMS, nos permite crear un informe SLA mediante el asistente. De esta forma se podrán añadir varios módulos que tengan en común varios agentes de una manera más sencilla.

Wizard-sla-tab-reporting builder.png




7.3.6 Pestaña Global

Esta pestaña pertenece a la versión Enterprise de Pandora FMS, nos permite crear un informe de tipo Exception, General o Top n de una manera sencilla mediante el uso de un Wizard. De esta forma se podrá añadir diferentes módulos de diferentes agentes, pudiendo elegir además la operación de cada módulo: sumatorio, media, mínimo, máximo.

Global2.jpg





7.3.7 Pestaña Advance options

Esta pestaña pertenece a la versión Enterprise de Pandora, en esta se puede darle mucha mas personalizacion a los informes, entre otras cosas se puede elegir la fuente en que se genera el informe en PDF, elegir el logo que aparecera en las cabecera de PDF, editar la cabecera y el pie del PDF, y editar la portada del informe.

Advance options-tab-reporting builder.png



Y los campos que componen este formulario son:

  • Family font: es una lista desplegable de todas las fuentes que tienes instalado en tu Pandora Console en el directorio <pandoraconsole>/enterprise/include//mpdf50b/ttfonts., la fuente por defecto es la fuente Times Roman. Y si quieres ampliar el juego de fuentes, tienes que tener en cuenta que tienen que tener acceso de lectura para el grupo de apache y que son en formato TTF. Si se quieren representar caracteres de tipo japonés, chino, etc, es necesario usar una fuente TTF con esos caracteres. Pandora incluye la fuente "code" que visualiza todos los caracteres existentes en UTF8.
  • Custom logo: es una lista desplegable con los posibles logos que pueden ir en la cabecera de cada página de PDF. Las imágenes de logo se guardan en <pandora_console>/images/custom_logo/. Y la de por defecto es pandora_logo.jpg. Al seleccionarlo se puede ver una previsualización debajo de este formulario.
  • Header: es un editor rico en el que puedes copiar y pegar texto formateado de una aplicación ofimática o editarlo por medio de la botonera, este texto sera el que aparecerá en la cabecera.
  • First page: como el campo Header, este es otro editor de texto rico para crear y editar la página de la portada del PDF.
  • Footer: Igual que los otros dos campos, pero orientado a editar y crear los pies de cada página del PDF.



7.3.7.1 Macros

Es posible utilizar macros en la primera página, cabecera y pie de página. De momento estas son las macros implementadas:

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


7.3.8 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.


7.4 Visualización de un informe

Para poder ver un informe ya creado se va a Reporting > Custom Reporting.

Report list.png



Los informes se pueden ver en HTML, XML, PDF o CSV. También se pueden enviar por email. Para ello, pondremos la dirección donde se quiere recibir:

Send email.png



Para ver un informe en HTML se pincha en el iconoPre46.png. Una vez se abre el informe en HTML es posible elegir desde que fecha y hora se genera.

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




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

En la versión Enterprise de Pandora FMS existe un extensión que permite enviar, de forma programada, los informes generados por correo electrónico. El informe se envía en formato pdf.

Para acceder a la extensión se va a Servers > Cron Jobs.

Para añadir una tarea de enviar un informe de correo electrónico se debe de rellenar los siguientes campos:

  • Task: Se debe elegir la opción “send custom report by email”.
  • Scheduled: En este campo se elige la frecuencia con que se enviara el informe.
  • First Execution: En este campo se elige la fecha y hora de la primera ejecución.
  • Report build: En este campo se elige 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 programada, es posible forzar su ejecución pulsando en el círculo verde que hay a la derecha de la tarea o borrarla pulsando en la x roja que hay a la izquierda.



7.5.1 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


7.6 Borrado de un informe

Para borrar un Informe se va a Reporting > Custom Reporting. Aparece una lista con todos los informes creados, para borrar un informe se pulsa en el icono papelera que hay a la derecha del nombre del informe.

Pre44.png



8 Plantillas de informes

(Funcionalidad implementada en Pandora 5.0 Enterprise)

8.1 Introducción

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. Cada elemento de las plantillas macheará con un agente y/o módulo mediante una expresión regular o una subcadena haciendo este sistema muy flexible.

Templates1.png

Como se puede observar en la imagen anterior se creará una plantilla de informe que contendrá elementos o items, cada uno de estos items generará uno o más items de informe si al aplicar coincide con algun agente/módulo de los elegidos en dicha aplicación. Los tipos de items de plantilla serán casi todos los disponibles en los informes: valor medio, S.L.A., eventos de un agente, etc.


A continuación, se describirán tres ejemplos de items de plantillas.

8.2 Ejemplo

Para acceder al menú de administración de plantillas clickar: Reporting > Custom reporting y clickar en el boton de listar plantillas:



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



8.3 Ejemplo 1: Automatic combined graph

Este elemento generará gráficas para mostrar el tráfico de red entrante de los agentes seleccionados. Para ello creará gráficas combinadas por cada agente que cuyo nombre de módulo sea igual a "Network Traffic (Incoming)" y "Network Traffic (Outgoing)". Además de crear gráficas combinadas las unirá 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.

Otro control importante de este tipo de item de plantilla es Create a graph for each agent que permitirá una vez seleccionado crear una gráfica combinada por cada agente o en caso de que esté seleccionado crear una gráfica combinada para todos los agentes y módulos que coincidan.

8.4 Ejemplo 2 Top N

Este elemento generará un informe de tipo Top N mostrando las 5 CPUs más cargadas 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 desclickando la caja al lado del nombre del agente (exact match). Al dejarse en blanco el nombre del agente coincidirá sobre todos los agentes seleccionados durante la aplicación.

8.5 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.

8.6 Aplicación

Una vez creados los distintos elementos de una plantilla se deben aplicar para generar el/los informe/s en la pestaña Template Wizard.



Template application.png



Durante la aplicación del informe se podrá seleccionar una caja Create report per agent para que se genere un informe por cada agente seleccionado en la aplicación o en caso de que esté seleccionado un informe con todos los resultados:

  • 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]

Esta plantilla una vez aplicada sobre los agentes que se ven en la imagen generará el informe con título "Sample template report - agents (3) - October 14, 2013, 04:21 pm" que se muestra a continuación:



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 "Cache mem free" y "proctotal".



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 crea un elemento con dos subelementos.



Template application top n.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



8.7 Editar plantilla

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



Template general.png



8.8 List of templates

Reporting > Custom Reporting > damos al botón Templates list (arriba a la derecha)



Template main.png



En esta acción podemos crear nuevas templates, editar las existentes, copiar y borrarlas.

8.9 Template edit

Dentro de cada template podemos editar los parametros generales de dicha template:



Template general.png



8.10 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



8.11 Editor de items

En la sección del editor de items se podrán crear nuevos items dentro del template. Los tipos de items son los mismos que los de los informes con la diferencia que cuando se elija un agente se rellenará como una expresión regular, por ejemplo oracle_agent[.]* correspondría con los agentes: oracle_agent_1, oracle_agent_2, etc. En caso de dejar vacío el agente este item de la plantilla se aplicará sobre todos los agentes seleccionados en el Wizard de plantillas.

Cuando se rellene un módulo podrá ser de forma literal haciendo click en el check Module exact match o mediante una expresión regular si no se hace click sobre este.



Template create item.png



8.12 Opciones avanzadas

En esta sección se pueden configurar aspectos visuales del informe resultante como la fuente, el logo, la cabecera, la primera página o el pie de informe.



Template advance.png



8.13 Wizard

Por último, para aplicar las plantillas se deberá elegir la plantilla, los agentes a aplicar (mediante el tick se pueden seleccionar todos), pulsar en la flecha señalando la derecha y pulsar el botón Apply template. El comportamiento por defecto será crear un informe con el nombre de la plantilla y todos los items que este contenga. Pero si se hace click en Create report per agent se creará un informe distinto por cada agente seleccionado.



Template wizard.png



Como se comentó anteriormente si en un item se ha rellenado el campo de nombre de agente, solo se aplicará la plantilla si la expresión regular del agente coincide con alguno de los agentes selecionados en el Wizard. Por ejemplo, supongamos que hemos rellenado en un item como nombre de agente Contador 1[.]* entonces solo se aplicará a los agentes Contador 1 y Contador 10 pero no en el agente Contador 2.



Template wizard1.png



Como resultado en la vista del listado de informes se pueden ver los informes creados tras la aplicación:



Template wizard2.png



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



Template wizard cleanup.png




Volver a Indice de Documentacion Pandora FMS