Maps

The Data tab enables you to select resources to apply to the map.

Perform the following steps to set the settings for the Data tab.

1. For Datasource and Resource Type settings, please refer to section Select Widget Resources in Create.
   If you change the Datasource, you will get the following message. You have the choice to Confirm the new data source selected and continue or click Cancel to cancel it.

   
   Note: Resource Type, Object, allows you to search on object description, device display name, and plugin.ObjectName. You must enter a string in double-quotes. Search can also be performed on a word. You may enter one or more strings/words in Resource Type > Object.
   Example# 1
   If you enter "IP of device" echo CPU196640, these are 3 key terms to search on. All objects containing IP of device, echo, and CPU196640 will be available to choose from.
   IP of device is in double-quotes as the search is on all words with space in between. A string can have one or more spaces in it.
   Example# 2
   If you enter IP of device echo CPU196640, these are 5 key terms to search on. All objects containing IP, of, device echo, and CPU196640 will be available to choose from.
   Example# 3
   If you enter CPU, all objects containing CPU will be available to choose from. It can return objects such as CPU196640 CPU196632, etc.
   
2. After selecting the resources, click Add.
3. Enable Use Lat/Long Metadata to allow user to choose a metadata namespace. This option enables using metadata in SevOne NMS to automatically place devices on the map at the coordinates found in the metadata value. Once the user specifies a namespace and attribute to look for the latitude / longitude information, nodes with valid metadata show with icon denoting this to the user.
   Note: The device(s) added must have topology links as well as latitude / longitude metadata value. At present latitude / longitude only works for devices.

   The list of available Namespace(s) and its corresponding Attribute(s) are obtained from SevOne NMS you are using as a datasource.

   1. Namespace - click the namespace drop-down to choose a namespace from the list.
   2. Attribute - click the drop-down to choose an attribute from the list.
   3. Click Add All to Map button adds all devices as new nodes on the map that have valid latitude / longitude metadata denoted by icons.
      Note: Once the devices are added as new nodes on the map, a pop-up appears in the upper-right corner which indicates that the nodes with latitude and longitude have been successfully added. For example,
      

      

      Click Undo to remove the nodes added on the map or Dismiss to accept the message.

4. Select one or more options from the Resources list or you may select the Select all check box to choose all the resources in the list. Click the Remove button to remove the selected resources.
   Note: Replace Untitled Map with a map name. For example, Map - Asia.
5. Choose Canvas or Map mode.
   Note: Canvas mode is an infinite space to place map items. Map mode is a graphically based map. Maps can have both states defined which allows switching between them seamless.
   Warning: IMPORTANT: Missing / misconfigured tile server for Map mode
   As the tile server for Map (geospatial) mode is missing or misconfigured in SevOne Data Insight 3.13.0 - 3.13.9, 3.14.0 - 3.14.6, 6.5.0 - 6.5.4, and 6.6.0, Map mode is unavailable. To resolve this or if you are installing SevOne Data Insight 6.7.0 or above, you are required to perform additional configuration to obtain the proper tiles for the maps.

   Note: Create tile server URL
   For details on how to create a tile server URL, please refer to SevOne Data Insight Administration Guide > Configuration > Helm Chart > Configure Maps > section Create Tile Server URL.

   • for Dark mode, https://api.mapbox.com/styles/v1/sevone/cllfjv99c01mp01ql9neoau07/tiles/256/{z}/{x}/{y}@2x?access_token=<ACCESS_TOKEN>
   • for Light mode, https://api.mapbox.com/styles/v1/sevone/cllfl73f101qb01qnc7wh22i5/tiles/256/{z}/{x}/{y}@2x?access_token=<ACCESS_TOKEN>

   • if using Command Line Interface,
     • refer to to SevOne Data Insight Administration Guide > section Configuration > Helm Chart > Configure Maps. You are required to configure variables tileserver and attribution under maps.
     • you must perform an upgrade to SevOne Data Insight 6.7.0 or above. For details on how to upgrade using the command line interface, please refer to SevOne Data Insight Upgrade Process Guide > section using Command Line Interface.
   • if using Graphical User Interface,
     • you must perform an upgrade to SevOne Data Insight 6.7.0 or above. Please refer to SevOne Data Insight Upgrade Process Guide > section using Graphical User Interface > at step Configure, configure variables Tileserver and Attribution under Maps and successfully complete the upgrade.

   Important: NOTICE
   Failure to set variable maps.tileserver while performing an upgrade from SevOne Data Insight 3.13.0 - 3.13.9, 3.14.0 - 3.14.6, 6.5.0 - 6.5.4, and 6.6.0 to SevOne Data Insight 6.7.0 or above, will convert your current map in Maps mode to Canvas mode without the ability to switch back to Map mode until the tile server is provided.
   
   If the owner of the selected tile server requires to be given credit for the tiles being used, set variable maps.attribution. Text entered in variable maps.attribution will appear in the bottom right corner of each map.

   For further assistance, please contact SevOne Support Team or your Technical Account Manager to configure this properly.

   1. Mode: Canvas > Options drop-down
      • Choose the LAYOUT on how you want to view your topology. It can be Organic, Sequential, Lens, or Custom.
        Note: Alert Status and Metrics Styling options turn on/off the styling rules temporally for the map. For example, turning off Alert Status stops the map from coloring or sizing nodes based on alert status until it is turned back on. The same applies to Metrics Styling.
      • Choose the OVERLAYS. For example, Metrics Styling or Alert Status.
   2. Mode: Map > Options drop-down
      • Choose the OVERLAYS. For example, Metrics Styling or Alert Status.
