Customizable Console: Dashboard

The Dashboard

Introduction

Enterprise version.The Dashboard is a Pandora FMS Enterprise feature that allows users to build their own monitoring pages. It is possible to add more than one page and there you may add monitoring maps, graphs, status summaries, etc.

dash1.jpg

The set up or see a dashboard, go to Reporting > Dashboard, located on Pandora FMS web console's right side.

When entering this section, a list will appear with the dashboards that the user has permissions to access, as well as the option to create new ones.

Pandora FMS simplifies monitoring management through user permissions. There are several permission systems that restrict what a user can see or manage, the most important is the concept of groups (either predefined groups by Pandora FMS and/or customized groups) combined with the profile of each user. Pay special attention to the notes about the All group (ALL) throughout the documentation.

Migration to the new dashboard system

From version 745 onwards, a new dashboard system comes into operation in Pandora FMS.

If there are already any dashboards created in your system there will be no need of performing any additional configurations, as the migration to the new system will be done automatically. However, you will need to relocate and resize the corresponding widgets.

In some cases, the contents of some widgets cannot be migrated, so you must delete and create again the widgets.

Creating a Dashboard

To create a Dashboard, go to Reporting > Dashboard and click New dashboard.

dash2.jpg

In the popup dialog, assign a name to the dashboard, which will have a single cell by default, and indicate whether it will be private (only the user who created it and the Pandora FMS administrator will be able to see it) or visible for a group.

Only a group to which the user creating the dashboard belongs can be assigned, unless that user explicitly belongs to the ALL group.

If you checked the option Favourite when reloading the page, you will have in the menu a direct access to the recently created dashboard.

To edit the Dashboard, click on the editing button located at the right of the icon line, then to add cells click on the circle icon with +.

Click Add widget, and you will see a new window where all types of items that can be added are. You may browse through the different pages and see all available widgets by using the buttons at the left corner.

You may modify again the Dashboard (name, private, users, favorites): click on the icon next to the add cells button. You may also select other dashboards from the deploying list next to it and repeat the widget modifying and adding procedures.

Adding widgets to the Dashboard

Several different widgets (objects) can be added to each dashboard, each one occupying a cell. Each widget has its own characteristics and configurations, their use and the options available for each one are detailed below.

Widgets have some common fields such as title, group, background color, etc.

Display a list of agents/modules

To show a list of selected agents and modules use the following widget.

Existing agent common modules are loaded by default. If any of them match, the data will be displayed. It may also be configured using these options:

  • Title: Title the widget will be given.
  • Background image: CSS color code for the background.
  • Group: Group to filter the agent list.
  • Agent: Agent list.
  • Show common modules: There are two options, showing the selected agent common modules or showing all selected agent modules. By default Show common modules.
  • Modules: Module list generated from what has been selected on agents and common modules.

When saving the configuration, the widget should look something like the one shown below.

Triggered alert reports

To show a report on triggered alerts, use the following widget.

The settings options it shows are:

  • Title: Widget title.
  • Background image: Background color in CSS code.
  • Groups: Group from which the alert report is to be obtained.

When saving the configuration, the widget will look something like this.

Clock

This widget displays a clock with the time set in the console. To add this widget, click on the following icon:

The following setup window will appear.

In Clock type, choose digital or analogical clock. The other options are those common to the previous widgets.

User defined graphs

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

Item configuration window.

  • Graph: Combo where the graph that will appear can be chosen. Select it from the graphs created on Pandora FMS.
  • Periodicity: Combo where the graph period is established.
  • Stacked: The type of graph that the data will be shown on.

When clicking on update a window like the following should appear:

In the Stacked section you have a series of options:

They are the different graph modes for showing data. For example:

Gauge Mode:

In this type of graph, the maximum and minimum for each timer will be defined by the minimum and maximum values defined within each module. Otherwise, the maximum or minimum value the module took throughout its runtime will be the one shown. Warning or Critical values are shown as orange and red stripes accordingly.

Stacked area:

List of latest events

To add a list with the latest events that took place in Pandora FMS, click on the following icon:

When clicking on the icon, the item configuration window appears.

  • Event Type: Combo where you may choose amongst the different types of events available (Critical, Warning, etc.).
  • Max. hour old: Combo where the time interval to be used is defined (in hours).
  • Limit: Combo where the maximum number of events to be showed is set.
  • Event Status: Combo where the status for each event can be chosen: validated, unvalidated, all.
  • Groups: Groups that will be shown in events.
  • Tags: Tags that will be shown in events.

Click on update and a window like the following should appear:

Click on the agent name to access the agent configuration window.

Display module status history graph

To display a graph of historic module status, use the following widget.

The settings options are:

  • Agent: Agent used to obtain the module list of the selected one.
  • Module: Module that provides the historical data.
  • Periodicity: Period covered by the module status history graph. Value between 1h and 48h.
  • Text size of value in px: Pixel size for the value size. If not indicated, Pandora FMS will indicate it.

