Pandora: Documentation en: Interface

From Pandora FMS Wiki
Revision as of 07:59, 29 May 2017 by Tatiana (talk | contribs)
Jump to: navigation, search

Go back to Pandora FMS documentation index

1 The Pandora FMS Interface

1.1 Introduction

In this section, we're going to show you the basic menus of the Pandora FMS Interface along with all icons and features required to start learning how to use Pandora FMS.

1.2 Pandora FMS Start Session Screen

On the image below, you see the default Pandora FMS start session screen:


At the bottom of the screen, is the version of Pandora FMS you're currently using.

There are text entry boxes in the center to enter the user's name and password with the session start button (login).

Introduce credentials to start. The defaults are:

  • User: admin
  • Password: pandora

The console displays the default Pandora FMS main welcome page. Pandora FMS start session screens can be customized. This will be explained in the Custom welcome screen section.

1.3 Pandora FMS Main Page

The Pandora FMS main page shows basic information about the system status and the number of checks.

The Pandora FMS main screen is shown here:


The static elements which do not change in different screens of the interface are:

  • Operation Menu
  • Administration Menu
  • Defined Links
  • Headers

The dynamic elements which do change in different screens are:

  • Header information
  • User information, pending messages, system notifications, etc. (this will be explained in the subsection header below).
  • Site news
  • Last activity of the Web Console
  • General basic information
  • Checking main view in Pandora FMS

1.3.1 Pandora FMS Customized Page

The Pandora FMS main page can be personalized under 'Operation' -> 'Workspace' and 'Edit my user'.

Home screen.jpg

Note: Shortcut bar functionality is implemented in Pandora 5.0

Available Options:

  • Default: Pandora FMS main page as shown by default.
  • Dashboard: You can choose a user dashboard.
  • Visual Console: You can pick the user's visual console.
  • Event List
  • Group View
  • Tactical View
  • Alert Detail
  • Other: Users are able to customize their home page. It's going to display the default view by default. Example: Select 'Other' and type 'sec=estado&sec2=operation/agentes/estado_agente' to show a detailed agent view.

1.3.2 The Operation Menu

The Operation menu allows you to view all checking done by Pandora FMS agents, the visual maps, network maps, server status, inventory, see and manage the incidents (if you have sufficient permissions), see the users, see the SNMP console, see the messages and use the extensions.


From the Operation menu down to any submenu, there could be other elements which are going to be displayed by selecting the menu:


All of these elements link to other pages containing information and all of them will be explained in the chapters dealing with Operations in Pandora FMS in great detail.

1.3.3 The Administration Menu

The Administration Menu allows users to see and manage the monitoring that Pandora FMS agents execute. It also allows modules and components of these checks to be viewed, the alerts that these modules and agents can launch and how these alerts work, the existing policies, users, SNMP console, reports, user profiles, the Pandora FMS servers and their assigned tasks, the system audit register, the Pandora FMS web console, database maintenance and the console extensions.


There could be other elements present which will be displayed when selecting menus in any submenu down from the Administration menu.


All of these elements are links to pages with information. All of them will be explained in 'Operation and Management' in the Pandora FMS chapters in great detail.

1.3.4 Links Menu

The links menu just shows a link to default sites. They can be added, modified or deleted from the Pandora FMS administration menu. These links allow Pandora FMS to link to other WEB applications and turns Pandora FMS into a central management point.


1.3.5 Headers

The Pandora FMS headers offer several quick links or a direct access to important features of the system and a search bar:


From left to right, the header provides the following:

  • A link to the system status which shows the Pandora FMS server status.
  • The auto-refresh button which, apart from updating the screen, could be configured to auto-refresh in a determined time interval. This allows you to define e.g. that it will be refreshed every X time on any page. By doing this, the session or the information in it won't get lost. It also displays the updated data.
  • If there are pending system warnings, an alert icon will show. When you click on it, a modal window will be displayed, containing the current system warnings. In the center of this information window, you may find update manager updates, system security problems or value notifications (e.g. the default console password) by default.

