Pandora: Documentation en: Data Presentation/Network Maps
- 1 Network Maps
- 1.1 Introduction
- 1.2 Network map elements
- 1.3 Creation of a network map
- 1.4 Editing a network map
- 1.5 Network map view
- 1.5.1 Minimap
- 1.5.2 Contextual Menu
- 1.5.3 Holding Area
- 1.5.4 Edit nodes
- 1.5.5 Massive edition of nodes
- 1.5.6 Creation of agent nodes
- 1.5.7 Modify the zoom level
1 Network Maps
Network Maps are a graphical representation of your network, you can see the different elements that make it up and the status of them, simply and quickly Network Maps can be accessed through the left menu and can be found in the Topology Maps section under the name Network Map .
1.2 Network map elements
Network maps can contain:
- Real nodes: which uniquely represent the agents added on the map. These nodes have an icon representing the operating system of the agent, and an aura (with the default circular form, but can be chosen among other forms) of agent state that can be:
- Green, is in a correct state.
- Red, is in critical condition some of its modules.
- Yellow, some modules are in warning status.
- Orange, one of the alarms has been triggered on the agent.
- Gray, the agent is in unknown state.
- Fictitious nodes, which represent a link to another network map or simply a point for personal use within the map, can have any shape available (circle, rhombus, square), any size and text of course. And if it is a link to another map the color follows the following rules, you can't customize the color:
- Green, if all nodes in the linked map are correct.
- Red, if any of the nodes in the linked map are in critical condition.
- Yellow, if any of the map nodes are in the warning state and there are none in critical condition.
- Orange, Gray following the same rule as the other colors.
- Relationship between nodes.
- The simple kinship lines represents the hierarchy between the components of the network map.
- Kinship lines between network interfaces, which represent the connection of map components through their network interfaces. These lines are characterized by ending or beginning with round arrowheads, which represent the state of the network interface by means of a color. In order to establish this type of relations, it is necessary that the agent represented by the node has the "ifOperStatus" monitoring modules of its network interfaces, which must also have the nomenclature "ifname_ifOperStatus" (for example, eth0_ifOperStatus). This allows you to easily locate the interfaces of the network map elements by name.
1.3 Creation of a network map
To create a new network map we have two options: Create a new empty network map or create an autogenerated network map.
1.3.1 Empty network map
A form will appear in which we will have to indicate the name, group and description of the network map, along with the radius of the nodes of it.
Clicking on the "Save network map" button will create a new network map in which we can start adding elements.
1.3.2 Non empty network map
We will see a form with more options than the previous case.
We will detail each of the available options:
- Name: red map name.
- Group: the group to which the network map belongs to the ACLs, and also the group from which the map is generated from the agents containing in that group.
- Position X: offset applied to the default position on the map to display it always the same in the x-axis component.
- Position Y: offset applied to the default position on the map to display it always the same in the y-axis component..
- Zoom scale: application for the map's default view to always display it with this same enlargement.
- network map source: filter or source of the agents from which the map was generated or new nodes added to the holding area. They can be:
- Group: appear in the network map (or in the holding area) only the agents that belong to that group or children groups.
- Recon Task: Only the agents that have been discovered by the recon task that has been chosen on the same form and which must be Level 2 appear on the network map (or on the holding area).
- CIDR IP mask: appear in the network map (or in the holding area) only the agents that their main IP passes the IP mask filter.
- Don't show subgroups: option to not show secondary groups.
- Method of generating the network map: the method of distribution of the nodes which form the network map, by default is radial, but there are the following:
- Radial: in which all the nodes are around the fictional node that symbolizes the Pandora.
- Circular: in which the nodes will be available in concentric circles.
- Flat: in which the nodes of arborescent form will be available.
- spring1, spring2: are variations of the Flat
- Separation between nodes: Sets the desired separation between the nodes for the network map.
- Minimum distance between nodes (only circular method): Sets the minimum separation we want between the nodes for the network map.
- Separation between arrows (only flat and radial): Sets the separation between arrows that we want for the network map.
- Default separation for nodes (spring2 only): Sets the minimum separation we want between the nodes for the network map.
When defining the options that we want we can click on the "Save network map" button at that moment the Pandora FMS console will begin to generate the network map showing the message "Pending to generate", this can take a while.
1.4 Editing a network map
To access to edit a map, in addition to having ACL permissions of type "IW", you can editing through the "wrench" icon.
The form for editing the network maps is the same as the creation form except for some tokens that can not be changed when its created.
1.4.1 Duplicate a network map
From the list of network maps you can duplicate a network map with all its contents and settings, except the name which is "Copy of ...".
1.5 Network map view
In the view of a network map. we can see different elements and algo manage the existing nodes.
The minimap provides us with a global view that shows the entire extent of the map, but in a much smaller view, in addition to the view of the map is shown all nodes completely but without state and without relations. Except for the fictional point of Pandora shown in green. And also a red box is shown on the part of the map being displayed.
It is located in the upper left corner and can be hidden by clicking on the arrow icon.
1.5.2 Contextual Menu
Contextual Menu From the contextual menu, you can perform more complex tasks on the network map.
The available options are:
- Add node: Allows you to add a new real or fictitious node.
- Set centre: Sets the center of the map to show that section of the map when you access it.
- Refresh: Refresh the network map.
- Refresh Holding Area: Refresh the network ma’s holding area.
- Restart map: Allows you to adjust the map values using a form and generate it again.
1.5.3 Holding Area
The holding area is where the new network nodes appear, preventing new nodes from appearing in the middle of their network maps and reflecting the changes in the monitored architecture clearly.
New nodes in the holding area appear only when the bench is refreshed by the context menu. In addition, the network map creation filter is applied to search for new nodes, such as per group, per network mask, or new ones found by a recontask network discovery task. The aesthetics of the nodes and the links between the nodes are dotted lines and contours. The nodes inside the holding area remain as a holding area items until they are dragged out.
1.5.4 Edit nodes
22.214.171.124 Change the position
By holding it down on a map node you can change its position.
126.96.36.199 Relate a node to another
With the Secondary button of the mouse, clicking on a node a contextual menu appears, choose the option "Choose as a child".
You start the operation of linking one node with another. For this, you must to right click on another node (fictitious or not) and you will have a contextual menu that shows you "choose as a parent" or "cancel the operation".
And at the end of the operation, the node will be linked to another node, and the marks on the nodes will disappear.
You can also define from the contextual menu a type of connection by network interface and you can select from which network interface the connection is
In the same way that the previous link can be made by right clicking on the element that we will define as a child and clicking add network interface.
Then go to the element that we will define as a parent for the link, right-click and select set parent interface.
A window will show asking to select the interface to use on both nodes for the link.
Once you select the interfaces on both nodes, a circle will appear right at the ends of the link representing the status of those interfaces.
188.8.131.52 View node information
Shows in a separate popup window a detail view of the agent.
184.108.40.206 Delete nodes
With the Secondary button of the mouse, clicking on a node a contextual menu appears, choose the option "Delete"
220.127.116.11 Change the shape of the aura state
With the Secondary button of the mouse, clicking on a node appears a contextual menu, we enter in the information of the agent and from the menu of form we can change the form of the aureola of the node.
18.104.22.168 Delete relations between nodes
From the information of the agent we can see the option of relations in which we can either select the interfaces for each node or delete the link.
1.5.5 Massive edition of nodes
Holding down the "control" key, you will see a translucent rectangle to be able to select several nodes at the same time. And once you have selected several, you can do:
- With the main button, you can drag them all at once.
- With the right button, you have a menu with the options, link by relationship with another node, forward, delete, open details window and change the shape of the state aura (and if it is a fictional node the Form of this).
1.5.6 Creation of agent nodes
The creation of agent nodes apart from the initial load if you choose a group in the creation of the map, can be created once add new agent nodes, from the control panel, there are two ways that we will deal next.
22.214.171.124 creation of one node
In the contextual menu in the add agent part, you have a smart control by which it filters and displays the list of possible agents as written.
Once selected, the "Add Agent" button is clicked on the panel and a new node of this agent will appear in the center of the part that is currently showing the map.
126.96.36.199 Massive creation of a node
Desde la segunda sección del menú de añadir agentes, "Add Agent Node (Filter by group)", podemos agregar varios nodos de agente filtrando por un grupo. Basta con seleccionar los agentes deseados de la caja de agentes y hacer click en el botón "Add Agent Node".
188.8.131.52 Creation of fictional nodes
Desde la tercera sección del menú de añadir agentes, "Add fictional point", podemos agregar nodos ficticios. Basta con indicar el nombre del nuevo nodo ficticion, indicar el mapa de red al que enlaza (si es que enlaza con alguno) y hacer click en el botón "Add Fictional Node".
1.5.7 Modify the zoom level
Mouse wheel, with the mouse wheel you can vary the zoom level on the map, which by default always opens at the maximum zoom level, the maximum level is shown the system icon, at higher levels is not displayed and The text of each node is from a smaller source. There are 5 zoom levels.