Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:documentation:04_using:06_data_presentation_network_maps [2021/04/26 16:05]
admscopia
en:documentation:04_using:06_data_presentation_network_maps [2021/11/05 12:05] (current)
Line 1: Line 1:
-====== 6.Network Maps ======+====== Network Maps ====== 
 +{{indexmenu_n>6}}
  
-[[Pandora:Documentation_en|Go back to Pandora FMS documentation index]]+[[en:documentation:start|Go back to Pandora FMS documentation index]]
  
  
-= Network Maps = +===== Network Maps ===== 
-====== Introduction====== +==== Introduction ====
-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.+
  
-You may find more information about [[https://pandorafms.com/|network mapping in Pandora FMS website]]. Network maps are part of  [[https://www.youtube.com/watch?v=knfbmEPLaf8|"Network monitoring"]].+Network Maps are network graphical representationsThere 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.
  
-====== Network map elements ======+You may find more information about [[https://pandorafms.com/network-mapper/|network mapping in Pandora FMS website]]. Network maps are part of "[[https://www.youtube.com/watch?v=knfbmEPLaf8|Network monitoring]]"
 + 
 + 
 +==== Network map elements ====
 Network maps can contain: 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:   * **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:
Line 27: Line 29:
   * **Relationship between nodes**: relationship between nodes can be:   * **Relationship between nodes**: relationship between nodes can be:
     * //The simple kinship// represents the hierarchy between the components of the network map.     * //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 <code>ifOperStatus</code> monitoring modules of its network interfaces, which must also have the nomenclature <code>ifname_ifOperStatus</code> (for example, <code>eth0_ifOperStatus</code>). This allows you to easily locate network map element interfaces by name.+    * //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.
  
-======Creating a network map======+==== Creating a network map ====
 To create a new network map, there are two options: **Create empty network map** or create an auto-generated network map (**Create networkmap**). To create a new network map, there are two options: **Create empty network map** or create an auto-generated network map (**Create networkmap**).
  
-<br> 
-<center> 
-[[image:nw-map-cnf01.png]] 
-</center> 
  
-=====Empty network map=====+{{ wiki:nw-map-cnf01.png }} 
 + 
 +=== 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. A form will appear where the name, group and description of the network map must be indicated, along with the radius of its nodes.
  
-<br> +{{  :wiki:nw-map-cnf03.png  }}
-<center> +
-[[image:nw-map-cnf03.png]] +
-</center> +
-<br>+
  
-;NameName of the network map. +**Name** 
-;GroupThe group the network map for [[Pandora:Documentation_en:Managing_and_Administration#Profiles.2C_users.2C_groups_and_ACL|ACL]] belongs to, and in addition the group the map must be generated from based on the agents within that group. + 
-;Node ratiusRatius of the icons of each of the map's nodes.+Name of the network map. 
 + 
 +**Group** 
 + 
 +The group the network map for [[:en:documentation:04_using:11_managing_and_administration#profiles_users_groups_and_acl|ACL]] belongs to, and in addition the group the map must be generated from based on the agents within that group. 
 + 
 +**Node ratius** 
 + 
 +Ratius of the icons of each of the map's nodes.
  
 Clicking on the **Save network map** button will create a new network map where elements can be added. Clicking on the **Save network map** button will create a new network map where elements can be added.
  
-=====Non empty network map=====+ 
 +=== Non empty network map ===
 A form with more options than the previous case will appear. A form with more options than the previous case will appear.
  
-<br> + 
-<center> +{{ wiki:nw-map-cnf02.png }} 
-[[image:nw-map-cnf02.png]] +
-</center> +
-<br>+
    
-  * **Group**: Groups that will have access to the network map. User can only assign a group to which the user creating the empty network map belongs, unless that user explicitly belongs to the [[Pandora:Documentation_en:Managing_and_Administration#Group_all|ALL group]].+  * **Group**: Groups that will have access to the network map. User can only assign a group to which the user creating the empty network map belongs, unless that user explicitly belongs to the [[en:documentation:04_using:11_managing_and_administration#Group_all|ALL group]].
   * **Position X**: Offset applied to the default position on the map to display it always the same in the x-axis component.   * **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.   * **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.   * **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 [[en:documentation:04_using:06_data_presentation_network_maps#Holding_area|holding area]]. They can be:   * **Source**: Filter or agent source where the map was generated or new nodes are added to the [[en:documentation:04_using:06_data_presentation_network_maps#Holding_area|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). **Even if the user who is creating the network map does not explicitly** belongs to the ALL group, he/she can still assign the [[Pandora:Documentation_en:Managing_and_Administration#Group_all|ALL group]] as the source of Agents.+    * //Group//: Only the agents that belong to that group or children groups appear in the network map (or in the holding area). **Even if the user who is creating the network map does not explicitly** belongs to the ALL group, he/she can still assign the [[en:documentation:04_using:11_managing_and_administration#Group_all|ALL group]] as the source of Agents.
     * //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).     * //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).     * //CIDR IP mask//: Only the agents whose main IP passes the IP mask filter appear in the network map (or in the holding area).
Line 72: Line 76:
   * **Network map generating method**: The network map node distribution method. There are the following:   * **Network map generating method**: The network map node distribution method. There are the following:
     * //Circular//: Where nodes will be available in concentric circles.     * //Circular//: Where nodes will be available in concentric circles.
-{{ wiki:Network map creation method circular.png ?400}}+ 
 +{{ wiki:Network map creation method circular.png?400 }} 
     * //Flat//: Where arborescent nodes will be available.     * //Flat//: Where arborescent nodes will be available.
-{{ wiki:Network map creation method flat.png ?400}}+ 
 +{{ wiki:Network map creation method flat.png?400 }} 
     * //Radial:// Where all nodes are around the fictional node that symbolizes Pandora FMS.     * //Radial:// Where all nodes are around the fictional node that symbolizes Pandora FMS.
-{{ wiki:Network map creation method radial.png ?400}} + 
-{{ wiki:Network map creation method radial dynamic.png ?400}}+{{ wiki:Network map creation method radial.png?400 }} 
 + 
 +{{ wiki:Network map creation method radial dynamic.png?400 }} 
     * //Spring1, Spring2:// They are Flat variations.     * //Spring1, Spring2:// They are Flat variations.
-{{ wiki:Network map creation method spring1.png ?400}} + 
-{{ wiki:Network map creation method spring2.png ?400}}+{{ wiki:Network map creation method spring1.png?400 }} 
 + 
 +{{ wiki:Network map creation method spring2.png?400 }} 
       * **Node separation:** (Except for **Radial dynamic**) It sets the desired separation between network map nodes.       * **Node separation:** (Except for **Radial dynamic**) It sets the desired separation between network map nodes.
       * **Minimum node distance (only circular method):** It sets the minimum separation between network map nodes.       * **Minimum node distance (only circular method):** It sets the minimum separation between network map nodes.
Line 88: Line 102:
 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. 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.
    
-<center> +{{ wiki:nw-map01.png }}
-[[image:nw-map01.png]] +
-</center>+
  
-====== Editing a network map ======+==== Editing a network map ====
 To access map editing, click on its edit button. To access map editing, click on its edit button.
  
-<center> +{{ wiki:nw-map-edit01.png }} 
-[[image:nw-map-edit01.png]] +
-</center> +
-<br>+
  
 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. 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.
  
  
-<br> + 
-<center> +{{ wiki:nw-map-edit03.png }} 
-[[image:nw-map-edit03.png]] +
-</center> +
-<br>+
  
 Once you are done with the changes, click on **Updated network map** to save it.  Once you are done with the changes, click on **Updated network map** to save it. 
  
-===== Duplicating  a network map =====+=== 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...**". 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...**".
  
-<br> 
-<center> 
-[[image:nw-map-edit02.png]] 
-</center> 
-<br> 
  
-======Network map view======+{{ wiki:nw-map-edit02.png }} 
 + 
 + 
 +==== Network map view ====
 When viewing a created network map, there are different fields and  the existing nodes can also be managed. When viewing a created network map, there are different fields and  the existing nodes can also be managed.
  
-===== Minimap =====+=== Minimap ===
 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. 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.
  
-<br> 
-<center> 
-[[image:nw-map01-minimap.png]] 
-</center> 
-<br> 
  
-===== Contextual menu =====+{{ wiki:nw-map01-minimap.png }} 
 + 
 + 
 +=== Contextual menu ===
 From the contextual menu, more complex tasks can be performed on the network map. Deploy it by clicking on any empty map area.  From the contextual menu, more complex tasks can be performed on the network map. Deploy it by clicking on any empty map area. 
  
-<br> + 
-<center> +{{ wiki:nw-map02.png }} 
-[[image:nw-map02.png]] +
-</center> +
-<br>+
    
 The available options are: 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. 
  
-===== Holding area =====+**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. 
 + 
 +=== 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. 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.
    
-<br> + 
-<center> +{{ wiki:nw-map03.png }} 
-[[image:nw-map03.png]] +
-</center> +
-<br>+
  
 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. 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.
Line 161: Line 176:
 The nodes inside the holding area remain as a holding area items until they are dragged out. The nodes inside the holding area remain as a holding area items until they are dragged out.
  
-===== Edit nodes ===== +=== Edit nodes === 
-==== Change the position ====+== Change the position ==
 By clicking on a node and clicking while dragging it to the desired position. By clicking on a node and clicking while dragging it to the desired position.
  
-==== Linking a node to another ====+== 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**. With the secondary button of the mouse, click on a node and a contextual menu will appear, choose the option **Define as child element**.
  
  
-{{ wiki:nw-map04.png ?450}}+{{ wiki:nw-map04.png?450 }}
  
 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**). 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**).
  
-{{ wiki:nw-map05.png ?450}}+{{ wiki:nw-map05.png?450 }}
  
 And at the end of the action, both nodes will be linked to each other. And at the end of the action, both nodes will be linked to each other.
  
-{{ wiki:nw-map06.png ?800|Haga clic para ampliar}}+{{ wiki:nw-map06.png?800 |Haga clic para ampliar}}
  
 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. 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.
Line 183: Line 198:
 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**. 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**.
  
-{{ wiki:nw-map07.png ?400}}+{{ wiki:nw-map07.png?400 }}
    
 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**). 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**).
    
-{{ wiki:nw-map08.png ?400}}+{{ wiki:nw-map08.png?400 }}
  
 A window will pop up asking to select the interface to use on both nodes for the link. A window will pop up asking to select the interface to use on both nodes for the link.
    
-{{ wiki:nw-map09.png ?700}}+{{ wiki:nw-map09.png?700 }}
  
-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 <code>ifOperStatus</code> module).+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).
  
-{{ wiki:nw-map10.png ?500}}+{{ wiki:nw-map10.png?500 }}
  
-==== See node information ====+== See node information ==
 Additional map node information may be seen by right clicking on them and choosing the option **Show details and options** from the menu. Additional map node information may be seen by right clicking on them and choosing the option **Show details and options** from the menu.
  
-<br> 
-<center> 
-[[image:nw-map11.0.png]] 
-[[image:nw-map11.png]] 
-</center> 
-<br> 
  
-==== Delete nodes ====+{{ wiki:nw-map11.0.png }} 
 + 
 +{{ wiki:nw-map11.png }} 
 + 
 + 
 +== Delete nodes ==
 Delete a node selecting the secondary button of the mouse and choose the option "Delete"in the menu. Delete a node selecting the secondary button of the mouse and choose the option "Delete"in the menu.
  
-<br> 
-<center> 
-[[image:nw-map12.png]] 
-</center> 
-<br> 
  
-==== Change the shape of the aura state ====+{{ wiki:nw-map12.png }} 
 + 
 + 
 +== Change the shape of the aura state ==
 Change the node's aura shape by accessing the node information window in "Node options" section. Change the node's aura shape by accessing the node information window in "Node options" section.
  
-<center> +{{ wiki:mapas_red_21.png }}
-[[image:mapas_red_21.png]] +
-</center>+
  
 Click on **Update node** to save changes. Click on **Update node** to save changes.
  
-==== Delete relations between nodes ====+== Delete relations between nodes ==
 Access the agent's information and in the **Relations** section select the interfaces in the **Interface Source** for each node to delete the link. Access the agent's information and in the **Relations** section select the interfaces in the **Interface Source** for each node to delete the link.
  
Line 231: Line 241:
 {{ wiki:nw-map13.png }} {{ wiki:nw-map13.png }}
  
-===== Mass node edition =====+=== Mass node edition ===
 You may select several nodes two ways: You may select several nodes two ways:
  
-  * Keeping the <code>Ctrl</code> key pressed and clicking on each of the nodes to be edited.+  * Keeping the ''Ctrl'' key pressed and clicking on each of the nodes to be edited.
   * Click on the secondary button of the mouse and drag to select a specific area that contains the nodes.   * Click on the secondary button of the mouse and drag to select a specific area that contains the nodes.
  
Line 242: Line 252:
   * With the right button, deploy a menu with several options, like linking by kinship with another node, add a link to another interface, open wit detail and options window, //or delete nodes//.   * With the right button, deploy a menu with several options, like linking by kinship with another node, add a link to another interface, open wit detail and options window, //or delete nodes//.
  
-{{ wiki:nw-map14.png ?800|Click to zoom in}}+{{ wiki:nw-map14.png?800 |Click to zoom in}}
  
 If you open the detail and options window, you may see information about the node, the interface, the relations with other nodes and you also have the option of changing the shape of the aura status (in the case of a fictitious node, changing its shape). If you open the detail and options window, you may see information about the node, the interface, the relations with other nodes and you also have the option of changing the shape of the aura status (in the case of a fictitious node, changing its shape).
  
-===== Creation of agent nodes =====+=== Creation of agent nodes ===
 Click on an empty space within the network map and choose the option **Add node**. Click on an empty space within the network map and choose the option **Add node**.
    
-<br><br> 
-<center> 
-[[image:nw-map15.png]] 
-</center> 
-<br><br> 
  
-==== Single node creation ====+{{ wiki:nw-map15.png }} 
 + 
 + 
 +== 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. 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.
  
-<center> +{{ wiki:nw-map17.png }}
-[[image:nw-map17.png]] +
-</center>+
  
 Once selected, click on **Add Agent node** to create the new map node. Once selected, click on **Add Agent node** to create the new map node.
  
-==== Mass node creation ====+== 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**. 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**.
  
-<center> +{{ wiki:nw-map18.png }}
-[[image:nw-map18.png]] +
-</center>+
  
-==== Fictional node creation ====+== 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**. 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**.
-<center> 
-[[image:nw-map19.png]] 
-</center> 
  
-===== Modify the zoom level ===== +{{ wiki:nw-map19.png }}
-With the mouse wheel, you may change the zoom in level on the network map, to see in detail one of its sectionsThere is a total of 5 zoom levels. +
- +
- +
-<br><br>+
  
 +=== 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.
  
  
-[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]+[[en:documentation:start|Go back to Pandora FMS documentation index]]
  
-[[Category:Pandora FMS]] 
ºº