Informes

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.

Pandora FMS simplifica la administración de la monitorización mediante los permisos de usuario. Existen varios sistemas de permisos que restringen lo que un usuario puede ver o administrar, el más importante es el concepto de grupos (ya sean grupos predefinidos por Pandora FMS y/o grupos personalizados) combinados con el perfil de cada uno de los usuarios. Preste usted especial atención a las notas sobre el grupo Todos (ALL) a lo largo de toda la documentación.

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

Creación de un informe

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

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

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

Una vez hecho esto tendremos un informe vacío.

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

Edición de un informe

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

Borrar un informe

Para borrar un informe, nos iremos a Reporting → Custom Reports y aparecerá 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.

Pestañas

Pestaña Main

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

Los campos que hay en este formulario son:

  • Nombre: Donde deberá definir el nombre del informe.
  • Grupo: Donde definirá el grupo de acceso que puede ver el informe. Solamente podrá asignar un grupo al cual pertenezca el usuario que está creando el informe, a menos que dicho usuario pertenezca explícitamente al grupo TODOS (ALL).
  • Descripción: Esta descripción para darle mas información a los usuarios sobre el informe, se mostrará en la lista de informes, también se mostrará en la visualización del informe como XML y como PDF.

Pestaña List Items

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

  • Modificar el ítem (haciendo clic 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 cabecera con las flechas blancas, ordenando alfabéticamente por tipo de elemento, alfabéticamente por nombre del agente o alfabéticamente por el nombre del módulo.
  • Eliminar el ítem haciendo clic en el aspa roja.

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

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 ítems.
  • Agent: Columna en la que aparece el nombre del agente, puede estar en blanco para tipos de ítems 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 ítems 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 haya dado al ítem este para facilitar su trabajo sobre él.
  • Options: Columna que muestra los botones/iconos para editar el ítem o borrarlo.

Pestaña Item editor

La pestaña Ítem editor, es la más compleja del resto, porque desde esta se podrán crear los ítems del formulario o editarlos. Además, el formulario es dinámico según el tipo de ítem a crear. En la edición se pueden editar todos los campos excepto el tipo. Si necesita 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 ítems para el informe, el cual al elegir el tipo habilita y deshabilita los campos necesarios para configurar este tipo de ítem, 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 ítem de informe.

Tipos de items

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

Items de gráficas

Simple graph

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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 nos 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.
  • Etiqueta: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Vista de ejemplo de este tipo de informe:

Simple baseline graph

Con este gráfico se pueden ver futuros valores con 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.

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • Module: Lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Etiqueta: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Vista de ejemplo de este tipo de informe:

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

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.

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 puede crear desde Administration, Manage reports en Graph builder.

Vista de ejemplo de este tipo de informe:

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_modulo) 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 se puede ver 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:

Estos son algunos ejemplos de cada uno de los tres tipos de gráficas 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.

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

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

SQL pie graph

Ejemplo gráfico circular para informes basados en consulta SQL

SQL Vertical bar graph

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

SQL horizonal bar graph

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

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, 8×5, de 8:00 a 16:00 de lunes a viernes).

A partir de la versión 749 de Pandora FMS, este tipo de informes incluye también la posibilidad de marcar la casilla 24×7, la cual se encuentra debajo del tiempo de trabajo. De esta manera se recogerá la información sin tener en cuenta la configuración de tiempo de trabajo y pudiendo comparar ambos casos, ya que nos mostrará 2 gráficas independientes.

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) coloreará 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 .

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

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:

Failover mode

Esta utilidad sirve para asignar módulos ‘failover o de backup’ al módulo principal sobre el que se quiere realizar el cálculo de disponibilidad. Es decir, si un módulo tiene asignado uno o varios módulos de failover, el cálculo de disponibilidad para un periodo determinado lo hará teniendo en cuenta dichos módulos.

Cuando caiga el módulo principal medido, si existen uno o varios módulos de backup operativos se tendrán en cuenta éstos para el cálculo del SLA. De esta forma se muestra sólo la caída real del servicio donde primario y backups no funcionen.

Añadir módulos failover o de backup

Esto lo haremos en la edición del módulo sobre el que queremos realizar el cálculo de disponibilidad, en la sección de relaciones de módulos (‘Module relations’):

