Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
a075528
[DOCS-13277] Update side panel references to NDM device view
git-thuerk-done Mar 12, 2026
fe4570f
Add new NDM device view screenshots and video for topology page
git-thuerk-done Mar 12, 2026
51f3812
Update geomap screenshots for NDM device view
git-thuerk-done Mar 12, 2026
d72146e
Update config management and device profiles screenshots for NDM devi…
git-thuerk-done Mar 12, 2026
091f6f4
Update NDM setup page screenshots
git-thuerk-done Mar 12, 2026
2f627b9
Add device view tabs (Metrics, Traffic, Events) and update Syslog/Tra…
git-thuerk-done Mar 12, 2026
88fd99c
Merge remote-tracking branch 'origin/master' into alicia.thuerk/DOCS-…
git-thuerk-done Mar 13, 2026
0ceb293
Update side panel references to NDM device view
git-thuerk-done Mar 13, 2026
43431eb
Apply suggestions from Ida's review
git-thuerk-done Mar 17, 2026
c8c417d
add missing video
git-thuerk-done Mar 17, 2026
a50998f
updates from Ida's review
git-thuerk-done Mar 17, 2026
bea18bc
Update NDM device view sections with new screenshots and reworked con…
git-thuerk-done Mar 19, 2026
a6d43a0
Fix typo in image filename, broken image ref, Vale flag, and trailing…
git-thuerk-done Mar 19, 2026
2568599
Update content/en/network_monitoring/devices/topology.md
git-thuerk-done Mar 20, 2026
9fe24d7
Remove misspelled topology_depdencies.png
git-thuerk-done Mar 20, 2026
bd9731c
Fix Vale warnings: on-premises, ensure → verify
git-thuerk-done Mar 20, 2026
7023bc3
Merge branch 'master' into alicia.thuerk/DOCS-13277-ndm-device-views
git-thuerk-done Mar 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions content/en/network_monitoring/devices/config_management.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Network Configuration Management (NCM) extends [Network Device Monitoring (NDM)]
- Compare two configuration versions side by side
- Use AI-generated summaries to understand changes and their potential impact during incidents

{{< img src="/network_device_monitoring/config_mgmt/network_device_config_redacted.png" alt="Network Device Management configuration tab, showing the most recent configuration and an AI summary of what changed." style="width:100%;" >}}
{{< img src="/network_device_monitoring/config_mgmt/network_device_config_ndm_view.png" alt="Network Device Management configuration tab, showing the most recent configuration and an AI summary of what changed." style="width:100%;" >}}

**Note**: NCM is read-only in Preview.

Expand Down Expand Up @@ -90,13 +90,13 @@ Network Configuration Management (NCM) extends [Network Device Monitoring (NDM)]

## Viewing configurations

Network Configuration Management is accessible from the device side panel in Network Device Monitoring:
Network Configuration Management is accessible from the NDM device view in Network Device Monitoring:

1. Navigate to [Network Device Monitoring][3].
2. Select a device from the device list or from any NDM visualization such as [Device Geomap][4] or the [Device Topology][5] map.
3. Open the **Configuration** tab in the device side panel.
3. Open the **Configuration** tab in the NDM device view.

{{< img src="/network_device_monitoring/config_mgmt/config_tab_redacted.png" alt="Network Device Management side panel, highlighting the Configuration tab." style="width:100%;" >}}
{{< img src="/network_device_monitoring/config_mgmt/config_tab.png" alt="The NDM device view, highlighting the Configuration tab." style="width:100%;" >}}

On the Configuration tab, you can filter what the configuration list displays:
- **All**: Shows both running and startup configurations
Expand Down Expand Up @@ -129,11 +129,11 @@ To see what changed between configuration versions:
1. Select two configurations from the history list or timeline using the checkboxes.
2. Click **Compare Two Configs** to open the comparison view.

