Pandora: Documentation es: Dashboard

From Pandora FMS Wiki
Jump to: navigation, search

Volver a Indice de Documentacion Pandora FMS

1 Dashboard

1.1 Introducción

El Dashboard es una funcionalidad de Pandora FMS (versión Enterprise) que permite que cada usuario se construya su propia página de monitorización. Se puede añadir más de una página, y en ella se pueden añadir mapas de monitorización, gráficas y resúmenes de estado, entre otros elementos.



Dash1.JPG




Para configurar o visualizar un dashboard, debe accederse a la sección Reporting -> Dashboard, situada en el menú lateral de la consola web de Pandora FMS:



Dashboard1.png



Al entrar en esta sección, aparecerá una lista con los dashboards a los que el usuario tenga permisos para acceder, así como la opción de crear otros nuevos.

1.2 Creación de un Dashboard

Para crear un Dashboard, pulse en el botón "New dashboard" del menú Reporting -> Main Dashboard.



Dash2.JPG



Se creará un dashboard con un objeto de muestra. Para personalizarlo, añadiendo widgets y especificando los usuarios que podrán modificarlo, deberá hacer clic en el botón de Opciones, del menú superior derecho:

Dash-options.png



En el diálogo que aparece debe asignarle un nombre al dashboard, seleccionar el número de celdas (widgets) que va a contener, e indicar si será de tipo privado (sólo podrá verlo el usuario que lo haya creado y el administrador de Pandora) o visible para un grupo, como en la imagen a continuación.



Dash-options2.png



Aplique los cambios con el botón "Save" (tenga en cuenta que si quiere cambiar el número de celdas, debe hacer clic en "Update"). El siguiente paso es añadirle objetos al dashboard, haciendo clic en “Add Widget”. Esta opción sólo aparecerá en las celdas vacías:



Dashboard5.png



Aparecerá una nueva ventana donde están todos los tipos de objeto que se pueden añadir. Puede navegarse entre las distintas páginas con los botones de la parte superior izquierda.



Dash-widgets.png




1.2.1 Añadir Widgets en el Dashboard

A cada dashboard se le pueden añadir varios widgets (objetos) diferentes, ocupando una celda cada uno. Cada widget tiene sus características y configuraciones propias, por lo que a continuación se detallará su uso y las opciones disponibles para cada uno.

1.2.1.1 Informe de Estado de grupos

Este widget muestra un estado del grupo de Pandora FMS que se escoja, indicando el número total de agentes y módulos en dicho grupo, así como un conteo organizado por su estado. Para añadir este widget, debe hacer clic en el siguiente icono:



Groups status.png



Aparecerá la siguiente ventana de configuración.



Dash-groups.png



En ella debe indicar el nombre a mostrar para el objeto y el grupo que debe aparecer. Opcionalmente, puede escogerse un color de fondo específico para el widget, estableciendo su código CSS. El widget resultante será algo similar a esto:


Group stats widget.png


Puede acceder al grupo correspondiente haciendo clic en su nombre, una vez el widget esté creado.

1.2.1.2 Gráficas definidas por el usuario

Para añadir una gráfica definida por el usuario se pincha en el siguiente icono:



Custom graph.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Config custom graph3.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Título: título que aparecerá encima de la gráfica.
  • Gráfica: combo donde se puede elegir la gráfica que aparecerá. Se elige entre las gráficas creadas en Pandora FMS.
  • Periodo: combo donde se elige el periodo de la gráfica.
  • Apilado: se seleccionará el tipo de gráfica sobre la que se muestran los datos.
  • Color: por cada agente/modulo se puede seleccionar un color para la gráfica. Si el tipo de gráfica es Gauge, gráfico bala, barras horizontales o gráfico circular, no se podrá seleccionar colores.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



View custom graph.png



En el apartado apilado tenemos varias opciones:



Config custom graph2.png



Son los diferentes modos de gráfica con los que podemos mostrar los datos, por ejemplo:

Modo Gauge:



View gauges.png



En este tipo de gráfica el máximo y el mínimo de cada reloj vendrá dado por el valor máximo y mínimo definido dentro de cada módulo, de no ser así se mostrará el valor máximo o mínimo que ha cogido nuestro módulo a lo largo de su ejecución. El valor "Warning" o "Critical" se muestran como una ralla naranja o roja respectivamente.


