Pandora: Documentation en: Data Presentation/Visualization

From Pandora FMS Wiki
Jump to: navigation, search

Go back to Pandora FMS documentation index

Template wip.png

We are working on the translation of the Pandora FMS documentation. Sorry for any inconvenience.

 


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.

2 Graphs

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

General features

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.

Graphs normal.png

2.1.2 TIP Graphs

General features

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.

Graphs tip.png

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

2.2.1 Introduction

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

Comparativa resolucion graficas2.jpg

Low resolution (1)


Comparativa resolucion graficas.jpg

High resolution (5)

Comparativa resolucion graficas3.jpg

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.

Monitor detail.png

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:

Pre1.png

After filtering, click on the agent name, for example localhost.localdomain, to access the agent operation menu.

Pre2.png

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

Pre3.png

If you click on the graphic icon, you will access a new window where you can customize the module data to be displayed.

Quick graph.png

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.

Pre4.png

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

Refresh Time

The field in which the graph's refresh time is defined.

Avg. Only

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

Begin Date

By a calendar, it's possible to define the moment from which the data is going to be shown.

Begin Time

Time represented in hour, minutes and seconds format

Zoom Factor

You may enlarge or reduce the graph by this combo.

Time Range

You may choose the graph's time frame by this combo.

Show Events

If you click on it, it's going to show the module's events.

Show Alerts

If you click on it, it's going to show the module's alerts.

"Show percentile"

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:

  • interface_ifOperStatus
  • interface_ifInOctets
  • interface_ifOutOctets

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:

Interface charts1.png

Agent overview with network traffic data

Interface charts2.png

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

Cg menu.png

And click on "Create graph".

Graph builder.png

Now we're going to describe the fields you're going to encounter there:

Name

Name we want to assign to the graph.

Group

Here you can add the graph to a specific group.

Description

In this field you can write the information you need.

Width

The field intended for the graph's 'width' value.

Height

The field intended for the graph's 'height' value.

Period

It's the combo by which you're able to define the temporary period used to create the graph.

Graphic Type

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.

Equalize thresholds

Indicates whether the general upper and lower thresholds should be set for value comparisons in bullet charting.

Percentile

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.

Template warning.png

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.

Pre8.png

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:

Pre7.png

You can adjust certain displays within the view screen:

Cg view.png

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.

Pre12.png

When accessing the graph, it will be painted with the most recent values for the selected time threshold.

Pre13.png

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

Area.png

  • Horizontal bars Type

Horbars.png

  • Vertical bars Type

Vertbars.png

  • Bullet chart Type

Bear in mind, this type of chart is not compatible with negative values.

Bullchart.png

  • Gauge Type

Gauge.png

  • Pie Type

Pie.png

  • Line Type

Pre14.png

  • Stacked area Type

Pre15.png

  • Stacked line Type

Pre16.png

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.

Cg list2.png

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.
2.4.5.1 Creating a container

To create a Graph Container, access the container tab from the custom graphs homepage:

Cg container.png

Click on "Create container"

Cg container2.png

Which will take you to the creation fomr:

Cg container3.png

In the creation form, you can fill in the following fields:

Name

The name of the container

Group

Owner group of the container.

Description

Customized description of the container.

Parent container

Where to store this container.

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

Cg container add1 new.png

Custom graph

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.

Cg container add2.png

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.

Cg container add3 new.png
2.4.5.3 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.

Cg container edit list.png
2.4.5.4 Container view

By clicking on the container tab, you can access the list of containers and their graphs:

Cg container list.png

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.

Grafica realtime.png

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.

Grafica realtime snmpwalk.png

Grafica realtime snmpwalk OID.png

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.

Grafica realtime monitor detail.png

These graphs are the same as those generated in SNMP Interface throughput explained above, with the data we have passed to the module.

3 Views

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.

Vista tactica nueva.png

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.

Vista grupos nueva.png

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)
  • Tags
  • OS
  • Module groups
  • Module
  • Policies

Tree nueva.png

The information about and agent will be displayed by clicking on it.

Tree agent.png

At the same time, clicking on a module its graph or information will be able to be shown.

Tree module.png

Tree module2.png

Tree module3.png

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.

Vista detallesagentes nueva.png

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.

Vista detallesmonitores nueva.png

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.

Vista etiquetas nueva.png

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.

Vista detallesalertas nueva.png

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.

Agente-alerta.png

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.

Ex4c new.png

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

Ex4.png

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.

Mobile1.png

The login screen within the mobile web interface.

Mobile2.png

The tactical view of the mobile web interface.

Mobile3.png

The detailed event view.

Mobile4.png

The detailed module graph.

Mobile5.png

The general options menu.

Mobile6.png

The agent's detailed view.

Mobile7.png

The module's detailed view.

Go back to Pandora FMS documentation index