Pandora: Documentation en: Data Presentation/Visualization

From Pandora FMS Wiki
Jump to: navigation, search

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.


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.



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



Agente-alerta.png



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

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

6 The Tree View

The tree view allows to visualize the agent's monitors in a tree-shaped structure. Please click on 'Monitoring' -> 'Views' and 'Tree View' to invoke it.

Tree nueva.png

It is possible to choose the classification of the view:

  • Módules
  • Policies
  • Module group
  • Group
  • Operating system

They're assorted by group by default. Within this level, the number of agents in 'ok' (green), 'critical' (red), 'warning' (yellow) and 'unknown' (gray) states is displayed.

They can be filtered by the module's states ('normal', 'critical', 'warning' or 'unknown'). A search by agent's name is also supported here.

Clicking on the name of the agent, it will apear a pop-up with information about it: name, address, time of last update, operating system, event and access graph.

Tree agent.png


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