6. Click to drag-and-drop one or more nodes from the results list onto the map to create nodes on the map.
   Note: Maps has two mouse modes - hand mode and pointer mode . To toggle between mouse modes, click on the icon above the zoom level as shown in the screenshot below.
   To create links between nodes/links or to move the nodes/links around, you must be in pointer mode.
   To pan around the area, you must be in hand mode. Hand mode does not interact with nodes/links.
   Note: Edit a Node
   To edit a single node, please refer to section Edit a Node.
   To edit nodes grouped together, please refer to section Edit a Group of Nodes.
7. Current Resources may be removed at any time by selecting the resource from the Resources list and clicking Remove. Deleting a resource from the Widget Resource list is a destructive process and cannot be undone.
   Note: Deleting a resource from the current Resources list is a destructive process and cannot be undone.
   Deleting a resource does not remove its associated nodes from the map. You must individually delete nodes and node links to remove them from the map.
8. Bookmarks allow you to save any Maps view that you frequently visit. Any bookmarks generated are based exactly upon the current view within the Maps viewer.
   1. To bookmark an area, click on the icon, located at the lower left-hand side of the map.
   2. In the Bookmark name field, enter a name for the bookmark. Click on the to save the bookmark.

The following fields apply to Canvas and Map modes.

1. CANVAS STYLE - adjusts the background color for canvas mode.
   1. Label Color - select the text color for the node name.
   2. Label Backing - select the text background color for the node name.
   3. Show node labels - enable to display the node names.
   4. Show link labels - enable to display the link names.
2. GENERAL
   1. Enable Map Options - select check box to allow you to configure the following settings. If check box is unchecked, he following settings cannot be changed.
      • Allow Geo/Canvas Switching - allows you to switch between Geo and Canvas settings.
      • Allow Overlay Toggling - allows OVERLAYS toggling for Metrics Styling and Alert Status.
      • Allow Layout Switching - allows you to choose the topology layout. The layout can be Organic, Sequential, Lens, or Custom.
      • Allow Tag Toggling - if tags are associated with the node(s), they can be toggled to hide / show the node(s).
      • Allow Policy Toggling - allows you to toggle the policies to be shown / hidden on the map interface.

The following fields apply to Map mode only.

1. ZOOMING
   1. Range - extend the bar to the right to increase the zoom level or shorten the bar to decrease it. With this, you can increase the zoom level to allow street view in Maps. The zoom level range is between 1 - 20 and 9 is the default value.
2. CLUSTERING
   1. Enable clustering - enable to cluster the nodes on the map.
   2. Cluster Distance - slider defines how sensitive the clustering is to zoom level. Higher values mean the nodes will cluster at wider zoom levels.

3. BACKGROUND Choose Geo or Image option.

   1. Geo
      • Tile Server URL - the default tile server URL is only available if it is already set as described in the warning message above. The client browser must have an internet connection for this to work. Please note the tile server must work with the Leaflet. For additional details, please refer to https://leafletjs.com/reference-1.9.3.html#tilelayer.
        Note: If you have already set variables tile server and attribution and successfully installed or performed an upgrade to SevOne Data Insight 6.7.0 or above but, would now like to change the tile server for aesthetic, functional, or network/security purposes, you may easily do so by resetting variables maps.tileserver and maps.attribution in /opt/SevOne/chartconfs/di_custom.yaml file using the Command Line Interface as described in the warning message above.
   2. Image
      • Custom images can be uploaded (from the Image Gallery or Drag and Drop or Browse Files) or by entering the image URL to use as background for the Maps.
        Note: Nodes are not shared between Map and Image. Once you switch, you will lose the details.

Click button.

