Support Center Home

Cisco SD-WAN Monitoring


LogicMonitor’s out-of-the-box monitoring for Cisco SD-WAN networking architecture leverages the Cisco vManage API to monitor performance and availability metrics for various edge devices across your network. Cisco SD-WAN is also known as Viptela SD-WAN. ​​


As of March 2021, LogicMonitor’s Cisco SD-WAN vManage package is known to be compatible with Cisco SD-WAN vManage API:

  • Version 17.2.2 through version 19.2.31, including CSRF token use for versions 19.2.1 and up

As Cisco releases newer versions of SD-WAN vManage API, LogicMonitor will test and extend coverage as necessary.

Setup Requirements​

Add Resources Into Monitoring

Add your Cisco SD-WAN vManage host into monitoring. For more information on adding resources into monitoring, see Adding Devices. ​

Obtain Credentials

LogicMonitor must provide the appropriate credentials in order to successfully access the Cisco vManage resource’s data. These credentials must belong to a vManage/API user. See Cisco’s vManage REST API documentation for details.

Assign Properties to Resources

Once credentials have been obtained, the following custom properties must be set on the vManage resource within LogicMonitor. For more information on setting properties, see Resource and Instance Properties.

vmanage.uservManage username
vmanage.passvManage password
vmanage.portThe TCP port used to connect to vManage API endpoint. If not set, the port defaults to 8443.

Import LogicModules

From the LogicMonitor public repository, import all Cisco SD-WAN LogicModules, which are listed in the LogicModules in Package section of this support article. If these LogicModules are already present, ensure you have the most recent versions.

Once the LogicModules are imported (assuming all previous setup requirements have been met), data collection will automatically commence.


The modules in this package are designed with a debug mode embedded in the scripts. If issues occur, turn on debug mode in the script by setting the variable debug to “true” to get more information in the output when testing the script in the Collector Debug Facility. For more information on testing scripts in the Collector Debug Facility, see Script Troubleshooting.

LogicModules in Package

LogicMonitor’s package for Cisco SD-WAN consists of the following LogicModules. For full coverage, please ensure that all of these LogicModules are imported into your LogicMonitor platform.

Display NameTypeDescription
addERI_Cisco_vManagePropertySourceSets Cisco HyperFlex host UUID ERI for topology mapping.
addCategory_Cisco_vManagePropertySourceIdentifies if the device is a vManage host and sets a system category.
Cisco_SDWAN_TopologyTopologySourceGenerate Cisco SD-WAN topologies based on data from the vManage API.
Cisco vManage: WAN Edge InventoryDataSourceMonitors the WAN edge inventory of devices and their validity and deployed/staging state.
Cisco vManage: Transport HealthDataSourceMonitors vManage overall transport performance metrics such as jitter, loss and latency.
Cisco vManage: SitesDataSourceMonitors all sites associated to the vManage portal.
Cisco vManage: OMP PeersDataSourceDisplay information about active OMP peering sessions.
Cisco vManage: OMPDataSourceMonitors vManage device OMP (Overlay Management Protocol) metrics.
Cisco vManage: IPv4 InterfacesDataSourceDisplay information about IPv4 interfaces.
Cisco vManage: DevicesDataSourceMonitors all sites associated to the vManage portal.
Cisco vManage: Control WAN InterfacesDataSourceDisplay information about the WAN interface control connection.
Cisco vManage: Certificate SummaryDataSourceDisplay information about certificates.
Cisco vManage: BFD Summary Per TLOCDataSourceMonitors BFD session metrics by device per TLOC (transport location).
Cisco vManage: BFD SessionsDataSourceDisplay information about BFD sessions.
Cisco vManage: BFD Device SummaryDataSourceMonitors BFD session metrics by device.
Cisco vManage: Application Aware Routing StatsDataSourceMonitors Application Aware Routing metrics.
Cisco vManage: Application Aware Routing SLA ClassesDataSourceMonitors Application Aware Routing metrics.
Cisco vManage: AlarmsDataSourceMonitors vManage portal active and cleared alarms.

The DataSources in this package do not include predefined datapoint thresholds (that is, no alerts will trigger based on collected data). This is because the technology owner has not provided KPIs that can be reliably extended to the majority of users. If you’d like to receive alerts for collected data, you’ll need to manually create custom thresholds, as discussed in Tuning Static Thresholds for Datapoints.

In This Article