Tabla de Contenidos
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.
En la versión 771, o posterior, el “Sistema ACL Enterprise” tiene habilitadas opciones específicas para la administración y manejo de informes con perfiles de usuario personalizados que se adaptan a cualquier necesidad. Para más detalles consulte la sección “Sistema ACL Enterprise enfocado a informes”.
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 informe:
- 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 informe”) Si escoge esta opción aparecerá una lista donde podrá elegir a algún otro grupo que también podrá editar el informe.
Por defecto el informe será interactivo (marcado como No en Non-interactive Report). Al marcar un informe 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.
Versión 770 o posterior.
En la lista de informes (List of reports) al hacer clic en el icono correspondiente de la columna HTML (excepto si el informe no es interactivo) podrá visualizar por pantalla los filtros e informe en sí mismo. Dicho reporte podrá ser agregado (o removido) a su lista de informes favoritos (Favorite) haciendo clic en el icono de estrella que acompaña al nombre del informe.
Cada informe será agregado, junto a los que ya tenga seleccionados, en la seeción Reporting del menú Favorite (sección Operation).
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 informe. 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 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 informe. 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.
- Graph render: Representar en gráfica, con las opciones para Avg only (Solo media), Max only (Solo máx), Min only (Solo min.), Avg max & min (Media, máx. y min.).
- Full resolution graph (TIP): Gráfica a resolución completa (TIP) , solo para Avg only (Solo media), Max only (Solo máx), Min only (Solo min.) del punto anterior.
- Show threshold: Mostrar umbrales, al activar esta característica serán pintados como fondos en distintos colores.
- 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 informe. 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 informe. 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;
Versión 765 o posterior.
En SQL query, para delimitar el reporte en fecha y hora tanto de inicio como de finalización, puede utilizar las macros _start_date_
y _end_date_
respectivamente. Ejemplo:
Luego al solicitar el informe, marque Set initial date para seleccionar la fecha y hora de inicio en From: y seleccione la fecha y hora de finalización en to:, luego haga clic en Update:
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 informe. 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
Ejemplo de gráfico circular (SQL pie graph) para informes basados en consulta 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.
Gráfico de histórico de módulo
Mostrará una gráfica (Module Histogram graph) con el histograma de estados del módulo elegido.
Ejemplo de definición de módulo:
Ejemplo de visualización:
IPAM
IPAM networks
- Filter by network: Escoja una de las redes creadas en la Vista de operación.
- Show alive IPs only: Si está activo, en el informe se mostrarán únicamente las direcciones IP que estén en línea.
- Show IPs not assigned to an agent: Permite elegir o no las direcciones IP que estén “huerfanas”.
Items de SLA
Todos los informes de Acuerdo de nivel de servicio (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 o SLA) de cualquier monitor de Pandora FMS.
Los campos de este formulario son:
- Name: Nombre del informe. 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).
- Only display wrong SLAs: Solo muestra las S.L.A. que estén equivocadas.
- Work 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.
- Show graph: Elegir si se mostrará una gráfica de SLA (Only graph), un resumen de estado (Only table) o mostrar ambos elementos (Chart&graph).
- Order: Ordenar los ítems SLA según el criterio elegido.
Una vez seleccionadas estas opciones, agregue cada uno de los módulos objetivos sobre los que necesite 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 SLA 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 estados 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 anterior un estado 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, aunque puede ser desactivado en Current Month).
Permite editar el working time para un horario de servicio personalizado (por ejemplo jornadas de 8 horas, cinco días a la semana). En la parte inferior puede 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, aunque puede ser desactivado en Current month).
Permite editar el working time para un horario de servicio personalizado (por ejemplo jornadas de 8 horas, cinco días a la semana). En la parte inferior puede 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:
- Name: Nombre del informe. 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).
- Work 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 tenga definidos en la 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 observa la imagen, cuando en alguno de los módulos tiene 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 informe. 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 informe. 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 informe. 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.
- Use prefix notation: Utilice la notación de prefijo para los valores numéricos (ejemplo: 20,8 Kbytes/seg); de lo contrario, se mostrará el valor completo (ejemplo: 20742 bytes/seg).
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 informe. 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.
- Use prefix notation: Utilice la notación de prefijo para los valores numéricos (ejemplo: 20,8 Kbytes/seg); de lo contrario, se mostrará el valor completo (ejemplo: 20742 bytes/seg).
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 informe. 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.
- Use prefix notation: Utilice la notación de prefijo para los valores numéricos (ejemplo: 20,8 Kbytes/seg); de lo contrario, se mostrará el valor completo (ejemplo: 20742 bytes/seg).
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 informe. 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 informe (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 informe. 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 informe. 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.
- Use prefix notation: Utilice la notación de prefijo para los valores numéricos (ejemplo: 20,8 Kbytes/seg); de lo contrario, se mostrará el valor completo (ejemplo: 20742 bytes/seg).
- 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 informe. 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 informe. 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 informe. 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:
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 informe. 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 informe. 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 quien está creando el group report no 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 informe. 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
Agents/Modules 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 informe; 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 informe.
Ejemplo:
Si vuelve a editar el informe, deberá volver a seleccionar de nuevo los módulos.
Agentes/Estado de los módulos
Agents/Modules status muestra en modo tabla el estado de los módulos así como su dato y el último tiempo en registrar dicho dato. Ejemplo de solicitud:
Genera la siguiente salida de ejemplo:
Aparte de las opciones generales también permite filtrar por:
- Grupo (Group).
- Selector para agentes múltiples (Agents y el botón All correspondiente).
- Selector para módulos múltiples (Show modules, Modules y el botón All correspondiente).
- Cada uno de los módulo agregados podrá ser excluido al hacer clic en el icono de equis que acompaña su nombre.
El informe puede ser exportado a PDF y CSV (en la imagen un CSV abierto en una hoja de cálculo):
En la Metaconsola el informe contiene el servidor al cual pertenece el agente:
Plantillas están tanto en nodo como en Metaconsola: Esto permite hacer búsquedas por medio de expresiones regulares. Ejemplo:
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
Esta característica también funciona en Metaconsola.
- Name: Nombre del informe; 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
.
Custom SQL
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.
Primer ejemplo
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:
Segundo ejemplo
Versión 765 o posterior.
En una consulta SQL, para delimitar el reporte en fecha y hora tanto de inicio como de finalización, puede utilizar las macros _start_date_
y _end_date_
respectivamente. Ejemplo:
Tercer ejemplo
Obtener todos los módulos llamados Host Alive
que estén en estado critico. Para este ejemplo vaya al menú Reporting → Custom SQL y agregue una consulta con el siguiente código:
SELECT ta.alias AS AGENT, tm.nombre AS MODULE, te.datos AS DATA FROM tagente ta INNER JOIN tagente_modulo tm ON ta.id_agente = tm.id_agente INNER JOIN tagente_estado te ON tm.id_agente_modulo = te.id_agente_modulo WHERE tm.nombre LIKE 'Host%Alive' AND te.estado = '1';
Guarde la consulta con un nombre adecuado.
Ahora vaya al menú Reporting → Customs reports y agregue un reporte con el botón Create report. De nuevo utilice un nombre adecuado y rellene los campos solicitados, guarde el informe con el botón Save.
Ahora vaya al editor de item pulsando en el icono Item editor y seleccione en Type de la lista desplegable la opción SQL query (está en la subsección Grouped). El campo Serialised déjelo en blanco y rellene adecuadamente el resto de los campos. Guarde los cambios.
Vaya al botón de visualización, obtendrá algo parecido a esto:
Top N
Muestra los primeros valores, especificados en el campo 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 informe; 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.
- Use prefix notation: Utilice la notación de prefijo para los valores numéricos (ejemplo: 20,8 Kbytes/seg); de lo contrario, se mostrará el valor completo (ejemplo: 20742 bytes/seg).
- 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 informe; 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 quien está creando el item de informe no 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:
Representación gráfica personalizada
Es necesario conocimiento avanzado sobre Pandora FMS para realizar este tipo de informe ya que es capaz de combinar varios elementos diferentes de PFMS, algunos más complejos que otros.
La Representación gráfica personalizada (Custom render) permite generar informes directos y concisos tanto por pantalla como en PDF (con ciertas limitaciones en ese último formato). Consta de dos componentes, la definición de macros (Macros definition) y la definición gráfica en HTML (Render definition) donde serán insertados los resultados de los macros.
Macros definition
- En la lista desplegable (Type) seleccione el tipo de macro a utilizar.
- Todos los macros, en el Render definition, deben ir con un formato especial: al inicio y al final con el carácter
_
. Por ejemplo: si se agrega un macro llamadonombremacro
deberá colocar_nombremacro_
en el Render definition. - Tipo cadena (String): inserta una cadena donde esté ubicado el nombre del macro (con formato
_nombremacro_
) en el Render definition. - Tipo consulta de lenguaje estructurado (SQL): Obtendrá información de la base de datos (monovalor) y será insertada donde esté ubicado el nombre del macro en el Render definition.
- Tipo gráfico de consulta de lenguaje estructurado (Graph SQL): Permite crear una gráfica de tipo tarta a través de una consulta SQL (véase “Gráficas definidas desde SQL”). Esta consulta sólo podrá tener dos campos que como alias deberán llevar
label
yvalue
; también se podrá definir su alto y ancho. - Gráfica simple de un módulo(Simple graph): Permitirá añadir una gráfica simple de un módulo de Pandora FMS, por lo tanto consta del campo de selección de un agente y después un módulo, también el alto de la gráfica y su periodo cantidad de tiempo en segundos.
Render definition
- Dispone de un editor HTML “lo que vd. ve es lo que obtiene” (abreviado en inglés WYSIWYG) y además, pulsando el botón correspondiente, podrá insertar código HTML puro en una ventana emergente de edición.
Algunas instrucciones en CSS están sin soporte para la generación del informe PDF.
Ejemplo 1 (Simple graph)
Ejemplo 2 (Graph SQL)
Este ejemplo carece por completo de uso práctico en la vida real y solamente tiene propósito didáctico. La consulta a la base de datos es sumamente sencilla:
SELECT tagente_modulo. nombre as 'label', tagente_modulo.id_agente_modulo as ' value' FROM tagente_modulo WHERE tagente_modulo.id_agente=43;
Nótese el uso de los alias label
y value
en la consulta (véase “Gráficas definidas desde SQL” e “Ingeniería de Pandora FMS”).
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 informe; 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 (el tiempo en estado de advertencia es tratado como el tiempo en OK si la casilla de verificación de “Time in warning status” está deshabilitada).
- Time Warning: Tiempo en estado de advertencia.
- 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 informe. 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 informe. 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 acciones
Muestra un listado (Actions alert report) con las alertas lanzadas por los módulos del grupo del informe en el periodo definido.
Para que este informe se visualice en Metaconsola deberá tener la replicación de eventos activada, de lo contrario el informe siempre indicará que no tiene datos a mostrar.
- Time lapse: Intervalo de tiempo sobre el que se calculará el informe (desde el momento actual).
- Group: Lista que filtra los agentes que aparecen en el siguiente campo. No se refleja en el informe, es solo una utilidad del formulario. Aunque quien está creando el item de informe 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).
- Show modules: Selector de todos los módulos o solo los comunes a los agentes seleccionados previamente.
En Metaconsola no se podrá agrupar ni filtrar por plantillas.
- Only data: Si está activada solo mostrará en el resultado los grupos / módulos / agentes /plantillas que contengan al menos una alerta disparada, si está desactivada los mostrará todos.
- Time lapse intervals: Agrupaciones de tiempo que generan tablas. Por ejemplo, si el periodo del informe es de 24 horas (1 día) y se agrupa por intervalos de 6 horas, la información se mostrará en cuatro tablas diferentes ( 24/6=4 ).
- Show summary: Para mostrar o no una tabla de los totales de la información requerida.
- Group by: Para agrupar el informe, bien sea por grupo / agente / módulo / plantilla.
En Metaconsola no se podrá agrupar ni filtrar por plantillas.
Ejemplos:
Mostrando solo los módulos con alerta disparada y su total.
Mostrando todos los módulos con alerta disparada o sin ella y su total.
Mostrando intervalos de 6 horas:
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 informe; 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 quien está creando el informe de alertas de un grupo no 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 informe. 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 (similar al informe de evento de agente).
- 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 informe. 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 informe; 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 quien está creando item de informe de eventos no 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 informe; 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 informe 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 de módulos
Versión 765 o posterior.
Modules inventory lista los módulos registrados y dispone de filtros para seleccionar de manera detallada, incluso a nivel de grupos de módulos, mostrando nombre, descripción, grupo de módulo, etiquetas, grupo de agente y grupo secundario de agente.
- Name: Nombre del informe.
- Agent group filter: Permite seleccionar por grupos de agentes. Para mostrar absolutamente todos los agentes, seleccione All.
- Module group filter: Permite filtrar por grupos de módulos.
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 informe; 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 quien está creando item inventario de informe 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.
- Regular expression: Expresión que permite filtrar por palabras clave en los distintos campos del reporte.
- 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 aquí):
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 informe; 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 quien está creando el item de informe 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 informe. 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 informe; los macros están deshabilitados en este campo.
Aunque 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 informe; 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 informe; 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 informe; 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
Primeras N conexiones de NetFlow
Top-N connections (Primeras N conexiones) es una tabla que muestra el TOP-N de conexiones entre pares de IP Origen - IP Destino, basándose en el tráfico entre dichas direcciones IP ( la suma de los porcentajes de los N elementos de la tabla no va a ser cien porque hay muchas otras parejas de conexiones src/dst que no están en la tabla).
Items de log
Informe de log
Este tipo de informe (Log report) mostrará las entradas de log en el periodo seleccionado.
- Name: Nombre del informe. 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 informes de permisos
Informe de permisos de usuario
Permite seleccionar usuarios o grupos de usuarios y listar sus nombres, grupos y permisos.
- Name: Nombre del informe; 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:
Informes de NCM
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 quien está creando el item de informe 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 quien está creando el item de informe 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 quien está creando el item de informe 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
La programación automática de informes está incluída en las Tareas de Consola (Console task). Para crear una tarea de Consola vaya al menú Discovery → New console task.
Para editar una tarea de Consola haga clic en el icono descrito en la sección anterior.
En ambos casos la interfaz es la misma excepto el botón respectivo para crear (Create) o editar (Update) y guardar los cambios.
Los campos comunes para cada tarea son:
- Scheduled: Periodicidad de la tarea, diariamente (Daily), cada hora (Hourly), mensualmente (Monthly), una sola vez (Not scheduled, ver siguiente punto), semanalmente (Weekly) y anualmente (Yearly).
- Next execution: Próxima ejecución de la tarea, seleccione fecha en el primer campo y hora en el segundo campo (menú emergente al hacer clic en cada uno).
- Group: Grupo al que pertenecerá la tarea.
Los parámetros a rellenar cambian según la tarea que usted escoja en la lista desplegable de Task.
Envío automático de un informe por correo electrónico
Seleccione Send custom report by email en la lista Task:
- Report pending to be created: Reporte personalizado (consulte “Creación de un informe” ) para creación del informe.
- Report per agent: Información de los Agentes para el informe, Agents; si se desea generar informes separados para cada informe.
- Send to email addresses: Direcciones de correo (separadas por medio de comas) para enviar el informe.
- Subject: Tema del correo que se enviará.
- Message: Cuerpo del mensaje con el que se enviarán los informes.
- Report Type: Tipo de informe que será enviado.
Aplicación y envío de plantilla de informe por correo electrónico
Seleccione Send custom report (from template) by email en la lista Task:
Los informes que se enviarán por correo electrónico son:
- Template pending to be created: Plantilla personalizada para creación del informe.
- Agents: Agentes a incluir en el informe, utilice Regex agent filter para seleccionar agentes por medios de expresiones regulares.
- Report per agent: Información de los Agentes seleccionados en Agents para el informe, si se desea generar informes separados para cada informe.
- Send to email addresses: Direcciones de correo (separadas por medio de comas) a quienes enviar el informe.
- Subject: Tema del correo que se enviará.
- Message: Cuerpo del mensaje con el que se enviarán los informes.
- Report Type: Tipo de informe que será enviado.
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 informes.
- 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”.
Ejemplos
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 informe 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 informes.
- 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: Aplicando una plantilla
Cuando se especifique un módulo, este podrá interpretarse de forma literal activando la casilla de verificación Module exact match. Si no lo activamos, utilizará el método estándar de macheo por expresión regular.
Opciones avanzadas
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.
Sistema ACL Enterprise enfocado a informes
Versión 771 o posterior.
Por medio del “Sistema ACL Enterprise” podrá crear perfiles personalizados con los que podrá asignar derechos de visualización, modificación, creación y borrado de informes.
Para ello deberá ir a la configuración del Sistema ACL Enterprise (Management → Profiles → Enterprise ACL setup), seleccionar el perfil al cual asignará los derechos en la lista desplegable en User profile.
Seleccione Reporting en Section y luego agregue en Section 2 los derechos que usted considere necesarios:
- New custom reports: Permite crear informes al perfil de usuario seleccionado.
- Edit custom reports: Permite editar informes al perfil de usuario seleccionado.
- Remove custom reports: Permite borrar informes al perfil de usuario seleccionado.
El siguiente ejemplo muestra las tres opciones seleccionadas para el perfil por defecto llamado Operator (Read); también podrá crear los nuevos perfiles de usuarios y repetir el procedimiento anterior.