Dashboard

The Dashboard is a Pandora FMS functionality that allows each user to build their own monitoring page. More than one page can be added, and monitoring maps, graphs and status summaries, among other elements, can be added.

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.

To configure or view a dashboard, access the section Operation → Reporting → Dashboard → Dashboard → Dashboard list. When entering this section, a list will appear with the dashboards to which 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 Operation → Reporting → Dashboard → Dashboard list → New dashboard.

By default the Dashboard will have only one cell and you should indicate if it will be private (only the user that has created it and the Pandora FMS administrator will be able to see it) or visible to a group. You will only be able to assign a group to which the user that is creating the dashboard belongs to, unless this user explicitly belongs to the group ALL .

The Date range button is disabled by default and enabling it allows you to add a date range or a standard time period by clicking on the List icon (last 24 hours, this week, etc.) for the widgets you add to the Dashboard: Basic chart, Block Histogram, Data matrix, Custom graph, Graph module histogram, NetFlow, Security Hardening, Agent module graph (Single graph), SLA percent and Top N. Although each widget displays its own date range value, it will actually use the one set in the Dashboard configuration.

If you have checked the Favourite option, a shortcut to the newly created Dashboard will be added to the menu when the page is reloaded.

Para editar el Dashboard haga clic en el botón de edición situado a la derecha de la fila de iconos, luego para agregar celdas haga clic en el icono de círculo con +.

Click on Add widget, a new window will be displayed with all the types of objects that can be added. Using the buttons at the top left you can navigate between the different pages and see all the available widgets.

You can modify the Dashboard again (name, private, users, favorite): click on the icon next to the add cells button. You can also select other dashboards from the drop-down list right next to it and repeat the procedures for modifying and adding widgets.

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.

The Agent/Module View widget is used to display a list of selected agents and their modules.:

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: List of modules generated from what you have selected in agents and modules according to the previous point.

The Triggered alerts report widget is used to display a report of triggered alerts:

The important field to configure is the group from which to obtain the triggered alerts and the recursive option to search also in subgroups of the selected group.

This Clock widget displays a clock with the time set in the Console.

Choose in Clock type analog or digital clock. The other options are common to the previous widgets.

To add a user-defined graph click on Defined custom graph:

• 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.
• If the Date Range button is enabled in the Dashboard configuration, although it displays its own interval it will actually use the time period set in Date range.

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

• 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, not validated or all.
• Tags: Tags that will be shown in events.

The Module histogram widget is used to display a graph of the module status history.

• 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.
• If the Date Range button is enabled in the Dashboard configuration, although it displays its own interval it will actually use the time period set in Date range.

To display the graph of the most important list of events by module according to the group, the Top N events by module widget is used:

• Amount to show: Amount of event types.
• Max. hours old: Time (in hours) where the existing events to show will be taken into account.

This General group status widget shows a status of the Pandora FMS group of your choice, indicating the total number of Agents and Modules in that group, as well as a count organized by their status.

In the configuration window you can configure the group to be displayed. If the All group is selected all the groups will be shown, if a group is selected the Group recursion option is available to recursively show the subgroups of the selected group. Once the widget is created you can access the corresponding group by clicking on its name.

To display the tree view (Tree view widget):

The default tree view will be displayed without the need to modify configuration options. If configured:

• Type tree: Tree view grouped by tags, (policies), etc.
• 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).
• Modules status: Filter by module status (in version 771 or later you can also filter by triggered alert).
• 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.

Choose a map from those that have been created and wait a few moments. Adjust the size to fit the screen size where the visual map will be displayed.

The General visual maps report widget allows you to select one or more Visual Consoles.

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.

The Icon and module value widget is available to display the module value and an icon:

• Agent: Agent used to obtain the module list of the selected one.
• Module: Module used to obtain the data to be shown.

The Module status widget is used to display the module value:

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

To add the content of a URL in Pandora FMS you must add the URL content widget.

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

Widget Module in a table:

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.
• Data separator: Separator to generate different lines. Possible options are: carriage return, vertical bar, semi-colon, colon, comma, space.

