Pandora: Documentation en: Dashboard

From Pandora FMS Wiki
Revision as of 16:17, 8 June 2016 by Asier (talk | contribs) (Creating a Dashboard)
Jump to: navigation, search

Go back to Pandora FMS documentation index

1 The Dashboard

1.1 Introduction

The Dashboard is a feature of the Enterprise Version of Pandora FMS. It was designed to allow the users to build their own monitoring pages. It's possible to add more than a page, because you're also able to add monitoring maps, graphs, etc.

The dashboard's configuration is carried out from the same place in which it's possible to gain access to it. Please click on 'Reporting' and 'Dashboard' on the web console's right side to gain access to it.



Dashboard1.png



If you click on the dashboard, the user configured pages are going to be displayed.



Dash1.JPG



1.2 Creating a Dashboard

Dashboards are customized, each user configures his or her own Dashboards and can only see those that he or she has configured.

To create a Dashboard, we click on Reporting -> Main Dashboard, all users have a dashboard named "default".

Click on the "add" button.



Dash2.JPG



In the prompt that appears, the name is placed and the group this dashboard will be visible for is assigned. After we click on 'Add'



Dash3.JPG



Since a new tab has been added, we should know have two tabs, the default tab and the new one. The next step is to add items. For this we press "Add Widget"



Dashboard5.png



A new window appears where all items that can be added are shown.



Dashboard6.png





Dashboard7.png





Dashboard53.png



1.2.1 Adding items to the Dashboard

A series of different items can be added, each with its own characteristics.

1.2.1.1 Group Status Report

To add a report with Pandora FMS group status, we click on the following icon.



Dashboard8.png



When clicking on the icon, the item's configuration window will appear.



Dashboard9.png



The title is then placed, the groups that have to appear are marked on the report, and we press the "update" button and a window like the following should appear:



Dashboard10.png



clicking the group names we can access the corresponding group in the operations menu

1.2.1.2 User defined graphs

To add a user defined graph, we click on the following icon:



Dashboard11.png



When clicking on the icon, we get the item configuration window.



Dashboard12.png



On the configuration window we must configure the following parameters:

  • Title: title that'll appear above the graph.
  • Graph: combo from which the graph that'll appear can be chosen. Choices are from graphs created on Pandora FMS.
  • Period: combo where the graphs period is established.
  • Pile-Up: the type of graph that the data will be shown on is chosen.

The "update" button is pressed and a window like the following should appear:



Dashboard13.png



In the pile up section we have a series of options:



Dashboard135.png



They're the different graphic modes that we can show data with. For example:

Gauge Mode:



Dashboard1355.png



In this type of graph the maximum and minimum for each timer will be defined by the minimum and maximum value defined within each module. If otherwise, the maximum or minimum value our module has taken throughout its runtime will be the one shown. "Warning" or "critical" values are shown as orange and red stripes accordingly.


Piled up area:



Dashboard13555.png



1.2.1.3 List of latest events

To add a list with the latest events occurred on Pandora FMS we must click on the following icon:



Dashboard15.png



When clicking on the icon the item configuration window appears.



Dashboard16.png



On the configuration window the following parameters must be configured:

  • Title: title that'll appear above the graph
  • Event Type: combo where you can choose amongst the different types of events available (Critical, Warning...).
  • Interval: combo where the time interval to be used can be defined.
  • Limit: combo where the maximum number of events that'll appear can be defined.
  • Event Status: combo where the status for each event can be chosen: validated, unvalidated, all.
  • Groups: groups that will be shown in events are selected.

We click on the "update" button and a window like the following should appear:



Dashboard17.png



If we click on the agent name the agent configuration window is accessed.

1.2.1.4 System status

To add a report with Pandora FMS monitors status, we click on the following icon:



Dashboard18.png



When clicking on the icon we get the item with the system status.



Dashboard19.png



1.2.1.5 Pandora FMS welcome message

To add a welcome message on Pandora FMS we click the following icon:



Dashboard20.png



When clicking on the icon the item with the welcome message appears.



Dashboard21.png



1.2.1.6 Agent module graph

To add a graph for an agent module on Pandora FMS, we click on the following icon:



Dashboard22.png



When clicking on the icon, the item's configuration screen will appear.



Dashboard23.png



On the configuration window we must configure the following parameters:

  • Title: title that'll appear above the graph
  • Group: combo where the agent's group is assigned.
  • Agent: combo where the agent is chosen
  • Module: combo where the module is chosen
  • Period: combo where the period of time for the graph is set.

We click on the "Update" button, and should get a window like the following:



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.
  • Group: combo donde se elige el grupo de los agentes que aparecerán ene le mapa
  • Layout: combo donde se elige según el tipo de mapa como están colocados los agentes.
  • No overlap: si se marca los agentes no aparecerán sobrepuestos.
  • Simple: si se marca los agentes aparecerán sin iconos.
  • Font size: 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:



Dashboard30.png



1.2.1.9 Mapa de la consola visual

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.
  • Height in px (zero for auto): altura del widget (con valor cero tomará una altura automática).

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



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



Dash8.JPG



Las opciones de configuración que presenta son:



Dash9.JPG



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



Dash10.JPG



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.



Dash11.JPG



Las opciones de configuración que presenta son:



Dash12.JPG



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



Dash10.JPG



1.2.1.16 Top N de módulos

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



Dash13.JPG



Las opciones de configuración que presenta son:



Dash14.JPG



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



Dash15.JPG



1.2.1.17 Mostrar un mapa de servicios

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



Dash16.JPG



Las opciones de configuración que presenta son:



Dash17.JPG



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



Dash18.JPG



1.2.1.18 Informe de alertas disparadas

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



Dash19.JPG



Las opciones de configuración que presenta son:



Dash20.JPG



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



Dash21.JPG



1.2.1.19 Mostrar la vista de árbol

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



Dash22.JPG



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:



Dash23.JPG



  • Título: título que le daremos al widget.
  • Imagen de fondo: código CSS para elegir el color de fondo.
  • Tab: pestala de la vista de árbol que queremos mostrar.
  • Agents status: si queremos filtrar por estado de agente.
  • 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.



Dash24.JPG



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 Editing a Dashboard

You may edit the dashboard's name and group. In order to update an already existing dashboard, please click on the 'Dashboard Options' and 'Update Dashboard' options.

Dashboard36.png



Please click on the 'Update Dashboard' option as shown above.



Dashboard37.png



1.4 Deleting a Dashboard

In order to delete a dashboard, please click on the triangle-shaped icon, which is located on the tab you intend to delete. It's also going to display the 'Update Dashboard' and 'Delete Dashboard' options.



Dashboard40.png



Please click on the 'Delete Dashboard' option.

Go back to Pandora FMS Documentation Index