[DOCS-12421] Network Devices GeoMap (#32854)

* adding params

* updating screenshots for topology

* adding landing page info

* add overview and troubleshooting

* adding mappings

* last update today

* adjusting setup

* add video

* fix decimal degrees and add link

* feedback from PM

* Apply suggestions from code review

Co-authored-by: Joe Peeples <joe.peeples@datadoghq.com>

* incorporating feedback from Joes review

* update references to geomap tag; replace with geolocation tag

* new screenshot

* fix screenshot

* final screenshot fix

* adding table with examlples

* rename image

* replace image

---------

Co-authored-by: Joe Peeples <joe.peeples@datadoghq.com>

Author: git-thuerk-done

config/_default/menus/main.en.yaml

@@ -3676,10 +3676,10 @@ menu:
       parent: ndm
       identifier: ndm_profiles
       weight: 304
-    - name: Device Topology Map
-      url: network_monitoring/devices/device_topology_map
+    - name: Maps
+      url: network_monitoring/devices/topology
       parent: ndm
-      identifier: ndm_topology_map
+      identifier: ndm_network_maps
       weight: 305
     - name: SNMP Metrics Reference
       url: network_monitoring/devices/data

config/_default/params.yaml

@@ -141,6 +141,8 @@ code_language_ids:
     traces: "Traces"
     metrics: "Metrics"
     logs: "Logs"    
+    topology: "Topology Map"
+    geomap: "Geomap" 
 branch: ""
 
 signupclass: sign-up-trigger

content/en/network_monitoring/devices/_index.md

@@ -38,7 +38,7 @@ Network Device Monitoring (NDM) gives you visibility into your on-premises and v
     {{< nextlink href="network_monitoring/devices/getting_started" >}}<u>Getting Started</u>: Getting started with Network Device Monitoring{{< /nextlink >}}
     {{< nextlink href="network_monitoring/devices/supported_devices" >}}<u>Supported devices</u>: View supported NDM devices{{< /nextlink >}}
     {{< nextlink href="network_monitoring/devices/snmp_metrics?tab=snmpv2" >}}<u>SNMP Metrics</u>: Collect SNMP Metrics from your network devices {{< /nextlink >}}
-    {{< nextlink href="network_monitoring/devices/device_topology_map" >}}<u>Device Topology Map</u>: View your network's physical connections{{< /nextlink >}}
+    {{< nextlink href="network_monitoring/devices/topology" >}}<u>Device Maps</u>: View your network's physical and geographical connections{{< /nextlink >}}
     {{< nextlink href="network_monitoring/devices/guide/device_profiles/" >}}<u>SNMP Profile Manager </u>: Getting started with device profiles{{< /nextlink >}}
     {{< nextlink href="network_monitoring/devices/integrations/" >}}<u>Integrations </u>: Supported NDM Integrations{{< /nextlink >}}
 {{< /whatsnext >}}

content/en/network_monitoring/devices/geomap.md

@@ -0,0 +1,106 @@
+
+---
+title: Device Geomap
+code_lang: geomap
+type: multi-code-lang
+code_lang_weight: 1
+further_reading:
+- link: "https://www.datadoghq.com/blog/visualize-network-device-topology/"
+  tag: "Blog"
+  text: "Visualize relationships across your on-premise network with the Device Topology Map"
+- link: "/network_monitoring/devices/data"
+  tag: "Documentation"
+  text: "Data Collected with Network Device Monitoring"
+- link: "https://www.datadoghq.com/blog/monitor-snmp-with-datadog/"
+  tag: "Blog"
+  text: "Monitor SNMP with Datadog"
+---
+
+## Overview
+
+[Device Geomap][1] displays the geographic distribution of your network devices discovered through Network Device Monitoring (NDM). Using the [Geomap Widget points visualization][11], it plots devices on a geographical map based on their configured locations, allowing you to visualize site coverage, assess connectivity, and monitor regional network health. Use it to identify device outages, latency issues, or coverage gaps across distributed environments.
+
+{{< img src="network_device_monitoring/geomap/device_geomap.png" alt="Network Device Geomap tab displaying the location of mapped devices." style="width:100%;" >}}
+
+### Prerequisites
+
+- [Network Device Monitoring][2] must be configured on your devices.
+- Devices must be tagged using the `geolocation:<value>` format, where `<value>` is the location identifier. 
+
+## Configuring locations
+
+Devices appear on the Device Geomap when they're tagged with `geolocation:<value>` and mapped to geographic coordinates.
+
+For example:
+| Geolocation   | Latitude | Longitude |
+|---------------|----------|-----------|
+| nyc-office    | 40.758896| -73.98513 |
+| denver-office | 39.7433  | -104.9886 |
+| boston-office | 42.3601  | -71.0589  |
+| singapore     | 1.3521   | 103.8198  |
+
+Configure device locations using the following steps:
+
+1. Tag devices using the `geolocation:<value>` format, where `<value>` is the location identifier. See the [network device tagging][4] documentation for more information.
+
+   {{< img src="network_device_monitoring/geomap/device_side_panel.png" alt="Network Device side panel of a device, highlighting the `geolocation:boston-office` tag." style="width:100%;" >}}
+
+2. From the Device GeoMap page, click **Add locations** in the top right corner. This opens the [Geomap locations settings][3] page, which provides multiple tabs to manage device locations:
+
+   - **All**: Displays all devices with `geolocation` tags, regardless of their mapping status.
+   - **Needs Coordinates**: Shows devices tagged with `geolocation` values that don't have corresponding location coordinates configured.
+   - **On Map**: Lists tagged devices with configured coordinates that are displayed on the Geomap.
+   - **Unused**: Shows location mappings (coordinates) that have been configured but are not associated with any tagged devices.
+
+   {{< img src="network_device_monitoring/geomap/settings_on_map.png" alt="Settings page of Device Geomap, highlighting the All tab." style="width:100%;" >}}
+
+3. On the settings page, click **+ Add mapping** and enter the location value along with its latitude and longitude coordinates in [decimal degrees][10] notation. 
+
+   {{< img src="network_device_monitoring/geomap/add_mapping.png" alt="Settings page of Device Geomap, displaying the Add Mapping screen with fields for location, latitude, and longitude." style="width:80%;" >}}
+
+4. To bulk import locations, select **Import from CSV** from the **+ Add mapping** dropdown. The CSV form provides a template you can download and use.
+
+   {{< img src="network_device_monitoring/geomap/mapping_csv.png" alt="Settings page of Device Geomap, displaying the Import from CSV option." style="width:90%;" >}}
+
+## Viewing devices
+
+After devices are added to the map, you can zoom in to click on an individual device or select a device cluster to view all devices in that location. Clicking on any device opens a side panel with detailed device information, including status, tags, and key metrics.
+
+{{< img src="network_device_monitoring/geomap/geomap_device_cluster.mp4" alt="A user zooming in on the map, clicking on a device cluster, and opening the side panel of a device that is unreachable. " video=true >}}
+
+## Troubleshooting
+
+If you experience issues using Device Geomap, use the following troubleshooting guidelines. If you need further assistance, contact [Datadog support][5].
+
+### Device appears in multiple locations
+
+When a device is tagged with multiple `geolocation` tags, it displays at only one location on the map. However, when you click on any device cluster containing that device, it appears in the side panel for all tagged locations. 
+
+### CSV upload fails
+
+If your CSV file fails to upload despite appearing correct, verify the following:
+
+- No missing commas between fields
+- No extra spaces or special characters
+- Proper formatting according to the CSV template (available for download in the **+ Add mapping > Import from CSV** form)
+
+### Tagged device does not appear on map
+
+If a device doesn't appear on the map after tagging:
+
+1. Verify that the location tag has coordinates configured on the [Settings][3] page.
+2. Allow a few minutes for tag updates to be reflected in the map.
+
+## Further Reading
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://app.datadoghq.com/devices/maps/geomap
+[2]: /network_monitoring/devices/setup#configuration
+[3]: https://app.datadoghq.com/devices/settings/geomap
+[4]: /network_monitoring/devices/setup#enrich-network-devices-with-tags
+[5]: /help
+[8]: /network_monitoring/devices/topology
+[9]: /network_monitoring/devices/geomap
+[10]: https://en.wikipedia.org/wiki/Decimal_degrees
+[11]: /dashboards/widgets/geomap/?tab=points

content/en/network_monitoring/devices/device_topology_map.md renamed to content/en/network_monitoring/devices/topology.md

@@ -1,7 +1,12 @@
+
 ---
 title: Device Topology Map
+code_lang: topology
+type: multi-code-lang
+code_lang_weight: 0
 aliases:
-- /network_monitoring/devices/network_topology_map
+- /network_monitoring/devices/network_topology_map 
+- /network_monitoring/devices/device_topology_map
 further_reading:
 - link: "https://www.datadoghq.com/blog/visualize-network-device-topology/"
   tag: "Blog"
@@ -18,7 +23,7 @@ further_reading:
 
 The [Network Device Topology Map][2] uses [Cloudcraft][7] diagrams to provide an interactive visual representation of your network's physical connections. The map automatically discovers and displays devices, their interfaces, and the relationships between them. This visualization helps you identify issues in your network devices, understand their upstream and downstream impacts, troubleshoot connectivity problems, and gain insights into how traffic flows through your infrastructure.
 
-{{< img src="/network_device_monitoring/network_topology_map/network_topology_map_new.mp4" alt="A user adds team, service, and vendor tags to the network device topology map, then selects a device to open its side panel." video="true" >}}
+{{< img src="/network_device_monitoring/network_topology_map/network_topology_map_new_2.mp4" alt="A user adds team, service, and vendor tags to the network device topology map, then selects a device to open its side panel." video="true" >}}
 
 ## Setup
 
@@ -43,7 +48,7 @@ Under Group By, use **tags** such as `team`, `service`, and `vendor` to select h
 
 Select the **+ Filter** dropdown to refine which devices are displayed on the Device Topology Map.
 
-{{< img src="/network_device_monitoring/network_topology_map/device_topology_filter_2.png" alt="The Device Topology Map with the filter dropdown open." style="width:90%;" >}}
+{{< img src="/network_device_monitoring/network_topology_map/device_topology_filter_3.png" alt="The Device Topology Map with the filter dropdown open." style="width:90%;" >}}
 
 **Note:** The **Filter Devices** setting determines which devices appear on the Device Topology Map for all queries, including those that filter by a device facet in the search bar.
 
@@ -59,15 +64,19 @@ By default, the **Unmonitored Device** option is unchecked, which hides devices
 
 In addition to showing an overview of your network's physical connections, the Device Topology Map lets you investigate individual devices to understand their connections, flows, and overall status. Hover over a device to see its status and key metrics, or click a device to open a side panel with details such as its IP address, tags, throughput, CPU, and memory.
 
-You can also view the device's connected interfaces in the **Interfaces** tab:
+{{< img src="/network_device_monitoring/network_topology_map/network_topology_map_device_inspect_view_6.png" alt="The Network Device Topology Map with a device selected, displaying information about the device in the side panel." style="width:100%;" >}}
+
+### Link details
+
+Click on a link between devices to explore connection details including traffic volume, bandwidth utilization, errors, and discards, with options to view the data in [Device Overview][10] or [NetFlow Monitoring][11].
 
-{{< img src="/network_device_monitoring/network_topology_map/network_topology_map_device_inspect_view_5.png" alt="The Network Device Topology Map with a device selected, displaying information about the device in the side panel." style="width:100%;" >}}
+{{< img src="/network_device_monitoring/network_topology_map/link_details.mp4" alt="A user clicking on a link between devices to open a side panel showing additional link details." video="true" >}}
 
 ### View flow details
 
-Click the **Flow** tab in the side panel to explore the device's traffic sources, destinations, and volume. The data is automatically filtered by the device's `@device.ip`. For more information, see [NetFlow Monitoring][1].
+Click the **NetFlow** tab in the side panel to explore the device's traffic sources, destinations, and volume. The data is automatically filtered by the device's `@device.ip`. For more information, see [NetFlow Monitoring][1].
 
-{{< img src="/network_device_monitoring/network_topology_map/Netflow_tab.png" alt="View of the Device side panel, with the NetFlow tab highlighted." style="width:100%;" >}}
+{{< img src="/network_device_monitoring/network_topology_map/netflow_tab_3.png" alt="View of the Device side panel, with the NetFlow tab highlighted." style="width:100%;" >}}
 
 ### Icon legend
 
@@ -171,16 +180,26 @@ The connections discovered with LLDP or CDP can correspond to devices already mo
 
 The device resolution can fail if the device is not monitored with NDM, or the LLDP or CDP data is insufficient to match the discovered device to the monitored device.
 
+## Next steps
+
+NDM provides multiple visualization tools to monitor your infrastructure:
+
+- **[Device Geomap][9]**: View the geographic distribution of devices across locations to identify regional issues and coverage gaps.
+- **[Device Overview][10]**: Access detailed metrics and performance data for individual devices.
+- **[NetFlow Monitoring][1]**: Analyze traffic flows and bandwidth utilization across your network.
 
 ## Further Reading
 
 {{< partial name="whats-next/whats-next.html" >}}
 
-
 [1]: /network_monitoring/netflow/
 [2]: https://app.datadoghq.com/devices/maps/topology 
 [3]: /network_monitoring/devices/snmp_metrics/?tab=snmpv2#autodiscovery
 [4]: /network_monitoring/devices/profiles/
 [5]: /help
 [6]: /network_monitoring/devices/snmp_metrics/?tab=snmpv2#ping
 [7]: /datadog_cloudcraft/
+[8]: /network_monitoring/devices/topology
+[9]: /network_monitoring/devices/geomap
+[10]: https://app.datadoghq.com/devices
+[11]: https://app.datadoghq.com/devices/netflow