Documentation forSolarWinds Platform Self-Hosted

Display the Worldwide Map in the SolarWinds Platform

This topic applies only to the following products:

SolarWinds Observability Self-Hosted

DPAIMEOCNAMNCMNPMNTASAMSRMUDTVMANVNQM

The Worldwide map uses the MapQuest Web SDK to display the Worldwide map in the SolarWinds Platform Web Console and the MapQuest Batch Geocode API to get nodes coordinates. Nodes and groups that contain information about their location are displayed automatically. See Place nodes automatically on the Worldwide Map in the SolarWinds Platform.

Objects with the same position are displayed as one location.

Although there is one Worldwide map, you can add the Worldwide Map widget to multiple views, and display different objects and information on each view. For example, you can apply different zoom levels, use different titles and subtitles, or center the map on different coordinates.

If you cannot see the Worldwide Map widget on a view, add the widget. See Add widgets to SolarWinds Platform views, or classic dashboards.

Add nodes manually

Add a new location into the map, and define the nodes positioned in the location.

  1. Click Manage Map in the Worldwide Map widget.
  2. Click Place Nodes on the Map Manually, and click into the map where you want to place the nodes.
  3. Use the Grouping and Search tools to select nodes which you want to place on the map.

    Click > next to a node group to expand a list of all nodes in the group.

  4. Provide a name for the location.
  5. Click Place on Map.
  6. Click Submit.
    If you want to further edit the map, click Save and Continue.

Edit the position of locations

If the exact position is not known or important, you can drag locations to their positions.

  1. Click Manage Map in the Worldwide Map widget.
  2. Click a map location, and click Edit Location.
  3. Provide the Latitude and Longitude of the new location, and click Save.
  4. Click Submit.
    If you want to further edit the map, click Save and Continue.

Add or remove nodes in locations, or rename locations

  1. Click Manage Map in the Worldwide Map widget.
  2. Click the map location you want to edit, and click Edit at the top right of the list of nodes at the selected map location.
  3. Add or remove nodes in the location.
    • Select nodes to be added in the Available Objects section.
    • To remove nodes, click x next to the node in the Selected Objects section.

      If you want to rename the location, type the new name in the Name of Location field at the bottom of the Available Objects section.

  4. Click Save Changes.
  5. To apply your changes in the resource, click Submit or Save and Continue if you want to further edit your worldwide map.

Delete locations

  1. Click Manage Map in the Worldwide Map widget.
  2. Select the map location.
  3. Click Remove from Map, and then confirm the map location removal.
  4. Click Submit.
    If you want to further edit the map, click Save and Continue.

See also Worldwide Map.

Define an API key for Worldwide maps

Starting with 2023.3, you can use a custom API key for the MapQuest provider. You can continue using the API key provided by SolarWinds.

To set a custom API key for Worldwide maps:

  1. In the SolarWinds Platform Web Console, click Settings > All Settings, and then click Web Console Settings in the Product Specific Settings.

  2. Scroll down to Worldwide Map Settings.

  3. In Map API Key, provide the key you want to use for communication with the MapQuest map provider and save your settings.

The new API key will now be used in requests to MapQuest.