When saving the configuration through Update, the widget should look something like the one shown below.

Top N events per modules

To show the graph for top events per modules, based on the group, the following widget is used.

The configuration options are:

  • Amount to show: Amount of event types.
  • Max. hours old: Time (in hours) where the existing events to show will be taken into account.
  • Groups: Agent groups to include.
  • Legend position: Graph key position.

When saving the configuration, the widget should look something like the one below.

Group Status Report

This widget shoss the selected Pandora FMS group status, pointing out the total amount of agents and modules within that group as well as an organized counting by its state. To add this widget, click on the following icon:

Configuration window:

Once configurad as explained in previous sections, the resulting widget will be something similar to this:

Once the widget is created, you may access the corresponding group by clicking on its name.

Show tree graph view

To show the tree graph view, use the following widget.

This widget will show the default tree graph view without the need to modify configuration options. However, there are some things that can be modified if you wish. The settings options are:

  • Type tree: Tree view grouped by tags, (//policies//), etc.
  • Groups: Desired group.
  • Open all nodes: If checked, the tree view will have all nodes opened.
  • Agents status: Filter by agent status.
  • Filter Agents: Filter by agent name.
  • Modules status: Filter by module status.
  • Filter modules: Filter modules by name.

When saving the configuration, the widget should look similar to the one shown below.

The Visual Console's Map

This version is supported in desktop screens only for now. Maps must be previously created in Topology maps > Visual console.

Click on the icon shown below in order to add a map from Pandora FMS visual console.

Item configuration window:

Choose a map, among those created, in the Visual console combo and click Ok. Wait a little. Adjust the size to the appropriate measures according to the screen size where the visual map will be displayed.

Visual maps report

In order to add a report containing Pandora FMS visual maps, click on the following icon:

Item configuration window:

Select a visual console in Maps. You may select several if you press CTRL while you click on each of the desired visual consoles. Click OK and the report with the selected data will be created:

This list will show a green rectangle (OK) if everything in the console is in normal status, but if one of the modules is in any of the other possible states, it will be red (BAD).

If you click on the map's name, you will access the map within the visual console.

Show icon and module value

To show the icon and a module value, use the following widget.

The settings options it shows are:

  • Label: Text label to be shown.
  • Agent: Agent used to abotain the module list of the selected one.
  • Module: Module used to obtain the data to be shown.
  • Icon: Icon displayed on the widget.
  • Text size of value in px and Text size of label in px: Size in pixels of text value and tag accordingly. If nothing is specified, Pandora FMS default one will be indicated.
  • Size icon: Icon size, default icon size if nothing is specified.

When saving the configuration, the widget should look something like the one shown below.

Show module status

To display the module value, use the following widget represented by the following icon:

Setting options:

  • Agent: Agent used to obtain the module list of the selected one.
  • Module: Module used to obtain status for the image.
  • Icon: Icon shown in the widget that reflects changes in module status.
  • Text size of label in px: Pixel size for the label size. If no size is displayed, Pandora FMS will specify it.
  • Size icon: Icon size.

When saving the configuration, the widget should look something like the one shown below.

See URL content

In order to have the URL content displayed in Pandora FMS, click on the icon shown on the picture below.

Item configuration window:

Within the configuration window, the following parameters must be configured:

  • URL: The combo where agent web address of the website to be shown must be included. By clicking Ok and loading the page, it will show something like this:

Bear in mind that the website must match the size of the cell that hosts the widget or have //responsive web design// technology. Likewise, pay attention to the iFrame or boxes you have and in addition the possible links that use HTTP instead of HTTPS (encrypted content).

Show the module value as a chart

To show the module value use the following widget.

The setting options it shows are:

  • Agent: Agent chosen to obtain the module list of the selected one.
  • Module: Module used to obtain the data to be shown.
  • Text size of value in px: Pixel size for value size. If no value is indicated, Pandora FMS will specify it.
  • Data separator: Separator to generate different lines. Possible options are: carriage return, vertical bar, semi-colon, colon, comma, space.

When saving the configuration, the widget should look something like the one shown below.

Haga clic para ampliar

Show module value

To show the module value view use the following widget.

The setting options are:

  • Agent: Agent used to obtain the module list of the selected one.
  • Module: Module used to obtain the data to be shown.
  • Text size of value in px and Text size of label in px: Size in pixels of text value and tag accordingly. If nothing is specified, Pandora FMS sets the default one.

When saving, the widget should look something like the one shown below.

System status

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

The item with all the information about the current system status is displayed automatically.

Network Map

This type of element is not compatible with another network map or with a services map in the same dashboard

In order to add a Pandora FMS network map, click on the icon:

Item configuration window:

  • Map: Combo where the network map is selected.
  • X offset and Y offset: Amount that moves along the X and Y axis, negative numbers are accepted.
  • Zoom level: Level of focus on the network map.

If you click Update, a window the one shown below will appear.

Message panel

In order to add a Pandora FMS message panel, click on the icon shown below.

Item configuration window:

  • Text: A free-text field containing the message itself.

If you click Update, a window like the one below will appear.

Custom reports

In order to add custom reports in Pandora FMS, click on the icon shown below.

Item configuration window:

  • Report: Choose the report, which must be previously created and contains the widget.

Click Update:

Showing a service map

This type of element is not compatible with another service map or with a network map in the same dashboard

To show a service map use the following widget.

Settings options:

  • Service: Service to be shows. It must have been previously created in the service section.
  • Legend: If you want a graph legend.

When saving the configuration, the widget should look something like the one below.

Agent module graph

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

Item configuration screen:

  • Agent: Combo where the agent is chosen.
  • Module: Combo where the agent module selected in the previous point is chosen.
  • Show full legend: If the box is checked, the full legend will be displayed.
  • Periodicity: Combo where the graph time period is set.
  • Graph color: Define the colors graph's maximum, minimum and average. If Show full legend is not checked, only the graph's average will appear, so only that color will be used.

Click Update, which should provide a window like the following:

Show module SLA percentage

To show a list of selected agents and the modules, use this widget.

Setting options:

  • Agent: Agent used to obtain the module list of the selected one.
  • Module: Module that will provide the data for the selected module status history graph.
  • Periodicity: Period on which the status history graph of the selected module will be made. The value to be selected must be between 1h and 48h.
  • Text size of value in px and Text size of label in px: Value size in pixels for the value and the tag accordingly. If nothing is indicated, Pandora FMS will set the default one.

Click Update:

Group Status

This widget shows a table with the status of the selected groups:

Configuration window:

  • Groups: Groups to be shown in the widget.
  • Status: Status of the groups to be shown.

Click Update, and a window like the following will appear:

Tactical View

In order to add a tactical view of Pandora FMS, click on the icon shown below.

Configuration window:

  • Status and Monitor Checks: General information on the modules.
  • Server Performance: Summary of server statistics.
  • Summary: Summary information about agents and modules.

Click Update:

Top Number of events per agent groups

To show the graph for top events for agents, use the following widget:

Setting options:

  • Amount to show: Amount of agents.
  • Max. hours old: Time during which existing events shown will be taken into account.
  • Groups: Agent groups to be included.
  • Legend position: Graph legend position.

When saving the configuration, the widget will look something like this:

Top N modules

To see graph of the list of more recent modules, use the following widget:

Setting options:

  • Agent: Agents to include through a regular expression (regex).
  • Module: Modules to be included through a regular expression.
  • Period: Data period that will be used to show the widget's information.
  • Quantity (n): Amount of modules shown.
  • Order: Way to organize elements, either ascending, descending, or even by agent name.
  • Display: List to be shown by minimum, maximum or average.

When saving the configuration, the widget should look like the one shown below.

Show agent WUX transaction

This widget shows a selected WUX transaction:

Setup window:

  • Agent: Choose the agent that has the WUX monitoring to be shown.
  • WUX Transaction: Choose the WUX module to show.

Click Update, and a window like the following will appear:

Show agent WUX transaction statistics

This widget shows the stats of a selected WUX transaction:

Setup window:

  • Agent: Choose the agent that has WUX monitoring to show.
  • WUX Transaction: Choose the WUX module to show.

Click Update, and a window like the following will appear:

Placing items on the dashboard

When clicking on the items from the Dashboard it is possible to move them around and place them wherever the user wants.

Editing objects on the dashboard

To edit configuration parameters for a Dashboard item, press on the configuration icon that can be found on the top right corner of the item to edit.

Once clicked on the icon, the settings menu will appear. Modify it and click Update to save the changes.

Deleting objects on the Dashboard

To delete the configured parameters for an item on the dashboard, click on the trashcan icon at the top right of the item you wish to delete.

Editing a Dashboard

Dashboard values that can be changed include name and group. In order to update an already existing dashboard, click Options.

Click Ok on the modified element to save the changes.

Deleting a Dashboard

In order to delete a created dashboard, go to the list of created dashboards and delete the desired one.

dash61.jpg

Slideshow mode

To activate the slideshow mode, or presentation, simply access this mode on the top right menu, from the dashboard section, and select the dashboards you want to include in the presentation.

dash4.jpg

The console will switch to slide mode, from where you may control, among other things, the rotation frequency.

dash5.jpg

Full screen mode

To access the full screen mode, click on the icon below.

dash25.jpg

This simple and intuitive screen and controls resemble those of the slide mode. It allows to set a refresh rate and switch to slideshow mode.

dash26.jpg

Share Dashboard

To share a dashboard, you just need to click the following button, copy the URL and share it with whomever you want.

Go back to Pandora FMS documentation index