Área apilada:



View stacked graph.png



1.2.1.3 Lista de los últimos eventos

Para añadir una lista con los últimos eventos ocurridos en Pandora FMS se pincha en el siguiente icono:



Events list.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Config event list.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Título: título que aparecerá encima de la gráfica.
  • Event Type: combo donde se puede elegir entre los diferentes tipos de eventos que hay (Critical, Warning, …).
  • Interval: combo donde se define el intervalo de tiempo que se usará.
  • Limit: combo donde se define el número máximo de eventos que apareceran.
  • Event Status: combo donde se puede elegir el estado del evento, validado, sin validar o todos.
  • Groups: se marcan los grupos de los que se mostraran los eventos.
  • Tags: se marcan los tags de los que se mostraran los eventos.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



View event list.png



Si se pincha en el nombre del agente se accede a la ventana de configuración del agente.

1.2.1.4 Estado del sistema

Para añadir un informe con el estado de los monitores de Pandora FMS se pincha en el siguiente icono:



Monitor health.png



Al pinchar en el icono aparece el objeto el estado del sistema.



Dashboard19.png



1.2.1.5 Mensaje de Bienvenida de Pandora FMS

Para añadir Mensaje de bienvenida de Pandora FMS se pincha en el siguiente icono:



Dashboard20.png



Al pinchar en el icono aparece el objeto con el mensaje de bienvenida.



Dashboard21.png



1.2.1.6 Gráfica del módulo de un agente

Para añadir una gráfica del módulo de un agente de Pandora FMS se pincha en el siguiente icono:



Dashboard22.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Single graph01.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Título: título que aparecerá encima de la gráfica.
  • Agente: combo donde se elige el agente.
  • Módulo: combo donde se elige el módulo.
  • Periodo: combo donde se elige el periodo de tiempo que tendrá la gráfica.
  • Colores del gráfico : Podemos definir el color para el máximo, mínimo y media del gráfico. Si el check Show full legend no esta marcado, solo aparecerá la media en el gráfico, y por tanto, solo se utilizara ese color.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



Dashboard24.png



1.2.1.7 Informe de los mapas visuales

Para añadir un informe de los mapas visuales de Pandora FMS se pincha en el siguiente icono:



Dashboard25.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Dashboard26.png



Se pone el título, se marcan los mapas de la consola visual que deben aparecer en el informe y se pulsa el botón de “update”. Entonces aparece una ventana como la siguiente:



Dashboard27.png



Si se pincha sobre el nombre del mapa se accede al mapa en la consola visual.

1.2.1.8 Mapa de Red

Para añadir un mapa de red de Pandora FMS se pincha en el siguiente icono.



Dashboard28.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Dashboard29.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Title: título que aparecerá encima del mapa.
  • Map: combo donde se elige el mapa a utilizar en el widget
  • X offset: Cantidad que se desplazará sobre el eje x, se aceptan cantidades negativas.
  • Y offset: Cantidad que se desplazará sobre el eje y, se aceptan cantidades negativas.
  • Zoom level: nivel de enfoque sobre el network map.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



Dashboard30.png



1.2.1.9 Mapa de la consola visual

Template warning.png

Esta versión solo está por el momento soportado en versiones de escritorio

 


Para añadir un mapa de la consola visual de Pandora FMS se pincha en el siguiente icono :



Dashboard31.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Dashboard32.png



Se pone el título, se elige en un combo el mapa que deben aparecer en el objeto.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:


Template warning.png

Los mapas deben ser creados previamente en Administration > Reporting > Visual console

 




Dashboard33.png



1.2.1.10 Ver contenido de URL

Para añadir el contenido de una URL en Pandora FMS se pincha en el siguiente icono.



Dashboard 41.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Dashboard 42.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Title: título que aparecerá encima del widget.
  • URL: combo donde se elige el tamaño de la letra usada para poner el nombre del agente.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



Dashboard 43.png



Hay que tener en cuenta que solo se mostrarán en el widget las url embebidas. Esto es así porque se está enviando la opción "X-Frame_Options: SAMEORIGIN" en la cabecera de respuesta. Esta opción impide que el navegador muestre iFrames que no estén alojados en el mismo dominio que la página principal. Por este motivo solo se podrán mostrar url con contenido embebido.