System advises.jpeg

  • A link to the general contextual help content of Pandora FMS.
  • A button for closing the session.
  • The user which is currently connected. A direct link to his user page (in brackets).
  • If the user has pending messages to read, a card will be shown. If you click on it, a modal window with the current messages will appear.
  • The search bar which allows to search in several elements: Agents, reports, alerts, maps, combined graphs and / or users in the Pandora FMS database.


By clicking on the link, this goes straight to the server status, providing feedback:


Click auto-refresh to update the page. It also allows the update frequency to be selected:

Autorefresh select time pandora v5.png

Once this has been activated, the remaining time until the next update will be shown next to the link name:

Autorefresh count down pandora v5.png

Auto refresh is only shown on some pages. It's disabled on other pages by default to avoid conflicts and losing data e.g. if you fill out a form in this moment. The list of pages containing auto refresh are:

  • Tactical View
  • Group View
  • Agent Detail
  • Alert Detail
  • Monitor Detail
  • Service View
  • Dashboard
  • View Events
  • SNMP Console
  • Network Map

The search tool allows you to look for entries in maps, reports, graphs, alerts, users and agents. The information is arranged in slides for each kind of data, the agent slide is selected in advance:

Searchbar agent.jpg

The direct link to events is the same as the one which the Operation menu shows. This shows events which occur in the system and allows their management if there are sufficient permissions to do that. The event management will be explained in the chapter "Management of the application".

1.4 Icons within the Pandora FMS Interface

In Pandora FMS, there are several text-side icons, which include other icons. We're going to explain the most important ones in this section.

1.4.1 Contextual Help Icon

