Skip to content
Release: Australia · Updated: 2026-07-09 · Official documentation · View source

SD-WAN data model

The ServiceNow AI Platform® uses a custom data model that defines how SD-WAN connectors discover and retrieve device information.

The high-level Telecom Data Model, part of the Common Service Data Model (CSDM), does not define how specific technologies such as SD-WAN should be modeled. To address this gap, the SD-WAN data model provides a dedicated set of classes and relationships that define the structure of an SD-WAN network within the Configuration Management Database (CMDB).

The model documents comprehensive details about network assets, including configuration data, available ports, and bandwidth allocations across sites and services. This enables centralized management of SD-WAN repositories, streamlined provisioning and monitoring, and efficient resource allocation for building and maintaining network infrastructure.

The Discovery Builder framework supports the SD-WAN data model. You can use the framework to create and customize discovered objects that map directly to SD-WAN-specific classes and relationships, such as controllers, edge devices, tunnels, overlays, and underlays. Discovered data is mapped to the appropriate SD-WAN classes rather than to generic network CI types, supporting downstream assurance workflows such as fault management and performance monitoring."

ServiceNow AI Platform® SD-WAN data model architecture

Image omitted: sd-wan-architecture.svg
SD-WAN architecture class relationships

The following table describes the classes used in the SD-WAN data model and the type of data each class stores.

ClassDescription
GroupDiscovered organizations or administrative domains (ADOMs). Required
CompanyDiscovered organizations or administrative domains
Network siteNetwork site, including geographical information
Network service instanceLogical grouping of devices and their associated configurations
Network equipment modelsProduct model of the equipment
IP router or any other supported equipment classesHardware or network gear classification, used for storing information about network equipment
Key valuesAdditional attributes or fields related to a CI that aren't covered by predefined CI columns
Network interfaceNetwork interface on a piece of equipment
Network adapterNetwork adapter on a piece of equipment
IP addressManagement IP address associated with a device
Per-device licenseLicense assigned to a specific device. Optional
LocationLocation of a network site