Seleccionamos el módulo que queremos que actúe como failover y seleccionamos el tipo de relación que en este caso es de tipo failover.

Una vez asignados los módulos en el informe activamos la opción ‘failover mode’ :

Tendremos dos tipos de representación visual:

  • Normal: Mostrará la gráfica del módulo principal, así como la de todos sus módulos de failover o backup y la gráfica resultado.

  • Simple: Solo mostrará una gráfica que será el resultado del cálculo de disponibilidad de dichos módulos.

En los informes de ‘avalability graph’ de tipo simple se añade la posibilidad de añadir un módulo failover directamente en el informe a modo de simulación, este funcionará exactamente igual que los anteriores.

Esto no es aplicable en el wizard o en los informes de plantillas.

Module Histogram graph

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

Ejemplo de definición de módulo:

Ejemplo de visualización:

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 periodos desconocidos, dado que Pandora FMS no puede garantizar el estado del módulo si no tiene datos del mismo. También se consideran válidos todos los periodos 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 periodos 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.

S.L.A.

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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. A partir de la versión 749 de Pandora FMS, este tipo de informes incluye también la posibilidad de marcar la casilla 24×7, la cual se encuentra debajo del tiempo de trabajo. De esta manera se recogerá la información sin tener en cuenta la configuración de tiempo de trabajo y pudiendo comparar ambos casos, ya que nos mostrará 2 gráficas independientes.
  • Mostrar 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 ítems 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:

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

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 FMS no recibe información de un objetivo. En esta situación Pandora FMS 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 cálculo 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.

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

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 cálculo final lo tomará como si en todo ese intervalo el estado del módulo hubiese sido correcto.

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

S.L.A. Mensual

Este ítem 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.

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

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

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

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

Ejemplo de visualización:

S.L.A. Hora a hora

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

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

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

Ejemplo de visualización:

S.L.A. de Servicios

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 8×5).

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 FMS. Los valores límites de validez de SLA se recuperarán de forma automática de la definición del propio servicio.

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.

En este ejemplo podemos observar un esquema del cálculo 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 cálculo 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 cálculo final.

Items de predicción

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.

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 algunos datos. Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

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

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

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: Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

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

Obteniendo los siguientes resultados:

Items de módulo

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 muestra el valor medio.

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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: Mostrar los datos de promedio en intervalos personalizados.
  • Table / Graph options: Mostrar tabla, gráfica o ambos.
  • Etiqueta: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

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

Max. Value

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Ejemplo de visualización:

Min. Value

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Ejemplo de visualización:

Monitor report

Muestra el porcentaje de tiempo que un módulo se ha encontrado en estado normal u otro de sus estados, como warning o critico, en el periodo de tiempo definido.

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • Module: Lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

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

Serialize data

