Pandora: Documentation en: Data Presentation/Visualization
- 1 Typography and languages
- 2 Graphs
- 2.1 Interpreting graphs in Pandora FMS
- 2.2 Module graphs
- 2.3 Interface graphs
- 2.4 Custom graphs
- 2.4.1 Creating combined graphs
- 2.4.2 Adding elements to combined graphs
- 2.4.3 Seeing combined graphs
- 2.4.4 Deleting Stored Combined Graphs
- 2.4.5 Graph containers
- 2.5 Real-time Graphs
- 3 Views
- 4 The Mobile Console
1 Typography and languages
Pandora FMS includes a collection of fonts that can be used within graphics, maps and reports. Among the included fonts,smallfont.ttf is used by default, because it supports characters such as Latin, Arabic, hiragana, katakana and many others.
The fonts are located in the directory named '/include/fonts' in which you're able to paste new fonts if you need them.
The graphs show the data collected by Pandora FMS during a time threshold defined by the user. Pandora FMS graphs show data on request, being generated every time the operator requires one of them, showing the most recent data.
2.1 Interpreting graphs in Pandora FMS
The graphs in Pandora represent the values that a module has had over a period of time.
Due to the great amount of data that Pandora FMS stores, two different types of functionality are offered, the graphs normal and the graphs full scale or TIP.
2.1.1 Normal graphs
These are graphs that represent the information stored by the module at a basic level.
It allows us to see an approximation of the values in which our module oscillates.
They divide the module data into boxes in such a way that a sample of the module values is represented.
Not all values are painted, which is complemented by dividing the view into three graphs:
- Max (maximum values),
- min (minimum values)
- avg (average values)
- Advantages: They are generated very quickly, without consuming hardly any resources.
- Disadvantages: The information provided is approximate. The states of the monitors they represent are calculated based on events.
2.1.2 TIP Graphs
They represent real data.
It shows us a true representation of the data reported by our module.
As these are real data, it will not be necessary to supplement the information with extra graphs (avg, min, max).
The calculation of periods in unknown state is supported by events, such as normal graphs, but is complemented by extra detection in cases where events have been purged (by performance optimization, for example).
- Advantages: The data represented are all decompressed data from the database. It's the most realistic way to review module data.
- Disadvantages: Its processing is slower than in normal graphs. Depending on the time range and the volume of data to be displayed, your display may be less fluid.
After having seen how Pandora FMS interprets the graphs, we will go into detail the different types of graphs available depending on the origin of the data:
- Module graphs.
- Interface graphs.
- Custom graphs.
2.2 Module graphs
Module graphs represent the data reported by specific modules.
You can define in the visual configuration the interactive or static graphs. In the case of interactive graphs, by placing the mouse at some point on the backside of the graph, the specific data of that point will be shown.
Non-interactive graphics will generate a static image with which you cannot interact.
They have normal and TIP modes for painting.
In normal mode, it is possible to adjust the resolution of the graph to improve the display, as you can see in the following example image. The values between which the resolution can be configured are 1 (lowest) and 5 (highest).
Low resolution (1)
High resolution (5)
Pure Data TIP
Note: You can configure all aspects of the graphs in the menu Setup > Setup > Visual Style.
2.2.2 Where can module graphs be found?
Module graphs are son accesible through monitor detail, which can be reach by clicking on Monitoring > Views > Monitor detail.
You can also find them in the agent view (list of modules). To access these graphs you must choose an agent from Monitoring > Views > Agents Detail:
After filtering, click on the agent name, for example localhost.localdomain, to access the agent operation menu.
In this screen we have a list with all the agent modules. In the module table view, two icons appear under the legend "Graph", one will show the raw data (right) and the other a link to access the module graph (left).
If you click on the graphic icon, you will access a new window where you can customize the module data to be displayed.
The graphs have a configuration menu that allows (by hovering the mouse over the tab to the left of the graph window), reconfiguring the view of the current graph. In the legend you can see statistical data (Last value, Average, Maximum and Minimum) for each of the series shown.
To select an area of the graph that we want to represent, it will be enough by selecting this area with the mouse in the graph below, outcoming a zoom in the desired area.
The following parameters can be set in the quick graph configuration:
2.2.3 Display options
The field in which the graph's refresh time is defined.
If you select it, it's going to show the medium data without minimum and maximum only (This feature is not available for boolean modules).
By a calendar, it's possible to define the moment from which the data is going to be shown.
Time represented in hour, minutes and seconds format
You may enlarge or reduce the graph by this combo.
You may choose the graph's time frame by this combo.
If you click on it, it's going to show the module's events.
If you click on it, it's going to show the module's alerts.
Adds a graph that indicates the percentile line (configurable in general visual options of Pandora FMS).
Time Compare (Overlapped)
If you click on it, it's going to show a second overlapping graph along with the module's data within the previous interval, e.g. if the module represents one week, the previous week is also going to be shown.
Time Compare (Separated)
The same as the overlapped version but with separated graphs. For example, if we request a period of one week and activate this option, the week before the chosen one will also be shown.
Show Event Graph: If you click on it, it's going to show a bar graph along with received events within the graph's interval below it (Pandora FMS versions 5 and above only).
"Show Unknowns Chart."
It shows boxes in grey shading covering the periods in which Pandora FMS cannot guarantee the module's status, either due to data loss, disconnection of a software agent, etc.
Show Full Scale Graph (TIP).
Switches the painting mode from "normal" to "TIP". In this mode, the graphs will show real data rather than approximations, so the time it will take to generate them will be longer.
Once the values have been changed, click on "Reload" to apply them.
2.3 Interface graphs
Interface graphs are a specialized combined graphs that allow us to analyze the performance of a network interface.
They are automatically shown whenever the following modules exist in the agent:
Octets in and out may also appear as your HC alternatives (ifHCInOctects, ifHCOutOctects).
When the system detects the existence of these modules, it will automatically generate the interface analysis section and the following graphs:
Agent overview with network traffic data
Interface graph detail
These graphs also allow the quick selection of options, as in the module graphs, with the particularity that they insert the information from different sources (input and output bytes) in the same view and the variety of painting options is smaller.
2.4 Custom graphs
Custom graphs allow you to combine information from multiple modules into a single, variable size graph. In this way, information from various sources can be compared visually.
2.4.1 Creating combined graphs
To add a combined graph, go to Reporting > Custom graphs
And click on "Create graph".
Now we're going to describe the fields you're going to encounter there:
Name we want to assign to the graph.
Here you can add the graph to a specific group.
In this field you can write the information you need.
The field intended for the graph's 'width' value.
The field intended for the graph's 'height' value.
It's the combo by which you're able to define the temporary period used to create the graph.
By means of a combo the type of graph is marked choosing between Horizontal bars, Vertical bars, Bullet graph, Circular graph, Line, Stacked line, Meter, Area, and Stacked area.
Indicates whether the general upper and lower thresholds should be set for value comparisons in bullet charting.
Displays the 0 percentile of the data.
Add summation series
Displays the summation of all data.
Add average series
Displays the average of all data.
Modules and series
This field will only be active if you select to add summatory and/or average series. If checked, the graph will show the module data next to its summation and average. Otherwise, it will only show the summation and average.
Show TIP graphic.
The TIP painting system will be used to display real values of each data source selected in the element configuration.
When exporting graphics in CSV format, it is important to bear in mind the decimal separator configuration of the CSV file management program to be used. Pandora FMS uses a dot as a separator by default.
2.4.2 Adding elements to combined graphs
To add new modules, click on the Graph Editor button, you will be presented with a form where you can add new modules from any agent.
The "weight" option allows you to adjust the data in order to compare graphs of different magnitudes. This field multiplies the data by the defined weight.
For example, if we want to put in the same CPU graph with values between 0 and 100 and number of connections with values between 1000 and 10000, it is convenient to multiply the CPU by 10.
There is no limit on the number of elements that can be displayed, but from five onwards, the amount of information displayed makes it difficult to interpret, unless large graphics (800x600, etc.) are used.
Example of custom graph:
You can adjust certain displays within the view screen:
2.4.3 Seeing combined graphs
To see a combined graph, go to Reporting > Custom Graph where a list of all saved graphs appears. To see a graph, click on its name.
When accessing the graph, it will be painted with the most recent values for the selected time threshold.
From this page it is possible to modify certain display parameters such as time period, graph type and zoom (Graph definition, Zoom x1, Zoom x2 and Zoom x3).
The following is an example with the different types of graphics (the area type is in the image above). Area, Horizontal bars, Vertical bars, Bullet charts, Gauge, Pie, Line, Stacked line y Stacked area.
- Area Type
- Horizontal bars Type
- Vertical bars Type
- Bullet chart Type
Bear in mind, this type of chart is not compatible with negative values.
- Gauge Type
- Pie Type
- Line Type
- Stacked area Type
- Stacked line Type
2.4.4 Deleting Stored Combined Graphs
To delete a stored combined graph, please click on 'Reporting' and 'Custom Graph'. It's the location in which all stored graphs are listed. Please click on the trash icon on the graph's right side to delete it.
2.4.5 Graph containers
From Pandora FMS 7.0NG. 710 the concept of "Graph container" appears.
This concept allows:
- Defining as many containers as we want.
- Nesting containers.
- Creating simple module graphs.
- Referrencing to custom graps.
- Creating graphs using dynamic rules.
18.104.22.168 Creating a container
To create a Graph Container, access the container tab from the custom graphs homepage:
Click on "Create container"
Which will take you to the creation fomr:
In the creation form, you can fill in the following fields:
The name of the container
Owner group of the container.
Customized description of the container.
Where to store this container.
22.214.171.124 Adding graphs to the container
There are three options to add graphs to a container:
Simple module graph
Allows you to add a simple module graph, select the agent and module to be painted, as well as the time threshold.
You also have the following options:
Only average: Displays only the graph corresponding to the average of values (normal system).
Show TIP graph: Shows the module's real data.
Allows you to select an existing custom graph and add it to the list of graphs in the container.
Allows you to select the time threshold and whether or not you want real data.
Simple module graphs based on dynamic rules
Allows you to add several simple module graphs using selectors based on regular expressions.
Specify the regular expressions that agents and modules must meet to be added to the list of graphs to generate.
For example, if we have the agents called office1,office2,room1,room2 with the inOctects modules, and we would only like to represent the modules of the office agents, we would specify it as follows:
- agent: office.*
- module: inOctects
Automatically, the system would create 2 graphs, one for the office1 agent module inOctects, and another for the office2 agent inOctects module.
You also have the following options:
Only average: Displays only the graph corresponding to the average of values (normal system).
Show TIP graph: Shows the module's real data.
126.96.36.199 Listing and managing a container's graphs
At the bottom of the container's editing page, you will be able to see the list of graphs registered in this container, you can delete them by clicking on the trash can icon.
It is not possible to edit container graphics, you must create it again with the necessary modifications and then remove it.
188.8.131.52 Container view
By clicking on the container tab, you can access the list of containers and their graphs:
On this tab you will see nested those containers defined in this way.
To view the graphs stored in a container, click on the container title.
2.5 Real-time Graphs
There are two ways to display graphs in real time. On the one hand, we have a series of checks generated by Pandora FMS and others generated by SNMP modules.
First, let's talk about the graphs created by Pandora FMS. To do this we have to go to Monitoring > Views > Real-time graphs.
These graphs are based on the execution of commands from the console to the machine where it is hosted where the following checks can be performed:
- Pandora FMS Server Apache load: shows us in real time the load caused by the Apache service.
- Pandora FMS Server CPU: shows us in real time the load of the CPU where the Pandora FMS console we are working with is installed.
- Pandora FMS Server Disk IO wait: shows us in real time the input/output requests of the disk that are in queue.
- Pandora FMS Server load: shows us in real time the load caused by the server.
- Pandora FMS Server MySQL load: shows us in real time the load caused by the MySQL service.
- Pending packages from Pandora FMS Server: shows us in real time the amount of packages in queue that the Pandora FMS server has to manage.
- SNMP Interface throughput: Once introduced the SNMP data about the machine: IP, community and OID, it will show us in real time the data returned by the machine to which we are making the request. In this type of graphs only versions 1, 2 and 2c can be checked. In order to know the OID there is the SNMP walk tool with which we can observe in tree form the OID of the machine to which we point. To learn more about SNMP monitoring go to the following link.
Besides choosing the type of graph we want to use, we must select the update interval of the graph (which minimally affects the performance) and if we want to show the data incrementally or not. If you use the incremental, you will see a rate of the changes made in the results per second (in the case of interval to 1 second). It is important to emphasize that it is not possible to generate new graphs of the ones that come by default in Pandora FMS.
Secondly, we are going to talk about the graphs generated by SNMP modules, which, unlike the graphs described above, can also be made in version 3. These graphs can be observed in two places. Both in Monitoring > Views > Monitor Detail or within the view of an agent.
These graphs are the same as those generated in SNMP Interface throughput explained above, with the data we have passed to the module.
3.1 Tactical view
This section shows general information about the status of Pandora FMS. On the one hand, you can see a visual report with the status of the server, of the modules and the alerts, a count of created and fired alerts, a summary of modules by state, the total of agents and modules, as well as the performance of the server. On the other hand, the last generated events can be observed, as well as their statistics. Finally, we also find a list with the status of active servers.
3.2 Group view
This section shows a summary of the status of agents and modules divided by groups. On the one hand, it is possible to observe a percentage statistic of agent and module states. On the other hand, a matrix with the number of agents and modules by state and by group.
3.3 The Tree View
This section shows information about agents and modules in tree form. It is possible to choose through which classification this information can be observed. In all of them we will be able to filter by group, agent or module.
The clasification can be sorted byr:
- Groups (default view)
- Module groups
The information about and agent will be displayed by clicking on it.
At the same time, clicking on a module its graph or information will be able to be shown.
3.4 Agent Details
This section shows a list with the existing agents in Pandora FMS installation. The result of the list can be filtered by group, agent name, status or custom fields.
Inside the represented information we can see the agent status and the alerts it contains. The status of the agent will depend on the status of its modules or the status of the agent:
- Critical (red): At least one monitor is in critical condition.
- Warning (yellow): At least one monitor is in warning state.
- Normal (green): All your monitors are in normal state
- Not Started (blue): No associated data
- Unknown (grey): Agent down
The status of the alerts will depend on whether any alerts have been fired (orange), whether they have been disabled (grey) or no alerts have been fired (green).
From this view we will be able to accede to the edition or visualization of the agent that we want.
3.5 Monitor Details
This section shows a list with the existing monitors in Pandora FMS installation. You can filter the list result by group, monitor status, module group, module name, label, server type, data type and if they are enabled/disabled.
Inside the represented information we can see the agent to which it belongs, the data it houses and the state it has. The states of a module can be:
- Critical (red): The data received is within the threshold configured as critical.
- Warning (yellow): The data received is within the threshold configured as warning.
- Normal (green): The data received is outside the critical and warning thresholds.
- Not initiated (blue): No information received.
- Unknown (grey): Has received information at some time, but is currently not receiving information.
3.6 Tag view
This section shows a list of agents and modules that have tags. They can be filtered by group, monitor status, module group, module name, server type, agent custom field or labels.
3.7 Alert Details
This section shows a list of alerts created in Pandora FMS. They can be filtered by group, state, label, text, action and whether they are enabled or disabled. Besides the information of each alert, we can force its execution.
Additionally, we can validate an alert. With this, we will only change the state of the alert to "not fired" restoring this way the counter of the same ones, without having to wait for the configured threshold.
3.8 Agent/ Alert View
This section shows a list of agents that have alerts, with the type of alert they have. You can also show those agents that do not have any type of alert.They can be filtered by group and show those agents that don’t have any configured alert.
3.9 Agents / Modules View
By clicking on 'Monitoring' > 'Views' and 'Agent/Module View', a matrix containing modules, agents and the state of every single module is displayed.
In order to invoke the extensions, please click on 'Operation' -> 'Extensions' and the 'Agents/Modules' view.
If we tick the recursion token, we can list the agent / module content taking into account the secondary groups and subgroups of the agents.
3.10 Module Groups View
This section allows to have a precise overview in a module table by its state, regarding the module's group and the module itself. In order to access the extensions, please click on 'Monitoring' > 'Views' and 'Module Groups'.
As you can see on the image above, there is a matrix containing the module's number, assorted by agent group along with different colors, depending on whether there are modules in 'critical', 'warning' or 'OK' states or not.
4 The Mobile Console
Pandora FMS comes with a new mobile console. This console a reduced version of the default console and allows any user with a mobile device with at least 600x280 pixels of screen resolution to browse all information provided by Pandora FMS like agents, monitor view, alerts, agent detail (graphs included), group view and last events.
The mobile interface is located at '/mobile' [url], so if your regular console is located at 'http://firefly.artica.es/pandora_demo/' your mobile console is located at 'http://firefly.artica.es/pandora_demo/mobile'.
This URL is compatible to any device which is able to access native websites. It has been thoroughly tested with iPhone and android-based cellphones and tablets and adapts automatically to the width of your device's screen.
The login screen within the mobile web interface.
The tactical view of the mobile web interface.
The detailed event view.
The detailed module graph.
The general options menu.
The agent's detailed view.
The module's detailed view.