Smartscape - Extensions - Networking

• Reference
• Published Apr 09, 2026

This section documents the generic network model for Smartscape. The model consists of two entities - Network Device and Network Interface - which are populated by network extensions and integrations (both Dynatrace-developed and custom).

IDs

The Smartscape ID for Network Devices (EXT_NETWORK_DEVICE) is calculated based on the its chassis' MAC address which can be defined as the first valid MAC address assigned to the device components.

For Network Interfaces (EXT_NETWORK_INTERFACE) the Smartscape ID is calculated based on both the underlying device's chassis MAC address as well as the interface's name.

Device types

The device_type field allows narrowing down the scope of queries by the device's technology type. Within the SNMP Autodiscovery extension, this value is computed based on the device's System Object ID (1.3.6.1.2.1.1.2) and allows mapping to a recommended Dynatrace Extension for further monitoring.

Integrators can reuse the same value or provide their own alternative to describe the general family of such devices.

Monitoring modes

The monitoring_mode field indicates the level of data available for a particular device. SNMP Autodiscovery uses two such values:

Dynatrace Extensions as well as other integrators are advised to use the value Extension. This indicates that the device is polled directly and benefits of monitoring insights from a specialized integration.

Network Device

Smartscape node type: EXT_NETWORK_DEVICE

A Network Device entity. Represents a physical device with network connectivity.

Query

Fetch all network device entities.

smartscapeNodes EXT_NETWORK_DEVICE

Count network devices by their monitoring mode.

smartscapeNodes EXT_NETWORK_DEVICE
| summarize count(), by: { monitoring_mode }

Find devices that are network neighbors and include their names.

smartscapeEdges calls
| filter target_type == "EXT_NETWORK_DEVICE"
| fieldsAdd source_name=getNodeName(source_id), target_name=getNodeName(target_id)

Base entity fields (i.base_entity)

The following base fields are used for all entities.

External network entity fields (i.ext_network_entity)

Fields common to all entities within the shared network model

External network device fields (i.ext_network_device)

Fields that describe all network devices

External network SNMP device fields (i.ext_network_snmp_device)

Fields specific to network devices discovered via SNMP

External network autodiscovered device fields (i.ext_network_autodiscovered_device)

Fields specific to network devices created by the SNMP Autodiscovery extension

Network Device relationship fields

Network Interface

Smartscape node type: EXT_NETWORK_INTERFACE

A Network Interface entity. Represents a physical or virtual network interface or port on a network device.

Query

Fetch all network interface entities.

smartscapeNodes EXT_NETWORK_INTERFACE

Fetch traffic in and out timeseries for all network interfaces.

timeseries {
  traffic.in=avg(com.dynatrace.extension.network_device.if.bytes_in.count, scalar: true),
  traffic.out=avg(com.dynatrace.extension.network_device.if.bytes_out.count, scalar: true)
},
filter: { isNotNull(dt.smartscape.ext_network_interface) },
by: { dt.smartscape.ext_network_interface }

Fetch all interfaces that are link neighbors with each other, along with the devices they belong to.

smartscapeEdges calls
| filter source_type == "EXT_NETWORK_INTERFACE"
| fields
  neighbor.device=getNodeName(getNodeField(source_id, "references")[belongs_to.ext_network_device][0]),
  neighbor.interface=getNodeName(source_id),
  relation=concat("--- ", type, " --->"),
  base.interface=getNodeName(target_id),
  base.device=getNodeName(getNodeField(target_id, "references")[belongs_to.ext_network_device][0])

Base entity fields (i.base_entity)

The following base fields are used for all entities.

External network entity fields (i.ext_network_entity)

Fields common to all entities within the shared network model

External network interface fields (i.ext_network_interface)

Fields representing all network interfaces when running on network devices

Network Interface relationships fields