Muestra un ítem 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 FMS. El agente para ello deber serializar los datos separándolos con un caracter separador línea y otro separador de campo, y todas las líneas deben contener todos los campos. Este tipo de ítem por ejemplo se usa para el agente que extrae datos de gestión de la plataforma SAP (http://en.wikipedia.org/wiki/SAP_AG).

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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 líneas (compuestas por campos) de la cadena de texto serializada.
  • Etiqueta: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

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:

Summatory

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • Module: Lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

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

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:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • Module: Lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Ejemplo de visualización del informe:

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:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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:

Last Value

Último valor 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 muestra el último valor.

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • Agent: el control inteligente para elegir el agente para este ítem.
  • Module: Lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Show item in landscape format {only PDF}: Permitirá mostrar el informe en formato apaisado únicamente en PDF.
  • Page break at the end of the item {only PDF}: Generará un salto de página al final del elemento únicamente en PDF.

En la versión del informe en HTML se genera un ítem de este tipo por ejemplo:

Items agrupados

General

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

Configuraremos los siguientes campos:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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.

Ejemplo de visualización del informe:

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • Grupo: Combo para seleccionar el grupo. Aunque el usuario quien está creando el group report no pertenezca pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como fuente de Agentes, Alertas, etcétera.
  • Recurse: Analizar recursivamente los grupos hijos del grupo seleccionado.

Ejemplo de visualización del informe:

Exception

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

Podremos configurar los siguientes campos:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe.
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe.
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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:

Agents/Modules

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

Consultas SQL

Este ítem muestra, en los informes de datos, de la BD de Pandora FMS, una tabla para disponer de datos personalizados extraídos directamente de la BD.

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
    • _timefrom_ : Se sustituye por la fecha de inicio especificada en el informe.
  • 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.

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

Ejemplo de visualización de informe:

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

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

Defina su consulta y un nombre para identificarla y presione “Save” para que aparezca en la lista:

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.

Ejemplo de visualización de informe:

Network interfaces

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

Podemos indicar:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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. Aunque el usuario quien está creando el item de informe no pertenezca pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como fuente de Agentes con Módulos de interfaz de red (ver nota siguiente).
  • 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:

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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. A partir de la versión 749 de Pandora FMS, este tipo de informes incluye también la posibilidad de marcar la casilla 24×7, la cual se encuentra debajo del tiempo de trabajo. De esta manera se recogerá la información sin tener en cuenta la configuración de tiempo de trabajo y pudiendo comparar ambos casos, ya que nos mostrará 2 gráficas independientes.
  • 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 ítems 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:

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

Muestra la siguiente información:

  • Agente: Agente.
  • Module / Dirección IP: Al configurar el ítem 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.
Items de texto/ HTML

Text

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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:

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

Puede agregar cualquier contenido html a este elemento.

Ejemplo de visualización de informe:

Import text from URL

Este ítem 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 mostrará el texto en formato plano.

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • URL: Campo de texto en el que introducir la dirección del server externo de donde extraer el texto.

Será necesario indicar el protocolo en la URL (http://, https://...)

Ejemplo de visualización del informe:

Items de alertas

Alert report agent

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Ejemplo de informe:

Alert report module

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • Module: Lista desplegable que se carga de forma dinámica con los módulos del agente seleccionado en el control previo.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Alert report group

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del 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).
  • Group: Grupo sobre el que se analizará la información de disparo de alertas. Aunque el usuario quien está creando el reporte de alertas de un grupo no pertenezca pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como fuente de alertas de grupo.
  • Recursion: Analizar los grupos hijo del grupo definido de manera recursiva.

Items de eventos

Event report agent

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • Severity, event type, event status: Seleccione los tipos de evento que desee visualizar.
  • Event graphs: Mostrar gráficas de resumen de eventos.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Ejemplo de visualización de este tipo de informe:

Event report module

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe.
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe.
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítem.
  • 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.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Ejemplo de visualización de este tipo de informe:

Event report group

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe.
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe.
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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. Aunque el usuario quien está creando item de reporte de eventos no pertenezca pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como fuente de eventos de 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 ítem de este tipo por ejemplo:

Items de inventario

Inventory

Este ítem 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.

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe.
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe.
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • Descripción: Campo de texto con descripción del ítem.
  • Grupo: Combo que filtra los agentes que aparecen en el siguiente campo. No se refleja en el informe, es solo una utilidad del formulario. Aunque el usuario quien está creando item inventario de reporte no pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como fuente de Agentes para el inventario.
  • 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 changes

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

Los campos de este formulario son:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe.
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • Descripción: Campo de texto con descripción del ítem.
  • 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. Aunque el usuario quien está creando el item de reporte de cambio de inventario no pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como fuente de Agentes con cambio en su inventario.
  • 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.

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

Ejemplo de visualización de este tipo de informe:

Items de configuración

Configuración de agente

Este tipo de informe nos mostrará una captura del estado del agente:

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe.
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe.
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • Etiqueta: Etiqueta que se puede asignar el elemento. Las siguientes macros pueden ser utilizadas: _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.

Ejemplo de visualización

Opciones de grupo

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

Aunque el usuario quien está creando el ítem de opciones de grupo no pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como fuente de Agentes de grupo.

Ejemplo de visualización:

Items de Netflow

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.

Ejemplo de visualización de este tipo de informe:

Netflow Pie Chart

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

Ejemplo de visualización de este tipo de informe:

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.

Ejemplo de visualización de este tipo de informe:

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.

Ejemplo de visualización de este tipo de informe:

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 parámetro “Filter”.

Ejemplo de visualización de este tipo de informe:

Items de log

Informe de log

Este tipo de informe mostrará las entradas de log en el periodo seleccionado.

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe.
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe.
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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:

Wizard general

Esta pestaña nos permite realizar un informe completo de forma automática, con unos pocos click. 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.

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

  • Nombre: Se pueden usar las siguientes macros:
    • _agent_ : Nombre del agente que ha seleccionado en el elemento del informe.
    • _agentdescription_ : Descripción del agente que ha seleccionado en el elemento del informe.
    • _agentgroup_ : Grupo del agente que ha seleccionado en el elemento del informe
    • _address_ : Dirección del agente que ha seleccionado en el elemento del informe
    • _module_ : Nombre del módulo de agente que ha seleccionado en el elemento del informe.
    • _moduledescription_ : Descripción del módulo de agente que ha seleccionado en el elemento del informe.
  • 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 ítems disponibles son: Alert Report Agent, Alert Report Module, AVG Module, Event Report Agent, Event Report Module, Monitor Report, Simple Graph y Disponibilidad.
  • Intervalo de tiempo: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
  • Filter group: Permite filtrar los agentes por grupo. Aunque el usuario quien está creando el item de reporte no pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como filtro de Agentes de los cuales escoger Módulos.
  • 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.
  • Etiqueta: Etiqueta que se puede asociar a los elementos. Se pueden utilizar macros : _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.
  • Nombre: Nombre que se puede asociar a los elementos. Se pueden utilizar macros : _agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.
  • Intervalo de tiempo: El rango de tiempo hacia atrás sobre el que se elaborará el informe (p.e. un mes desde la fecha elegida).

Ejemplo de visualización de informe (disponibilidad):

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 periodo 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 periodo 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:

  • Intervalo de tiempo: Este es el lapso de tiempo que refleja el informe. Si es una semana, por ejemplo, el informe mostrará los datos desde hace una semana hasta ahora
  • Show graph: Sólo SLA básico, permite elegir si mostrar una tabla con los datos, una gráfica, o ambos.

Aunque el usuario quien está creando el item de reporte no pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como filtro de Agentes de los cuales escoger Módulos.

Ejemplo de visualización de informe:

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.

  • Excepción: Esto muestra valores de varios módulos que satisfacen una operación lógica.
  • General: Muestra valores de varios módulos ordenados (ascendentemente, descendentemente, por nombre de agente) y/o agrupados por nombre.
  • 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.

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

Aunque el usuario quien está creando el item de reporte no pertenezca explícitamente al grupo TODOS (ALL), aún así podrá asignar el grupo ALL como filtro de Agentes de los cuales escoger Módulos.

Ejemplo de visualización de informe:

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

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 con 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 carácteres 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 con 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.

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.

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.

Visualización de un informe

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

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

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:

Para mostrar una versión en HTML del informe, haremos click en el icono.

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

Para ver un informe en XML se pincha en el icono

Para ver un informe en PDF se pincha en el icono

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.

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.

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

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.

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.

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

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

Plantillas de informes

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

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.

Ejemplo

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

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

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

Este ejemplo de plantilla contendrá tres ítems 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

Ejemplo 1: Automatic Combined Graph

La creación de gráficas combinadas es una opción dentro de Reporting > Custom graphs que permite generar informes visuales de tantos módulos como sean necesarios.

Esta sección permite definir un nombre para la gráfica y otros datos tales como la periodicidad, el tipo de gráfica o el peso que tendrá cada uno de los módulos.

Las gráficas combinadas permiten establecer el orden de cada módulo individual mediante la opción “sort” presente en el listado de opciones.

El resultado de las gráficas combinadas diferencia con claridad los datos de los distintos módulos seleccionados.

En el ejemplo siguiente se crearán 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.

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.

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

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.

Ejemplo 3 Eventos del agente

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

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.

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:

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:

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

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.

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]

Ejemplos

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

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

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

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

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

Editar plantilla

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

Lista de plantillas

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

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

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

Lista de items

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

Editor de items

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

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

En caso de dejar vacío el campo, el ítem de la plantilla se aplicaría sobre todos los agentes que se seleccionen 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.

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.

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

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

Volver al Índice de Documentación Pandora FMS