Customizable Console: Dashboard

Go back to Pandora FMS documentation index

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.

The building blocks of the dashboards are called graphical widgets ( or simply widgets ) that are classified according to the version used, either Open or Enterprise.

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.

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.

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

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.

Independently of the Favourite field in the general settings of a dashboard, it can also be added to the favorites system by clicking on the star button next to the name. To remove it from the favorites system, click it again and uncheck it.

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

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.

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.

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.

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:

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 Ok and a window like the following should appear:

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

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.

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.

This widget shows 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:

In the configuration window you may configure the group to be displayed (from version 764 onwards you have the Group recursion option to recursively display the subgroups of the selected group):

Once configured 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.

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 so. The settings options are:

• Type tree: Tree view grouped by tags, (policies), etc.
• Groups: Desired group/s whose information will be shown.
• Open all groups: If checked, the tree view will have all branches expanded as selected (Groups, Module groups, OS, Policies or Tags).
• Agents status: Filter by agent status (in version 771 or later you can also filter by triggered alert).
• Filter Agents: Filter by agent name.
• Modules status: Filter by module status (in version 771 or later you can also filter by triggered alert).
• Filter modules: Filter modules by name.

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

• In node you may filter both by Agents status and Module status with the condition Not normal which includes the Warning and Critical statuses at the same time.
• In Command Center (Metaconsole) you may only filter by Not normal in Agents status.

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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:

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.
• Enable sunburst: Allows you to enable a view that diverges from a central point.

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

In case you have configured sunburst you will see something similar to the following:

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:

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:

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.
• Group recursion: Allows you to display the subgroups of the selected groups.

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

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:

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:

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.

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:

This widget shows the stats of a selected WUX transaction:

Widget setup window:

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

This widget allows to display the services registered in the PFMS server.

Fast and orderly reporting by operating systems used by registered agents.

It has no configuration and depending on the group the user belongs to, they will be able to see a variable number of agents. At the same time, a summary of the status of these agents is shown: number of Normal agents, Critical agents and Unknown agents.

Color tabs modules allow multiple agent and module selection. It displays the selected modules in the form of tabs or tabs in which the content will be the alias of the agent data and unit.

To configure it, choose in the text box ·Agents the agents to be displayed (or select all of them in the corresponding selector ♦All).

Once you have selected the agent(s), select the type of module selection (·Type), either all modules (·Show all modules) or only the modules that the selected agents share in common. Then the modules (·Modules) will appear and you will be able to add them all with the respective All selector and delete them in their corresponding close button for each module. You will be able to format the data (·Format Data) and in Label select whether to show agent name, module or agent and module.

Block histogram allows multiple agent and module selection. It shows the selected modules in the form of blocks identified with the agent name and/or module name. To configure it, choose in the text box ·Agents the agents to be displayed (or select all of them in the corresponding selector ♦All). Once you have selected the agent(s), select the type of module selection (·Type), either all modules (·Show all modules) or only the modules that the selected agents share in common. Then the modules (·Modules) will appear and you will be able to add all of them with the corresponding All selector and delete them in their corresponding close button for each module. You will be able to format the data (·Format Data) and in Label select the name of the agent, module or agent and module to be shown.

The Grouped meter graphs widget displays, according to their size, a series of squares representing their threshold: the larger the space, the higher the number of squares. It is also possible to choose a custom threshold for graphical representation only.

It shares common features with other widgets such as title, group, background color, and so on:

• Format data: Formatting of the result, e.g. 1000 → 1K.
• Values: It cuts values at the top and at the bottom.
• Manual thresholds: By default it takes the values dynamically, those assigned to the modules themselves, but you may also add a specific threshold for all modules.
• Modules: It allows you to select the modules of the selected agents.

Once configured, you may obtain, for example:

Displays the information of the requested modules in an uncompressed form taking into account the value of the requested interval.

Configuration:

• Title.
• Background.
• Format data: If the data returned by the module is to be formatted, value: active by default.
• Periodicity: The period to display, default value: one day.
• Interval: The interval, default value 5 minutes.
• Limit: Number of rows to display in the table.
• Label: Label to show agent only, module only or both.
• Type: Show all modules or, if two or more modules have been selected, show the modules in common.
• Modules: Agent and module selector.
• All: Button for quick selection of all modules.

The Event cardboard widget presents a count of events grouped by criticality, over a period of time and by selected agent groups.

• Event type: It allows you to choose only one type of event, e.g. agent created, alert triggered, etc.
• Max. hours old : By default the events created in the last 8 hours.
• Event status : It allows filtering by event status (All, Pending only or Validated only).
• Severity: Select events by criticality, e.g. Informative, Maintenance, etc.

It allows displaying the average, maximum or minimum value (AVG, MAX, MIN) of a module or the sum (SUM) of an incremental module, with or without its unit of measurement (Unit) and descriptive label over a period of time (by default the last 30 days).

• Type: Average, sum, maximum or minimum value of a module.
• Time period: By default the last 30 days; the last month, the last 7 days, the current week, the last 24 hours or the current day are also available.
• Agent and Module: To choose the Agent and its module to display.
• Unit: If the module has a unit of measurement assigned to it (MB, sessions, bytes/sec, etc.), it will show said unit.

The Modules by status widget allows you to display modules by status (critical status by default) grouped by page (five by default). They are ordered by their last status change (Last status change), the most recent first, for example:

It presents the following configuration options:

• Free search: It allows you to select modules by keyword.

• Status: To select one or more states, the Critical state is selected by default.
• Limit: Results per page, five by default.

In the case of the Command Center (Metaconsole), at least one node must be selected:

Example with all nodes selected and all states selected:

The Basic chart widget allows to visually represent an agent module, changing color according to the status, with the option of displaying the value and choosing a specific time period.

• Agent and Module: Agent and module selectors accordingly. Mandatory options, write at least two characters to show the list of available resources.
• Interval: Time period to display, by default 1 day. You may also set a custom interval by clicking on the pencil icon.
• Color chart: Chart color. By default it takes the one you have in the visual configuration of the charts in position 1.
• Label: Show name of the agent, module or agent and module (module by default).
• Show label: Show or not the label, it does by default.
• Show value: Show or not the current data, it does by default.
• Format: To format the value, formatted by default.
• Color value: Color of the value font, black by default.

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

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.

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.

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.

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

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.

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

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

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.

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