To simply display the module value use the Module value widget:

Widget Global health info:

This widget has no major configuration, just adjust its location, size and color according to the Dashboard composition.

Network map:

• Map: Choose one of the registered maps from the list (menu Operation → Topology maps → Network map).
• Zoom level: Focus level on the Network Map.

To simply add a text or note to the Dashboard use the Panel with a message widget:

To add registered user reports (Custom report) in Pandora FMS :

Report: Escoja el informe, el cual debe estar creado previamente, y que contendrá el widget. Pulse Update.

To display a Service Map use the Service map widget:

• Service: Service to be shows. It must have been previously created in the service section.
• Enable sunburst: Allows you to enable a view that diverges from a central point.

Widget Agent module graph:

• Agent: Combo where the agent is chosen.
• Module: Combo where the agent module selected in the previous point is chosen.
• Periodicity: Combo where the graph time period is set. If the Date Range button is enabled in the Dashboard configuration, although it displays its own interval it will actually use the time period set in Date range.
• Sliced mode: It displays the information grouped by time (1 hour by default), with the option of displaying the maximum, minimum, average and sum (Maximum, Minimum, Average, Summation) in Area, Line or Verticals bars mode. To use this mode, activate the Sliced mode button and save the widget. Once the information has been refreshed, it can be edited again and the corresponding options can be chosen as needed.

Widget SLA percentage:

• 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.
• If the Date Range button is enabled in the Dashboard configuration, although it displays its own interval it will actually use the time period set in Date range.

The Groups status widget displays a table with the statuses of the selected groups.

To add a report with the status of Pandora FMS monitors, insert the Tactical view widget:

You can add one or more groups to the selection and to obtain a display at least one of the following parameters must be chosen:

• Status and Monitor Checks.
• Server Performance.
• Summary.

Widget Top N events by agent:

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

Widget Top N of agent modules:

• 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.
• If the Date Range button is enabled in the Dashboard configuration, although it displays its own interval it will actually use the time period set in Date range.

Widget Agent WUX transaction shows a selected WUX transaction:

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

The WUX transaction stats widget displays statistics of selected WUX transactions:

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

Widget Services view allows to display the services registered in the PFMS server.

It can be configured in tree mode (default) and in table mode.

OS Quick Report sorted by operating systems (OS Quick Report) 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.

The Color tabs module allows multiple selection of agents and modules. It displays the selected modules in the form of tabs or tabs in which the content will be 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 both.

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.

If the Date Range button is enabled in the Dashboard configuration, although it displays its own interval it will actually use the time period set in Date range.

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.

Widget Data Matrix displays the information of the requested modules in an uncompressed form taking into account the value of the requested interval.

• Format data: If the data returned by the module is to be formatted, value: active by default.
• Limit: Number of rows to display in the table.
• 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.
• If the Date Range button is enabled in the Dashboard configuration, although it displays its own interval it will actually use the time period set in Date range.

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

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

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.

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

The Heatmap widget dynamically displays the module status on a clickable map and provides more information in a pop-up window.

It allows grouping (Type field) by agent groups, modules by module group, modules by tag and module by agent. In the Search text field you can add a search string to limit the results.

The Group status map widget allows you to display the number of groups on a map with their corresponding states in each color. It allows adding links to the boxes and clicking on them zooms in, then creates a button to remove that zoom and return to the previous box in hierarchy. It also allows to choose specific agent groups and use recursion if you have subgroups in the chosen group.

The security hardening widget is only available in the Enterprise version and with the corresponding plugin installed and running.

Common fields

• Title: It allows to place a title, by default Security Hardening.
• Background: It allows to choose a background color.
• Group: It allows to filter the data by agent group (All by default, all groups).
• Date: Only for Data type with Evolution and Scoring by date, it allows to choose a period of time (last 7 days, last month, etc.). To choose these periods, click List, where you may even set a custom time period. When saved and edited again, the widget will show again the start date and end date interface with the values set to the selected period. The None value is not valid for the configuration.

• Data type: It allows to choose the following options:

List of agents with worst score.

