Cisco SD-WAN

Supported OS Linux Windows Mac OS

Overview

The Cisco SD-WAN integration lets you monitor your Cisco SD-WAN environment within Network Device Monitoring. Gain comprehensive insights into the performance and health of your SD-WAN infrastructure, including sites, tunnels, and devices.

Setup

The Cisco SD-WAN NDM integration is in Beta and will not be billed until it is Generally Available.

Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the Autodiscovery Integration Templates for guidance on applying these instructions.

Installation

The Cisco SD-WAN check is included in the Datadog Agent package. No additional installation is needed on your server.

Configuration

The Cisco SD-WAN integrations needs valid credentials to access the Catalyst Manager instance. Credentials should have the “Device monitoring” permission group.

  1. Edit the cisco_sdwan.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Cisco SD-WAN performance data. See the sample cisco_sd_wan.d/conf.yaml for all available configuration options.

  2. Restart the Agent.

Data Collected

Metrics

cisco_sdwan.application.latency
(gauge)
The latency in milliseconds by cloud application.
Shown as millisecond
cisco_sdwan.application.loss
(gauge)
The packet loss by cloud application.
Shown as percent
cisco_sdwan.application.qoe
(gauge)
The QOE score by cloud application.
cisco_sdwan.bfd_session.status
(gauge)
The status of the BFD session. The value is 1 if the session is up, 0 otherwise.
cisco_sdwan.bgp.neighbor
(gauge)
The status of each bgp neighbor. Constant metric equal to 1.
cisco_sdwan.control_connection.status
(gauge)
The status of the control connection. The value is 1 if the connection is up, 0 otherwise.
cisco_sdwan.cpu.usage
(gauge)
Percentage of CPU currently being used.
Shown as percent
cisco_sdwan.crash.count
(count)
The number of crashes.
cisco_sdwan.device.reachable
(gauge)
The status of the device. The value is 1 if the device is reachable, 0 otherwise.
cisco_sdwan.device.uptime
(gauge)
The time (in hundredths of a second) since the network management portion of the system was last re-initialized.
cisco_sdwan.disk.usage
(gauge)
The percentage of disk currently being used.
Shown as percent
cisco_sdwan.hardware.status_ok
(gauge)
The status of each hardware components. The value is 1 if the component is ok, 0 otherwise.
cisco_sdwan.interface.rx_bandwidth_usage
(gauge)
The percent rate of used received bandwidth.
Shown as percent
cisco_sdwan.interface.rx_bits
(count)
The total number of bits received on the interface.
Shown as bit
cisco_sdwan.interface.rx_bps
(gauge)
The inbound bandwidth rate in bits per second.
Shown as bit
cisco_sdwan.interface.rx_drops
(count)
The number of inbound packets chosen to be discarded even though no errors had been detected to prevent them being deliverable to a higher-layer protocol.
Shown as packet
cisco_sdwan.interface.rx_errors
(count)
The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.
Shown as packet
cisco_sdwan.interface.speed
(gauge)
The interface current speed in bits per second.
cisco_sdwan.interface.status
(gauge)
For each interface of each monitored Cisco SD-WAN device, this metric reports always 1 with the adminstatus and operstatus as tags, as long as a 'combined' status that can be used for monitors.
cisco_sdwan.interface.tx_bandwidth_usage
(gauge)
The percent rate of used sent bandwidth.
Shown as percent
cisco_sdwan.interface.tx_bits
(count)
The total number of bits transmitted out of the interface.
Shown as bit
cisco_sdwan.interface.tx_bps
(gauge)
The outbound bandwidth rate in bits per second.
Shown as bit
cisco_sdwan.interface.tx_drops
(count)
The number of outbound packets chosen to be discarded even though no errors had been detected to prevent them being transmitted.
Shown as packet
cisco_sdwan.interface.tx_errors
(count)
The number of outbound packets that could not be transmitted because of errors.
Shown as packet
cisco_sdwan.memory.usage
(gauge)
The percentage of memory currently being used.
Shown as percent
cisco_sdwan.omp_peer.status
(gauge)
The status of the OMP Peer connection. The value is 1 if the session is up, 0 otherwise.
cisco_sdwan.reboot.count
(count)
The number of reboots.
cisco_sdwan.tunnel.jitter
(gauge)
The jitter of the tunnel.
Shown as millisecond
cisco_sdwan.tunnel.latency
(gauge)
The latency in milliseconds of the tunnel.
Shown as millisecond
cisco_sdwan.tunnel.loss
(gauge)
The packet loss of the tunnel.
Shown as percent
cisco_sdwan.tunnel.qoe
(gauge)
The QOE score of the tunnel.
cisco_sdwan.tunnel.rx_bits
(count)
The total number of bits received through the tunnel.
Shown as bit
cisco_sdwan.tunnel.rx_packets
(count)
The total number of packets received through the tunnel.
Shown as packet
cisco_sdwan.tunnel.status
(gauge)
The status of the tunnel. The value is 1 if the tunnel is up, 0 otherwise.
cisco_sdwan.tunnel.tx_bits
(count)
The total number of bits transmitted out through the tunnel.
Shown as bit
cisco_sdwan.tunnel.tx_packets
(count)
The total number of packets transmitted out through the tunnel.
Shown as packet

Events

The Cisco SD-WAN check does not include any events.

Service Checks

The Cisco SD-WAN check does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.