{{< img src="/network_device_monitoring/config_mgmt/compare_two_configs_2.png" alt="Network Device Management configuration tab, highlighting the Compare Two Configs option." style="width:100%;" >}}
{{< img src="/network_device_monitoring/config_mgmt/compare_two_configs_3.png" alt="Network Device Management configuration tab, highlighting the Compare Two Configs option." style="width:100%;" >}}

The comparison view shows both configurations side by side with inline diffs that highlight changed lines. You can switch between different configuration pairs without closing the comparison view.

{{< img src="/network_device_monitoring/config_mgmt/config_screen_split_2.png" alt="Network Device Management configuration tab, comparing two versions in split view" style="width:90%;" >}}
{{< img src="/network_device_monitoring/config_mgmt/config_screen_split_3.png" alt="Network Device Management configuration tab, comparing two versions in split view" style="width:90%;" >}}

## AI summaries

Expand Down
8 changes: 4 additions & 4 deletions content/en/network_monitoring/devices/geomap.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ 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%;" >}}
{{< img src="network_device_monitoring/geomap/device_geomap_geolocation_tag.png" alt="The NDM device view of a device, highlighting the `geolocation:paris-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:

Expand All @@ -64,17 +64,17 @@ Configure device locations using the following steps:

## 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.
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 the NDM device view 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 >}}
{{< img src="network_device_monitoring/geomap/geomap_device_cluster_3.mp4" alt="A user zooming in on the map, clicking on a device cluster, and opening the NDM device view of a device." video=true >}}
Comment thread
git-thuerk-done marked this conversation as resolved.

## 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.
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 NDM device view for all tagged locations.