With Top-N agents with the worst score, the last scores of the ten agents are displayed (default) and sorted from worst to best score.

List of most frequent failed controls.

In Top-N most frequent failed checks, the last data of all agents and by type of check are grouped and the checks with the highest number of failures among all agents are shown. The number of checks to show, by default, is 10.

List of failed checks by category.

With Top-N checks failed by category, the latest data of all agents (or the selected group) are grouped by categories and the categories with the highest number of failures among all agents are listed.

The number of total categories to be listed is 10 (default value).

Vulnerabilities by category

In Vulnerabilities by category, a category is chosen and failed and passed checks (optionally skipped ones with the token Ignore skipped) of all agents in the selected group will be grouped.

Available categories:

• Access Control Management (selected by default).
• Account Management.
• Application Software Security.
• Audit Log Management.
• Continuous Vulnerability Management.
• Data Protection.
• Data Recovery.
• Email and Web Browser Protections.
• Inventory and Control of Enterprise Assets.
• Inventory and Control of Software Assets.
• Issue Response Management.
• Malware Defenses.
• Network Infrastructure Management.
• Network Monitoring and Defense.
• Secure Configuration of Enterprise Assets and Software.
• Security Awareness and Skills Training.
• Service Provider Management.

Scoring by date.

With Scoring by date, the last scores of the agents of the selected group (or all, All) within the selected time range are displayed.

It always takes the last score of each agent within the time range, i.e. if a range of one month is placed, the last score of the agents within that month will be searched.

Evolution

In Evolution, a global evolution of Security hardening is shown by averaging the tests that have passed and those that have failed, grouped by day, of all the agents or those within the selected group with the last eleven dates to avoid overflowing the graph. In Metaconsole, the average of all the agents of all the nodes is made, they are not separated.

The widget NetFlow allows you to view the data collected by the probes used to collect agent control data.

• To use it you must choose a filter and then a period of time (maximum one week).
• If the Date Range button is activated in theDashboard configuration, although it displays its own interval it will actually use the time period set in Date range.

The possible ways of visualization are as follows:

• Area graph: They show over time (from the source date to the target date), the evolution of the data. The level of precision of the graph must be chosen in the “Resolution” token.
• Circular mesh: Displays an interactive pie chart representing IP connection pairs and traffic volume.
• Data table: Displays a data table with each IP and a number of rows depending on the chosen resolution.
• Detailed host trafic: Displays a map of portions representing traffic by IP.
• Summary: It shows a summary table, a pie and a table with the data of the whole period.
• Top-N connections: A table showing the TOP-N connections between Source IP - Destination IP pairs, based on the traffic between those IP addresses (the sum of the percentages of the N elements of the table not necessarily will be one hundred because there may be other pairs of connections src/dst).

The widget allows you to display the agents belonging to one or more groups (except the All group).

It displays details such as last connection, IP address, operating system icon used (if applicable), among other details.

The widget Inventory allows filtering by agent, group and free search (Free search) for a module and available inventory date (by default Last). For each widget you can choose all defined inventory modules or only one in particular. Results can be sorted by agent name.

The GIS map widget allows you to choose from a list of registered maps. When clicking on an agent that appears in those maps, it displays detailed information about each one.

Once the communication between both systems has been configured, you can have a view of the incidents created and shared, with important information such as priority, owner, last update (among other fields, up to a maximum of nine) of the tickets created and still open.

You can limit the number of items per page (20 by default) and use a previously saved Custom search (Operation → ITSM → Dashboard → Tickets → List → Filter menu).

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.

The values of a Dashboard that can be edited are: name, group and number of cells. To modify a Dashboard already created, click on the Options icon. Click on Ok of the item you have modified to save the changes.

To delete a Dashboard already created, go to the list of Dashboards and delete the desired Dashboard in its corresponding trash can icon (Delete column).

To activate the slideshow mode, go to the top right menu, from the Dashboards section, and select the Dashboards to be displayed in the presentation. The Console will change to slide mode, from where you can control the rotation frequency, among other options.

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 only need to click on the following icon, copy the URL and send it to the recipients.

Go back to Pandora FMS documentation index