--- title: Device Topology Map description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > Network Monitoring > Network Device Monitoring > Device Topology Map --- # Device Topology Map ## Overview{% #overview %} The [Network Device Topology Map](https://app.datadoghq.com/devices/maps/topology) uses [Cloudcraft](https://docs.datadoghq.com/datadog_cloudcraft/) 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. {% video url="https://datadog-docs.imgix.net/images//network_device_monitoring/network_topology_map/network_topology_map_new_4.mp4" /%} ## Setup{% #setup %} The Datadog Agent version 7.52 and later automatically collects topology data. No additional installation is necessary. ### Prerequisites{% #prerequisites %} 1. Devices have LLDP (Link Layer Discovery Protocol) and/or CDP (Cisco Discovery Protocol) enabled with SNMP. Use the same protocol on connected devices so that they can discover each other. LLDP is generally preferred as it is a more common option. 1. Datadog Agent version 7.52 or later is installed. ## Navigation options{% #navigation-options %} In the Network Topology Map, the following navigation options are available: ### Group by{% #group-by %} Under Group By, use **tags** such as `location` and `vendor` to select how you want to visualize your devices: {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/device-topology-group_by_2.d30c0ba99af942b16360ecaeb6932925.png?auto=format" alt="A Group by control showing tags for location and vendor." /%} ### Filter devices{% #filter-devices %} Select the **+ Filter** dropdown to refine which devices are displayed on the Device Topology Map. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/device_topology_filter_3.2fe5612dae3748cac65338b4f67fe436.png?auto=format" alt="The Device Topology Map with the filter dropdown open." /%} **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. ### Resources{% #resources %} Use the **Resource** dropdown to filter the diagram by specific device types, such as Firewalls, Access Points, and Routers. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/resources_dropdown.f30c34c02d066ccbce9f75603a925112.png?auto=format" alt="The Device Topology Map with the Resources drop-down open, and Unmonitored Device un-checked." /%} By default, the **Unmonitored Device** option is unchecked, which hides devices that are not directly monitored by Network Device Monitoring but are discovered through LLDP/CDP from adjacent monitored devices. Check this option to display these unmonitored devices on the diagram. ## Investigating 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 the NDM device view with details such as its IP address, tags, throughput, CPU, and memory. While investigating a device, click the **Open Device Page** dropdown in the top right of the device view to navigate to [NetFlow Monitoring](https://docs.datadoghq.com/network_monitoring/netflow/) or other related pages for deeper investigation. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/network_topology_map_device_inspect_view_7.2eea0843abcccf129b027dfcd305cb65.png?auto=format" alt="The Network Device Topology Map with a device selected, displaying information in the NDM device view." /%} ### Dependencies{% #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. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/topology_dependencies.ddf1bb838a5d1ec44698eaf6a4c0a568.png?auto=format" alt="The NDM device view showing the Dependencies section with a graph of connected devices." /%} 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](https://docs.datadoghq.com/network_monitoring/devices/vpn_monitoring/) 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. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/ndm_summary_dependencies.3f41789aef2412e2f465bc08e8661268.png?auto=format" 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." /%} ### Metrics{% #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. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/metrics_3.79d94d16f52af59081a6458a12856cf5.png?auto=format" alt="The NDM device view with the Metrics tab open, showing CPU, memory, and throughput graphs." /%} ### Traffic{% #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](https://docs.datadoghq.com/network_monitoring/netflow/). {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/traffic_2.39bb715d0c6e4a582d2df7f755a24f1f.png?auto=format" alt="The NDM device view with the Traffic tab open, showing throughput stats, a traffic graph, and a Top Conversations table." /%} ### Events{% #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. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/events.7f6b545ee284ff471459938eec0f1abd.png?auto=format" alt="The NDM device view with the Events tab open, showing Syslog messages and SNMP traps." /%} ### View flow details{% #view-flow-details %} 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](https://docs.datadoghq.com/network_monitoring/netflow/). {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/netflow_tab_4.b2d30f9921b717da3a77abf256088dbd.png?auto=format" alt="The NDM device view with the Open Device Page dropdown showing the NetFlow Monitoring option." /%} ### Device settings{% #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. {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/device_settings.62b24b473e70e4de3efaba160c51e9f4.png?auto=format" alt="The Device Settings panel for an NDM device, showing the Information tab with general, network, and hardware details." /%} ### Link details{% #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](https://app.datadoghq.com/devices) or [NetFlow Monitoring](https://app.datadoghq.com/devices/netflow). {% video url="https://datadog-docs.imgix.net/images//network_device_monitoring/network_topology_map/link_details.mp4" /%} ### Icon legend{% #icon-legend %} SNMP devices are matched to a representative icon based on their device type in each device node, as defined in their [device profiles](https://docs.datadoghq.com/network_monitoring/devices/profiles/). | Icon | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/icons/access-point.177974fbf9f37c7a4a1ca743066691a9.png?auto=format" alt="Access point icon" /%} | Access Point | | {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/icons/firewall.87e4f6e75bb3fb943f29f017fb1103f6.png?auto=format" alt="Firewall icon" /%} | Firewall | | {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/icons/router.98f0bd7f08a2ed910736f55b81b6967a.png?auto=format" alt="Router icon" /%} | Router | | {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/icons/server.a8f94cce233056012bb674e0e5ce2696.png?auto=format" alt="Server icon" /%} | Server | | {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/icons/switch.528a0440ad4ca5a9624fc9b5acc0722d.png?auto=format" alt="Switch icon" /%} | Switch | | {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/icons/device.4e32f97244e129c77f1d10ae23450a8a.png?auto=format" alt="Device icon" /%} | Device | ## Troubleshooting{% #troubleshooting %} If you experience issues using the Network Topology Map, use the following troubleshooting guidelines. If you need further assistance, contact [Datadog support](https://docs.datadoghq.com/help). ### Empty map message{% #empty-map-message %} {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/no_devices_found.0905f0c2ae6d07cff1df25868ed109af.png?auto=format" alt="The no devices found message that is displayed when NDM is either not configured or because of filtering." /%} There are no devices because NDM is not configured. ### No connections found / No connected devices to show{% #no-connections-found--no-connected-devices-to-show %} {% image source="https://datadog-docs.imgix.net/images/network_device_monitoring/network_topology_map/no_connections_found.2c74a1926d20084c9b8ed8f66f8f391a.png?auto=format" alt="The no devices found message that is displayed when NDM is either not configured or because of filtering." /%} - Turn the **Unmonitored Device** selection on to show the unmonitored devices. - Use categorization tag to help understand your map view with information hierarchy. ### Missing devices/connections{% #missing-devicesconnections %} 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. Verify that your devices are exposing LLDP and CDP data with the following commands: For LLDP data: ```yaml sudo -u dd-agent datadog-agent snmp walk 1.0.8802 ``` For CDP data ``` sudo -u dd-agent datadog-agent snmp walk 1.3.6.1.4.1.9.9.23 ``` ### Missing connections or links{% #missing-connections-or-links %} 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{% #unmonitored-devices-showing-on-map %} The Device Topology Map shows all devices discovered with LLDP or CDP. These can be new devices that are not already monitored with SNMP or existing devices that were not resolved to the equivalent monitored device. You can use the **Unmonitored Device** selection to hide these nodes. ### Device duplicated on map{% #device-duplicated-on-map %} The Device Topology Map shows all devices discovered with LLDP and/or CDP. In some cases, these devices are already monitored with SNMP but can not be resolved to the equivalent monitored device. In this case, the device is shown twice: one node representing the monitored device and one node representing the LLDP/CDP discovered device. Use the **Unmonitored Device** selection to hide the unmonitored nodes. ### Borderless or black nodes on the map{% #borderless-or-black-nodes-on-the-map %} The borderless or black nodes on the Device Topology Map can represent devices discovered with LLDP or CDP that are not configured to be monitored with NDM, or devices discovered with LLDP or CDP that can not be resolved to the equivalent monitored device. ## Device resolution{% #device-resolution %} The Device Topology Map provides an overview of the devices monitored with NDM and their physical connections. The topology links data is based on LLDP (Link Layer Discovery Protocol) or CDP (Cisco Discovery Protocol) information collected with SNMP. The connections discovered with LLDP or CDP can correspond to devices already monitored with SNMP. The device resolution consists in matching the discovered device to the monitored device. ### Device resolution failures{% #device-resolution-failures %} 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{% #next-steps %} NDM provides multiple visualization tools to monitor your infrastructure: - **[Device Geomap](https://docs.datadoghq.com/network_monitoring/devices/geomap)**: View the geographic distribution of devices across locations to identify regional issues and coverage gaps. - **[Device Overview](https://app.datadoghq.com/devices)**: Access detailed metrics and performance data for individual devices. - **[NetFlow Monitoring](https://docs.datadoghq.com/network_monitoring/netflow/)**: Analyze traffic flows and bandwidth utilization across your network. ## Further Reading{% #further-reading %} - [Visualize relationships across your on-premises network with the Device Topology Map](https://www.datadoghq.com/blog/visualize-network-device-topology/) - [Data Collected with Network Device Monitoring](https://docs.datadoghq.com/network_monitoring/devices/data) - [Monitor SNMP with Datadog](https://www.datadoghq.com/blog/monitor-snmp-with-datadog/)