Pandora: Documentation en: Data Presentation/Visualization

From Pandora FMS Wiki
Jump to: navigation, search

Go back to Pandora FMS documentation index

1 Graphs

Graphs show data collected by Pandora FMS during a time threshold defined by the user. Pandora FMS graphs show data on request, and they are generated every time the operator requires one of them, showing the most recent data.

Info.png

Pandora FMS simplifies monitoring management through user permissions. There are several permission systems that restrict what a user can see or manage, the most important is the concept of groups (either predefined groups by Pandora FMS and/or customized groups) combined with the profile of each user. Pay special attention to the notes about the "All group" (ALL) throughout the documentation.

 


1.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 features are offered, the normal graphs and the full scale graphs or TIP.

1.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 value range of the module.

They divide the module data into boxes in such a way that a sample of the module values is represented.

Not all values are represented, 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 hardly consuming any resources. Disadvantages: The information provided is approximate. The states of the monitors they represent are calculated based on events.

Graphs normal.png

1.1.2 TIP Graphs

General features

These graphs represent real data.

It shows us a true representation of the data reported by the module.

As these are real data, it will not be necessary to add extra graphs to the information (avg, min, max).

Calculating periods in unknown state is supported by events, such as normal graphs, but is complemented by extra detection for cases where events have been purged (by performance optimization, for example).

  • Advantages: The data represented are all decompressed data from the database. It is the most realistic way to review module data.
  • Disadvantages: Its processing is slower than that of normal graphs. Depending on the time range and the volume of data to be displayed, your display may be less fluid.

Graphs tip.png

1.2 Module graphs

1.2.1 Introduction

Module graphs represent data reported by specific modules.

They may be interactive or static graphs (by placing the mouse at some point on the backside of the graph, the specific data of that point will be shown).

In normal mode, it is possible to adjust the resolution of the graph to improve the display. The values between which the resolution can be configured are 1 (lowest) and 5 (highest).

Low resolution (value 1)
High resolution (value 5)

TIP mode:

Datos puros TIP

Info.png

You may configure all aspects of the graphs in the menu Setup > Setup > Visual Style.

 


Setup Visual styles Chart fit to content.png

Info.png

There are graphs whose values are percentage values and the top of the graph exceeds the maximum value of one hundred, you can configure the graphs to stop adding a proportional top margin: just activate the option Chart fit to content.

 


1.2.2 Where can module graphs be found?

Module graphs are accessible through monitor detail, which can be reached by clicking on Monitoring > Views > Monitor detail. Select the parameters to filter or leave those by default and click Show.

Monitor detail.png

You may also find them in the agent view (module list). To access these graphs, choose an agent from Monitoring > Views > Agents Detail:

Pre1.png

To see the agent's operation menu, click on the agent's name, for example localhost.localdomain.

Pre2.png

This image shows a list with all agent modules. In the module table view, two icons appear under the legend Graph, one will show the raw data (right) and the other one a link to access the module graph (left).

Pre3.png

To customize the module data to be displayed, click on the graph icon and then Graph configuration menu.

Quick graph.png

Enabling Show AVG/MAX/MIN data series in graph will show the map key with the statistical data (Last value, Average, Maximum and Minimum) for each of the series shown.

Pre4.png

To select an area of ​​the graph that you want to represent, select that area with the mouse in the graph below, zooming in the desired area.You may use the right icon Overview Graph to have both graphs at the same time and click Cancel zoom to reset.

1.2.3 Display options

Info.png

Always keep in mind that the date and time of the computer where you are running the web browser to access the Console is the one that provides the date and time for the corresponding parameters.

 


Refresh Time

The field where the graph's refresh time is defined.

Avg. Only

If you select it, it will show the average data graph.

Begin Date

Date until which the graph will be drawn.

Begin Time

Time until which the graph will be drawn (hour, minutes, seconds).

Zoom Factor

Graph visor size, multipliable.

Time Range

Time range when data will be collected.

Show Events

It shows indicator points with event information at the top.

Show Alerts

It shows indicator points with triggered alert information at the top.

"Show percentile"

It adds a graph that indicates the percentile line (configurable in Pandora FMS general visual options).

Time Compare (Overlapped)

It shows the same graph overlapped but in the previous interval to the selected one. For instance, if you request a period of one week and activate this option, the week prior to the chosen one will also be shown overlapped.

Time Compare (Separated)

It shows the same graph as the overlapped version but in a separated graph. For example, if you request a period of one week and activate this option, the week before the chosen one will also be displayed.

Show Unknowns Chart

It shows boxes in grey shading covering the periods where Pandora FMS cannot guarantee the module's status, either due to data loss, software agent shutdown, etc.

Show Full Scale Graph (TIP).

It switches the drawing mode from "normal" to "TIP". That way, 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 Reload to apply them.

