Difference between revisions of "Pandora: Documentation en: Interface"

From Pandora FMS Wiki
Jump to: navigation, search
(States and possible values of Agents, Modules and Groups)
m (Server management: Typo.)
 
(64 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
[[Pandora:Documentation_en|Go back to Pandora FMS documentation index]]
 
[[Pandora:Documentation_en|Go back to Pandora FMS documentation index]]
  
= The Pandora FMS Interface =
 
  
== 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.
+
= Pandora FMS Interface =
  
== Pandora FMS Start Session Screen ==
+
== Introduction ==
  
On the image below, you see the default Pandora FMS start session screen:
+
This section shows some of Pandora FMS interface common bases.
  
 +
== Pandora FMS login screen ==
  
<center>
+
[[Image:If1.JPG|center|800px]]
[[image:Interfaz1.jpg|center|450px]]
 
</center>
 
  
 +
At the bottom of the screen, there is the version of Pandora FMS currently used. There are text entry boxes at the center to enter the username and password with the button to log in. The login wallpaper [[Pandora:Documentation_en:Console_Setup#Style_configuration|can be customized]].
  
At the bottom of the screen, is the version of Pandora FMS you're currently using.
+
The default credentials are:
  
There are text entry boxes in the center to enter the user's name and password with the session start button (login).
+
;User: <code>admin</code>
 +
;Password: <code>pandora</code>
  
Introduce credentials to start. The defaults are:
+
Once you enter the valid login credentials, the console displays the default Pandora FMS main welcome page. Pandora FMS login screens can be customized. This will be explained in the [[Pandora:Documentation_en:Interface#Pandora_FMS_Customized_Page|Custom welcome screen section.]]<br><br><br>
  
* '''User''': admin
+
== Pandora FMS main page ==
* '''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.
+
The Pandora FMS default main page shows basic and general information about the status of the systems and the number and type of checks that Pandora FMS performs.
  
== Pandora FMS Main Page ==
+
[[Image:If2.JPG|center|800px|Click on the image to enlarge]]
  
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:
  
<center><br><br>
+
* Operation menu
[[image:pagipal.jpg|center|800px]]
+
* Administration menu
</center><br><br>
+
* Defined links
 +
* Header
  
The static elements which do ''not'' change in different screens of the interface are:
+
The dynamic elements which do change in different screens are:
 
 
* Operation Menu
 
* Administration Menu
 
* Defined Links
 
* Headers
 
 
 
The dynamic elements which ''do'' change in different screens are:
 
  
 
* Header information
 
* Header information
* User information, pending messages, system notifications, etc. (this will be explained in the '''subsection header''' below).
+
** User information, pending messages, system notifications, etc. (this will be explained in the '''header sub-section ''' below).
 
* Site news
 
* Site news
* Last activity of the Web Console
+
* Web console's last activity
 
* General basic information  
 
* General basic information  
* Checking main view in Pandora FMS
+
* Pandora FMS Overview:
 +
** <b>Server health</b>: Server general status.
 +
** <b>Monitor health</b>: Monitor general status.
 +
** <b>Module sanity</b>: General status of the modules that collect data, compared to the non-started ones.
 +
** <b>Alert level</b>: Alert general status.
 +
 
 +
This is the default home page, but the user can customize it.
  
 
=== Pandora FMS Customized Page ===
 
=== Pandora FMS Customized Page ===
  
The Pandora FMS main page can be personalized under 'Operation' -> 'Workspace' and 'Edit my user'.
+
In the '''Workspace''' -> '''Edit my user''' view you can choose the Pandora FMS home screen.
 +
 
 +
[[Image:If3.JPG|center|800px]]
  
<center><br><br>
+
;Default: Pandora FMS main page as shown above by default.
[[image:home_screen.jpg|center|900px]]
+
;Visual Console: You can pick the user's visual console.
</center><br><br>
+
;Event List: List of events.
 +
;Group View: Agent group view.
 +
;Tactical View: Agent tactical view.
 +
;Alert Detail: Alert list
 +
;Other: Users are able to customize their home page by entering the url that points to the console. For instance, to see the agent detail: <code> sec=status&sec2=operation/agents/status_agent </code>.
 +
;Dashboard: To choose a user dashboard.
  
''Note: Shortcut bar functionality is implemented in Pandora 5.0''
+
Click '''Update''' to save changes.
  
Available Options:
+
=== The operation menu ===
  
* '''Default:''' Pandora FMS main page as shown by default.
+
The operation menu allows you to view all checking done by Pandora FMS agents, visual maps, network maps, inventory, see and manage the incidents (if you have the according permissions), see the SNMP console, see the messages and use the extensions.
* '''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.
 
  
=== The Operation Menu ===
+
[[Image:Menuope.jpg|center|250px]]
  
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 drop-down elements.
  
<CENTER><br><br>
+
Each of these elements links to other pages containing information and all of them will be explained in the chapters dealing with operation in Pandora FMS in more detail.
[[image:Menuope.jpg]]
 
</CENTER><br><br>
 
  
From the Operation menu down to any submenu, there could be other elements which are going to be displayed by selecting the menu:
+
=== The administration menu ===
  
<CENTER><br><br>
+
The administration menu allows you to view and manage the checks carried out by Pandora FMS agents, the modules and components of said checks, the alerts that these modules and agents can launch and how these alerts work, the existing policies, the users, the user profiles, the Pandora FMS servers and their assigned tasks, the system audit log, the general performance of Pandora FMS web console, the database maintenance and console's extensions.
[[image:Image2.jpg]]
 
</CENTER><br><br>
 
  
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.
+
[[Image:Extension.jpg|center|250px]]
  
=== The Administration Menu ===
+
There could be other elements which will be displayed when selecting menus in any Administration drop-down submenu.
  
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.
+
Each of these elements provides another page with information. All of them will be explained in detail in the chapters of operation and management with Pandora FMS.
  
<CENTER><br><br>
+
=== Links menu ===
[[image:Extension.jpg]]
 
</CENTER><br><br>
 
  
There could be other elements present which will be displayed when selecting menus in any submenu down from the Administration menu.
+
The links menu simply displays a link to preconfigured sites. These can be added, modified and deleted from the Pandora FMS Administration menu. These links allow you to link Pandora FMS with other WEB applications of your organization and make Pandora FMS a central management point.
  
<CENTER><br><br>
+
<br><br>
[[image:Extension2.jpg]]
+
<CENTER>
 +
[[image:Enlaces.jpg|center|400px]]
 
</CENTER><br><br>
 
</CENTER><br><br>
  
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.
+
=== The Header ===
  
=== Links Menu ===
+
Pandora FMS header offers several quick links or direct access to important features of the system and a search bar:
  
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.
+
[[Image:If4.JPG|center|700px]]
  
<CENTER><br><br>
+
From left to right, the header provides the following:
[[image:Enlaces.jpg]]
 
</CENTER><br><br>
 
  
=== Headers ===
+
* The search bar which allows to run a search in several elements: agents, reports, alerts, maps, combined graphs, users and / or policies in Pandora FMS database.
  
The Pandora FMS headers offer several quick links or a direct access to important features of the system and a search bar:
+
[[Image:Header-search_bar-pfms.png|center|330px]]
  
<center><br><br>
+
* The auto-refresh button which, apart from updating the screen, can be configured to auto-refresh in a certain time interval. This allows you to  configure it to be refreshed every X time on any page. By doing this, the session or the information in it will not get lost. It also displays the updated data.
[[image:Cabecera.jpg|center|600px]]
+
*  If there are pending system notifications, an alert icon will be displayed and by clicking on it, a modal window with the current alerts will be displayed.
</center><br><br>
 
  
From left to right, the header provides the following:
+
[[Image:System_advises.jpeg|center|500px]]
  
* A link to the system status which shows the Pandora FMS server status.
+
{{Warning|These messages, much like Console email notifications, redirec to the URL of the file <code>/etc/crontab</code> or to a public URL with the option <code>force</code> enabled. If its configuration is omitted, it will use as URL <code>localhost</code> '''''by default'''''.}}
* 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.
 
  
<center><br><br>
+
* A link to the system status, which shows Pandora FMS server status.
[[image:System_advises.jpeg | 600px]]
+
* A link to the general support of Pandora FMS.
</center><br><br>
+
* A link to the general contextual help content of Pandora FMS.
 +
* Information about the logged in user, a direct link to its user page (between curly brackets).
 +
* A button to log out.
 +
* If you have messages yet to be read, an icon of an envelope will be shown. The drop-down will show a modal window with the available messages.
  
* A link to the general contextual help content of Pandora FMS.
+
The link to the system status also alerts you when a service is down, changing icon:
* 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.
 
  
<center><br><br>
+
[[Image:Servers.jpg|center|50px]]
[[image:Servers.jpg]]
 
</center><br><br>
 
  
By clicking on the link, this goes straight to the server status, providing feedback:
+
By clicking on the link, it takes you directly to the server status, reporting different details about them:
  
<center><br><br>
+
[[image:Config.jpg|center|800px]]
[[image:Config.jpg|center|550px]]
 
</center><br><br>
 
  
Click auto-refresh to update the page. It also allows the update frequency to be selected:
+
In the user editing section, you may configure the auto-refresh for certain sections. If enabled in this section, the auto refresh button allows you to update the page by clicking on it, or select an update frequency:
  
<center><br><br>
+
[[Image:Autorefresh_select_time_pandora_v5.png|center|450px]]
[[image:Autorefresh_select_time_pandora_v5.png]]
 
</center><br><br>
 
  
 
Once this has been activated, the remaining time until the next update will be shown next to the link name:
 
Once this has been activated, the remaining time until the next update will be shown next to the link name:
  
<center><br><br>
+
[[Image:Autorefresh count down pandora v5.png|center|400px]]
[[image:Autorefresh count down pandora v5.png]]
 
</center><br><br>
 
  
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:
+
Auto refresh is only shown on some pages. It is disabled on other pages by default to avoid conflicts and losing data when editing forms. The pages where it is allowed are:
  
* '''Tactical View'''
+
* '''Tactical view'''
* '''Group View'''
+
* '''Group detail'''
* '''Agent Detail'''
+
* '''Agent detail'''
* '''Alert Detail'''
+
* '''Alert detail'''
* '''Monitor Detail'''
+
* '''Monitor detail'''
* '''Service View'''
+
* '''Service view'''
 
* '''Dashboard'''
 
* '''Dashboard'''
* '''View Events'''
+
* '''Event view'''
* '''SNMP Console'''  
+
* '''SNMP trap console'''  
* '''Network Map'''
+
* '''Network map'''
 +
* '''Cluster view'''
 +
* '''Graph view'''
 +
* '''Visual consoles'''
  
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:
+
==== Search bar results ====
  
<center><br><br>
+
In the search bar, by just entering a couple of letters, you are shown a fast access with a single click to the components that match the entered letter or text string.
[[image:Searchbar_agent.jpg|800px]]
 
</center><br><br>
 
  
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".
+
[[Image:Header-search_bar-pfms.png|center|330px]]
 +
 
 +
In addition, the search bar allows looking for terms in policies, visual consoles, reports, graphs, users, alerts, modules or agents when entering a text string and pressing <kbd>Enter</kbd>. A summary of the found elements is shown. The information is classified in tabs for each type of data, with the agent tab pre-selected:
 +
 
 +
[[Image:Header-search_bar_string_2-pfms.png|center|800px]]
 +
 
 +
You may click on any any tab to see the rest of the categories, if there were any search results..
 +
 
 +
[[Image:Header-search_bar_string_1-pfms.png|center|800px]]
  
 
== Icons within the Pandora FMS Interface ==
 
== 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.
+
In Pandora FMS, there are several icons, whether text-side icons or icons together with other icons, etc. Usually speaking, when hovering the mouse over them for a certain amount of time you are shown a text tag showing its name and/or function. Here you have the most important ones explained.
  
 
=== Contextual Help Icon ===
 
=== 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.
+
[[Image:help_green.png|left|Contextual help]]
  
It's a round-shaped icon in form of an interrogation mark on green background.
+
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 (pop-up windows must be enabled in your browser) and provides full help.
  
 +
It may also represent: [[Image:help_w.png|Contextual help]][[Image:help_g.png|Contextual help]].<br><br><br>
  
<center><br><br>
+
=== Suggestion/Advice Icon ===
[[image:Icono.jpg]]
 
</center><br><br>
 
  
=== Suggestion / Advice Icon ===
+
[[Image:Estrella.jpg|left]]
  
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 suggestion and advice icon provides you with some help on the field it comes with. It is shown by placing the cursor over it.<br><br><br>
  
The icon is a yellow star.
 
  
<center><br><br>
+
=== Management Icon ===
[[image:Estrella.jpg]]
 
</center><br><br>
 
  
=== Management Icon ===
+
[[Image:Mango.jpg|left]]
  
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.
+
The management icon comes with some lines in some tables. It represents a direct link to the element's configuration. To have access to the linked page, click on it.<br><br><br>
  
<center><br><br>
 
[[image:Mango.jpg]]
 
</center><br><br>
 
  
 
=== Full Screen Icon ===
 
=== 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.  
+
[[Image:Flecha.jpg|left]]
  
The icon is a square with four arrows - one in each corner.
+
It is present in mainly visual sections to display information in full-screen mode by hiding the menus.<br><br><br>
 
 
<center><br><br>
 
[[image:Flecha.jpg]]
 
</center><br><br>
 
  
 
=== Magic Wand Icon (Wizard) ===
 
=== 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.
+
[[Image:Magica.jpg|left]]
 
 
The Magic Wand Icon is shown below.
 
  
<center><br><br>
+
The magic wand icon indicates that this feature will be useful to easily apply (via an assistant) to a large number of items an action.<br><br><br>
[[image:Magica.jpg]]
 
</center><br><br>
 
  
 
=== Remote Configuration Edit Icon  ===
 
=== 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':
+
[[Image:Oso.jpg|left]]
  
<center>
+
It is used to remotely edit the configuration file of the software agents.<br><br><br>
<br><br>
 
[[image:Oso.jpg|center]]
 
</center><br><br>
 
  
If you click the icon, the 'R' column on the right indicates that the software agent can be remotely configured from the console.
+
=== Force Action Icon ===
  
The option is also shown if you try to edit the agent's features, after clicking on the 'edit' button below its name:
+
[[Image:Force.JPG|left]]
  
<center>
+
Pandora FMS remote checking has an update interval, but this could be forced by clicking on the button.<br><br><br>
<br><br>
 
[[image:Save.jpg]]
 
</center><br><br>
 
 
 
On the following page, the agent details will be shown. Next to the name box, the agent remote configuration edit icon will appear:
 
 
 
<center><br><br>
 
[[image:Silva.jpg]]
 
</center><br><br>
 
 
 
=== 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.
 
 
 
<center>
 
<br><br>
 
[[image:Cero.jpg]]
 
</center><br><br>
 
  
 
=== Refresh Icon (after a forced-update Action) ===
 
=== 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.
+
[[Image:Toner.jpg|left]]
  
<center>
+
Once the force update icon has been clicked, it changes to show that it has been activated. It returns to its usual state once the checking has been updated.<br><br><br>
<br><br>
 
[[image:Toner.jpg]]
 
</center><br><br>
 
  
It returns to its usual appearance once the checking has been updated.
+
=== Alternative Texts on Icons and Images when hovering the Mouse over them ===
  
=== 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 hovering over it with the mouse pointer. You can obtain alternative textual information as well as the image information.
 
+
[[Image:Raton.jpg|center]]
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.
 
 
 
<center>
 
<br><br>
 
[[image: Raton.jpg]]
 
</center><br><br>
 
 
 
== 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.
 
 
 
<center>
 
<br>
 
[[image: Rata.jpg]]
 
</center>
 
 
 
The Flash graphs give this information:
 
 
 
<center>
 
<br>
 
[[image:Verde.jpg]]
 
</center>
 
  
<center>
+
== Server management ==
<br>
 
[[image:Pastel.jpg]]
 
</center>
 
  
In case there is no data to show in a graph, Pandora FMS displays an error message in the image:
+
Server detailed view is used to know, besides the general status of the Pandora FMS servers, their load level and execution delay.
  
<center>
+
[[Image:Servers-manage_servers_pandora_fms_servers.png|center|770px]]
[[image:Pastelito.jpg]]
 
</center>
 
  
== Data missing on Agent Data Lists ==
+
In this view, you may see different information on each column: 
  
If the agent has no data to show, it displays a warning message instead:
+
;Name: Generally the hostname of the machine is used. 
 +
;Status: (green = active, gray = stopped or down).
 +
;Type: Data server, network server, etc. 
 +
;Version: It shows the current version of Pandora FMS server. 
 +
;Modules: Number of modules of this type executed by the server regarding the total number of modules of this type. 
 +
;Lag: Highest time that the oldest module is waiting to receive data / Number of modules that are out of their life time. This indicator is used to know if there are too many modules and to know if the server is at the limit of its load capacity. Delayed modules indicates the number of modules that have not reported to the server. 
 +
;T/Q (Current threads/queued modules currently): It shows the number of threads currently active on each server. Total number of modules in queue waiting to be attended. These parameters reflect status of excessive load. There should almost never be modules queued, this reflects the inability of the server to process data. 
 +
;Updated: Each server has a "Keepalive" that updates its status, to make sure it is active, also updating its statistics.
 +
;OP.: Available operations, icon column.
  
<center>
+
Some icons have special relevance:
<br><br>
 
[[image:Piña.jpg]]
 
</center><br><br>
 
  
The above is an example of an agent without any alerts.
+
[[Image:Servers-manage_servers_pandora_fms_servers-icons.png|center|300px]]
  
== States and possible values of Agents, Modules and Groups ==
+
* '''Poll request''': It requests the remote test server to execute all the checks it has, forcing it to execute them again. Valid for all network servers, e.g. Network server, WMI server, Plugin server, WEB Server, etc. 
 +
* '''Edit''': Change IP address and server description. recon server tasks.
 +
* '''Delete''': Delete the server. 
 +
* '''Edit remote server configuration''': Edit server remote configuration. Valid for Pandora FMS or Satellite server servers.
 +
* '''Manage Discovery tasks''': Manage Discovery tasks. Suitable for Discovery servers.
  
If an agent has any data to show, this data could be in several status:
+
== Status and possible values of agents, modules and groups ==
  
* '''OK:''' Green
+
Agents contain modules with the different checks that are carried out. Their status could be:
* '''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.
+
* '''OK:''' Green.
 +
* '''Warning / Notice:''' Yellow.
 +
* '''Critical:''' Red.
 +
* '''Unknown:''' Grey.
 +
* '''Not started:''' They cannot be seen. They only appear in blue in the management view.
  
''Data view for one agent''
+
This would be the '''agent data view''', which are called '''Modules''' in Pandora FMS. It shows the module name, its status (in a colored box) and its numeric or alphanumeric value.
  
<center>
+
[[Image:Modulos_descr.jpg|center|800px]]
<br><br>
 
[[image:Modulos_descr.jpg|center|800px]]
 
</center><br><br>
 
  
 
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:
 
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''
+
[[Image:If5.JPG|center|740px]]
  
<center>
+
IAgents will portrait in their status the worst situation of its modules, so it there is only one in critical state, the agent will be red.  
<br><br>
 
[[image:Agent detail2.png|center|800px]]
 
</center>
 
<br><br>
 
 
 
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.
 
<br>
 
<br>
 
 
'''Group View'''
 
'''Group View'''
  
As before, the group view summarizes the status of all agents for each group.
+
As before, the group view summarizes the status of all agents. A group could have one of the following states:
 
 
In this group view, we can see the following status:
 
  
* '''OK:''' All agents are working appropriately (green).
+
* '''OK''' (green): All agents are working properly.
* '''Warning / Notice:''' At least one agent of this group is in a 'warning' status (yellow).
+
* '''Warning/Notice''' (yellow): At least one agent of this group is in a 'warning' status.
* '''Critical:''' At least one agent is in a 'critical' status (red).
+
* '''Critical''' (red): At least one agent is in a 'critical' status.
* '''Unknown:''' All agents of this group have an 'unknown' status (grey).
+
* '''Unknown''' (grey): All agents of this group are in 'unknown' status.
* '''Without Modules:''' When the agents of a group don't have modules or if they are not initialized (white).
+
* '''Without Modules''' (white): When the agents of a group do not have modules or if they are not initialized.
  
 
'''Module View'''
 
'''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 list which contains all modules of all agents. The list shows the status of all modules using 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.
+
This view is very useful for comparing module information from different agents thanks to its filtering options.
  
== The Widget's Auto-complete Agent ==
+
== The widget's auto-complete agent ==
On some pages under Pandora FMS, you're maybe seeing some pages as this:
+
On some pages under Pandora FMS, you may see something like this:
  
 
<center>
 
<center>
Line 389: Line 301:
 
</center>
 
</center>
  
This widget starts it's 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:
+
This widget starts searching as you are typing and displays the agents which correspond to the characters you typed in. The color coding of the results are:
 
* '''First block in green''': The agents matching by name.
 
* '''First block in green''': The agents matching by name.
 
* '''Second block in yellow''': The agents matching by description.
 
* '''Second block in yellow''': The agents matching by description.
Line 395: Line 307:
  
  
{{Tip|Please keep in mind that the widget starts working after you've typed at least two characters.}}
+
{{Tip|Bear in mind that the widget starts working after you have typed at least two characters.}}
  
== Network interfaces table ==
+
== Network interface 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 determined agent.
+
Given the special importance of communications through the network interfaces of the devices to be monitored, Pandora FMS has a separate table to describe them.
  
<center>
+
This table can appear in places such as an agent overview, the detail view of an agent in the tree view, certain report types, etc. As its name indicates, it displays information about the network interfaces of a given agent.
[[File:snmp-interface-table.png]]
 
</center>
 
  
There are some ways to show the table:
+
[[Image:snmp-interface-table.png|center|600px]]
  
* '''Recon script''': [[Pandora:Documentation en:Recon Server#SNMP L2 Recon Script|More information]]. This script will create agents and modules prepared to properly show the information in case of being network interface modules.
+
There are some ways this table might be shown:
 +
* '''Recon script''': [[Pandora:Documentation en:Recon Server#SNMP L2 Recon Script|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 into the agent's setup view, will show the found interfaces and the only thing to do will be 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''' also will be required.
+
* '''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 left to do is choosing the modules to be created. The module <code>ifOperStatus</code> is required to see the interface in the table. To view the input and output traffic graph, the modules <code>ifInOctets</code> and <code>ifOutOctets</code> are also required.
  
* '''Manual creation''': To display the interface into 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 this types: ''remote_snmp_proc'', ''remote_icmp_proc'', ''remote_tcp_proc'', ''generic_proc''. It's recommended the use of the ''remote_snmp_proc'' type and attack to the ''ifOperStatus'' ''OID'' of the interface (.1.3.6.1.2.1.2.2.1.8.<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. This modules should attack the ''OID'' .1.3.6.1.2.1.2.2.1.10.<index> and .1.3.6.1.2.1.2.2.1.16.<index>, respectively. To show the IP and the MAC of the interface into the table, it's necessary to add this data to the ''ifOperStatus'' module's description.
+
* '''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: <code>remote_snmp_proc</code>, <code>remote_icmp_proc</code>, <code>remote_tcp_proc</code> and <code>generic_proc</code>. It is recommended to use the <code>remote_snmp_proc</code> type and attack the <code>ifOperStatus</code> '''OID''' of the interface (.1.3.6.1.2.1.2.2.1.8.<index>) to get its real status. To view the input and output traffic graph, two modules of <code>remote_snmp_inc</code> type and called '''''<interface name>''_ifInOctects_''' and '''''<interface name>''_ifOutOctets_''' should be created. These modules should attack the ''OID'' .1.3.6.1.2.1.2.2.1.10.<index> and .1.3.6.1.2.1.2.2.1.16.<index>, respectively. To show the IP and the MAC of the interface on the table, it is necessary to add this data to the above mentioned <code>ifOperStatus</code> module's description.
  
 
[[Pandora:Documentation_en|Go back to Pandora FMS Documentation Index]]
 
[[Pandora:Documentation_en|Go back to Pandora FMS Documentation Index]]

Latest revision as of 12:04, 11 March 2021

Go back to Pandora FMS documentation index


1 Pandora FMS Interface

1.1 Introduction

This section shows some of Pandora FMS interface common bases.

1.2 Pandora FMS login screen

If1.JPG

At the bottom of the screen, there is the version of Pandora FMS currently used. There are text entry boxes at the center to enter the username and password with the button to log in. The login wallpaper can be customized.

The default credentials are:

User
admin
Password
pandora

Once you enter the valid login credentials, the console displays the default Pandora FMS main welcome page. Pandora FMS login screens can be customized. This will be explained in the Custom welcome screen section.


1.3 Pandora FMS main page

The Pandora FMS default main page shows basic and general information about the status of the systems and the number and type of checks that Pandora FMS performs.

Click on the image to enlarge


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

  • Operation menu
  • Administration menu
  • Defined links
  • Header

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 header sub-section below).
  • Site news
  • Web console's last activity
  • General basic information
  • Pandora FMS Overview:
    • Server health: Server general status.
    • Monitor health: Monitor general status.
    • Module sanity: General status of the modules that collect data, compared to the non-started ones.
    • Alert level: Alert general status.

This is the default home page, but the user can customize it.

1.3.1 Pandora FMS Customized Page

In the Workspace -> Edit my user view you can choose the Pandora FMS home screen.

If3.JPG
Default
Pandora FMS main page as shown above by default.
Visual Console
You can pick the user's visual console.
Event List
List of events.
Group View
Agent group view.
Tactical View
Agent tactical view.
Alert Detail
Alert list
Other
Users are able to customize their home page by entering the url that points to the console. For instance, to see the agent detail: sec=status&sec2=operation/agents/status_agent .
Dashboard
To choose a user dashboard.

Click Update to save changes.

1.3.2 The operation menu

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

Menuope.jpg

From the Operation menu down to any submenu, there could be other drop-down elements.

Each of these elements links to other pages containing information and all of them will be explained in the chapters dealing with operation in Pandora FMS in more detail.

1.3.3 The administration menu

The administration menu allows you to view and manage the checks carried out by Pandora FMS agents, the modules and components of said checks, the alerts that these modules and agents can launch and how these alerts work, the existing policies, the users, the user profiles, the Pandora FMS servers and their assigned tasks, the system audit log, the general performance of Pandora FMS web console, the database maintenance and console's extensions.

Extension.jpg

There could be other elements which will be displayed when selecting menus in any Administration drop-down submenu.

Each of these elements provides another page with information. All of them will be explained in detail in the chapters of operation and management with Pandora FMS.

1.3.4 Links menu

The links menu simply displays a link to preconfigured sites. These can be added, modified and deleted from the Pandora FMS Administration menu. These links allow you to link Pandora FMS with other WEB applications of your organization and make Pandora FMS a central management point.



Enlaces.jpg


1.3.5 The Header

Pandora FMS header offers several quick links or direct access to important features of the system and a search bar:

If4.JPG

From left to right, the header provides the following:

  • The search bar which allows to run a search in several elements: agents, reports, alerts, maps, combined graphs, users and / or policies in Pandora FMS database.
Header-search bar-pfms.png
  • The auto-refresh button which, apart from updating the screen, can be configured to auto-refresh in a certain time interval. This allows you to configure it to be refreshed every X time on any page. By doing this, the session or the information in it will not get lost. It also displays the updated data.
  • If there are pending system notifications, an alert icon will be displayed and by clicking on it, a modal window with the current alerts will be displayed.
System advises.jpeg

Template warning.png

These messages, much like Console email notifications, redirec to the URL of the file /etc/crontab or to a public URL with the option force enabled. If its configuration is omitted, it will use as URL localhost by default.

 


  • A link to the system status, which shows Pandora FMS server status.
  • A link to the general support of Pandora FMS.
  • A link to the general contextual help content of Pandora FMS.
  • Information about the logged in user, a direct link to its user page (between curly brackets).
  • A button to log out.
  • If you have messages yet to be read, an icon of an envelope will be shown. The drop-down will show a modal window with the available messages.

The link to the system status also alerts you when a service is down, changing icon:

Servers.jpg

By clicking on the link, it takes you directly to the server status, reporting different details about them:

Config.jpg

In the user editing section, you may configure the auto-refresh for certain sections. If enabled in this section, the auto refresh button allows you to update the page by clicking on it, or select an update frequency:

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 is disabled on other pages by default to avoid conflicts and losing data when editing forms. The pages where it is allowed are:

  • Tactical view
  • Group detail
  • Agent detail
  • Alert detail
  • Monitor detail
  • Service view
  • Dashboard
  • Event view
  • SNMP trap console
  • Network map
  • Cluster view
  • Graph view
  • Visual consoles

1.3.5.1 Search bar results

In the search bar, by just entering a couple of letters, you are shown a fast access with a single click to the components that match the entered letter or text string.

Header-search bar-pfms.png

In addition, the search bar allows looking for terms in policies, visual consoles, reports, graphs, users, alerts, modules or agents when entering a text string and pressing Enter. A summary of the found elements is shown. The information is classified in tabs for each type of data, with the agent tab pre-selected:

Header-search bar string 2-pfms.png

You may click on any any tab to see the rest of the categories, if there were any search results..

Header-search bar string 1-pfms.png

1.4 Icons within the Pandora FMS Interface

In Pandora FMS, there are several icons, whether text-side icons or icons together with other icons, etc. Usually speaking, when hovering the mouse over them for a certain amount of time you are shown a text tag showing its name and/or function. Here you have the most important ones explained.

1.4.1 Contextual Help Icon

Contextual help

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 (pop-up windows must be enabled in your browser) and provides full help.

It may also represent: Contextual helpContextual help.


1.4.2 Suggestion/Advice Icon

Estrella.jpg

The suggestion and advice icon provides you with some help on the field it comes with. It is shown by placing the cursor over it.



1.4.3 Management Icon

Mango.jpg

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



1.4.4 Full Screen Icon

Flecha.jpg

It is present in mainly visual sections to display information in full-screen mode by hiding the menus.


1.4.5 Magic Wand Icon (Wizard)

Magica.jpg

The magic wand icon indicates that this feature will be useful to easily apply (via an assistant) to a large number of items an action.


1.4.6 Remote Configuration Edit Icon

Oso.jpg

It is used to remotely edit the configuration file of the software agents.


1.4.7 Force Action Icon

Force.JPG

Pandora FMS remote checking has an update interval, but this could be forced by clicking on the button.


1.4.8 Refresh Icon (after a forced-update Action)

Toner.jpg

Once the force update icon has been clicked, it changes to show that it has been activated. It returns to its usual state once the checking has been updated.


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

Almost all Pandora FMS images have an alternative text which is shown when hovering over it with the mouse pointer. You can obtain alternative textual information as well as the image information.

Raton.jpg

1.5 Server management

Server detailed view is used to know, besides the general status of the Pandora FMS servers, their load level and execution delay.

Servers-manage servers pandora fms servers.png

In this view, you may see different information on each column:

Name
Generally the hostname of the machine is used.
Status
(green = active, gray = stopped or down).
Type
Data server, network server, etc.
Version
It shows the current version of Pandora FMS server.
Modules
Number of modules of this type executed by the server regarding the total number of modules of this type.
Lag
Highest time that the oldest module is waiting to receive data / Number of modules that are out of their life time. This indicator is used to know if there are too many modules and to know if the server is at the limit of its load capacity. Delayed modules indicates the number of modules that have not reported to the server.
T/Q (Current threads/queued modules currently)
It shows the number of threads currently active on each server. Total number of modules in queue waiting to be attended. These parameters reflect status of excessive load. There should almost never be modules queued, this reflects the inability of the server to process data.
Updated
Each server has a "Keepalive" that updates its status, to make sure it is active, also updating its statistics.
OP.
Available operations, icon column.

Some icons have special relevance:

Servers-manage servers pandora fms servers-icons.png
  • Poll request: It requests the remote test server to execute all the checks it has, forcing it to execute them again. Valid for all network servers, e.g. Network server, WMI server, Plugin server, WEB Server, etc.
  • Edit: Change IP address and server description. recon server tasks.
  • Delete: Delete the server.
  • Edit remote server configuration: Edit server remote configuration. Valid for Pandora FMS or Satellite server servers.
  • Manage Discovery tasks: Manage Discovery tasks. Suitable for Discovery servers.

1.6 Status and possible values of agents, modules and groups

Agents contain modules with the different checks that are carried out. Their status could be:

  • OK: Green.
  • Warning / Notice: Yellow.
  • Critical: Red.
  • Unknown: Grey.
  • Not started: They cannot be seen. They only appear in blue in the management view.

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

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:

If5.JPG

IAgents will portrait in their status the worst situation of its modules, so it there is only one in critical state, the agent will be red.

Group View

As before, the group view summarizes the status of all agents. A group could have one of the following states:

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

Module View

This view provides a list which contains all modules of all agents. The list shows the status of all modules using the same color coding as described above.

This view is very useful for comparing module information from different agents thanks to its filtering options.

1.7 The widget's auto-complete agent

On some pages under Pandora FMS, you may see something like this:

Agent autocomplete.png

This widget starts searching as you are typing and displays the agents which correspond to the characters you 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.


Info.png

Bear in mind that the widget starts working after you have typed at least two characters.

 


1.8 Network interface table

Given the special importance of communications through the network interfaces of the devices to be monitored, Pandora FMS has a separate table to describe them.

This table can appear in places such as an agent overview, the detail view of an agent in the tree view, certain report types, etc. As its name indicates, it displays information about the network interfaces of a given agent.

Snmp-interface-table.png

There are some ways this table might be shown:

  • Recon script: 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 left to do is choosing 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 and generic_proc. It is recommended to use the remote_snmp_proc type and attack the ifOperStatus OID of the interface (.1.3.6.1.2.1.2.2.1.8.<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 .1.3.6.1.2.1.2.2.1.10.<index> and .1.3.6.1.2.1.2.2.1.16.<index>, respectively. To show the IP and the MAC of the interface on the table, it is necessary to add this data to the above mentioned ifOperStatus module's description.

Go back to Pandora FMS Documentation Index