### CSV upload fails

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -101,9 +101,9 @@ Datadog provides reasonable defaults for most devices through out-of-the-box (OO

1. Click the pencil icon to edit and modify any of the default metadata fields.

2. Metadata functionality is available and displayed on the [Network Device Monitoring (NDM)][15] page as searchable facets, and on the side panel of a selected device:
2. Metadata functionality is available and displayed on the [Network Device Monitoring (NDM)][15] page as searchable facets, and in the NDM device view of a selected device:

{{< img src="/network_device_monitoring/profile_onboarding/device_metadata_2.png" alt="The NDM side panel page profile, highlighting the metadata sections." style="width:100%;">}}
{{< img src="/network_device_monitoring/profile_onboarding/device_metadata_2.png" alt="The NDM device view, highlighting the metadata sections." style="width:100%;">}}

### Step 6: Define metrics

Expand Down
2 changes: 1 addition & 1 deletion content/en/network_monitoring/devices/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Network Device Monitoring helps you gain insights into the health and performanc

This guide covers configuring Network Device Monitoring on your hosts, enriching device tags, setting up and viewing device profiles, viewing data in NetFlow Monitoring, and validating data in the provided dashboards and Device Topology Map.

{{< img src="network_device_monitoring/getting_started/ndm_landing_page.png" alt="The Network Device Monitoring landing page, showing graphs and interfaces." style="width:100%;" >}}
{{< img src="network_device_monitoring/getting_started/ndm_landing_page_2.png" alt="The Network Device Monitoring landing page, showing graphs and interfaces." style="width:100%;" >}}

## How it works

Expand Down
8 changes: 8 additions & 0 deletions content/en/network_monitoring/devices/snmp_traps.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,12 +55,20 @@ To enable listening for SNMP traps, use the following instructions:

**Note**: Multiple v3 users and passwords are supported as of Datadog Agent `7.51` or higher.

## Viewing SNMP traps

After configuration, SNMP traps are forwarded as logs to Datadog. You can find them in the [Log Explorer][2] with the following search query: `source:snmp-traps`.

{{< img src="network_device_monitoring/snmp/snmp_traps_3.png" alt="Log Explorer showing `source:snmp-traps` with an SNMP trap log line selected, highlighting the Network Device tag" style="width:90%" >}}

<div class="alert alert-info">Even though SNMP traps are <em>forwarded as logs</em>, <code>logs_enabled</code> does <strong>not</strong> need to be set to <code>true</code>.</div>

You can also view SNMP traps directly from the NDM device view. Select a device in [**Infrastructure > Network Devices**][8] and click the **Events** tab. Syslog messages and SNMP traps are combined in a single view. Use the filters to narrow results by event type.

{{< img src="network_device_monitoring/network_topology_map/events.png" alt="The NDM device view with the Events tab open, showing Syslog messages and SNMP traps." style="width:100%;" >}}
Comment thread
git-thuerk-done marked this conversation as resolved.

[8]: https://app.datadoghq.com/devices

### Using the default SNMP trap port 162

Binding to a port number under `1024` requires elevated permissions. To bind to a port number such as the default SNMP Trap port `162`, use the following instructions:
Expand Down
4 changes: 2 additions & 2 deletions content/en/network_monitoring/devices/syslog.md
Original file line number Diff line number Diff line change
Expand Up @@ -186,9 +186,9 @@ After your network devices are configured and the Datadog Agent is running, you

4. Optionally, to observe Syslog messages in NDM, navigate to [**Infrastructure > Network Devices**][5].
- Select a device that is configured to send Syslog messages.
- In the device side panel, click the **Syslog** tab to view your Syslog messages:
- In the NDM device view, click the **Events** tab. Syslog messages and SNMP traps are combined in a single view. Use the filters to narrow results by event type.

{{< img src="network_device_monitoring/syslog/syslog_tab.png" alt="Network Device Monitoring side panel, highlighting the Syslog tab." style="width:100%;" >}}
{{< img src="network_device_monitoring/network_topology_map/events.png" alt="The NDM device view with the Events tab open, showing Syslog messages and SNMP traps." style="width:100%;" >}}
Comment thread
git-thuerk-done marked this conversation as resolved.

## Further Reading

Expand Down
61 changes: 49 additions & 12 deletions content/en/network_monitoring/devices/topology.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ aliases:
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"
text: "Visualize relationships across your on-premises network with the Device Topology Map"
- link: "/network_monitoring/devices/data"
tag: "Documentation"
text: "Data Collected with Network Device Monitoring"
Expand All @@ -23,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_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" >}}
{{< img src="/network_device_monitoring/network_topology_map/network_topology_map_new_4.mp4" alt="A user adds team, service, and vendor tags to the network device topology map, then selects a device to open the NDM device view." video="true" >}}

## Setup

Expand Down Expand Up @@ -62,21 +62,57 @@ By default, the **Unmonitored Device** option is unchecked, which hides devices

## Investigating 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.
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 the NDM device view with details such as its IP address, tags, throughput, CPU, and memory.

{{< 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%;" >}}
While investigating a device, click the **Open Device Page** dropdown in the top right of the device view to navigate to [NetFlow Monitoring][1] or other related pages for deeper investigation.

### Link details
{{< img src="/network_device_monitoring/network_topology_map/network_topology_map_device_inspect_view_7.png" alt="The Network Device Topology Map with a device selected, displaying information in the NDM device view." style="width:100%;" >}}

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].
### Dependencies

The **Dependencies** section in the NDM device view shows the number of physically connected devices and VPN tunnels at a glance, along with a visual graph of neighboring devices.

{{< img src="/network_device_monitoring/network_topology_map/topology_dependencies.png" alt="The NDM device view showing the Dependencies section with a graph of connected devices." style="width:100%;" >}}

Click **View dependencies** to open the full device page. On the **Dependencies** tab, use the **Physical** or **VPN** filters to switch between physical connections and VPN tunnels (VPN dependencies require [VPN Monitoring][12] to be configured). The physical view displays a topology graph alongside a table of connected devices showing their status, device name, IP address, monitors, local interface, and remote interface.

{{< img src="/network_device_monitoring/network_topology_map/ndm_summary_dependencies.png" alt="The Dependencies tab on the NDM device page with the Physical filter selected, showing a topology graph and a table of connected devices with status, IP address, and interface details." style="width:100%;" >}}

### Metrics

Click the **Metrics** tab in the NDM device view to see key metrics for the device, including CPU usage, memory usage, and throughput. Summary stats are displayed at the top, and each metric is shown as a graph over time. Click **View all metrics** to explore the full list of collected metrics.

{{< img src="/network_device_monitoring/network_topology_map/metrics_3.png" alt="The NDM device view with the Metrics tab open, showing CPU, memory, and throughput graphs." style="width:100%;" >}}

### Traffic

Click the **Traffic** tab to view total, inbound, and outbound throughput for the device. A traffic graph shows activity over time, and the **Top Conversations** table lists the highest-volume source-to-destination flows with bit rate, packet rate, and total bytes. Click **View traffic** to investigate further on the device summary page, and in [NetFlow Monitoring][1].

{{< 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" >}}
{{< img src="/network_device_monitoring/network_topology_map/traffic_2.png" alt="The NDM device view with the Traffic tab open, showing throughput stats, a traffic graph, and a Top Conversations table." style="width:100%;" >}}

### Events

Click the **Events** tab to view Syslog messages and SNMP traps in a single, combined view. Use filters to narrow results by event type. Spikes in event volume are visually highlighted, helping you identify and investigate errors.

{{< img src="/network_device_monitoring/network_topology_map/events.png" alt="The NDM device view with the Events tab open, showing Syslog messages and SNMP traps." style="width:100%;" >}}

### View flow details

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].
To explore a device's traffic sources, destinations, and volume, click the **Open Device Page** dropdown and select **NetFlow Monitoring**. 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_4.png" alt="The NDM device view with the Open Device Page dropdown showing the NetFlow Monitoring option." style="width:100%;" >}}

### Device settings

Click the **Device Settings** icon in the NDM device view to open the Device Settings panel. The **Information** tab displays general details (name, namespace, and description), network details (IP address, subnet, and geolocation), and hardware details (model, vendor, OS, and version). The **Tags** tab lets you view and manage tags associated with the device.

{{< img src="/network_device_monitoring/network_topology_map/device_settings.png" alt="The Device Settings panel for an NDM device, showing the Information tab with general, network, and hardware details." style="width:90%;" >}}

### 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/netflow_tab_3.png" alt="View of the Device side panel, with the NetFlow tab highlighted." style="width:100%;" >}}
{{< img src="/network_device_monitoring/network_topology_map/link_details.mp4" alt="A user clicking on a link between devices to view additional link details." video="true" >}}

### Icon legend

Expand Down Expand Up @@ -136,7 +172,7 @@ There are no devices because NDM is not configured.

### Missing devices/connections

The Device Topology Map data is based on LLDP (Link Layer Discovery Protocol) and CDP (Cisco Discovery Protocol) information collected with SNMP. If your map is missing devices and/or connections, ensure the following:
The Device Topology Map data is based on LLDP (Link Layer Discovery Protocol) and CDP (Cisco Discovery Protocol) information collected with SNMP. If your map is missing devices and/or connections, verify the following:

- Datadog Agent version 7.52 or later is installed.
- Devices have LLDP and/or CDP enabled with SNMP.
Expand All @@ -155,7 +191,7 @@ sudo -u dd-agent datadog-agent snmp walk <DEVICE_IP> 1.3.6.1.4.1.9.9.23

### Missing connections or links

If your device is exposing topology data with LLDP or CDP but some of the connections are missing, ensure that the **Unmonitored Device** selection is off.
If your device is exposing topology data with LLDP or CDP but some of the connections are missing, verify that the **Unmonitored Device** selection is off.

### Unmonitored devices showing on map

Expand Down Expand Up @@ -202,4 +238,5 @@ NDM provides multiple visualization tools to monitor your infrastructure:
[8]: /network_monitoring/devices/topology
[9]: /network_monitoring/devices/geomap
[10]: https://app.datadoghq.com/devices
[11]: https://app.datadoghq.com/devices/netflow
[11]: https://app.datadoghq.com/devices/netflow
[12]: /network_monitoring/devices/vpn_monitoring/
Loading
Loading