Pandora: Documentation en: Data Presentation/Visual Maps
- 1 Visual Maps
- 1.1 Creating a Visual Map
- 1.2 Viewing a Visual Map
- 1.3 Deleting a Visual Map
- 1.4 Tabs in the Visual Map Editor
- 1.5 The Choice Palette
- 1.6 Elements to use within a Visual Map
- 1.7 Sharing a Visual Console
- 1.8 Macros for visual maps
- 1.9 Full example
1 Visual Maps
Pandora FMS allows you to create visual maps in which each user is able to create his own monitoring map.
The new visual console editor is much more practical, although the old visual console editor had its advantages. Within the new visual console, we've been successful in imitating the sensation and touch of a drawing application like GIMP. We've also simplified the editor by dividing it into several subject-matter tabs named 'Data', 'Preview', 'Wizard', 'List of Elements' and 'Editor'.
The elements the Pandora FMS Visual Map was designed to handle are 'static image', 'percentage bar', 'module graph' and 'simple value'.
1.1 Creating a Visual Map
In order to create a visual map, please click on 'Topology Maps' and 'Visual Console'. It's going to display a list, containing all the maps created so far. In order to create a new map, please click on the 'Create' button.
The picture below shows a window intended to name the map. Please pick a group and select the map you intend to use. Once you have filled out all the appropriate fields, please click on the 'Create' button.
1.2 Viewing a Visual Map
In order to inspect all visual maps which have been created so far, please click on 'Reporting' and 'Visual Console'. It's going to display a list which contains all maps created so far.
The visual console items come with the following characters: "_", "," , "[" and "(". For the first letter, it's shown in the left menu within the 'Visual Console' sub menu.
In order to see the map, please click on the map's name you intend to inspect.
Below the map, there is a combo which was designed to pick the map's appropriate refresh time. The map can be viewed in full-screen mode by clicking on this icon . It's also possible to go to the map's editing page by clicking on this icon. It's also possible to display a public link to the current visual map which is accessible without having to login into the Console.
1.3 Deleting a Visual Map
In order to delete a visual map, please click on 'Topology Maps' and 'Visual Console'. It's going to display a list in which all maps created so far are contained. In order to delete a map, please click on the trashcan icon in the row of the visual map you intend to delete.
1.4 Tabs in the Visual Map Editor
Within the data tab, you may edit and create the visual console's basic data. There is only one visible for a new map until you save it. The essential values within this particular tab are the visual console's name, the group for the ACL management and the background image.
By creating it, the size of the visual console is determined by the background's image size. If you change the background, the last user-defined size or the previous background will be stored.
The background images are stored within the Pandora Console directory under 'var/www/pandora_console' in the '/images/backgrounds/' directory.
The visual console view is a static view, so if the state of the elements contained in there changes, they're not going to be drawn again. Same as the visual console's view which is contained in Visual Console's menu.
1.4.3 The Wizard
In here is a small questionnaire to create several elements of the static-image type simultaneously within the visual console by only two clicks.
As you can see in the picture below, the form consists of the following:
- The image which will be the same for all the elements created in the batch.
- The distance between the elements, that will be one after another in a horizontal line from position '0,0'.
- The agent's selection box to select one or several agents. Whether you select one or several agents, the batch elements will be created for the visual console.
- The module's selection box, which is a dynamically designed control which is filled by the agent's modules you've picked within the agent's selection box. You're able to pick the modules for which you intend the static image elements in the visual console to be drawn in it.
1.4.4 Services Wizard
The services wizard contains a small questionnaire to create several service elements into the visual console by a few clicks clicks. The selected services will appear placed automatically into the visual console with the chosen icon.
1.4.5 List of Elements
This tab provides a questionnaire for the visual console which you're presently editing. It's tabulated in files of the elements and a quick way of editing the different elements. It's also a useful tool for users which require to adjust certain element's values.
The supported actions within this questionnaire are editing and the deletion of elements. Creating elements and changing the element's type is not supported here. These actions are required to be carried out under the 'Editor' and 'Create' tabs.
The first line is the background image's configuration.
The rest of the lines are going to be map elements, associated in lines of two elements each and separated by a horizontal black line as shown on the picture below.
1.4.6 The Editor
184.108.40.206 The Button Box
The buttons this particular tool is composed of are the following:
- Buttons to create different types of elements, located on the left side named 'Static Graph', 'Percentile Item' (bubble and percentile type), 'Module Graph', 'Simple Value Label', 'Icon' and 'Service'.
If you click on them, the options palette containing the fields to fill out in order to create an element of this type is going to appear. They can also be deactivated if you're editing or creating an element. If it's active in the moment you're clicking on it, it's going to close the options palette.
- The 'Delete Item' button which is deactivated by default until you select an element, except the background. By clicking on it, it's going to delete the element of this visual console for good and also deletes it from the database.
- The 'Edit Item' button, which is also deactivated by default until you select any element contained in the visual console. By clicking on it, it's going to display the options palette of this element, so you're able to edit its values.
220.127.116.11 The Working Area
The working area has the size of 100% of your Pandora Console's width and a height of 500 pixels. As you can see, it's equipped with scroll bars for the purpose of rendering the work of handling big sized visual consoles a little easier. Please keep in mind that the visual console's size is the same as the one of the background image. In the working area, all elements which have been created in the default position of '0,0' (which is the upper left corner) are going to be shown.
18.104.22.168 Advanced Options
By default, the position is '0x0', where the first number is the X and the second one is the Y axis. These values are declared in pixels. Please keep in mind and that the Y axis is inverted within which the highest value is '0', ascending downwards. The X axis is defined classically. It starts in the left corner and increases to the right side.
You're not required to insert an exact position here, unless you're required to have a very precise one. You may locate it by moving through the visual console the same way as with a drawing tool after creating an element.
In order to represent a link between elements from the visual console, we've used lines that are drawn between them. These lines are drawn in a specific color, depending on the state of the parent element. Within the control, it's going to display a list of elements contained in this visual console which come into consideration to be the parent elements.
The element can also be the connection to another visual console to obtain more usability, e.g. you have two visual consoles: One which represents the machines inside a building, managed by you and a second visual console which represents a world map. On this last one, the default setting is to have an element, able to change the state (only on static images) which represents the building you are managing and provides easy access to the other one.
This control provides you with a drop-down list which displays the already created visual console to link it.
You may change the text color (which is 'black' by default) for aesthetic reasons or to improve the label's text visibility if the map's background is very dark. It's was also designed as an interactive control. It's also possible to input a color by using the classical HTML hexadecimal format. You may also invoke a pop up which contains the typical color palette.
It's a special type of element which neither can be created nor destroyed. Only the following values could be edited:
- The background image by using the choice palette.
- The size which is gained by the selected background image. Just like the static image, the '0x0' value is a special value which means that it takes the original proportions of the background's image file.
- It's possible to apply the original size of the background by clicking on the 'Original Size' button.
- Also it's possible to modify height-width ratio of the background image. This can be attained by clicking on the 'Proportional Width' and 'Proportional Height' buttons.
(Pandora FMS versions 5 and above only)
- Grid: You're able to display a grid, designed move elements aligned to that grid. If this option is deactivated, the elements can be moved freely again.
- Auto-Save Button: If it's disabled, you're only able to move the items because the creation buttons are disabled.
(Pandora FMS versions 5 and above only)
- Save current Edition: You're also able to deactivate the auto-save functionality within the visual console which is activated by default and to force the saving by clicking on the diskette-shaped button. This feature really comes in handy in conjunction with slow connections, especially if you're uncertain the auto save has been carried out appropriately.
1.5 The Choice Palette
It's displayed if you double click on the item you intend to edit or by clicking on the 'edit' button, contained in the button box. The form of the option palette contains the the below mentioned controls for all elements. Some elements contain additional controls which you're able to look up in their corresponding sections.
Labels are texts which are displayed on its corresponding element in the visual console.
Since the 5.0.1 version of Pandora FMS, it contains a feature-rich editor with which you're able to augment labels by styles.
An intelligent control with which you're able to search for an agent of your Pandora FMS installation by its IP or the agent's name.
This control responds to the control's selection of the agent which automatically inserts the modules the corresponding agent contains.
1.6 Elements to use within a Visual Map
1.6.1 Static Image
This element displays a static image. Depending on the state of the module, agent or map, it's always going to display one image or another. In a current Pandora FMS installation they're available under '/var/www/pandora_console/images/console/icons'. You're also able to upload them by the tool included within the file. The image designations are shown below.
<image_name>_<state>.png where the state could be:
- "" If the agent, module or the visual console has any state at all.
- bad: If the agent contains some failed module, the module itself fails or the visual console (which provides the link) contains some element in a 'bad' state.
- ok: If the agent, module or the visual console is in the 'ok' state.
- warning: If the agent contains any module, the module itself or any element on the visual console is in a 'warning' state.
Creating a Static Image
In order to create a static image, please click on the 'Static Graph' button. It's the first one on the left side of the button box. It's going to display a palette which contains the options for a new image. The common options could be seen on the chapter's beginning named The Choice Palette, but the ones which are considered exclusive for the static image are mentioned in the section below.
Static Image Options
- Image: It provides a drop-down control with which you're able to pick the displayed image. It also provides image preview under its control.
- Size: Within this control, you're able to input an appropriate size for the image. By default, it comes with the value of '0x0' which means that it's going to take the original image's size as a template.
- In order to create a floating text, you're only required to create a static image, but without an actual image.
This element displays a static image which is unassociated to any module.
In a normal Pandora FMS installation, the images are available under '<pandora_home>/images/console/icons'. You're required to upload any new image by using the 'file manager' tool. As for any other element in the visual console, you may associate a label, an initial position, a size, a parent element and a link to another visual map.
You may perform all of these tasks in the visual map editor as shown below.
Icons linked to other Pages
Since the 5.0 version, you may associate a complete URL in order to link it to another web page by using a label field.
Example: In order to link an icon within the visual console to the SNMP console, you're required to create one element of the icon type. This icon is going to contain a label which contains the complete SNMP console's URL as shown below.
In the preview mode of the visual console, you may can click on the icon and it's going to redirect you to the SNMP console.
1.6.3 The Percentile Item Bar
Percentile items allow you to see the module's state in a descriptive way. The items can be of the bubble or percentile (progress bar) type.
Percentile Item Options
The percentile bar contains much less controls than the rest of the elements, but it has four controls which we're going to explain below.
- Width: This is the percentile's bar width in pixels.
- Max Value: This is the maximum value, the represented module can assume. For this reason it's always a good thing to examine the module to monitor just to see what's its maximum value is going to be, e.g. in case of the screen shot, it's the CPU module which moves from the value of '0' to '100'.
- Type: This field allows to configure whether the item type is going to be of the 'bubble' or the 'percentile' type. It's a graphical way of representing this item.
An element of the 'percentile' type.
- Value to Show: This field allows you to choose between the percentage of accomplishment or the module's last value.
- Advanced Options: This element has no advanced controls which differ from the basic ones.
1.6.4 The Module Graph
Just as its name says: A graph which provides the activity information of one agent's module which is going to be displayed within the visual console.
The Module Graph's Options It's necessary to define width and height in the graph in order for it to change from being hidden to be shown in the advanced options.
- Period: The period or time frame that goes until the present time. Please keep in mind that this graph is going to change as time progresses.
- Size: The width and height of the image the graph is going to be displayed in. It's not only the graph itself, but the graph and the ciphers of all axes.
- Advanced Options: This element has no advanced controls which differ from the basic ones.
Since the graphs were designed to calculate themselves first and create an image afterwards, creating graphs is not an instantaneous process. Depending on the architecture on which you have built Pandora FMS, its completion can be either almost instantaneous or take quite a few seconds, within which you're only going to see the element's label on the map without the graph's actual image.
1.6.5 Simple Value
This element only displays a text of the '[label][module value]' type in the visual console. You're only required to define a label (if you want), to select the agent and the module which is going to display the intended last value within the visual console's drawing.
Simple Value Options
The simple value choice palette doesn't have its own controls.
Since Pandora FMS versions 5.0.1 and above, you're also able to setup a style to the value by using the rich editor within the macro (_VALUE_).
From version 7. Subtype samples of single values, data image in base64
When a module is selected that contains a string beginning with data:image as its latest status in the database it will be represented on the map not as a single value text but as an image made up of data from the text string that contains information from a coded image.
This feature was designed to create labels without any associated content. The only requirement is to fill out the 'Label' field.
It's a static graph which was designed to display the group's status.
Group item edition
1.7 Sharing a Visual Console
From Pandora FMS versions 4.0.2 and above, it's possible to share a visual console with anyone within the company's network, even if they don't have a valid user account to login to Pandora FMS. You may share the visual console with anyone, just by providing a public URL.
Please access the visual console's main view, click on the sharing tab and on the camera-shaped icon as shown on the picture below in order to do so.
This special URL is of the static type and similar to the one shown below.
Please feel free to share this particular URL with anyone within your company's network and they're instantly able to access the information published in that visual console. They of course can't access any of the links within the console, just the information contained in it. This is a good way to provide access to specific information under Pandora FMS.
1.8 Macros for visual maps
Since 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 substituted in the viewing mode by the data that you obtain from the feature of that macro.
List of visual map macros:
_date_ : It gets the date using the local PHP format.
_time_ : It gets the time using the local PHP format.
1.9 Full example
A chip manufacturer sells computers via its website all around the world. The company consists of three big departments: Management, an on-line shop and support.
As you can see, there are three services which are offered to customers: An on-line shop, support and (indirectly) management. All services are crucial for the business, because if one fails, the others can be affected and the company could lose a lot of money - even customers. And in the end, as you know, happy customers bring more customers to your company.
To monitor the service of a chip-manufacturing company, we're required to understand all its services in detail.
The on-line shop department is responsible for ensuring the shop's website is online, that all product prices are appropriate for the intended market, creating the product categories, and, over all, to ensure that all information about products, delivery and payment methods are properly displayed on the website to render the shopping an easy task for the customers. In this example, we intend to monitor the following parameters from their service:
The support department has to solve all customer's problems by the computers they've purchased. Some tasks of this department are: Helping customers to configure their computers, manage the replacement of computer parts and manage the return of delivered products. This department in conjunction with the online shop are client side services. It's important for them to be perceived as a high-quality company. We intend to monitor the following parameters from their support service:
The third department is the management which consists of marketing, the production of commercials, HHRR (Human Health Risk Resources) and other departments which are focused on internal management. Their first and foremost job is to ensure all processes within the company are conducted appropriately. The services of this department are crucial, because it's considered the coordinator of all other departments. The most interesting parameters regarding management services (which we intend to monitor in this example) are the following:
To monitor the services, we're generating some maps with the Pandora FMS Visual Console and the pictures we possess about the of the chip-manufacturing company's services hierarchy. These maps are calculated in real time, because you have to be able to evaluate the status of your services at any time. The first thing we have to do is to generate a map of each service.
The picture below shows a map of the on-line shop service along with each parameter's status. As you can see, the parameter called 'Content Updated' bears a red dot. It means there is a problem with it. The other shown parameters are appropriate because they bear green dots. Clicking on the green arrow leads to a map which presents a more generalized view of the services, as you're going to see in the following steps.
If you want to display detailed information about the problem, click on the red dot and you'll see a detailed view with which you're able to learn more about the problem. This detailed (and pretty technical) view displays the data which was gathered by Pandora FMS from a lot of sources like CRM, ERP, SAP servers, databases (e.g. MySQL, Oracle, etc), even from devices like PCs, servers and routers.
We've also generated another map for the support service which is shown on the picture below. As you can see, all important parameters of the support service are appropriate, because all of them bear green dots.
To finish with the services map, we've also generated a map for management services, as you can see on the picture below. This display also shows all important parameters along with colored dots. In this case, all the dots are green - which means the parameters of the monitored services are all within areas which are considered to be normal.
As you can see on the picture below, we've also generated a map with a more generalized view on which all the services are displayed. On this map, you're able to see the chip-manufacturing company's entire service hierarchy and the states of all monitored services. If you click on any dot, you're going to see a detailed map of each service. With these maps, we've created a complete topological map of all the chip-manufacturing company's services. Each service's status is the same as the one shown on the detailed map for each service. As you can see, the values for the management and support services are normal, but the online shop service seems to have some kind of problem. As you can see, the status of the service climbs up in the hierarchy until it reaches the top for the purpose of informing the user of important incidences.