Pandora: Documentation en: Data Presentation/Network Maps
- 1 Network Maps
- 1.1 Introduction
- 1.2 Network map elements
- 1.3 Creating 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 Mass node edition
- 1.5.6 Creation of agent nodes
- 1.5.7 Modify the zoom level
1 Network Maps
Network Maps are network graphical representations. There you can see the different elements that make them up and their status, simply and quickly. Network Maps can be accessed through the left menu at the Topology Maps > Network Map section.
1.2 Network map elements
Network maps can contain:
- Real nodes: They represent the agents added to the map. These nodes have an icon representing the agent's operating system, and an aura identifying the agent state. The shape is circular by default but it can be customized. The status representing the node may be:
- Green, it is in a normal state.
- Red, it is in critical condition some of its modules.
- Yellow, some module is in warning status.
- Orange, one of the alerts has been triggered on the agent.
- Gray, the agent is in unknown state.
- Fictitious nodes: They represent a link to another network map or simply a point for personal use within the map. They may have any available shape (circle, rhombus, square), any size and label of course. And if it is a link to another map, the color follows the following rules if it cannot be customized:
- 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 warning state and there are none in critical status.
- Orange, if any of the linked map nodes has any triggered alert.
- Gray, if any of the linked map nodes is in unknown status and there is no other in critical, warning or triggered-alert status.
- Relationship between nodes: relationship between nodes can be:
- The simple kinship represents the hierarchy between the components of the network map.
- Kinship between network interfaces, which represent map component connection through their network interfaces. These lines usually end or begin with round arrowheads, which represent the state of the network interface by means of a color. In order to establish these 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 network map element interfaces by name.
1.3 Creating a network map
To create a new network map, there are two options: Create a new empty network map or create an auto-generated network map (Create networkmap).
1.3.1 Empty network map
A form will appear where the name, group and description of the network map must be indicated, along with the radius of its nodes.
Clicking on the "Save network map" button will create a new network map where elements can be added.
1.3.2 Non empty network map
A form with more options than the previous case will appear.
These are the available options:
- Name: Network map name.
- Group: The group to which the network map belongs to for ACLs, in addition to the group from which the map is generated from the agents contained in that group.
- Node radius: Radius of the icons of each of the map nodes.
- Description: Network map description.
- 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 be displayed with the same zoom-in.
- Source: Filter or agent source where the map was generated or new nodes are added to the holding area. They can be:
- Group: Only the agents that belong to that group or children groups appear in the network map (or in the holding area).
- 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: Only the agents whose main IP passes the IP mask filter appear in the network map (or in the holding area).
- Do not show subgroups: Option to not show secondary groups.
- Network map generating method: The network map node distribution method. There are the following:
- Radial: Where all nodes are around the fictional node that symbolizes Pandora FMS.
- Circular: Where nodes will be available in concentric circles.
- Flat: Where arborescent nodes will be available.
- spring1, spring2: They are Flat variations.
- Node separation: It sets the desired separation between network map nodes.
- Minimum node dist (only circular method): It sets the minimum separation between network map nodes.
- Rank separation (only flat and radial): It sets the separation between arrows in the network map.
- Ideal default node separation (spring2 only): It sets the minimum separation between network map nodes.
After defining the desired options, click on the "Save network map" button. At that moment, the Pandora FMS console will begin to generate the network map showing and will redirect you there.
1.4 Editing a network map
To access map editing, click on its edit button.
The form for editing network maps is the same as the creation form, except for some tokens that can not be changed when it is created.
1.4.1 Duplicating a network map
From the network map list, you may duplicate a network map with all its content and settings, except for the name, which is "Copy of ...".
1.5 Network map view
When viewing a created network map, there are different fields and the existing nodes can also be managed.
The minimap provides a global view that shows the entire extent of the map, but in a much smaller view. In addition, a red box is shown representing the map section displayed onscreen.
It is located at the upper left corner and can be hidden by clicking on the arrow icon.
From the contextual menu, more complex tasks can be performed on the network map. Deploy it by clicking on any empty map area.
The available options are:
- Add node: It allows to add a new real or fictitious node.
- Set centre: It sets the map center to show that section of the map when you access it.
- Refresh: It refreshes the network map.
- Refresh Holding Area: It refreshes the network map’s holding area.
- Restart map: It allows you to adjust map values using a form and generate it again.
1.5.3 Holding area
The holding area is where 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 this one is refreshed by the context menu. In addition, the network map creation filter is applied to search for new nodes, such as by group, by network mask, or new ones found by a recontask network discovery task.
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 clicking on a node and clicking while dragging it to the desired position.
126.96.36.199 Linking a node to another
With the secondary button of the mouse, click on a node and a contextual menu will appear, choose the option "Define as child element".
That starts the linking operation between two nodes. To complete it, click on the secondary button on the other node, and in the following contextual menu, choose the option "Define as parent element" (the action can also be cancelled through the option "Abort the action of set relationship").
And at the end of the action, both nodes will be linked to each other.
You can also define from the contextual menu a type of connection by network interface, and you may select from which network interface the connection is done.
In a similar way as the previous one, the link can be set by right clicking on the element to be defined as a child and selecting the option "Add an interface link".
Then right click on the parent node and choose the option "Set parent interface" from the contextual menu (as before, the action can be cancelled by clicking on "Abort the interface relationship").
A window will pop up asking to select the interface to use on both nodes for the link.
Once the interfaces on both nodes have been selected, a circle will appear right at the ends of the link representing the status of those interfaces (status of the interface ifOperStatus module).
188.8.131.52 View node information
Additional map node infromation may be seen by right clicking on them and choosing the option "Show details and options" from the menu.
184.108.40.206 Delete nodes
Delete a node selecting the secondary button of the mouse and choose the option "Delete"in the menu.
220.127.116.11 Change the shape of the aura state
Change the node's aura shape by accessing the node information window in "Node options" section.
18.104.22.168 Delete relations between nodes
The "Relations" section can be found at agent information, where you may both select the interfaces for each node as well as delete the link.
1.5.5 Mass node edition
Holding down the "control" key, select each node or click on the secondary button of the mouse and drag to select a specific area that contains the nodes. Once several have been selected, they will look black rimmed to be distinguished from those which are not selected. You may carry out the following mass operations with those:
- With the main button, drag them all at once.
- With the right button, see a menu with several options, like linking by kinship 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
In a generated network map, new nodes can be created manually. In order to do so, click on an empty space within the network map and choose the option "Add node".
22.214.171.124 Single node creation
In the contextual menu, in the add agent section, there is a smart control which filters and displays a list of possible agents according to the requirements.
Once selected, click on "Add Agent node" to create the new map node.
126.96.36.199 Mass node creation
From the second section of the add agents menu, "Add Agent Node (Filter by group)", you may add several agent nodes filtering by group. Just select the desired agents from the agent box and click on "Add Agent Node".
188.8.131.52 Fictional node creation
From the third section of the add agents menu, "Add fictional point", you may add fictional nodes. Just type in the name of the new fictional node, the network map it belongs to (if it is linked to any of them) and click on "Add Fictional Node".
1.5.7 Modify the zoom level
With the mouse wheel, you may change the zoom in level on the network map, to see in detail one of its sections. There is a total of 5 zoom levels.