---
title: Netnology Cisco SD-WAN
description: Cisco SDWAN Controller Metric Exporter
breadcrumbs: Docs > Integrations > Netnology Cisco SD-WAN
---

# Netnology Cisco SD-WAN
Supported OS Integration version1.0.1
## Overview{% #overview %}

This check monitors Cisco SD-WAN controllers through the Datadog Agent using an SD-WAN platform provided by [Netnology](https://netnology.io). The check enables users to monitor the network health and performance of multiple Cisco SD-WAN controllers simultaneously. Collected information can then be used for aggregated dashboarding and notifications on configured monitors/alerts.

Currently, only Cisco vManage devices are supported as SD-WAN controller targets.

## Setup{% #setup %}

The Netnology Cisco SD-WAN integration is not included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package, so you need to install it manually.

### Installation{% #installation %}

For Agent v7.21+ / v6.21+, follow the instructions below to install the check on your host. See [Use Community Integrations](https://docs.datadoghq.com/agent/guide/use-community-integrations.md) to install with the Docker Agent or earlier versions of the Agent.

1. Run the following command to install the Agent integration:

   ```bash
   datadog-agent integration install -t nn_sdwan==1.0.1
   ```

1. Configure your integration similar to core [integrations](https://docs.datadoghq.com/getting_started/integrations.md).

### Configuration{% #configuration %}

1. Edit the `nn_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 [sample nn_sdwan.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/nn_sdwan/datadog_checks/nn_sdwan/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent).

### Validation{% #validation %}

[Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#agent-status-and-information) and look for `nn_sdwan` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **nn\_sdwan.app\_aware\_routing.jitter**(gauge)           | The change in latency for packets when traversing a link*Shown as millisecond*    |
| **nn\_sdwan.app\_aware\_routing.latency**(gauge)          | The time required for packets to traverse a link*Shown as millisecond*            |
| **nn\_sdwan.app\_aware\_routing.loss\_percentage**(gauge) | The percentage of packets lost during transmission*Shown as percent*              |
| **nn\_sdwan.app\_aware\_routing.rx\_octets**(gauge)       | The number of octets received on a link*Shown as byte*                            |
| **nn\_sdwan.app\_aware\_routing.tx\_octets**(gauge)       | The number of octets transmitted on a link*Shown as byte*                         |
| **nn\_sdwan.cert\_summary**(gauge)                        | The number of normal, warning, and invalid certificates                           |
| **nn\_sdwan.connection\_summary\_stats\_error**(gauge)    | The number of certificate errors for WAN edges, vBond devices, and vSmart devices |
| **nn\_sdwan.connection\_summary\_stats\_total**(gauge)    | The number of certificates for WAN edges, vBond devices, and vSmart devices       |
| **nn\_sdwan.device\_control\_status**(gauge)              | The number of devices that are up, partially up, and/or down                      |
| **nn\_sdwan.reboot\_count**(gauge)                        | The number of times in the past 24 hours that the controller has rebooted         |
| **nn\_sdwan.site\_health**(gauge)                         | The number of sites that are up, contain warnings, and/or are down                |
| **nn\_sdwan.top\_app\_stats**(gauge)                      | The number of bytes sent across a link by application*Shown as byte*              |
| **nn\_sdwan.transport\_interface**(gauge)                 | The number of links with active throughput within a particular range              |
| **nn\_sdwan.vmanage\_count**(gauge)                       | The number of devices for each status                                             |
| **nn\_sdwan.wan\_edge\_health**(gauge)                    | The number of normal, warning and error WAN edges                                 |
| **nn\_sdwan.wan\_edge\_inventory**(gauge)                 | The number of deployed, authorized, staging, and total WAN edges                  |

### Events{% #events %}

The Netnology Cisco SD-WAN integration does not include any events.

### Service Checks{% #service-checks %}

**nn\_sdwan.sdwan\_controller.online**

Returns `CRITICAL` if the remote host cannot be pinged, `WARNING` if the controller can be pinged but is not responding to API calls, and `OK` otherwise.

*Statuses: ok, warning, critical*

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).