¡Esta es una revisión vieja del documento!
Informes
Informes
Pandora FMS ofrece la posibilidad de presentar los datos monitorizados de manera ordenada por medio 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, se puede elegir un elemento de tipo gráfica simple que realice gráficas individuales o un elemento de tipo SLA (Service Level Agreement o acuerdo de nivel de servicio) que 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. Se puede tener tantos elementos como necesite, del tipo y estilo que desee.
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.
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 (Name) y seleccionar el grupo (Group) al que pertenecerá el informe, también si el informe es privado o no (Write access) y la descripción del mismo.
En el campo Write access podrá elegir los derechos de edición del reporte:
- Only the group can edit the report : Solamente el grupo al cual pertenece el informe podrá editarlo.
- Only the user and the admin user can edit the report : Solamente el autor y un usuario administrador podrán editar el informe.
- The next group can edit the report : (“El siguiente grupo puede editar el reporte”) Si escoge esta opción aparecerá una lista donde podrá elegir a algún otro grupo que también podrá editar el reporte.
Por defecto el reporte será interactivo (marcado como No en Non-interactive Report). Al marcar un reporte como no interactivo, el mismo solamente podrá ser enviado por correo electrónico:
Por defecto tiene activadas las opciones de crear una portada (Generate cover page in PDF render) y un índice (Generate index in PDF render) al momento de generar un PDF a partir del informe.
Una vez cumplimentados los campos necesarios, presione Save.
Una vez hecho esto se tendrá un informe vacío y listo para agregar elementos al mismo.
Edición de un informe
Para editar un Informe acceda a Reporting → Custom reports. Pulse en el nombre correspondiente del informe.
Borrar un informe
Para borrar un informe, vaya al menú Reporting → Custom Reports. Luego haga clic en el icono de la papelera que se encuentra en el lado derecho del nombre del informe.
Si son varios informes, en la columna Op, haga clic en la correspondientes casillas de selección y a continuación use el botón Delete.
Pestañas
Pestaña Main data
La pestaña Main data (Datos principales) es la única disponible en un Informe nuevo, ya que en esta usted define los datos básicos del informe. Una vez guardado correctamente tendrá acceso al resto de las pestañas.
Estos campos son los mismos tanto para creación de un informe como para su edición.
Al finalizar de crear o editar pulse el botón Update para guardar los datos de los campos.
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.
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 del que se extraerán los datos para realizar 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 “ Op. ” que muestra los botones/iconos para editar el ítem o borrarlo.
Desde esta pestaña puede:
- Modificar el ítem (haciendo clic en el icono de llave inglesa o llave de tuercas).
- Modificar el orden ( columna “ P. ”) por medio de las casillas de selección en la columna “ Sort “ y el desplegable inferior de ordenar elementos ( ” Sort items “ ).
- 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 marcando la casilla de selección en la columna ” Op. ” y pulsando en el botón “ Delete ” que está justo debajo del listado de renglones.
Si es un informe extenso con multitud de ítems, dispone en la parte de arriba de un formulario para filtrar por distintos criterios.
Pestaña Item editor
La pestaña Item 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 cambiar 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 configurarlo.
- Name: Nombre del reporte. 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.
- Description: Caja de texto donde describir el ítem de informe.
- Show item in landscape format (only PDF): Mostrar el artículo en formato apaisado (solo PDF).
- Page break at the end of the item (only PDF): Salto de página al final del artículo (solo PDF).
En el siguiente ejemplo un usuario ubicado en América modifica un item tipo SLA en un servidor Pandora FMS ubicado en Europa:
Tipos de ítems
Están disponibles los siguientes, reunidos en trece categorías:
Items de gráficos
Gráfico simple
Muestra la gráfica simple (Simple graph) de un Módulo.
Los campos de este formulario son:
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
- Time comparison (overlapped): Al estar activado 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.
Ejemplo:
Gráfico simple de línea base
Con este gráfico (Simple baseline graph) se pueden ver futuros valores con estimaciones del Módulo seleccionado. Por ejemplo, si se selecciona un período 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:
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
Vista de ejemplo de este tipo de informe:
Este tipo de gráficas pueden sobrecargar en exceso Pandora FMS si se usan muchos datos para realizar las estimaciones futuras
Gráfica personalizada
Gráfica combinada definida por el usuario (Custom graph). Se añade un campo con un combo para seleccionar la gráfica que se quiere añadir.
Los campos de este formulario son:
- Name: Nombre del reporte. 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).
- Custom graph: Una lista desplegable con los gráficos definidos por el usuario. Estos gráficos pueden ser creados bien desde el botón Create o desde el menú Reporting → Custom graph → Create custom graph (herramienta Graph builder). Si existe y el gráfico definido necesita ser editado, utilice entonces el botón Edit.
Vista de ejemplo de este tipo de informe:
Gráficas definidas desde SQL
Este tipo de ítems han de usarse con cuidado ya que pueden sobrecargar en exceso a Pandora FMS
Este tipo de elemento de informe permite que se puedan definir gráficas personalizadas para usarlas en los informes.
- Estas gráficas 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 llamadovalue
para almacenar el valor numérico a representar. - Dispone de tres opciones: gráfica de barras horizontal, gráfica de barras vertical y gráfico circular.
Por seguridad las siguientes palabras son reservadas y por tanto excluidas de las consultas:
*
, DELETE
, DROP
, ALTER
, MODIFY
, password
, pass
, INSERT
y UPDATE
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;
Otro ejemplo muestra una gráfica en la que se puede conocer el número de módulos en estado desconocido por cada agente:
- Name: Nombre del reporte. 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.
- SQL query: Consulta de Lenguaje Estructurado según las condiciones descritas anteriormente.
- Max items: Cantidad de elementos máximos a graficar.
- Query History Database: Incluye datos de más de 30 días de antigüedad y que estén almacenados en la base de datos histórica. Con esta opción seleccionada, puede necesitar algo más de tiempo para mostrar el resultado.
Gráfico circular de SQL
Gráfico de barra vertical SQL
Ejemplo de gráfica de barras verticales (SQL Vertical bar graph) para informes basados en consulta SQL:
Gráfico de barra horizontal SQL
Ejemplo de gráfica de barras horizontales (SQL horizontal bar graph) para informes basados en consulta SQL:
Gráfico de disponibilidad
Informe de disponibilidad (Availability graph), 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álculo 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. cada 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
Fecha de predicción
Este tipo de ítem (Prediction date) 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 .
Para configurar este tipo de ítem se deben proporcionar algunos datos.
- Name: Nombre del reporte. 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.
- Periodicity: 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.
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
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
use la siguiente definición:
Esto generará la siguiente salida:
Gráfico de proyección
Este tipo de ítem (Projection graph) 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, implementada siguiendo el método de los mínimos cuadrados.
Deberá configurar los siguientes parámetros con exactitud para poder recibir resultados relevantes:
- Name: Nombre del reporte. 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.
- Periodicity: El periodo de tiempo que se tomará de base para la estimación.
- Projected period: El periodo de tiempo a futuro en el cual se proyectarán los datos.
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
En la imagen de ejemplo, la zona marcada period representa la evolución de los datos del módulo durante el intervalo de tiempo 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
Valor medio
Valor medio (Avg. Value) de un módulo en el periodo definido. Este periodo se calcula en el momento de ver el informe.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: El periodo de tiempo que tomará hacia atrás en el punto temporal en que se genere el informe.
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- 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. Al activar esta opción se habilitarán los siguientes campos:
- Time lapse intervals: Lapsos de tiempo en los cuales el periodo es dividido para realizar cálculos más precisos.
- Table only / Graph only / Graph and table: Mostrar tabla, gráfica o ambos.
En la versión del informe en HTML se genera un ítem de este tipo, por ejemplo:
Valor máximo
Valor máximo (Max. Value) de un módulo en el periodo definido, este periodo se calcula en el momento de ver el informe.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: El periodo de tiempo que tomará hacia atrás en el punto temporal en que se genere el informe.
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- 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. Al activar esta opción se habilitarán los siguientes campos:
- Time lapse intervals: Lapsos de tiempo en los cuales el periodo es dividido para realizar cálculos más precisos.
- Table only / Graph only / Graph and table: Mostrar tabla, gráfica o ambos.
Ejemplo de visualización:
Valor mínimo
Valor mínimo (Min. Value) de un módulo en el periodo definido. Este periodo se calcula en el momento de ver el informe.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: El periodo de tiempo que tomará hacia atrás en el punto temporal en que se genere el informe.
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- 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. Al activar esta opción se habilitarán los siguientes campos:
- Time lapse intervals: Lapsos de tiempo en los cuales el periodo es dividido para realizar cálculos más precisos.
- Table only / Graph only / Graph and table: Mostrar tabla, gráfica o ambos.
Informe de monitores
La opció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 critical
, en el periodo de tiempo definido.
Los campos de este formulario son:
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
Y en la versión del informe en Html se genera un ítem de este tipo por ejemplo:
Serializar datos
Este reporte (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 de 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.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- 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.
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 genera un informe a partir de este contenido obtiene la siguiente salida:
Sumatorio
Muestra la suma de los valores de un módulo (Summation) en un periodo determinado.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
- Uncompress module: Para utilizar datos de módulos descomprimidos.
Ejemplo de visualización:
Datos históricos
Este tipo de elemento (Historical Data) sirve para recibir un volcado de los datos almacenados con más de 30 días de antigüedad del módulo que se le indique en la configuración del informe.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- 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:
Incremento
Utilice este tipo de elemento de informe (Increment) para mostrar un breve análisis en el que se indicará la variación de valor del módulo indicado.
- Name: Nombre del reporte. 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).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- 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:
Último valor
Último valor (Last Value) de un módulo en el periodo definido. Este periodo se calcula en el momento de ver el informe.
- Name: Nombre del reporte. 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 para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
En la versión del informe en HTML se genera un ítem de este tipo por ejemplo:
Histograma
- Name: Nombre del reporte. 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).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
Ejemplo, resultado de un solo módulo solicitado:
Items agrupados
General
Muestra valores de diferentes módulos ordenados (ascendente, descendente o por nombre de agente) o/y agrupados por agente.
- Name: Nombre del reporte. 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. Al seleccionar esta opción, Time lapse se deshabilita y no se muestra.
Los informes en período 0 no pueden mostrar la información pasada. La información contenida en este tipo de informes mostrará siempre la información más reciente.
- Group by agent: Agrupar las métricas del informe por agente.
- Order: Orden en el cual 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.
- Una vez agregados los datos de los anteriores campos, guarde el informe para poder así agregar agentes y módulos. Por cada agente y módulo que agregue solamente deberá usar el icono de guardar respectivo, pulse una sola vez y espere. Únicamente utilice el botón Update item si vuelve a editar alguno de los campos anteriores.
Ejemplo de visualización del informe:
Grupo de informes
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.
- Name: Nombre del reporte. 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.
- Recursion: Analizar recursivamente los grupos hijos del grupo seleccionado.
Ejemplo de visualización del informe:
Excepción
Muestra los valores de diversos módulos que cumplen operaciones lógicas (Condition):
- Equal to ( = ): Igual al valor indicado.
- Everything: Cualquier valor.
- Greater or equal to ( >= ): Mayor o igual al valor indicado.
- Greater than ( > ): Mayor al valor indicado.
- Less than ( < ): Menor al valor indicado.
- Less than or equal to ( ⇐ ): Menor o igual al valor indicado.
- Not equal to ( != ): No igual al valor indicado (cualquier valor distinto al valor indicado).
- Not OK: Reportar cuando su estado sea distinto a
OK
. - OK: Reportar cuando su estado sea
OK
.
Podremos configurar los siguientes campos:
- Name: Nombre del reporte. 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.
- Show graph: Permite elegir el mostrar tabla y gráfico (Chart & Graph), solo gráfico (Only graph) o solo tabla (Only table).
- Show summary: Mostrar un resumen final con los valores promedio, máximos y mínimos.
- Una vez agregados los datos de los anteriores campos, guarde el informe para poder así agregar agentes y módulos. Por cada agente y módulo que agregue solamente deberá usar el icono de guardar respectivo, pulse una sola vez y espere. Únicamente utilice el botón Update item si vuelve a editar alguno de los campos anteriores.
Ejemplo de visualización del informe:
Agentes/Módulos
Muestra una matriz de agentes y módulos de un determinado grupo de módulos seleccionados con su estado asociado. Puede obtener los agentes por grupos (incluye la opción de recursión para los subgrupos) y filtrar por módulos comunes entre ellos. Además, los módulos también pueden ser filtrados por grupos (aplicación, base de datos, red, etcétera).
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Group: Permite seleccionar por grupos de agentes. Para mostrar absolutamente todos los agentes, seleccione All.
- Recursion: Si de la lista anterior ha seleccionado un grupo distinto de ALL puede marcar esta opción para buscar agentes en los subgrupos.
- Module group: Filtra los agentes por grupos (Aplicación, Base de datos, General, etcétera).
- Agents: Selección múltiple de agentes para mostrar en el informe.
- Show modules: Permite mostrar todos los módulos de los agentes seleccionados en los puntos anteriores. Puede utilizar la opción de ver solamente los módulos que tienen en común entre ellos (Show common modules).
- Modules: Selección múltiple de módulos a mostrar en el reporte.
Ejemplo:
Si vuelve a editar el reporte, deberá volver a seleccionar de nuevo los módulos.
Consultas SQL
Este ítem muestra una tabla para disponer de datos personalizados extraídos directamente de la base de datos de Pandora FMS.
Este tipo de items han de usarse con cuidado ya que pueden sobrecargar en exceso al servidor Pandora FMS
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- 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 del menú Reporting
→ Custom SQL.
- Query SQL: Si no se escoge una plantilla de SQL se habilita esta caja de texto para introducir la consulta SQL.
- Serialized header: Campo de texto para definir las cabeceras de la tabla que se mostrarán en el informe, por cada columna de resultado de la consulta SQL efectuada. Separe dichas cabeceras con el caracter
|
. - Query History Database: Casilla de chequeo que al ser marcada hará que la consulta SQL 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
.
Ejemplo de consulta utilizando el desplegable Custom SQL template (consulta predefinida “SQL Monitoring Report Modules”, note el uso de los correspondientes encabezados en Serialized header):
Visualización de informe del ejemplo anterior:
Puede definir sus propias plantillas en el menú Reporting → Custom SQL.
En la vista de la lista de consultas, puede crear una nueva consulta almacenada pulsando el botón Create custom SQL:
Defina su consulta y coloque un nombre para identificarla y presione Save para que aparezca en la lista:
Para editar la consulta SQL, en la lista de consultas haga clic en el nombre y obtendrá una pantalla similar a la figura anterior. Realice los cambios necesarios y para guardar pulse el botón Edit.
Top N
Muestra los primeros valores, especificados en Quantity(n), discriminados por: máximo, mínimo o media sobre el total de módulos añadidos. Pueden ser ordenados de manera ascendente, descendente o por nombre de agente.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Order: Orden en el cual mostrar las métricas.
- Quantity(n): Cantidad de métricas a mostrar.
- Display: Seleccione máximo, mínimo o promedio.
- Show graph: Permite elegir el mostrar tabla y gráfico (Chart & Graph), solo gráfico (Only graph) o solo tabla (Only table).
- Show summary: Si se habilita, muestra un gráfico de resumen con el número máximo, mínimo y medio de módulos totales al final del informe y de las comprobaciones
- Una vez agregados los datos de los anteriores campos, guarde el informe para poder así agregar agentes y módulos. Por cada agente y módulo que agregue solamente deberá usar el icono de guardar respectivo, pulse una sola vez y espere. Únicamente utilice el botón Update item si vuelve a editar alguno de los campos anteriores.
- Tenga cuidado: cuando el módulo tiene diferentes intervalos durante su vida, la suma puede devolver resultados erróneos.
Ejemplo:
Interfaces de red
Este tipo de elemento de informe genera las gráficas de interfaces de red de todos aquellos dispositivos que pertenecen al grupo seleccionado.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
- Time comparison (overlapped): Al estar activado 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.
- Group: Grupo donde se buscarán agentes con módulos de tráfico de interfaz (ver nota siguiente acerca del 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.
- Graph render: Permite seleccionar en el gráfico solamente el máximo (Avg only), solamente el mínimo (Max only), solamente el promedio (Avg only) o los tres campos (Avg, max & min).
- Full resolution graph (TIP): Usar el sistema de pintado de datos reales TIP en vez del motor estándar. Si activa esta opción se deshabilita Graph render.
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:
Disponibilidad
Este ítem (Availability) muestra un tabla con los datos de disponibilidad de una lista seleccionada de agentes y módulos. Los datos representados en él son reflejo exacto de la situación de los módulos a lo largo del período seleccionado.
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.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Work time: El período 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 Show 24×7 item, de esta manera se recogerá la información sin tener en cuenta la configuración de Work time. Esto permite comparar ambos casos, ya que mostrará 2 gráficas independientes.
- Order: Orden en el cual mostrar las métricas.
- Select fields to show: Permite seleccionar los siguientes campos a mostrar:
- Total time: Tiempo total seleccionado.
- Time failed: Tiempo en estado de fallo.
- Time in OK status: Tiempo en estado OK.
- Time in unknown status: Tiempo en estado desconocido.
- Time of not initialized module: Tiempo en estado no inicializado.
- Time of downtime: Tiempo fuera trabajo.
- Show address instead of module name: Mostrará la dirección principal del agente en vez del nombre.
- Show summary: Mostrar un resumen final. Podrá seleccionar los siguientes campos a mostrar:
- Total checks: Total de verificaciones.
- Checks failed: Verificaciones fallidas.
- Checks in OK status: Verificaciones en estado OK.
- Unknown checks: Verificaciones en estado desconocido.
- Agent max value: Valor máximo del agente.
- Agent min value: Valor mínimo del agente.
- Fail over mode: El cálculo del SLA debe realizarse teniendo en cuenta los módulos que se hayan recuperado de fallos asignados al módulo primario. Al habilitar esta opción se activará el campo Fail over type el cual permite seleccionar entre Fail over normal o Fail over simple.
- Una vez agregados los datos de los anteriores campos, guarde el informe para poder así agregar agentes y módulos. Por cada agente y módulo que agregue solamente deberá usar el icono de guardar respectivo, pulse una sola vez y espere. Únicamente utilice el botón Update item si vuelve a editar alguno de los campos anteriores.
Ejemplo:
Muestra la siguiente información:
- Agent: Agente.
- Module / Dirección IP: Al configurar el ítem puede mostrar la dirección IP primaria del agente en vez módulo, muy útil para informes que pongan una lista agentes y direcciones IP 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.
Ejemplo con Show 24×7 item y Show summary seleccionados:
Items de texto/ HTML
Texto
Este ítem muestra en los informes un texto formateado con HTML, útil para incluir información adicional de cada empresa.
Captura de ejemplo de la ventana para añadir enlace:
Captura de ejemplo de la ventana para añadir imagen:
Puede agregar cualquier contenido HTML a este elemento. Ejemplo de visualización de informe:
Importar texto de una URL
Este ítem (Import text from URL) muestra el texto extraído desde un servidor externo al que tenga acceso Pandora FMS Console. Debe tener siempre en cuenta que en el formato de informe tipop HTML lo mostrará tal cual, pero en la versión de informe PDF solo mostrará el texto en formato plano.
- URL: Campo de texto para introducir la dirección del servidor externo para extraer el texto.
Debe indicar el protocolo en la URL ( http:
, https:
, …)
Ejemplo:
Items de alertas
Informe de alerta de módulo
Muestra un listado con las alertas lanzadas por el módulo seleccionado en el informe, en el periodo definido (Alert report module).
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
Ejemplo:
Informe de alerta de agente
Muestra un listado (Alert report agent) con las alertas lanzadas por los agentes del grupo del informe en el periodo definido.
Los campos de este formulario son:
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
Informe de alerta de grupo
Muestra un listado (Group alert report) con las alertas lanzadas en cualquier elemento del grupo definido en el informe, en el periodo definido.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: El rango de tiempo hacia atrás sobre el que se elaborará el informe (por ejemplo 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.
Ejemplo:
Items de eventos
Informe de evento de módulo
Muestra un listado (Module event report ) con los eventos ocurridos en el módulo de un agente seleccionado, en el periodo definido.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Module: Lista desplegable que se carga de forma dinámica con los Módulos del Agente seleccionado en el control previo.
- Show Summary group: Mostrar resumen de grupo.
- Severity: Seleccione los eventos según su severidad (o seleccione todos ellos con All).
- Event type: Seleccione los eventos según su tipo:
- Monitor in critical status: Monitor en estado crítico.
- Monitor in warning status: Monitor en estado de advertencia.
- Monitor in normal status: Monitor en estado normal
- Unknown: Desconocido.
- Unknown Monitor: Monitor en estado desconocido.
- Alert triggered: Alerta disparada.
- Alert recovered: Alerta recuperada.
- Alert stopped: Alerta finalizada.
- Manual alert validation: Validación manual de alerta.
- Agent created: Agente creado.
- Recon host detected: Equipo de red detectado con recon.
- System: Sistema.
- Error.
- Configuration change: Cambio de configuración.
- Event status: Seleccion los eventos según su estado (o seleccione todos ellos con All events).
- Include extended events: Incluir eventos ampliados.
- Event graphs: Gráficos de eventos:
- By user validator: Por validador de usuario.
- By criticity: Por prioridad.
- Validated vs unvalidated: Validado versus invalidado.
- Include filter:Incluir filtro (búsqueda de texto libre en la descripción del evento)
- Exclude filter: Excluir filtro (búsqueda de texto libre en la descripción del evento)
Ejemplo:
Informe de evento de agente
(Agent event report) Muestra un listado con los eventos ocurridos en el agente seleccionado, en el periodo definido.
- Name: Nombre del reporte. 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.
- Label: Etiqueta que se puede asignar al elemento. Las siguientes macros pueden ser utilizadas:
_agent_
,_agentdescription_
,_agentgroup_
,_address_
,_module_
,_moduledescription_
. - Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Agent: El control para elegir el Agente para este ítem, escriba las primeras letras del nombre y obtendrá una lista desplegable.
- Show Summary group: Mostrar resumen de grupo.
- Severity: Seleccione los eventos según su severidad (o seleccione todos ellos con All).
- Event type: Seleccione los eventos según su tipo:
- Monitor in critical status: Monitor en estado crítico.
- Monitor in warning status: Monitor en estado de advertencia.
- Monitor in normal status: Monitor en estado normal
- Unknown: Desconocido.
- Unknown Monitor: Monitor en estado desconocido.
- Alert triggered: Alerta disparada.
- Alert recovered: Alerta recuperada.
- Alert stopped: Alerta finalizada.
- Manual alert validation: Validación manual de alerta.
- Agent created: Agente creado.
- Recon host detected: Equipo de red detectado con recon.
- System: Sistema.
- Error.
- Configuration change: Cambio de configuración.
- Event status: Seleccion los eventos según su estado (o seleccione todos ellos con All events).
- Include extended events: Incluir eventos ampliados.
- Event graphs: Gráficos de eventos:
- By user validator: Por validador de usuario.
- By criticity: Por prioridad.
- Validated vs unvalidated: Validado versus invalidado.
- Include filter:Incluir filtro (búsqueda de texto libre en la descripción del evento)
- Exclude filter: Excluir filtro (búsqueda de texto libre en la descripción del evento)
Ejemplo:
Informe de evento de grupo
Muestra un listado con los eventos ocurridos en los agentes del grupo seleccionado, en el periodo definido (Group event report).
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Group: 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: Seleccione los eventos según su severidad (o seleccione todos ellos con All).
- Event type: Seleccione los eventos según su tipo:
- Monitor in critical status: Monitor en estado crítico.
- Monitor in warning status: Monitor en estado de advertencia.
- Monitor in normal status: Monitor en estado normal
- Unknown: Desconocido.
- Unknown Monitor: Monitor en estado desconocido.
- Alert triggered: Alerta disparada.
- Alert recovered: Alerta recuperada.
- Alert stopped: Alerta finalizada.
- Manual alert validation: Validación manual de alerta.
- Agent created: Agente creado.
- Recon host detected: Equipo de red detectado con recon.
- System: Sistema.
- Error.
- Configuration change: Cambio de configuración.
- Event status: Seleccion los eventos según su estado (o seleccione todos ellos con All events).
- Include extended events: Incluir eventos ampliados.
- Event graphs: Gráficos de eventos:
- By user validator: Por validador de usuario.
- By criticity: Por prioridad.
- Validated vs unvalidated: Validado versus no validado.
- Include filter:Incluir filtro (búsqueda de texto libre en la descripción del evento)
- Exclude filter: Excluir filtro (búsqueda de texto libre en la descripción del evento)
Ejemplo:
Items de inventario
Inventario de agentes
Agents inventory lista los agentes registrados y dispone de varios filtros para seleccionar de manera muy detallada, incluso a nivel de módulos.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Group: Permite seleccionar por grupos de agentes. Para mostrar absolutamente todos los agentes, seleccione All.
- Display options: Permite seleccionar las columnas del reporte con las características de cada agente.
- Agent group filter: Permite seleccionar un grupo y sus respectivos agentes.
- Agent OS filter: Permite filtrar por sistema operativo de cada agente.
- Agent status filter: Permite filtrar los agentes por su estado.
- Agent version filter: Permite filtrar los agentes por su versión de software. Ejemplo filtrando la expresión
756
y seleccionando el campoVersion
en Display options:
- Agente has remote configuration: Permite filtrar los agentes que poseen configuración remota.
- Agent module filter: Permite filtrar por módulos de los agentes.
Ejemplo:
Inventario
Este ítem (Inventory) 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:
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Group: 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.
- Recursion: Para seleccionar los subgrupos del grupo(s) seleccionado(s).
- Agents: Agentes de las máquinas de las que se tomará el inventario. Solo aparecerán los agentes con módulos de inventario.
- Modules: Los módulos de inventario comunes a los agentes seleccionados.
- Date: Fecha de los datos mostrados. Si se escoge Último, se tomarán los últimos datos de inventario conocido de los módulos seleccionados.
Ejemplo con los parámetros seleccionados en la lista anterior (la lista es más larga que la mostrada acá):
Ejemplo mostrando CPU y RAM:
Inventario de cambios
Este ítem (Inventory changes) muestra los cambios de inventario registrados en una o varias máquinas dentro de un periodo seleccionado.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Periodo en el que se registraron los cambios.
- Group: 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.
- Agents: Agentes de las máquinas de las que se tomará el inventario. Solo aparecerán los agentes con módulos de inventario.
- Modules: 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 ítem fuese demasiado grande, puede eliminar algunos de esos eventos manualmente para reducirlo.
Ejemplo:
Items de configuración
Configuración de agente
Este tipo de informe (Agent configuration) permite mostrar una captura del estado del agente seleccionado:
- Name: Nombre del reporte. 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.
Ejemplo:
Configuración del grupo
Este tipo de informe (Group settings) mostrará una captura del estado de los agentes que pertenecen al grupo seleccionado:
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
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:
Items de NetFlow
Gráfico de área de NetFlow
Este elemento de informe (NetFlow Area Chart) mostrará una gráfica con el análisis del tráfico utilizando filtros ya creados en la vista de NetFlow.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
Ejemplo:
Tabla de datos de NetFlow
Este elemento (NetFlow Data Chart) muestra los datos obtenidos al aplicar el filtro de NetFlow indicado por el usuario en una tabla ordenando por fecha y origen.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
Ejemplo:
Tabla de resumen de NetFlow
Este elemento de informe (NetFlow Summary Chart) mostrará una tabla con información resumida del tráfico que coincida con el filtro de NetFlow indicado en el parámetro Filter.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
Ejemplo
Items de log
Informe de log
Este tipo de informe (Log report) mostrará las entradas de log en el periodo seleccionado.
- Name: Nombre del reporte. 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: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Source: Origen de logs.
- Agents: Agentes para el filtrado.
Ejemplo:
Items de reportes de permisos
Reporte de permisos de usuario
Permite seleccionar usuarios o grupos de usuarios y listar sus nombres, grupos y permisos.
- Name: Nombre del reporte; los macros están deshabilitados en este campo.
- User: Permite seleccionar y filtrar los usuarios.
- Select by group: Permite seleccionar uno o más grupos y sus usuarios. Si activa esta opción User (punto anterior) dejará de estar disponible.
Ejemplo:
Pestaña Wizard general
Esta pestaña permite realizar un informe completo de forma automática, con pocos clic. Aplicando configuraciones comunes, puede generar elementos aplicados a multitud de agentes y/o módulos.
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 haya 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.
- 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:
Pestaña Wizard SLA
Este asistente permite crear ítems de informe SLA de manera automática.
Análisis de SLA disponibles:
- 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:
Pestaña Global
En este apartado del informe puede crear elementos de tipo Exception, General o Top N de una manera sencilla mediante el uso de un asistente.
- Exception: 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 puede añadir diferentes módulos de diferentes agentes, además de poder elegir la operación a realizar en cada módulo: sumatorio, media, mínimo, máximo.
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:
Pestaña de Opciones avanzadas
En la pestaña de configuración avanzada del informe puede 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 logotipos 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 para 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 visualización de 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 correo electrónico. Para ello debe indicar la dirección destino donde recibir el informe en formato PDF. Si necesita enviar a varios destinatarios coloque las direcciones separadas por comas:
Para mostrar una versión en HTML del informe, haga clic 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 utiliza 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, permite configurar el envío de informes en formato PDF a través de correos electrónicos.
Esta funcionalidad se encuentra 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, utiliCE la extensión de consola Enterprise CRON con las siguientes opciones:
Task
Seleccione send custom report by e-mail. Esto permite programar la generación y envío de un informe ya existente.
Scheduled
En este campo especifique la frecuencia con que se enviará el informe.
First Execution
En este campo establezca la fecha y hora de la primera ejecución.
Report build
En este campo seleccione el informe a enviar.
Send to mail
En este campo introduzca la dirección de correo electrónico a la que se enviará el informe.
Una vez haya rellenado los datos pulse en Create y aparecerá el nuevo ítem 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 puede 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, utilice la extensión de consola Enterprise CRON con las siguientes opciones:
Task
Seleccionaremos Send custom report (from template) by e-mail: Esto permitirá aplicar una plantilla de informe sobre agentes a elección y programar su generación y envío.
Scheduled
En este campo especifique la frecuencia con que se enviará el informe.
Next Execution
En este campo establezca la fecha y hora de la siguiente ejecución.
Template to build
En este campo seleccione la plantilla del informe a generar.
Agents
Seleccione los agentes sobre los que aplicará la plantilla.
Send to mail
En este campo se pone la dirección de correo electrónico a la que se enviará el informe.
Configuración
Para que funcione el envío del correo electrónico, debe configurarse previamente en las opciones de Pandora FMS.
Para editar esta configuración acceda a Setup → Setup → General Setup:
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.
Así, de forma sencilla y rápida, se podrá 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.
Al crear una plantilla de informe se define una serie de elementos.
Estos elementos definidos, son los mismos ítems de informe que se definen para un informe.
La diferencia reside en que cada uno de estos ítems de plantilla generará uno o más ítems de informe, siempre y cuando al aplicar la plantilla exista una coincidencia con algún agente/módulo de los elegidos.
Crear plantilla
Acceda al menú Reporting → Custom Reports y haga clic en el icono List of templates:
Haga clic en el botón Create template:
Complete los siguientes campos:
- Name: Nombre de la nueva plantilla de reportes.
- Group: Grupo al que pertenecerá la nueva plantilla.
- Agents to apply: una expresión regular, sin importar mayúsculas ni minúsculas, para filtrar los agentes a los cuales les será aplicada la nueva plantilla. Por ejemplo, si usa
Network*
los agentes llamadosnetwork_agent1
oNetworK CHECK
concidirán cuando sea aplicada la plantilla. - Generate cover page in PDF render: Para generar una portada en PDF.
- Generate index in PDF render: Para generar un índice en el renderizado o generación del PDF.
Para guardar la plantilla al terminar de rellenar los campos, pulse el botón “Save”.
Ejemplo
Acceda a la pantalla de informes siguiendo el enlace del menú: Reporting → Custom reports:
Haga clic en la pestaña de List of template:
Verá la lista completa de plantillas definidas en la 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.
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, por ejemplo:
En el ejemplo siguiente se crearán gráficas combinadas por cada agente que cuyo nombre de módulo sea igual a “DiskUsed_/” y “DiskUsed_/home”.
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étera.
Además está la opción de agregar una etiqueta label dinámica al futuro ítem de informe. En este campo puede usar macros predefinidas para identificar el ítem que se generará. Esto es útil cuando imprima en PDF ya que identificará inequívocamente el ítem de informe que está 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, permite 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”.
Debe guardar el ítem de la plantilla de reporte para poder agregar elementos.
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.
En el campo Agent se ha utilizado la expresión regular .*
que simboliza cualquier cadena alfanumérica, por lo que aplicará sobre cualquier agente.
Aplicando una plantilla
Una vez haya definido todos los ítems de plantilla que necesite, puede aplicar o instanciar esta plantilla a través de dos métodos: aplicación directa o por el asistente de plantillas.
Aplicación directa
Puede 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 cuadro de diálogo donde podrá elegir los agentes sobre los que se aplicará esta plantilla de informe:
Asistente de plantillas
Puede hacer uso del asistente de plantillas ( Template Wizard ) si necesita instanciar una plantilla de informe en un informe real para tenerlo disponible en la lista de informes de Pandora FMS, por ejemplo:
Puede activar la casilla de verificación Create report per agent para generar un informe por cada agente seleccionado. Si no lo activa, 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]
Editar plantilla
Para editar una plantilla vaya a la lista de plantillas creadas. Luego haga clic en el nombre de la plantilla a editar o utilice el icono de llave de tuercas en la columna Operations.
Dentro de una plantilla se puede modificar los siguientes parámetros:
- Name: Nombre de la plantilla de reportes.
- Group: Grupo al que pertenecerá la plantilla.
- Agents to apply: una expresión regular, sin importar mayúsculas ni minúsculas, para filtrar los agentes a los cuales les será aplicada la nueva plantilla. Por ejemplo, si usa
Network*
los agentes llamadosnetwork_agent1
oNetworK CHECK
concidirán cuando sea aplicada la plantilla. - Generate cover page in PDF render: Para generar una portada en PDF.
- Generate index in PDF render: Para generar un índice en el renderizado o generación del PDF.
Para guardar la plantilla al terminar de rellenar los campos, pulse el botón “Update”.
Lista de plantillas
Acceda a la pantalla de informes siguiendo el enlace del menú: Reporting → Custom reports.
Una vez dentro haga clic en la pestaña de List of templates:
En esta página, podrá ver la lista completa de plantillas definidas en la consola de Pandora FMS.
Borrar plantillas
Para borrar una plantilla vaya primero a la lista de plantillas. Desde allí podrá borrar una plantilla de informes por medio de su correspondiente icono de bote de basura en la columna de operaciones (Operations). También podrá seleccionar varias plantillas y luego pulsar el botón Delete.
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á sobre todos los agentes a la hora de aplicar la plantilla de informe:
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
Para acceder a las opciones avanzadas vaya a la modificación la plantilla de informes. Una vez allí haga clic sobre el icono Advanced options.
En esta sección podrá configurar aspectos visuales del informe resultante como la fuente, el logotipo, la cabecera, la primera página o el pie de informe, tal como haría con un informe estándar.
Una vez haya terminado de editar los aspectos visuales, haga clic en el botón Update para guardar los cambios.
Limpieza de informes
Para borrar los informes creados en aplicaciones anteriores de una plantilla vaya al Asistente de plantillas de informes. Allí debe seleccionar una plantilla en la lista desplegable de Templates y luego 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.