1.3 Interface graphs

Interface graphs are specialized combined graphs that allow 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

Input and output octets 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 enable quick option selection, as in module graphs, with the particularity that they add to same view information from different sources (input and output octets) and the variety of drawing options is smaller.

1.4 Custom graphs

Custom graphs allow to combine information from multiple modules into a single, size-variable graph. That way, information from several sources can be compared visually.

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

These are the fields that can be found:

Group

Here the graph can be added to a specific group. Users can only assign a group the user creating the combined graph belongs to, unless that user explicitly belongs to the ALL group.

Periodicity
Define in the combo list the temporal period used to create the graph.
Type of graph
Choose between, horizontal bars, vertical bars, bullet graph, circle graph, line graph, stacked line, gauge, area and stacked area.
Equalize maximum thresholds
It indicates whether the general maximum and minimum thresholds should be set for value comparisons in bullet charts.
Percentile
It displays data percentile (customizable value in Pandora fMS console visual options).
Add summation series
It displays the sum of all data.
Add average series
It displays the average of all data.
Show TIP graphic
The TIP drawing 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.

 


1.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 to adjust the data in order to compare graphs of different magnitudes. This field multiplies the data by the defined weight.

For example, if you 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 to 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

1.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 made up by 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).

Example with the different types of graphics:

  • 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

1.4.4 Deleting stored combined graphs

To delete a stored combined graph, click on Reporting > Custom Graph. It is where all stored graphs are listed. Click on the trash icon on the graph's right side to delete it.

Cg list2.png

1.4.5 Graph containers

Info.png

Version NG 710 or higher.

 


The Graph container allows:

  • Defining as many containers as desired.
  • Nesting containers.
  • Creating simple module graphs.
  • Referencing custom graps.
  • Creating graphs using dynamic rules.
1.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

Set the fields:

Cg container3.png


Group
Owner group of the container. Even if the user who is creating the container does not explicitly belong to the ALL group, he/she can still assign the ALL group as the owner group of the container.
Parent container
Where to store the container.
1.4.5.2 Adding graphs to the container

There are three options to add graphs to a container:

Simple module graph

Cg container add1 new.png

Select the agent and module to be drawn, as well as the time threshold, in addition to the following options:

  • Type of graph: Area or line graph.
  • Show TIP graph: It shows the module's real data.


Custom graph

Cg container add2.png

Similar to the previous graph, it allows to select an existing custom graph.

Simple module graphs based on dynamic rules

Cg container add3 new.png

It 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 you have the agents called office1, office2, room1 and room2 with the inOctects modules, and you would only like to represent the modules of the office agents, you should specify it as follows:

  • agent: office.*
  • module: inOctects

The system would automatically create 2 graphs, one for the office1 agent inOctects module, and another for the office2 agent inOctects module.

1.4.5.3 Listing and managing container graphs

At the bottom of the container's editing page, you may see the list of graphs registered in this container. You can delete them by clicking on the trash can icon.

Cg container edit list.png

Info.png

It is not possible to edit container graphics, you must create it again with the required modifications and then remove it.

 


1.4.5.4 Container view

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

Cg container list.png

To see the graphs stored in a container, click on the container title. On this tab you will see nested those containers defined like that.

1.5 Real-time Graphs

There are two ways to display graphs in real time. On the one hand, there is a series of checks generated by Pandora FMS and others generated by SNMP modules. You may find more inofrmation in our video tutorial "[PFMS Reviews] Real-time graphs".

The first to be discussed is graphs created by Pandora FMS. Therefore, go to Monitoring > Views > Real-time graphs.

Click to zoom in
Pandora FMS Server Apache load
It shows in real time the load by the Apache service.
Pandora FMS Server CPU
It shows in real time the CPU load where the Pandora FMS console you are working with is installed.
Pandora FMS Server Disk IO wait
It shows in real time the input/output disk requests that are queueing.
Pandora FMS Server load
It shows in real time the load caused by the server.
Pandora FMS Server MySQL load
It shows in real time the load caused by the MySQL service.
Pending packages from Pandora FMS Server
It shows in real time the amount of queued packets that the Pandora FMS server has yet to manage.
SNMP Interface throughput
Once SNMP data about the machine are entered: IP, community and OID, it will show in real time the data returned by the machine to which you 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 you can see in tree form the OID of the machine to which you 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 to use, select the graphic update interval (which minimally affects the performance) and if you wish 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 (if the interval is 1 second). It is important to emphasize that it is not possible to generate new graphs apart from those that come by default in Pandora FMS.

Another graph type is SNMP version 3 available both in in Monitoring > Views > Monitor Detail as well as within the view the agent view.

Grafica realtime monitor detail.png

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


Go back to Pandora FMS documentation index