Option# 1

Right-click on a node. For example, CHI-SR01. This will bring up the Edit node pop-up.

1. Name - contains the name of the node you want to edit. If you want to change the node name, enter the name in this field and it will dynamically change the name.
2. Show label - enable to display node name selected. For example, CHI-SR01.
3. Tags - click the drop-down list to select an existing tag name or, enter a tag name to create one. The tag name can be added to the node(s) and link(s). Nodes/Links can be hidden/shown by tag name by checking/unchecking tags in the Options drop-down in the top left corner of the map.
4. TOPOLOGY
   • Filter by link type - enable to filter linked devices by link type and only generate topology for the desired link type.
   • Hops - determines how many levels out to generate the topology for. One hop generates topology only for the selected node. Two hops generate the topology for the selected nodes and all its direct neighbors, etc.
   • Click Generate Topology to use the selected node as a focal device for a topology query. Connected nodes and links will be automatically populated on the map using the specified number of hops.
5. Click to delete the selected node. For example, CHI-SR01.

Option# 2

Click on a node. For example, CHI-SR01. The right-panel will display 2 tabs - General and Metrics.

1. Name - enter the name of the node.
2. Show label - select the check box to display node name selected. For example, CHI-SR01.
3. Tags - click the drop-down list to select an existing tag name or, enter a tag name to create one. The tag name can be added to the node(s). Nodes can be hidden / shown by tag name by checking / unchecking tags in the Options drop-down in the top left corner of the map.
4. Resources - displays the selected nodes as the resources. Click Select all to select all the resources in the list. Remove will removed the selected resources.
5. Click Delete to delete the selected node. For example, CHI-SR01.

Metrics

1. DISPLAY AGGREGATION
   Note: Determines which aggregation is used to influence the coloring or sizing on the map by metric value. If more than one indicator is attached, this setting will decide if the minimum, maximum, average, or total value of the set is used.

   • Choose a metrics from options Min, Max, Average, and Total.

2. ATTACH INDICATORS
   Note: Metric attachments are required to be of the same unit type. Once selections are made, further selections are filtered by the chosen unit type.
   • Under Resource Type, Device will contain the name of the node selected.
   • Add one or more objects under Objects.
   • For Resource Type > Indicator Type, add one or more indicator types.
   • After selecting the resources, click Add.
   • Select one or more options from the Resources list or you may select the Select all check box to choose all the resources in the list. Click the Remove button to remove the selected resources.

1. Click to drag-and-drop the device group onto the map.

   

2. Right-click on the node and choose Expand Device Group or Explode Devices.

   

   Expand Device Group
   Expands the device group to the next level below it. To further expand, right-click on the node you choose to expand and select Expand Device Group.

   
   

   Expand Device Group only works for resource type, device groups.

   Note: You will see that 24 nodes in this example have been added. To accept, click Dismiss button. To collapse the group, click Undo.

   

   Explode Devices
   Explodes all group members in all the children.

   • When exploding device groups, it returns the devices.
   • When exploding object groups, it returns the objects.
   Note: You will see that 61 nodes in this example have been added. To accept, click Dismiss button. To collapse the group, click Undo
   
3. If you want to edit a single node, select the node and follow details in section Edit a Node.
4. Select more than one node and right-click to perform a Bulk Edit OR choose General and Metrics tabs in the right-panel to make the edits.
   1. Bulk Edit
      
   2. General and Metrics tabs

      General tab

      
      • Name - contains the names of the selected nodes.
      • Show label - select the check box to display node name(s) selected. For exa mple, LON-SW1, itl-sp01-br01.sevitlab.net, and LON-CORE01.
      • Tags - click the drop-down list to select an existing tag name or, enter a tag name to create one. The tag name can be added to the node(s). Nodes can be hidden / shown by tag name by checking / unchecking tags in the Options drop-down in the top left corner of the map.
      • Resources - displays the selected nodes as the resources. Click Select all to select all the resources in the list. Remove will removed the selected resources.
      • Click Delete to delete the selected node(s). For example, LON-SW1, itl-sp01-br01.sevitlab.net, and LON-CORE01.
      
      

      Metrics tab

      

      ATTACH INDICATORS

      Note: Metric attachments are required to be of the same unit type. Once selections are made, further selections are filtered by the chosen unit type.
      • Under Resource Type, Device will contain the name of the node(s) selected.
      • Add one or more objects under Objects.
      • For Resource Type > Indicator Type, add one or more indicator types.
      • After selecting the resources, click Add.
      • Select one or more options from the Resources list or you may select the Select all check box to choose all the resources in the list. Click the Remove button to remove the selected resources.