The Contextual Help Icon gives you general help on the field it comes with or in the application form or page where it is located. It opens a pop up window (you're required to have pop-up windows activated in your browser). It provides all information you might require. You're required to click on the icon to display this kind of help.

It's a round-shaped icon in form of an interrogation mark on green background.


1.4.2 Suggestion / Advice Icon

The suggestion and advice icons provide you with some help on the field it comes with. It's shown by clicking on the icon.

The icon is a yellow star.


1.4.3 Management Icon

The management icon comes with some files of some tables. It represents a direct link to the element's configuration. To have access to the linked page, you just have to click on it.


1.4.4 Full Screen Icon

It's usually shown next to the title of the pages you're on. It represents the possibility of the page to be shown as full screen. To use this functionality click on the icon.

The icon is a square with four arrows - one in each corner.


1.4.5 Magic Wand Icon (Wizard)

The magic wand icon shows the current functionality to apply a large amount of items the easy way by a single action (with the help of an assistant), e.g. there are wizards in the reporting section (Enterprise Version) that allow you to create report items for a large number of modules with one click. In the Visual Console Wizard, it can also be useful to easily create a lot of items.

The Magic Wand Icon is shown below.


1.4.6 Remote Configuration Edit Icon

There is a configuration option for the Pandora FMS software agents which allows the configuration to be remotely edited from the console (in the Enterprise version). This option comes in two different pages: The first one is the agent list and their management. You may access it through 'Administration' -> 'Manage Agents':


If you click the icon, the 'R' column on the right indicates that the software agent can be remotely configured from the console.

The option is also shown if you try to edit the agent's features, after clicking on the 'edit' button below its name:


On the following page, the agent details will be shown. Next to the name box, the agent remote configuration edit icon will appear:


1.4.7 Update Icon (forced Version)

Pandora FMS remote checking has an update interval - but this could be forced by clicking on a button. If it's forced, the module will be updated. This interval starts counting from zero.


1.4.8 Refresh Icon (after a forced-update Action)

Once the force update icon has been clicked, it's appearance changes to show that it's been activated.


It returns to its usual appearance once the checking has been updated.

1.4.9 Alternative Texts on Icons and Images when hovering the Mouse over it

Almost all Pandora FMS images have an alternative text which is shown when you're hovering with the mouse pointer over it. You can obtain alternative textual information as well as the information the images are able to offer in this way.


1.5 Images in Pandora FMS

The images in Pandora FMS can be graphs, generated by the Pandora FMS standard graph engine or Flash graphs, generated by the Flash engine. These can be defined by the administrator in the visual system configuration.

The current graphs (statics) provide less information as they aren't interactive. They don't show any text when hovering over them with the mouse pointer. The flash graphs can't be used in reports.


The Flash graphs give this information:



In case there is no data to show in a graph, Pandora FMS displays an error message in the image:


1.6 Data missing on Agent Data Lists

If the agent has no data to show, it displays a warning message instead:


The above is an example of an agent without any alerts.

1.7 States and possible values of Agents, Modules and Groups

If an agent has any data to show, this data could be in several status:

  • OK: Green
  • Warning / Notice: Yellow
  • Critical: Red
  • Unknown: Grey, with the information of the last contact in red.
  • Not started: They can't be seen. They only appear in blue in any management views.

This would be the data view of one agent which are called 'Modules' under Pandora FMS. It shows the module name, its status (in a colored box) and its numeric or alphanumeric value.

Data view for one agent

Modulos descr.jpg

There is also the detailed agent view. This view quickly summarizes the agent's overall status and the summarized status of the modules. We can see several agents in different states in this view:

The agent's view

Agent detail2.png

In this view, the agent called 'Database Server' has one configured module and one module in 'critical' state. Having an agent with at least one module in 'critical' state is displayed as a red box. The information of the agents as two '1' separated by ':' shows one defined module and one in 'critical' status (in dark red).

The agent called 'My Agent' has two modules in normal state.

The "vanesa-HP-630-Notebook-PC" agent has 20 modules. There are 3 in 'unknown state', represented as a 3 in light gray as it has all elements in 'unknown state'. It's displayed in blue. There are 2 modules in 'critical', 14 in 'normal' and 1 in 'warning' state.

Group View

As before, the group view summarizes the status of all agents for each group.

In this group view, we can see the following status:

  • OK: All agents are working appropriately (green).
  • Warning / Notice: At least one agent of this group is in a 'warning' status (yellow).
  • Critical: At least one agent is in a 'critical' status (red).
  • Unknown: All agents of this group have an 'unknown' status (grey).
  • Without Modules: When the agents of a group don't have modules or if they are not initialized (white).

Module View

This view provides a list which contains all modules of all agents. The list all states of all modules along with the same color coding as described above.

This view provides a lot of filtering options and comes in handy when comparing the module information of different agents.

1.8 The Widget's Auto-complete Agent

On some pages under Pandora FMS, you're maybe seeing some pages like this:

Agent autocomplete.png

This widget starts searching as you are typing and displays the agents which correspond to the characters you've typed in. The color coding of the results are:

  • First block in green: The agents matching by name.
  • Second block in yellow: The agents matching by description.
  • Third block in purple: The agents matching by address.


Please keep in mind that the widget starts working after you've typed at least two characters.


1.9 Network interfaces table

This table can appear in places like the general agent view, the agent detail view of the tree view, certain report types, etc. It shows the information about the network interfaces of a specific agent.


There are some ways to show the table:

  • Recon script: More information. This script will create agents and modules prepared to properly show the information in case of being network interface modules.
  • SNMP interfaces wizard: Through a simple setup, this assistant, which is located in the agent's setup view, will show the found interfaces and the only thing to do is choose the modules to be created. The module ifOperStatus is required to see the interface in the table. To view the input and output traffic graph, the modules ifInOctets and ifOutOctets are also required.
  • Manual creation: To display the interface on the table, a module should be created following certain naming conventions. This module should be called <interface name>_ifOperStatus and should be of one of these types: remote_snmp_proc, remote_icmp_proc, remote_tcp_proc, generic_proc. It's recommended to use the remote_snmp_proc type and attack to the ifOperStatus OID of the interface (.<index>) to get its real status. To view the input and output traffic graph, two modules of remote_snmp_inc type and called <interface name>_ifInOctects_ and <interface name>_ifOutOctets_ should be created. These modules should attack the OID .<index> and .<index>, respectively. To show the IP and the MAC of the interface on the table, it's necessary to add this data to the ifOperStatus module's description.

Go back to Pandora FMS Documentation Index