Difference between revisions of "Pandora: Documentation en: Data Presentation/Visual Maps"

From Pandora FMS Wiki
Jump to: navigation, search
(Nube de color)
(Simple value)
 
(38 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
 +
[[Pandora:Documentation|Go back to Pandora FMS documentation index]]
 +
 +
 
==Visual Consoles==
 
==Visual Consoles==
 
+
=== Introduction ===
Pandora FMS allows to build visual maps where each user defines their own way to visually represent the monitoring. The Visual Console editor allows the user, by dragging elements with the mouse, to visually design the final aspect, choosing the background and icons that represent the status of each relevant aspect you want to display. With Pandora comes a series of icons, but the user can easily customize their own. Different visual consoles can interact with each other, visualizing in a hierarchical way, the status of maps that are "below" in a top map, being able to abstract in this way, the monitoring and visualizing at high level, a whole series of elements.  
+
Pandora FMS allows to build visual maps where each user defines their own way to visually represent the monitoring. The Visual Console editor allows the user, by dragging elements with the mouse, to visually design the final aspect, choosing the background and icons that represent the status of each relevant aspect you want to display. With Pandora comes a series of icons, but the user can easily customize their own. Different visual consoles can interact with each other, viewing in a hierarchical way the status of maps that are "under" a superior map, being able to abstract that way the monitoring, and viewing at high level a whole series of elements.  
  
 
These are real-life examples of visual consoles, as seen on a 40"screen:
 
These are real-life examples of visual consoles, as seen on a 40"screen:
Line 15: Line 19:
 
=== Creation and access to visual consoles ===
 
=== Creation and access to visual consoles ===
  
To work with a visual map go to ''Topology Maps > Visual console''. A list appears with all the maps created, to create a new one click on the "Create" button. On the list we can edit a map, delete it or "clone" an existing one to modify it.
+
To work with a visual map, go to ''Topology Maps > Visual console''. A list appears with all created maps. To create a new one, click on "Create". On the list you can edit a map, delete it or "clone" an existing one to modify it.
  
Maps whose name begin with the characters "'''_'''", "''','''" , "'''['''" o "'''('''" will be displayed in the left menu in the Visual Console submenu. This allows you to create a kind of quick view from the menu, keep this in mind when naming your visual console.
+
Maps whose names begin with the characters "'''_'''", "''','''" , "'''['''" o "'''('''" will be displayed in the left menu in the Visual Console submenu. This allows you to create a kind of quick view from the menu. Keep it in mind when naming your visual console.
  
 
<center>
 
<center>
Line 23: Line 27:
 
</center>
 
</center>
  
For large environments where we have multiple visual consoles, a filter option has been created by searching for free text, by group and with recursion of secondary groups and subgroups.
+
For large environments where there are multiple visual consoles, a filter option has been created by searching for free text, by group and with recursion of secondary groups and subgroups.
  
 
==== Creating a visual console  ====
 
==== Creating a visual console  ====
  
The editor's organization is composed of several tabs: The "Main data" tab, which contains the general data of the visual console, the visualization tab, several wizards, a full screen view access, a link to share the visual console with a third party through a URL, a list of elements contained in the visual console and of course, the visual editor with which we will work to build and edit the console:
+
The editor's organization is made up by several tabs: The "Main data" tab, which contains visual console general data, the display tab, several wizards, a full screen view access, a link to share the visual console with a third party through a URL, a list of elements contained in the visual console and of course, the visual editor with which to build and edit the console:
  
 
<center>
 
<center>
Line 35: Line 39:
 
==== Creation - General data ====
 
==== Creation - General data ====
  
Here you can edit and create the basic data of the visual console. It'll be the only visible one to a new map until it's saved. The basic values it contains are: visual console name, ACL management group, and background image, which can be resized regardless of the size of the image. The background color is important because if the screen where the visual console is displayed is larger than the background image, it will fill in the rest with the background color selected here.
+
Here you can edit and create the basic data of the visual console. It will be the only visible one to a new map until it is saved. The basic values it contains are: visual console name, ACL management group, and background image, which can be resized regardless of the size of the image. The background color is important, because if the screen where the visual console is displayed is larger than the background image, it will fill in the rest with the background color selected here.
  
The background images are located in the Pandora's console directory, inside the directory:
+
The background images are located in the Pandora FMS console directory, inside the directory:
  
 
  ./images/console/backgrounds/
 
  ./images/console/backgrounds/
  
You can upload your own images through the file manager that Pandora has integrated (Admin tools -> File manager).  
+
You can upload your own images through the file manager that Pandora FMS has integrated (Admin tools > File manager).  
  
 
'''Visual Console Access Permissions'''
 
'''Visual Console Access Permissions'''
  
The ACLs in the Visual Consoles imply that anyone who has reading permission to a visual console, because they have access to the group with the Visual Console (VR) flag, will see all the contents of the VC, even if there are elements of another group in it.
+
Visual Console ACLs imply that anyone who has visual console reading permission, because they have access to the group with the Visual Console (VR) flag, will see all the contents of the VC, even if there are elements of another group in it.
  
 
<center>
 
<center>
Line 53: Line 57:
 
==== Creation - Wizard====
 
==== Creation - Wizard====
  
The wizard allows you to add elements to the VC quickly and conveniently. You can create elements of various types, and we recommend that before creating many elements you use it with only a couple of them, so that you don't have any problems later when deleting the elements (although if you make a mistake it might be faster to delete the entire VC).
+
The wizard allows you to add elements to the VC quickly and conveniently. You can create different types of elements, and it is recommended that before creating many elements you use it with only a couple of them, so that you do not have any troubles later on when deleting the elements (although if you make a mistake it might be faster to delete the entire VC).
  
The most relevant element is the one that allows you to create one element per agent, or on the contrary, to create one element per module. In this way you can add dozens of elements that represent a complete agent, or an element of an agent, or show all the modules of different agents, creating many elements at once, which can be identified by the agent name, the module name or both. The interface is not complex to use and the easiest thing to do is to try with some elements and see how it works.
+
The most relevant element is the one that allows to create one element per agent, or on the contrary, to create one element per module. That way you can add dozens of elements that represent a complete agent, or an element of an agent, or show all the modules of different agents, creating many elements at once, which can be identified by the agent name, the module name or both. The interface is not difficult to use and the easiest thing to do is try some elements and see how it works.
  
 
==== Creation - Service Wizard ====
 
==== Creation - Service Wizard ====
 
<br>
 
<br>
{{tip|This feature is available in the '''Enterprise''' version of '''Pandora FMS'''.}}
+
{{tip|This feature is only available in the '''Enterprise''' version of '''Pandora FMS'''.}}
  
The services wizard tab contains a small form to create several service type elements at once with just a couple of clicks. The selected services will appear in the visual console automatically placed with the selected icon.
+
The service wizard tab contains a small form to create several service type elements at once with just a couple of clicks. The selected services will appear in the visual console automatically placed with the selected icon.
  
 
<br>
 
<br>
 
<center>
 
<center>
 
[[File:Pandora new visual console, tab services wizard.png]]<br />
 
[[File:Pandora new visual console, tab services wizard.png]]<br />
''Screenshot of the services wizard tab.''
+
''Screenshot of the service wizard tab''
 
</center>
 
</center>
 
<br>
 
<br>
  
==== Creation - List of Elements ====
+
==== Creation - List of elements ====
  
This tab provides a form in rows of the items contained in the visual console you are editing. It's a quick way to edit the various items, and it's a useful tool for users who need to tune into certain item values.
+
This tab provides a form in rows of the items contained in the visual console you are editing. It is a quick way to edit the different items, besides being an useful tool for users who need to tune in certain item values.
  
The actions allowed in this form are: editing (but not changing the element type) and deleting elements (but not creating them). This action must be done in the Editor tab. Each row of this screen will be an element of the VC.
+
The actions allowed in this form are: editing (but not changing the element type) and deleting elements (but not creating them). This action must be done in the Editor tab. Each row of the screen will be an element of the VC.
  
  
 
<center>
 
<center>
 
[[File:Pandora new visual console, tab list elements.png|800px]]<br />
 
[[File:Pandora new visual console, tab list elements.png|800px]]<br />
''List of Elements example in a VC''
+
''Example of what the VS element list looks like''
 
</center>
 
</center>
  
==== Creation and edition of Visual Consoles ====
+
==== Creation and edition of visual consoles ====
  
This section contains most of the functionality of the Visual Console editor, and this is where the elements that make up a VC can be added and modified (except for the background image, which we saw previously).  
+
This section contains most of the feature of the visual console editor, and this is where the elements that make up a VC can be added and modified (except for the background image, seen previously).  
  
At the top left, there are the different elements that we can include in a VC (from left to right):
+
At the top left, there are the different elements that can be included in a VC (from left to right):
  
 
Static image, progress, graph, histogram of events (AutoSLA), raw data, label, statusless icon, group, rectangle, line and service.
 
Static image, progress, graph, histogram of events (AutoSLA), raw data, label, statusless icon, group, rectangle, line and service.
Line 100: Line 104:
 
</center>
 
</center>
  
Let's take a step by step look at the most relevant characteristics of the elements that can compose a VC.
+
The following are the most relevant characteristics of the elements that can make a VC.
 
 
  
 
==== Elements a map can contain ====
 
==== Elements a map can contain ====
Line 114: Line 117:
 
* Yellow, for WARNING status
 
* Yellow, for WARNING status
  
Depending on the status of the module, agent or map, it will show one or another image. In a normal Pandora installation they should be in:
+
Depending on the status of the module, agent or map, it will show one image or another. In a normal Pandora FMS installation they should be in:
  
 
  ./images/console/icons
 
  ./images/console/icons
Line 123: Line 126:
 
<center>
 
<center>
 
[[File:Static image, example.png]]<br />
 
[[File:Static image, example.png]]<br />
''Example of images with name and status.''
+
''Example of images with name and status''
 
</center>
 
</center>
 
<br><br>
 
<br><br>
  
* "": when the agent, module or visual console that it links has no status.
+
* "": When the agent, module or visual console that it links to has no status.
* "Bad":when the agent has a failed module, the module is in failure or the visual console that links contains some element in 'bad'.
+
* "Bad": When the agent has a failing module, the module fails or the visual console that links to contains some element in 'bad'.
* "Ok":when the agent, module or visual console that it links are correct.
+
* "Ok": When the agent, module or visual console that it links to are correct.
* "Warning": when the agent has some module in warning, the module is in warning or the visual console that it links contains some element in warning.
+
* "Warning": When the agent has some module in warning, the module is in warning or the visual console that it links to contains some element in warning.
  
 
A tag can be associated to the static image, or it can be left blank, that tag can be formatted and certain macros can even be added to the text (see below).
 
A tag can be associated to the static image, or it can be left blank, that tag can be formatted and certain macros can even be added to the text (see below).
  
The static image can be associated to a specific module, to a whole agent (so that if it has at least one bad module will go to red and will only go green if all its modules are in normal state). You can also choose whether to enable the last value, not to display it or just hide it for boolean modules (default option). The static image can also be associated with the general status of another visual console (see advanced options at the end of this chapter).
+
The static image can be associated to a specific module, to a whole agent (so that if it has at least one bad module, it will become red and will only become green if all its modules are in normal state). You can also choose whether to enable the last value, not to display it or just hide it for boolean modules (default option). The static image can also be associated to the general status of another visual console (see advanced options at the end of this chapter).
  
 
=====Icon=====
 
=====Icon=====
  
It is very similar to the static image, except that the selected icon will always appear in gray, as if it were in unknown. Often, icons that don't have status information are used, meaning they cannot be used as a static image, but as an icon. A simple image, such as a logo, for example.
+
It is very similar to the static image, except that the selected icon will always appear in gray, as if it were in unknown. Often, icons that do not have status information are used, meaning they cannot be used as a static image, but as an icon. A simple image, such as a logo, for example.
  
'''Icons linking other pages'''
+
'''Icons linking to other pages'''
  
By means of the tag field and in case a complete URL address is entered, the icon can be linked to a web page. For example, to link a visual map icon to the SNMP console viewer, an icon type element must be created that has the full URL of the viewer as a tag field:  
+
By means of the tag field and in case a complete URL address is entered, the icon can be linked to a website. For example, to link a visual map icon to the SNMP console viewer, an icon type element must be created that has the full URL of the viewer as a tag field:  
  
 
  <nowiki>http://</nowiki><pandora_home>/index.php?sec=snmpconsole&sec2=operation/snmpconsole/snmp_view
 
  <nowiki>http://</nowiki><pandora_home>/index.php?sec=snmpconsole&sec2=operation/snmpconsole/snmp_view
  
It can also be useful for linking to another visual console, for example, so that we can build "navigation icons" between our own visual consoles.
+
It can also be useful for linking to another visual console, for example, so that you can build "navigation icons" between our own visual consoles.
  
 
=====Progress=====
 
=====Progress=====
Line 154: Line 157:
 
<center>
 
<center>
 
[[File:Pandora new visual console, Percentile bar.png]]<br />
 
[[File:Pandora new visual console, Percentile bar.png]]<br />
''Example of an element of type Percentage bar, in this example the result of a module that monitors the CPU is shown.''
+
''Example of an element of Percentage bar type. In this example, the result of a module that monitors the CPU is shown''
 
</center>
 
</center>
  
  
'''Options of the percentile'''
+
'''Options of the percentile item'''
  
The percentage bar has far fewer controls than the rest of the elements, but it has two controls that we will explain:
+
The percentage bar has far fewer controls than the rest of the elements, but it has two controls that will be explained:
  
* '''Width''': which will be the width in pixels of the selected element (stick, ball, doughnut/circular).
+
* '''Width''': It will be the width in pixels of the selected element (stick, ball, doughnut/circular).
* '''Max value''': is the maximum value that the module can have to represent. So it is interesting that you examine the module to be monitored well to see what is the maximum value, for example, in the case of the screenshot is the CPU module that goes from 0 to 100.
+
* '''Max value''': It is the maximum value that the module can possibly represent. So it is interesting that you examine the module to be monitored well to see what the maximum value is, for example, in the case of the screenshot it is the CPU module that goes from 0 to 100.
 
* '''Type''': The type will allow you to define how to represent the element graphically (bar, ball, doughnut, etc.).
 
* '''Type''': The type will allow you to define how to represent the element graphically (bar, ball, doughnut, etc.).
  
 
=====Module graph=====
 
=====Module graph=====
  
Displays a graph in real time. It can be a graph of an ordinary data module, a combined graph or one of the graphs that obtain its value in tabular form, which can be of various types.
+
It displays a graph in real time. It can be a graph of an ordinary data module, a combined graph or one of the graphs that obtain its value in tabular form, which can belong to several types.
  
 
'''Options of a module graph'''
 
'''Options of a module graph'''
  
In the graph it is necessary to define the width and height, so it is no longer hidden in the advanced options to be displayed.
+
In the graph, it is necessary to define the width and height, so it is no longer hidden in the advanced options to be displayed.
  
* '''Interval''': the range of data that will display the graph from the current moment backwards, e. g. 1 day.
+
* '''Interval''': The data range that the graph will display from the current moment backwards, e. g. 1 day.
* '''Size''': width and height of the image that the graphic will occupy on screen and the figures of the axes.
+
* '''Size''': Width and height of the image that the graphic will take on screen and the figures of the axes.
* '''Background color''': White, black or transparent. This allows us to better fit it visually to our VC.
+
* '''Background color''': White, black or transparent. This allows to make it fit visually with your VC.
* '''Type''': allows us to choose the type: module graph, combined graph or tabular graph.
+
* '''Type''': It allows you to choose the type: module graph, combined graph or tabular graph.
* '''Agente/Modulo''': if you have chosen a graph associated with a data series.
+
* '''Agent/Module''': If you have chosen a graph associated with a data series.
  
 
Graphs are not "previewed" in edit mode, so a white box is displayed instead.  
 
Graphs are not "previewed" in edit mode, so a white box is displayed instead.  
Line 191: Line 194:
 
''Example of user view for that same VC''
 
''Example of user view for that same VC''
 
</center>
 
</center>
 
  
 
===== Pie and bars serialized graphs =====
 
===== Pie and bars serialized graphs =====
  
These two elements of the visual console allow complex pie graphs or vertical/horizontal bars to be incorporated into a visual console. Unlike a combined graph of the "pie" or "bars"type, these serialized graphs incorporate data from a single module, with a special format. We can only incorporate data from a "Text" module that contains series of data in the following format:
+
These two elements of the visual console allow to add complex pie or vertical/horizontal bars graphs to a visual console. Unlike a combined graph of the "pie" or "bars" type, these serialized graphs incorporate data from a single module, with a special format. Only a "Text" module that contains series of data in the following format can be added:
  
 
<pre>
 
<pre>
Line 205: Line 207:
 
</pre>
 
</pre>
  
Up to a maximum of six elements. To create a module with this data it is recommended to do it with an agent plugin. This would be an example of a Linux local plugin that generates an XML for such a module. In this case we are using the REST API of Integria IMS to obtain data of the open incidents, separated by status:
+
Up to a maximum of six elements. To create a module with this data, it is recommended to do it with an agent plugin. This would be an example of a Linux local plugin that generates an XML for such a module. In this case the REST API of Integria IMS is used to retrieve data from open incidents, separated by status:
  
 
<pre>
 
<pre>
Line 211: Line 213:
  
 
#NEW
 
#NEW
echo New,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,1"` > /tmp/soporte2.tmp
+
echo New,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,1"` > /tmp/support2.tmp
  
 
#UNCONFIRMED
 
#UNCONFIRMED
echo Unconfirmed,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,2"` >> /tmp/soporte2.tmp
+
echo Unconfirmed,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,2"` >> /tmp/support2.tmp
  
 
#ASSIGNED
 
#ASSIGNED
echo Assigned,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,3"` >> /tmp/soporte2.tmp
+
echo Assigned,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,3"` >> /tmp/support2.tmp
  
 
#REOPENED
 
#REOPENED
echo ReOpened,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,4"` >> /tmp/soporte2.tmp
+
echo ReOpened,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,4"` >> /tmp/support2.tmp
  
 
#MOVED TO DEVELOPMENT
 
#MOVED TO DEVELOPMENT
echo Developing,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,5"` >> /tmp/soporte2.tmp
+
echo Developing,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,5"` >> /tmp/support2.tmp
  
 
#PENDING:
 
#PENDING:
echo Pending,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,6"` >> /tmp/soporte2.tmp
+
echo Pending,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,6"` >> /tmp/support2.tmp
  
 
echo "<module>"
 
echo "<module>"
 
echo "<name>Support_Status</name>"
 
echo "<name>Support_Status</name>"
 
echo "<type>generic_data_string</type>"
 
echo "<type>generic_data_string</type>"
echo "<data><![CDATA[`cat /tmp/soporte2.tmp| tr -d ' '`]]></data>"
+
echo "<data><![CDATA[`cat /tmp/support2.tmp| tr -d ' '`]]></data>"
 
echo "</module>"
 
echo "</module>"
 
</pre>
 
</pre>
Line 239: Line 241:
 
<pre>
 
<pre>
 
<module>
 
<module>
<name>Soporte_Estados</name>
+
<name>Support_Status</name>
 
<type>generic_data_string</type>
 
<type>generic_data_string</type>
 
<data><![CDATA[New,0
 
<data><![CDATA[New,0
Line 250: Line 252:
 
</pre>
 
</pre>
  
Which will show a graph like this one when interpreted (in the case of a pie graph type):
+
That will show a graph like this one when interpreted (in the case of a pie graph type):
  
 
<center>
 
<center>
Line 264: Line 266:
 
=====Simple value=====
 
=====Simple value=====
  
This element allows the visual console to show the value of a module in real time. You only need to define a label (optional), and choose the agent and the module. To replace the value you must use the macro (_VALUE_). Several examples can be seen in the previous section.
+
This element allows the visual console to show the value of a module in real time. Just define a label (optional), and choose the agent and module. To replace the value, use the macro (_VALUE_). Several examples can be seen in the screenshot from the previous section.
  
 
'''Image-type data'''.  
 
'''Image-type data'''.  
Line 273: Line 275:
 
[[File:Data image vconsole.png]]<br />
 
[[File:Data image vconsole.png]]<br />
 
''Screenshot showing editor creating a single-value item with base64 content.''
 
''Screenshot showing editor creating a single-value item with base64 content.''
</center>
 
 
<center>
 
[[File:Data image vconsole 2.png]]<br />
 
''Screenshot of an error collected as single value in base64, displayed as an image.''
 
 
</center>
 
</center>
  
 
=====Event Histogram/AutoSLA=====
 
=====Event Histogram/AutoSLA=====
  
Displays a horizontal bar, similar to the main agent view, where events that have occurred in the last 24hrs are shown for an agent or an agent/module combination.
+
It displays a horizontal bar, similar to the main agent view, where events that took place in the last 24hrs for an agent or an agent/module combination are shown.
  
 
<center>
 
<center>
 
[[File:autosla_o2017.jpg]]<br />
 
[[File:autosla_o2017.jpg]]<br />
''Display example of an autosla with several elements''
+
''Display example of an autoSLA with several elements''
 
</center>
 
</center>
  
Line 295: Line 292:
 
=====Text Tag=====
 
=====Text Tag=====
  
This type of item can be used to create a text label without associated content. Contains text and HTML code (which can create an internal link or other advanced options).
+
This type of item can be used to create a text tag without associated content. It contains text and HTML code (which can create an internal link or other advanced options).
  
 
=====Group=====
 
=====Group=====
Line 306: Line 303:
 
=====Boxes and lines=====
 
=====Boxes and lines=====
  
If you can't "customize" a background image, this is a simple but effective way to "customize" the look of your console, adding boxes of different colors and shapes to order and enhance the look of your visual console.
+
If you cannot "customize" a background image, this is a simple but effective way to "customize" the appearance of your console, adding boxes of different colors and shapes to order and enhance the look of your visual console.
  
 
=====Clocks=====
 
=====Clocks=====
  
This item allows you to add to your visual console a dynamic clock, both analog and digital of any time zone, showing and updating the exact time at all times without having to reload the page.
+
This item allows you to add to your visual console a dynamic clock, both analog and digital of any time zone, showing and updating the exact time at all times without having to refresh the page.
  
 
[[File:reloj1.png]]<br />
 
[[File:reloj1.png]]<br />
Line 316: Line 313:
 
[[File:reloj2.png]]<br />
 
[[File:reloj2.png]]<br />
  
=====Color cloud=====
+
=====Heat map / Color cloud=====
  
This element allows the representation of colored blurred clouds that depend on the value of the assigned module.
+
This element allows representing colored blurred clouds that depend on the value of the assigned module. This is commonly called "heat map".
  
 
<center>
 
<center>
 
[[File:color-cloud-settings.png]]<br>
 
[[File:color-cloud-settings.png]]<br>
''Edit view of the element''.
+
''Element edit view''.
 
</center>
 
</center>
  
 
<br>
 
<br>
  
The configuration allows you to create ranges of values (for now only numerical). When the value of the selected module is between the values (including limits) of a range, the chosen color of that range will be used for the element. If no range is met, the default color will be used.
+
The configuration allows to create ranges of values (for now only numerical). When the value of the selected module is between the range values (including limits), the chosen color for that range will be used for the element. If no range is reached, the default color will be used.
  
 
<center>
 
<center>
Line 336: Line 333:
 
<br>
 
<br>
  
===== Avdanced Options of each Element =====
+
===== Avdanced options of each element =====
  
 
====== Position ======
 
====== Position ======
  
By default the position is 0x0, where the first digit is the X axis and the second digit is the Y axis. These values are in pixels, and note that the axis is defined in such a way that on the Y axis it is inverted, where the upper part is 0 and grows downwards. The X axis is defined in the classical form, i. e. it starts at the left edge and grows to the right. This position is automatically changed by clicking and dragging an item.
+
The default position is 0x0, where the first digit is the X axis and the second digit is the Y axis. These values are in pixels, and note that the axis is defined in such a way that on the Y axis it is inverted, where the upper part is 0 and it grows downwards. The X axis is defined in the classical form, i. e. it starts at the left side and grows to the right. This position is automatically changed by clicking and dragging an item.
  
 
====== Parent ======
 
====== Parent ======
Line 348: Line 345:
 
====== Associated Map ======
 
====== Associated Map ======
  
Several elements can be used to "summarize" the status of another visual console. In this way, the status of the icon (Green, Yellow or Red) is shown using the status of the linked console. It is also possible to activate a link from the element to the visual console.
+
Several elements can be used to "summarize" the status of another visual console. That way, the status of the icon (Green, Yellow or Red) is shown using the status of the linked console. It is also possible to activate an element link to the visual console.
  
 
''' Ways to calculate the status of the linked visual console '''
 
''' Ways to calculate the status of the linked visual console '''
Line 358: Line 355:
 
* By weight
 
* By weight
  
: It calculates the status of the elements that have a visual console, a module or an agent assigned in relation to a percentage of elements configured by the user. This percentage is the one that has to exceed the number of elements of a non-normal status with respect to the number of elements taken into account in the calculation for that status to change.
+
: It calculates the status of the elements that have a visual console, a module or an agent assigned in relation to a percentage of elements configured by the user. This percentage is the one that must exceed the number of elements of a non-normal status regarding the number of elements taken into account for the calculation for that status to change.
  
: For example, given an element with a percentage of 50% and a visual console linked with 5 elements:
+
: For example, given an element with a percentage of 50% and a visual console linked to 5 elements:
  
 
:- 1 ''critical'', 1 ''warning'' and 3 ''normal''  ->  Status ''normal''.
 
:- 1 ''critical'', 1 ''warning'' and 3 ''normal''  ->  Status ''normal''.
Line 368: Line 365:
 
:- 1 ''critical'', 1 ''warning'' and 3 ''unknown'' ->  Status ''unknown''.
 
:- 1 ''critical'', 1 ''warning'' and 3 ''unknown'' ->  Status ''unknown''.
  
: If several statuses exceed the weight, the priority is the same as in the rest of the status calculation (''critical'' > ''warning'' > ''unknown''). If there are no elements to perform the calculation, the status becomes ''unknown''.
+
: If several status exceed the weight, the priority is the same as in the rest of the status calculation (''critical'' > ''warning'' > ''unknown''). If there are no elements to perform the calculation, the status becomes ''unknown''.
  
 
* By critical elements
 
* By critical elements
  
: It calculates the status using the elements in ''critical'' status and the percentages of the thresholds defined by the user. If the number of elements in ''critical'' status with respect to the number of elements taken into account in the calculation exceeds the percentage assigned as ''warning'', the status becomes ''warning''. The same applies to the percentage assigned as ''critical'', which also has preference.
+
: It calculates the status using the elements in critical status and the percentages of the thresholds defined by the user. If the number of elements in critical status regarding the number of elements taken into account in the calculation exceeds the percentage assigned as warning, the status becomes warning. The same applies to the percentage assigned as critical, which also has preference.
  
 
<center>
 
<center>
Line 378: Line 375:
 
</center>
 
</center>
  
From the Pandora FMS 727 version we can make massive changes in this section. To do it, we must go to ''Extensions -> Visual Console Manager''. Here we must choose the visual map, the elements of the map and the type of status calculation that we want to change.
+
From Pandora FMS 727 version you can make massive changes in this section. To do it, go to ''Extensions > Visual Console Manager''. Once there, choose the visual map, the elements of the map and the type of status calculation you want to change.
  
 
<center>
 
<center>
Line 386: Line 383:
 
====== Restricted access to a group ======
 
====== Restricted access to a group ======
  
Selecting one will restrict the display of this item in the Visual Console for those users who don't have reading permissions over the group in question.  
+
Selecting one will restrict the display of this item in the visual console for those users who do not have reading permissions over said group.  
  
 
It will also be taken into account when calculating the status weight in a linked console: it will only be calculated on the elements that the user can see.
 
It will also be taken into account when calculating the status weight in a linked console: it will only be calculated on the elements that the user can see.
Line 392: Line 389:
 
=== Sharing a Visual Console ===
 
=== Sharing a Visual Console ===
  
It is possible to share a visual map with anyone, even if you don't have a username/password to enter Pandora. You can share the visual console with any user, simply by providing access via a public URL. To do this, from the console view, access the "share" tab (the camera icon at the top right), as shown in this screenshot:
+
It is possible to share a visual map with anyone, even if you do not have a username/password to log in Pandora FMS. You can share the visual console with any user, simply by providing access through a public URL. To do this, from the console view, access the "share" tab (the camera icon at the top right), as shown in this screenshot:
  
 
<center><Br><br>
 
<center><Br><br>
Line 398: Line 395:
 
</center><Br><br>
 
</center><Br><br>
  
This is a static URL and looks like this:
+
This is a static URL and it looks like this:
  
  http://192.168.50.2/operation/visual_console/public_console.php?hash=86d1d0e9b6f41c2e3e04c5a6ad37136b&id_layout=3&id_user=admin2
+
  <nowiki>http://192.168.50.2/operation/visual_console/public_console.php?hash=86d1d0e9b6f41c2e3e04c5a6ad37136b&id_layout=3&id_user=admin2</nowiki>
  
Share that URL with anyone, and you'll be able to access the information displayed in the Visual Console. The user will not be able to access from there any of the links or information of any agent, only the information published in the visual console.
+
Share that URL with anyone so that they may access the information displayed in the visual console. The user will not be able to access from there any of the links or information of any agent, only the information published in the visual console.
''This is an excellent way share data with anonymous users''
+
''This is an excellent way to share data with anonymous users''
  
 
=== Macros in Visual Consoles ===
 
=== Macros in Visual Consoles ===
  
From version 7.712 it is possible to use keywords or "macros" that act dynamically, so when entering a macro in the text box when editing an element of the visual console, this macro will be replaced in the view mode by the data obtained from the functionality of that macro.
+
From version 712 onwards, it is possible to use keywords or "macros" that work dynamically, so when entering a macro in the text box when editing an element of the visual console, this macro will be replaced in the view mode by the data obtained from the feature of that macro.
  
 
<br>
 
<br>
Line 413: Line 410:
 
List of visual maps' macros:
 
List of visual maps' macros:
  
_date_: Displays the date using the local PHP format. <br />
+
_date_: It displays the date using the local PHP format. <br />
_time_: Displays the time using the local PHP format. <br />
+
_time_: It displays the time using the local PHP format. <br />
_agent_: Displays the alias of the selected agent. <br />
+
_agent_: It displays the alias of the selected agent. <br />
_module_: Displays the name of the selected module. <br />
+
_module_: It displays the name of the selected module. <br />
_agentdescription_: Displays the description of the selected agent. <br />
+
_agentdescription_: It displays the description of the selected agent. <br />
_address_: Displays the ip address of the selected agent. <br />
+
_address_: It displays the ip address of the selected agent. <br />
_description_moduledescription_: Displays the description of the selected module. <br />
+
_description_moduledescription_: It displays the description of the selected module. <br />
  
 
<center><br>
 
<center><br>
Line 425: Line 422:
 
</center><br>
 
</center><br>
  
=== Full Screen View ===
+
=== Full screen view ===
  
One of the most important features of visual consoles is to allow automatic refresh and full-screen display. This has its most obvious application in large information panels. There is a control that allows you to define how often you want the screen to refresh. If you activate the "full screen" mode of a visual console, you will see the refresh time at the top on the right.
+
One of the most important features of visual consoles is to allow automatic refresh and full-screen display. Its most obvious application is in large information panels. There is a control that allows you to define how often you want the screen to be refreshed. If you activate the "full screen" mode of a visual console, you will see the refresh time at the top on the right.
  
 
<center>
 
<center>
Line 433: Line 430:
 
</center>
 
</center>
  
There is a similar functionality in dashboards, but they also allow you to rotate these screens, be it visual consoles or other types of dashboards. You'll see it in the chapter about dashboards.
+
There is a similar feature in dashboards, but they also allow you to rotate these screens, be it visual consoles or other types of dashboards. The chapter about dashboards provides further discussion about this topic.
  
 
=== Complete example of linked visual console ===
 
=== Complete example of linked visual console ===
Line 440: Line 437:
  
 
Chip Company is a company that sells computers over the Internet. Chip Company has three large departments:
 
Chip Company is a company that sells computers over the Internet. Chip Company has three large departments:
* Online shop,
+
* Online shop.
* Support,
+
* Support.
 
* Management.
 
* Management.
  
Line 450: Line 447:
 
As you can see, there are three services offered to the customer: Online Shop, Support and, indirectly, Management. All services are critical to the business because if one fails, others can be affected, and the company could lose a lot of money, even customers.
 
As you can see, there are three services offered to the customer: Online Shop, Support and, indirectly, Management. All services are critical to the business because if one fails, others can be affected, and the company could lose a lot of money, even customers.
  
In the end, in essence, what we want to know is whether we are fulfilling our customers' needs, because, as you know, a satisfied customer can mean more customers. That's why providing stable, quality service is so important.
+
In the end, essentially, what you want to know is whether you are fulfilling your customers' needs, since a satisfied customer can lead to more customers. That is why providing stable, quality service is so important.
  
To monitor Chip Company's services we need to know more about each of them.
+
To monitor Chip Company's services, it is necessary to know more about each one of them.
  
 
The <b>Online Shop</b> service is responsible for ensuring that the store's website is online, that all product prices are correct, managing product categories, and so on. In general, make sure that all information about products and payment methods is correct on the website to facilitate the purchase process.
 
The <b>Online Shop</b> service is responsible for ensuring that the store's website is online, that all product prices are correct, managing product categories, and so on. In general, make sure that all information about products and payment methods is correct on the website to facilitate the purchase process.
Line 462: Line 459:
 
</center><br><br>
 
</center><br><br>
  
The <b>Support</b> service has to resolve all possible queries that may arise to consumers with the equipment they have purchased. Some of the tasks of this department include: helping customers configure their configurations, managing computer replacements and parts, and managing equipment returns.  
+
The <b>Support</b> service must answer all possible questions that customers may ask about the equipment they purchased. Some of the tasks of this department include: helping customers with their configurations, managing computer replacements and replacement pieces, and managing equipment returns.  
  
This service, like the Online Shop, is directly related to the customer, so both are very important for the image of the company from the customer's point of view.
+
This service, like the Online Shop, is directly related with the customer, so both are very important for the image of the company from the customer's point of view.
  
From this department you want to monitor the following parameters:
+
From this department, the following parameters should be monitored:
  
 
<center><br><br>
 
<center><br><br>
Line 472: Line 469:
 
</center><br><br>
 
</center><br><br>
  
The third service is that of <b>Management</b> which includes the departments of: Marketing, Commercial, Human Resources and others related to management. Their main task is to ensure that all internal company processes function properly. The services offered by this department are crucial as they coordinate the other departments.  
+
The third service is that of <b>Management</b> which includes the departments of: Marketing, Sales, Human Resources and others related to management. Their main task is to ensure that all internal company processes work properly. The services offered by this department are essential as they coordinate the other departments.  
  
 
The most important parameters of the Management service are:
 
The most important parameters of the Management service are:
Line 480: Line 477:
 
</center><br><br>
 
</center><br><br>
  
To represent these services we can link several maps with the help of the <b>Visual Console of Pandora FMS</b> and the images that describe the hierarchy of Chip Company.
+
To represent these services, you may link several maps with the help of the <b>Pandora FMS visual console</b> and the images that describe the hierarchy of Chip Company.
  
The data from these maps are calculated in real time, so we will always know the status of the services at all times. The first thing we did was map each service independently.
+
The data from these maps are calculated in real time, so you will always know the status of the services at all times. The first thing to do was map each service independently.
  
The following image shows a visual console that simulates the Online Store service map with the status of all its parameters. As you can see the parameter '''Updated Content''' has a red dot which means that it has a problem. On the other parameters we can say that they are correct because they have green dots. The back arrow is used to go to the general map below.
+
The following image shows a visual console that simulates the Online Store service map with the status of all its parameters. As you may see, the parameter '''Updated Content''' has a red exclamation mark which means that there is something wrong. Regarding the other parameters, they are correct because they have green checks. The back arrow is used to go to the general map below.
  
 
<center><br><br>
 
<center><br><br>
Line 490: Line 487:
 
</center><br><br>
 
</center><br><br>
  
If you want to know more about the problem, you can click on the red dot and you will see the technical view with which you can know more about the problem. This technical view shows the data collected by Pandora FMS from sources such as: CRM, ERP, SAP, Databases (MySQL, Oracle, etc), including devices such as PC, servers or routers.
+
If you want to know more about the problem, you can click on the red exclamation mark and you will see the technical view to find out more about the problem. This technical view shows the data collected by Pandora FMS from sources such as: CRM, ERP, SAP, Databases (MySQL, Oracle, etc), including devices such as PC, servers or routers.
  
 
<center><br><br>
 
<center><br><br>
Line 497: Line 494:
 
<br><br>
 
<br><br>
  
We also made other maps for the Support service you can see in the image below. As you can see all the important parameters of the Support service are correct as they all have green dots.
+
There are also other maps for the Support service you can see in the image below. As you can see, all the important parameters of the Support service are correct as they all have green checks.
  
 
<center><br><br>
 
<center><br><br>
Line 503: Line 500:
 
</center><br><br>
 
</center><br><br>
  
To finish with the service maps we created a map for the Management service, which you can see in the following image. Again the map shows the most important parameters with their corresponding points, in this case all the points are green which means that all the parameters of the service are correct.
+
Finally, with the service maps a map for the Management service is created, which you can see in the following image. Again the map shows the most important parameters with their corresponding points, in this case all have green checks which means that all the parameters of the service are correct.
  
 
<center><br><br>
 
<center><br><br>
Line 509: Line 506:
 
</center><br><br>
 
</center><br><br>
  
In addition, we created a general map with all Chip Company services as shown in the following image. On this map you can see Chip Company's service hierarchy with the states of each state. If you click on one of the status reporting points you will see the specific map of each service. With all these maps we have created a complete navigable view of Chip Company's services. The status of each service is the same as shown on the specific maps of each service, as you can see Management and Support are correct, but Online Shop has problems. As you can see, the state of services is scaling within the hierarchy to the top, propagating the state.
+
In addition, a general map with all Chip Company services has been created as shown in the following image. On this map you can see Chip Company's service hierarchy with the states of each state. If you click on one of the status reporting points you will see the specific map of each service. All these maps provide a complete navigable view of Chip Company's services. The status of each service is the same as shown on the specific maps of each service. As you can see, Management and Support are correct, but Online Shop has problems. '''As you can see, the state of services climbs positions within the hierarchy to the top, spreading out the state.'''
  
 
<center><br><br>
 
<center><br><br>
Line 519: Line 516:
 
The options of favorite visual consoles allow you to have shortcuts from the menu bar or to access to a list of visual consoles marked as favorites.
 
The options of favorite visual consoles allow you to have shortcuts from the menu bar or to access to a list of visual consoles marked as favorites.
  
To mark a visual console as a favorite, we must mark the favorite visual console checkbox when creating or editing it in its main editing section:
+
To mark a visual console as a favorite, check the favorite visual console checkbox when creating or editing it in its main editing section:
  
 
[[Image:consola_favo_01.png|center]]
 
[[Image:consola_favo_01.png|center]]
  
To modify the options of favorite visual consoles we have to access to the Setup section -> Visual Styles from the sidebar menu.
+
To modify the options of favorite visual consoles, access the Setup > Visual Styles from the sidebar menu.
  
 
[[Image:consola_favo_style.png|center]]
 
[[Image:consola_favo_style.png|center]]
  
* Type of view of the visual consoles:The section of visual consoles by default will be the complete list of visual consoles or only the favorite ones
+
* View type of visual consoles: The section of visual consoles by default will be the complete list of visual consoles or just the favorite ones.
* Number of visual consoles to be displayed in the menu: Number of visual consoles to be displayed in the sidebar menu.
+
* Number of visual consoles to be displayed on the menu: Number of visual consoles to be displayed on the sidebar menu.
  
In case of entering a number in the number field of favorite visual consoles, then these will be displayed in such a way:
+
In case of entering a number in the number field of favorite visual consoles, then these will be displayed like this:
  
 
[[Image:Consola_favorito_2.png|center]]
 
[[Image:Consola_favorito_2.png|center]]
Line 538: Line 535:
 
[[Image:consola_favorito_4.png|center]]
 
[[Image:consola_favorito_4.png|center]]
  
Single section of the favorite visual consoles:
+
Section of favorite visual consoles:
  
 
[[Image:consola_favorito_3.png|center]]
 
[[Image:consola_favorito_3.png|center]]
Line 544: Line 541:
 
=== Visual Console Templates ===
 
=== Visual Console Templates ===
  
The main idea is to be able to select a visual console that we have already made, and export it to be used as a template, keeping all the elements of the visual console.
+
In this section, you my see the templates of created visual consoles, as well as create new templates.
 +
 
 +
To create a new template, all you have to do is choose a created visual console, a representative name and the group and a new template will be created.
  
To create a visual console template, in the templates section there is a form in which we must select an existing visual console from which we want to create the template, we can enter the name of the template and choose a group to which the template will be applied:
 
  
 
[[Image:Example_CV_3.png|center]]
 
[[Image:Example_CV_3.png|center]]
  
Once the template is created, we can apply it to as many agents as we want. A visual console will be created for each agent selected. To do this, we select the template. Then we choose a name. If we leave it blank it will be generated with a default name composed by the template name and the agent name. It must be borne in mind that the names of the modules of these agents must coincide with those of the template.
+
=== Visual console wizard ===
  
We select the agents on which we want to apply the template:
+
The visual console template wizard is used to use one of the previously created templates to apply to a new visual console. Choose the agents to which you want to apply the selected template. As many visual consoles will be created as agents have been chosen.
  
{{Tip|After creating the template, if you want to make any changes, you must make them on the chosen visual console and re-create the template.}}
+
{{Tip|After creating the template, if you want to make any changes, make them on the chosen visual console and re-create the template.}}
  
 
[[Image:Example_CV_4.png|center]]
 
[[Image:Example_CV_4.png|center]]
  
Once you have applied our template, you will create the visual consoles which will appear in your list.
+
Once you have applied the template, create the visual consoles, which will appear on your list.
 
 
If the template is created through a favorite visual console, all visual consoles created from this template will also be favorites:
 
 
 
[[Image:Example_CV_5.png|center]]
 
 
 
In order to make the use of templates more dynamic, we can add macros to the labels of the elements of the visual consoles: _agent_ and _agentalias_ replacing them with the name and alias of the agent.
 
 
 
Example of template creation:
 
 
 
We create a visual console with two simple graphic elements, in which we select an agent and a module. In this case, as a label we add a macro with the agent name.
 
 
[[Image:Example_CV_1.png|center]]
 
 
 
In the following image we see the result:
 
 
 
[[Image:Example_CV_2.png|center]]
 
 
 
We will create a template using this visual console as a base.
 
 
 
[[Image:Example_CV_3.png|center]]
 
 
 
We have already created the template and now we can apply it through the template wizard. To do this, we select the template. Then we choose a name. If we leave it blank it will be generated with a default name composed by the template name and the agent name. It must be borne in mind that the names of the modules of these agents must coincide with those of the template.
 
 
 
[[Image:Example_CV_4.png|center]]
 
  
If we go to the list of visual consoles we can see that the new visual consoles created through the template appear.
+
If the template is created through a favorite visual console, all visual consoles created from this template will also be favorite.
  
[[Image:Example_CV_5.png|center]]
 
  
Select a visual console from the list to check the result:
 
  
[[Image:Example_CV_6.png|center]]
+
In order to make the use of templates more dynamic, add macros to the labels of the elements of the visual consoles: _agent_ and _agentalias_ replacing them with the name and alias of the agent.
  
 
[[Pandora:Documentation|Go back to Pandora FMS documentation index]]
 
[[Pandora:Documentation|Go back to Pandora FMS documentation index]]
  
 
[[Category:Pandora FMS]]
 
[[Category:Pandora FMS]]

Latest revision as of 12:25, 14 January 2020

Go back to Pandora FMS documentation index


1 Visual Consoles

1.1 Introduction

Pandora FMS allows to build visual maps where each user defines their own way to visually represent the monitoring. The Visual Console editor allows the user, by dragging elements with the mouse, to visually design the final aspect, choosing the background and icons that represent the status of each relevant aspect you want to display. With Pandora comes a series of icons, but the user can easily customize their own. Different visual consoles can interact with each other, viewing in a hierarchical way the status of maps that are "under" a superior map, being able to abstract that way the monitoring, and viewing at high level a whole series of elements.

These are real-life examples of visual consoles, as seen on a 40"screen:

Vc sample1.jpg

Vc sample2.jpg

Vc sample3.jpg

1.2 Creation and access to visual consoles

To work with a visual map, go to Topology Maps > Visual console. A list appears with all created maps. To create a new one, click on "Create". On the list you can edit a map, delete it or "clone" an existing one to modify it.

Maps whose names begin with the characters "_", "," , "[" o "(" will be displayed in the left menu in the Visual Console submenu. This allows you to create a kind of quick view from the menu. Keep it in mind when naming your visual console.

Pre54 new.png

For large environments where there are multiple visual consoles, a filter option has been created by searching for free text, by group and with recursion of secondary groups and subgroups.

1.2.1 Creating a visual console

The editor's organization is made up by several tabs: The "Main data" tab, which contains visual console general data, the display tab, several wizards, a full screen view access, a link to share the visual console with a third party through a URL, a list of elements contained in the visual console and of course, the visual editor with which to build and edit the console:

Vc tabs o2017.jpg

1.2.2 Creation - General data

Here you can edit and create the basic data of the visual console. It will be the only visible one to a new map until it is saved. The basic values it contains are: visual console name, ACL management group, and background image, which can be resized regardless of the size of the image. The background color is important, because if the screen where the visual console is displayed is larger than the background image, it will fill in the rest with the background color selected here.

The background images are located in the Pandora FMS console directory, inside the directory:

./images/console/backgrounds/

You can upload your own images through the file manager that Pandora FMS has integrated (Admin tools > File manager).

Visual Console Access Permissions

Visual Console ACLs imply that anyone who has visual console reading permission, because they have access to the group with the Visual Console (VR) flag, will see all the contents of the VC, even if there are elements of another group in it.

Visual console edit1.jpg

1.2.3 Creation - Wizard

The wizard allows you to add elements to the VC quickly and conveniently. You can create different types of elements, and it is recommended that before creating many elements you use it with only a couple of them, so that you do not have any troubles later on when deleting the elements (although if you make a mistake it might be faster to delete the entire VC).

The most relevant element is the one that allows to create one element per agent, or on the contrary, to create one element per module. That way you can add dozens of elements that represent a complete agent, or an element of an agent, or show all the modules of different agents, creating many elements at once, which can be identified by the agent name, the module name or both. The interface is not difficult to use and the easiest thing to do is try some elements and see how it works.

1.2.4 Creation - Service Wizard


Info.png

This feature is only available in the Enterprise version of Pandora FMS.

 


The service wizard tab contains a small form to create several service type elements at once with just a couple of clicks. The selected services will appear in the visual console automatically placed with the selected icon.


Pandora new visual console, tab services wizard.png
Screenshot of the service wizard tab


1.2.5 Creation - List of elements

This tab provides a form in rows of the items contained in the visual console you are editing. It is a quick way to edit the different items, besides being an useful tool for users who need to tune in certain item values.

The actions allowed in this form are: editing (but not changing the element type) and deleting elements (but not creating them). This action must be done in the Editor tab. Each row of the screen will be an element of the VC.


Pandora new visual console, tab list elements.png
Example of what the VS element list looks like

1.2.6 Creation and edition of visual consoles

This section contains most of the feature of the visual console editor, and this is where the elements that make up a VC can be added and modified (except for the background image, seen previously).

At the top left, there are the different elements that can be included in a VC (from left to right):

Static image, progress, graph, histogram of events (AutoSLA), raw data, label, statusless icon, group, rectangle, line and service.

Vc o2017 izq.jpg

At the top right, the actions you can perform with an existing element: duplicate, delete, edit or activate a grid where you can "force" the placement of all elements.

Vc o2017 drcha.jpg

The following are the most relevant characteristics of the elements that can make a VC.

1.2.7 Elements a map can contain

1.2.7.1 Static Image

This item displays a static image that will be displayed in four possible colors:

  • Gay, for UNKNOWN status
  • Green, for normal status (OK)
  • Red, for CRITICAL status
  • Yellow, for WARNING status

Depending on the status of the module, agent or map, it will show one image or another. In a normal Pandora FMS installation they should be in:

./images/console/icons

And these files use a special nomenclature for these images: <name_image>_<status>.png where the status can be:

Static image, example.png
Example of images with name and status



  • "": When the agent, module or visual console that it links to has no status.
  • "Bad": When the agent has a failing module, the module fails or the visual console that links to contains some element in 'bad'.
  • "Ok": When the agent, module or visual console that it links to are correct.
  • "Warning": When the agent has some module in warning, the module is in warning or the visual console that it links to contains some element in warning.

A tag can be associated to the static image, or it can be left blank, that tag can be formatted and certain macros can even be added to the text (see below).

The static image can be associated to a specific module, to a whole agent (so that if it has at least one bad module, it will become red and will only become green if all its modules are in normal state). You can also choose whether to enable the last value, not to display it or just hide it for boolean modules (default option). The static image can also be associated to the general status of another visual console (see advanced options at the end of this chapter).

1.2.7.2 Icon

It is very similar to the static image, except that the selected icon will always appear in gray, as if it were in unknown. Often, icons that do not have status information are used, meaning they cannot be used as a static image, but as an icon. A simple image, such as a logo, for example.

Icons linking to other pages

By means of the tag field and in case a complete URL address is entered, the icon can be linked to a website. For example, to link a visual map icon to the SNMP console viewer, an icon type element must be created that has the full URL of the viewer as a tag field:

http://<pandora_home>/index.php?sec=snmpconsole&sec2=operation/snmpconsole/snmp_view

It can also be useful for linking to another visual console, for example, so that you can build "navigation icons" between our own visual consoles.

1.2.7.3 Progress

Progress type items allow us to see the status of a module in a very graphic and descriptive way. They can be progress bar, ball, donut or full doughnut type graphics.

Pandora new visual console, Percentile bar.png
Example of an element of Percentage bar type. In this example, the result of a module that monitors the CPU is shown


Options of the percentile item

The percentage bar has far fewer controls than the rest of the elements, but it has two controls that will be explained:

  • Width: It will be the width in pixels of the selected element (stick, ball, doughnut/circular).
  • Max value: It is the maximum value that the module can possibly represent. So it is interesting that you examine the module to be monitored well to see what the maximum value is, for example, in the case of the screenshot it is the CPU module that goes from 0 to 100.
  • Type: The type will allow you to define how to represent the element graphically (bar, ball, doughnut, etc.).
1.2.7.4 Module graph

It displays a graph in real time. It can be a graph of an ordinary data module, a combined graph or one of the graphs that obtain its value in tabular form, which can belong to several types.

Options of a module graph

In the graph, it is necessary to define the width and height, so it is no longer hidden in the advanced options to be displayed.

  • Interval: The data range that the graph will display from the current moment backwards, e. g. 1 day.
  • Size: Width and height of the image that the graphic will take on screen and the figures of the axes.
  • Background color: White, black or transparent. This allows to make it fit visually with your VC.
  • Type: It allows you to choose the type: module graph, combined graph or tabular graph.
  • Agent/Module: If you have chosen a graph associated with a data series.

Graphs are not "previewed" in edit mode, so a white box is displayed instead.

VC edit o2017.jpg
Example of editing view of a VC with several items

VC edit o2017-2.jpg
Example of user view for that same VC

1.2.7.5 Pie and bars serialized graphs

These two elements of the visual console allow to add complex pie or vertical/horizontal bars graphs to a visual console. Unlike a combined graph of the "pie" or "bars" type, these serialized graphs incorporate data from a single module, with a special format. Only a "Text" module that contains series of data in the following format can be added:

tag,value
tag2,value2
tag3,value3
tag4,value4
..

Up to a maximum of six elements. To create a module with this data, it is recommended to do it with an agent plugin. This would be an example of a Linux local plugin that generates an XML for such a module. In this case the REST API of Integria IMS is used to retrieve data from open incidents, separated by status:

#!/bin/bash

#NEW
echo New,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,1"` > /tmp/support2.tmp

#UNCONFIRMED
echo Unconfirmed,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,2"` >> /tmp/support2.tmp

#ASSIGNED
echo Assigned,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,3"` >> /tmp/support2.tmp

#REOPENED
echo ReOpened,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,4"` >> /tmp/support2.tmp

#MOVED TO DEVELOPMENT
echo Developing,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,5"` >> /tmp/support2.tmp

#PENDING:
echo Pending,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,6"` >> /tmp/support2.tmp

echo "<module>"
echo "<name>Support_Status</name>"
echo "<type>generic_data_string</type>"
echo "<data><![CDATA[`cat /tmp/support2.tmp| tr -d ' '`]]></data>"
echo "</module>"

This will generate an XML similar to his one:

<module>
<name>Support_Status</name>
<type>generic_data_string</type>
<data><![CDATA[New,0
Unconfirmed,0
Assigned,43
Reopened,6
Developing,5
Pending,197]]></data>
</module>

That will show a graph like this one when interpreted (in the case of a pie graph type):

Tarta serie.jpg
Editor view

Pie serie graph vc.jpg
Visual console view

1.2.7.6 Simple value

This element allows the visual console to show the value of a module in real time. Just define a label (optional), and choose the agent and module. To replace the value, use the macro (_VALUE_). Several examples can be seen in the screenshot from the previous section.

Image-type data.

If the module is a string type data, and contains a binary data encoded in Base64, it will display the image. It must start with "data:image".

Data image vconsole.png
Screenshot showing editor creating a single-value item with base64 content.

1.2.7.7 Event Histogram/AutoSLA

It displays a horizontal bar, similar to the main agent view, where events that took place in the last 24hrs for an agent or an agent/module combination are shown.

Autosla o2017.jpg
Display example of an autoSLA with several elements

1.2.7.8 Service

It allows to represent (and provide a link to) the current status of a service. It also indicates the % of SLA compliance in real time.

1.2.7.9 Text Tag

This type of item can be used to create a text tag without associated content. It contains text and HTML code (which can create an internal link or other advanced options).

1.2.7.10 Group

It is a static image that represents the status of a group.

Group palete.png
Editing of a group-type item
1.2.7.11 Boxes and lines

If you cannot "customize" a background image, this is a simple but effective way to "customize" the appearance of your console, adding boxes of different colors and shapes to order and enhance the look of your visual console.

1.2.7.12 Clocks

This item allows you to add to your visual console a dynamic clock, both analog and digital of any time zone, showing and updating the exact time at all times without having to refresh the page.

Reloj1.png

Reloj2.png

1.2.7.13 Heat map / Color cloud

This element allows representing colored blurred clouds that depend on the value of the assigned module. This is commonly called "heat map".

Color-cloud-settings.png
Element edit view.


The configuration allows to create ranges of values (for now only numerical). When the value of the selected module is between the range values (including limits), the chosen color for that range will be used for the element. If no range is reached, the default color will be used.

Color-cloud-example.png
Example of a visual console with several elements of the color cloud type.


1.2.7.14 Avdanced options of each element
1.2.7.14.1 Position

The default position is 0x0, where the first digit is the X axis and the second digit is the Y axis. These values are in pixels, and note that the axis is defined in such a way that on the Y axis it is inverted, where the upper part is 0 and it grows downwards. The X axis is defined in the classical form, i. e. it starts at the left side and grows to the right. This position is automatically changed by clicking and dragging an item.

1.2.7.14.2 Parent

The relationship between visual console elements is represented with lines between them. The color of the line depends on the state of the parent element.

1.2.7.14.3 Associated Map

Several elements can be used to "summarize" the status of another visual console. That way, the status of the icon (Green, Yellow or Red) is shown using the status of the linked console. It is also possible to activate an element link to the visual console.

Ways to calculate the status of the linked visual console

  • By Default
It calculates the status based on the status of all elements, as an agent would do.
  • By weight
It calculates the status of the elements that have a visual console, a module or an agent assigned in relation to a percentage of elements configured by the user. This percentage is the one that must exceed the number of elements of a non-normal status regarding the number of elements taken into account for the calculation for that status to change.
For example, given an element with a percentage of 50% and a visual console linked to 5 elements:
- 1 critical, 1 warning and 3 normal -> Status normal.
- 2 critical, 2 warning and 1 normal -> Status normal.
- 1 critical, 3 warning and 1 normal -> Status warning.
- 3 critical, 1 warning and 1 normal -> Status critical.
- 1 critical, 1 warning and 3 unknown -> Status unknown.
If several status exceed the weight, the priority is the same as in the rest of the status calculation (critical > warning > unknown). If there are no elements to perform the calculation, the status becomes unknown.
  • By critical elements
It calculates the status using the elements in critical status and the percentages of the thresholds defined by the user. If the number of elements in critical status regarding the number of elements taken into account in the calculation exceeds the percentage assigned as warning, the status becomes warning. The same applies to the percentage assigned as critical, which also has preference.

Consolavisual_nodo1.png

From Pandora FMS 727 version you can make massive changes in this section. To do it, go to Extensions > Visual Console Manager. Once there, choose the visual map, the elements of the map and the type of status calculation you want to change.

Consolavisual_nodo2.png

1.2.7.14.4 Restricted access to a group

Selecting one will restrict the display of this item in the visual console for those users who do not have reading permissions over said group.

It will also be taken into account when calculating the status weight in a linked console: it will only be calculated on the elements that the user can see.

1.3 Sharing a Visual Console

It is possible to share a visual map with anyone, even if you do not have a username/password to log in Pandora FMS. You can share the visual console with any user, simply by providing access through a public URL. To do this, from the console view, access the "share" tab (the camera icon at the top right), as shown in this screenshot:



Share visual console.png



This is a static URL and it looks like this:

http://192.168.50.2/operation/visual_console/public_console.php?hash=86d1d0e9b6f41c2e3e04c5a6ad37136b&id_layout=3&id_user=admin2

Share that URL with anyone so that they may access the information displayed in the visual console. The user will not be able to access from there any of the links or information of any agent, only the information published in the visual console. This is an excellent way to share data with anonymous users

1.4 Macros in Visual Consoles

From version 712 onwards, it is possible to use keywords or "macros" that work dynamically, so when entering a macro in the text box when editing an element of the visual console, this macro will be replaced in the view mode by the data obtained from the feature of that macro.


List of visual maps' macros:

_date_: It displays the date using the local PHP format.
_time_: It displays the time using the local PHP format.
_agent_: It displays the alias of the selected agent.
_module_: It displays the name of the selected module.
_agentdescription_: It displays the description of the selected agent.
_address_: It displays the ip address of the selected agent.
_description_moduledescription_: It displays the description of the selected module.


Macro mapa visual.png


1.5 Full screen view

One of the most important features of visual consoles is to allow automatic refresh and full-screen display. Its most obvious application is in large information panels. There is a control that allows you to define how often you want the screen to be refreshed. If you activate the "full screen" mode of a visual console, you will see the refresh time at the top on the right.

Vc fullscreen control.jpg

There is a similar feature in dashboards, but they also allow you to rotate these screens, be it visual consoles or other types of dashboards. The chapter about dashboards provides further discussion about this topic.

1.6 Complete example of linked visual console

You can see the service concept more clearly with the following example.

Chip Company is a company that sells computers over the Internet. Chip Company has three large departments:

  • Online shop.
  • Support.
  • Management.


center‎



As you can see, there are three services offered to the customer: Online Shop, Support and, indirectly, Management. All services are critical to the business because if one fails, others can be affected, and the company could lose a lot of money, even customers.

In the end, essentially, what you want to know is whether you are fulfilling your customers' needs, since a satisfied customer can lead to more customers. That is why providing stable, quality service is so important.

To monitor Chip Company's services, it is necessary to know more about each one of them.

The Online Shop service is responsible for ensuring that the store's website is online, that all product prices are correct, managing product categories, and so on. In general, make sure that all information about products and payment methods is correct on the website to facilitate the purchase process.

We are interested in the following parameters of this service:



Operation-detail.png


The Support service must answer all possible questions that customers may ask about the equipment they purchased. Some of the tasks of this department include: helping customers with their configurations, managing computer replacements and replacement pieces, and managing equipment returns.

This service, like the Online Shop, is directly related with the customer, so both are very important for the image of the company from the customer's point of view.

From this department, the following parameters should be monitored:



Support-service-detail.png


The third service is that of Management which includes the departments of: Marketing, Sales, Human Resources and others related to management. Their main task is to ensure that all internal company processes work properly. The services offered by this department are essential as they coordinate the other departments.

The most important parameters of the Management service are:



Management-detail.png


To represent these services, you may link several maps with the help of the Pandora FMS visual console and the images that describe the hierarchy of Chip Company.

The data from these maps are calculated in real time, so you will always know the status of the services at all times. The first thing to do was map each service independently.

The following image shows a visual console that simulates the Online Store service map with the status of all its parameters. As you may see, the parameter Updated Content has a red exclamation mark which means that there is something wrong. Regarding the other parameters, they are correct because they have green checks. The back arrow is used to go to the general map below.



Screen-onlineshop-detail.png


If you want to know more about the problem, you can click on the red exclamation mark and you will see the technical view to find out more about the problem. This technical view shows the data collected by Pandora FMS from sources such as: CRM, ERP, SAP, Databases (MySQL, Oracle, etc), including devices such as PC, servers or routers.



Agent-detail.png



There are also other maps for the Support service you can see in the image below. As you can see, all the important parameters of the Support service are correct as they all have green checks.



Screen-support-detail.png


Finally, with the service maps a map for the Management service is created, which you can see in the following image. Again the map shows the most important parameters with their corresponding points, in this case all have green checks which means that all the parameters of the service are correct.



Screen-management-detail.png


In addition, a general map with all Chip Company services has been created as shown in the following image. On this map you can see Chip Company's service hierarchy with the states of each state. If you click on one of the status reporting points you will see the specific map of each service. All these maps provide a complete navigable view of Chip Company's services. The status of each service is the same as shown on the specific maps of each service. As you can see, Management and Support are correct, but Online Shop has problems. As you can see, the state of services climbs positions within the hierarchy to the top, spreading out the state.



Screen-chip-overview.png


1.7 Favorite visual consoles

The options of favorite visual consoles allow you to have shortcuts from the menu bar or to access to a list of visual consoles marked as favorites.

To mark a visual console as a favorite, check the favorite visual console checkbox when creating or editing it in its main editing section:

Consola favo 01.png

To modify the options of favorite visual consoles, access the Setup > Visual Styles from the sidebar menu.

Consola favo style.png
  • View type of visual consoles: The section of visual consoles by default will be the complete list of visual consoles or just the favorite ones.
  • Number of visual consoles to be displayed on the menu: Number of visual consoles to be displayed on the sidebar menu.

In case of entering a number in the number field of favorite visual consoles, then these will be displayed like this:

Consola favorito 2.png

Section of all visual consoles:

Consola favorito 4.png

Section of favorite visual consoles:

Consola favorito 3.png

1.8 Visual Console Templates

In this section, you my see the templates of created visual consoles, as well as create new templates.

To create a new template, all you have to do is choose a created visual console, a representative name and the group and a new template will be created.


Example CV 3.png

1.9 Visual console wizard

The visual console template wizard is used to use one of the previously created templates to apply to a new visual console. Choose the agents to which you want to apply the selected template. As many visual consoles will be created as agents have been chosen.

Info.png

After creating the template, if you want to make any changes, make them on the chosen visual console and re-create the template.

 


Example CV 4.png

Once you have applied the template, create the visual consoles, which will appear on your list.

If the template is created through a favorite visual console, all visual consoles created from this template will also be favorite.


In order to make the use of templates more dynamic, add macros to the labels of the elements of the visual consoles: _agent_ and _agentalias_ replacing them with the name and alias of the agent.

Go back to Pandora FMS documentation index