Por ejemplo, si queremos mostrar un vídeo con la url "https://www.youtube.com/watch?v=ql6LEwhmDWE" deberemos cambiarla ya que esa url muestra la web completa donde se aloja el vídeo, para esto, cambiamos el texto "watch?v=" por "embed/" y nos quedará la url "https://www.youtube.com/embed/ql6LEwhmDWE" la cuál se mostrará correctamente en el iframe correspondiente a la celda del widget.

También, habrá que "autorizar" el contenido en el navegador en el que nos encontremos, validando este contenido de forma manual.

Autorizar contenido.png

1.2.1.11 Vista táctica

Para añadir una vista táctica de Pandora FMS se pincha en el siguiente icono.



Dashboard 44.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Dashboard 45.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Title: título que aparecerá encima del widget.
  • Status and Monitor checks: Enseña información sobre módulos del sistema.
  • Server performance: Resumen de estadísticas del servidor.
  • Summary: Resumen sobre información de agentes y módulos.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



Dashboard 46.png



1.2.1.12 Panel de nota

Para añadir un panel de nota de Pandora FMS se pincha en el siguiente icono.



Dashboard 47.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Dashboard 48.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Title: título que aparecerá encima del widget.
  • Text: Texto libre con el contenido de la nota.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



Dashboard 49.png



1.2.1.13 Informes de usuario

Para añadir informes de usuario de Pandora FMS se pincha en el siguiente icono.



Dashboard 50.png



Al pinchar en el icono aparece la ventana de configuración del objeto.



Dashboard 51.png



En la ventana de configuración se deben configurar los siguientes parámetros:

  • Title: título que aparecerá encima del widget.
  • Report: Nombre del informe que contendrá el widget.

Se pulsa el botón de “update”, y aparece una ventana como la siguiente:



Dashboard 52.png



1.2.1.14 Top N de eventos por grupos de agentes

Para mostrar la gráfica de top de eventos por agentes, usaremos el siguiente widget.



Top n events by group.png



Las opciones de configuración que presenta son:



Config topn agents.png



  • Title: título que le daremos al widget.
  • Amount to show: cantidad de agentes.
  • Max. hours old: tiempo en el que se tendrán en cuenta los eventos existentes para mostrar.
  • Groups: qué grupos de agentes queremos incluir.
  • Legend position: posición de la leyenda.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View topn agents.png



1.2.1.15 Top N de eventos por módulos

Para mostrar la gráfica de top de eventos por módulos en función del grupo, usaremos el siguiente widget.



Top n events by module.png



Las opciones de configuración que presenta son:



Config topn modules.png



  • Title: título que le daremos al widget.
  • Amount to show: cantidad de tipos de evento.
  • Max. hours old: tiempo en el que se tendrán en cuenta los eventos existentes para mostrar.
  • Groups: qué grupos de agentes queremos incluir.
  • Legend position: posición de la leyenda.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View topn modules.png



1.2.1.16 Top N de módulos

Para mostrar la gráfica de top de módulos, usaremos el siguiente widget.



Top n.png



Las opciones de configuración que presenta son:



Config topn agents modules.png



  • Title: título que le daremos al widget.
  • Period: periodo de datos que se van a utilizar para mostrar la información del widget.
  • Quantity (n): cantidad de módulos a mostrar.
  • Order: forma de ordenar los elementos.
  • Display: qué top queremos mostrar, mínimo, máximo, o promedio.
  • Items: para añadir los módulos que queremos que utilice el widget, se pueden añadir individual o masivamente.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View topn agents modules.png



1.2.1.17 Mostrar un mapa de servicios

Para mostrar un árbol de servicio, utilizaremos el siguiente widget.



Service map.png



Las opciones de configuración que presenta son:



Config service.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: color de fondo en valor CSS.
  • Servicio: servicio que mostrar, debe estar previamente creado en la sección de servicios.
  • Leyenda: si queremos que se muestre una leyenda explicativa.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View service.png



1.2.1.18 Informe de alertas disparadas

Para mostrar un informe de alertas disparadas usaremos el siguiente widget.



Alerts fired.png



Las opciones de configuración que presenta son:



Config alerts.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: color en código CSS.
  • Grupos: grupo del cual queremos obtener el informe de alertas.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View alerts.png



1.2.1.19 Mostrar la vista de árbol

Para mostrar la vista de árbol usaremos el siguiente widget.



Tree view.png



Este widget mostrará la vista de árbol por defecto sin necesidad de modificar opciones de configuración. No obstante hay algunas cosas que se pueden modificar si así lo deseamos, las opciones de configuración son:



Config tree.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Tab: pestaña de la vista de árbol que queremos mostrar.
  • Group: grupo qsobre el que queremos mostrar.
  • Open all nodes: Si está marcada, el árbol se mostrará abierto.
  • Agents status: si queremos filtrar por estado de agente.
  • Filter Agents: si queremos filtrar agentes por nombre.
  • Modules status: si queremos filtrar por estado de módulo.
  • Filtrar módulos: si queremos filtrar módulos por nombre.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View tree.png



1.2.1.20 Mostrar el valor del módulo y un icono

Para mostrar el valor del módulo y un icono usaremos el siguiente widget.



Module icon.png



Las opciones de configuración que presenta son:



Config module icon.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Label: etiqueta que queremos que se muestre.
  • Agent: Agente que se utilizará para obtener el listados de módulos del seleccionado.
  • Module: Módulo que se utilizará para obtener el dato a mostrar.
  • Icon: Icono que se mostrará en el widget.
  • Text size of value in px: Tamaño en pixeles para el tamaño del valor. si no se indica nada será lo especificado en PandoraFMS.
  • Text size of label in px:Tamaño en pixeles para el tamaño de la etiqueta, si no se indica nada será lo especificado en PandoraFMS.
  • Size icon: Tamaño del icono, si no se indica nada será el tamaño del icono.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View module icon.png



1.2.1.21 Mostrar el valor del módulo

Para mostrar el valor del módulo usaremos el siguiente widget.



Module value.png



Las opciones de configuración que presenta son:



Config module value.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Label: etiqueta que queremos que se muestre.
  • Agent: Agente que se utilizará para obtener el listados de módulos del seleccionado.
  • Module: Módulo que se utilizará para obtener el dato a mostrar.
  • Text size of value in px: Tamaño en pixeles para el tamaño del valor. si no se indica nada será lo especificado en PandoraFMS.
  • Text size of label in px:Tamaño en pixeles para el tamaño de la etiqueta, si no se indica nada será lo especificado en PandoraFMS.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View module value.png



1.2.1.22 Mostrar el estado del módulo

Para mostrar el valor del módulo usaremos el siguiente widget.



Module status.png



Las opciones de configuración que presenta son:



Config module status.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Label: etiqueta que queremos que se muestre.
  • Agent: Agente que se utilizará para obtener el listados de módulos del seleccionado.
  • Module: Módulo que se utilizará para obtener el estado para la imagen.
  • Icon: Icono que se mostrará en el widget y que cambiará según el estado del módulo.
  • Text size of label in px:Tamaño en pixeles para el tamaño de la etiqueta, si no se indica nada será lo especificado en PandoraFMS.
  • Size icon: Tamaño del icono, si no se indica nada será el tamaño del icono.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View module status.png



1.2.1.23 Mostrar el valor del módulo en formato tabla

Para mostrar el valor del módulo usaremos el siguiente widget.



Module table value.png



Las opciones de configuración que presenta son:



Config module table.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Agent: Agente que se utilizará para obtener el listados de módulos del seleccionado.
  • Module: Módulo que se utilizará para obtener el dato a mostrar.
  • Text size of value in px:Tamaño en pixeles para el tamaño del valor, si no se indica nada será lo especificado en PandoraFMS.
  • Separator of data: Separador que se utilizará para generar las diferentes lineas. Las opciones posibles son: Retorno de carro, barra vertical, punto y coma, dos puntos, coma, espacio en blanco.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View module table.png



1.2.1.24 Mostrar la gráfica del histórico de estados de un módulo

Para mostrar una gráfica del histórico de estados del módulo usaremos el siguiente widget.



Graph module histogram.png



Las opciones de configuración que presenta son:



Config grapg module.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Agent: Agente que se utilizará para obtener el listados de módulos del seleccionado.
  • Module: Módulo sobre el que se obtendrá los datos para el histórico.
  • Periodicity: Periodo sobre el que se realizará la grafica del historico de estado del módulo seleccionado. El valor a seleccionar está comprendido entre 1h y 48h.
  • Text size of value in px:Tamaño en pixeles para el tamaño del valoe, si no se indica nada será lo especificado en PandoraFMS.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View graph module.png



1.2.1.25 Mostrar un listado de Agentes/Módulos

Para mostrar un listado de agentes seleccionados y los módulos usaremos el siguiente widget.



Agent module.png



Por defecto carga los módulos en común de los agentes existentes, si hay alguno coincidente entonces saldrán datos. Existe también la posibilidad de configurarlo, estás son las opciones:



Config agent module.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Group: grupo para filtrar el listado de agentes.
  • Agents: listado de agentes .
  • Show common modules: Hay dos opciones, mostrar los módulos comunes a los agentes seleccionados o mostrar todos los módulos de los agentes seleccionados. Por defecto 'Show common modules'.
  • Modules: Lista de módulos generada a partir de lo seleccionado en agentes y mostrar los módulos en común.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View agent module.png



1.2.1.26 Mostrar el porcentaje SLA de un módulo

Para mostrar un listado de agentes seleccionados y los módulos usaremos el siguiente widget.



Sla percent.png



Las opciones de configuración que presenta son:



Config sla.png



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Agent: Agente que se utilizará para obtener el listados de módulos del seleccionado.
  • Module: Módulo sobre el que se obtendrá los datos para el histórico.
  • Periodicity: Periodo sobre el que se realizará la grafica del historico de estado del módulo seleccionado. El valor a seleccionar está comprendido entre 1h y 48h.
  • Text size of value in px:Tamaño en pixeles para el tamaño del valor, si no se indica nada será lo especificado en PandoraFMS.
  • Text size of label in px:Tamaño en pixeles para el tamaño de la etiqueta, si no se indica nada será lo especificado en PandoraFMS.

Al guardar la configuración, el widget presentará un aspecto como el siguiente.



View sla.png



1.2.2 Colocar objetos en el Dashboard

Pinchando con el ratón en los objetos del Dashboard es posible moverlos y colocarlos donde el usuario desee.

1.2.3 Editar Objetos en el dashboard

Para editar los parámetros de configuración de un objeto del Dashboard se pulsa sobre el icono de configuración que hay en la parte superior derecha del objeto que se quiere editar.



Dashboard34.png



Una vez se ha pinchado en el icono aparece el menú de configuración del objeto. Se modifica y se pincha en “update” para guardar los cambios.

1.2.4 Borrar objetos en el Dashboard

Para borrar los parámetros de configuración de un objeto del Dashboard, se pulsa sobre el icono papelera que hay en la parte superior derecha del objeto que se quiere borrar.



Dashboard35.png



1.3 Editar un Dashboard

Los valores de un dashboard que se puede editar son el nombre, el grupo y el número de celdas. Para modificar un Dashboard ya creado se pulsa sobre el icono 'Options'.

Dash7.JPG



Se pulsa en la opción “Update” del elemento que hayamos modificado.

1.4 Borrar un Dashboard

Para borrar un Dashboard ya creado se pulsa sobre el triángulo que hay en la pestaña que se quiere borrar. Aparecerá la opción de renombrar y borrar el dashboard.



Dash6.JPG



Se pulsa en la opción “Delete Dashboard”.

Volver a Indice de Documentacion Pandora FMS

1.5 Modo diapositivas

Para activar el modo diapositivas, o presentación, basta con acceder a dicho modo en el menú superior derecho, desde la sección de dashboards, y seleccionar los dashboard que queramos mostrar en la presentación.



Dash4.JPG



La consola cambiará a modo diapositivas, desde donde podremos controlar, entre otras cosas, la frecuencia de rotación.



Dash5.JPG




1.6 Modo pantalla completa

Para acceder al modo pantalla completa, lo haremos desde mediante el siguiente icono.



Dash25.JPG



Esta pantalla sencilla e intuitiva, y los controles se asemejan a los del modo diapositivas. Nos permite establecer una tasa de refresco y cambiar a modo diapositivas.



Dash26.JPG