Cisco SD-WAN Agent (TLocAgent)

Edit online

TLocAgent collects Transport Location (TLOC) data from the Cisco Edge devices using aggregated API and provides time-series metrics for the TLOC object type in the SD-WAN plug-in. By default, the agent runs every 5 minutes to collect the TLOC data and update the NMS.

The following data flow process explains how the TLOC agent retrieves device information, collects TLOC metrics, and updates the NMS for monitoring and visualization.

Fetch all devices from the NMS that are created during the activation of the SNMP and SD-WAN plugins.
Retrieve all Viptela devices from vManage.
For each Viptela device, query the TLOC metrics to capture performance indicators such as jitter, latency, and packet loss.
Send aggregated TLOC data to the corresponding NMS devices for monitoring and visualization. Provide the following performance indicators for the object type SDWAN::TLOC:
- Jitter
- Latency
- Packet loss
Due to potential delays in data availability from vManage, the retrieval of TLOC data might be delayed by up to 50 minutes. To accommodate this delay, a default 50-minute interval is set in the configuration file. The TLOC agent collects data that is up to 50 minutes old from vManage.
Note: You can modify the configuration by following the steps in section Configure Polling and Query Interval.

Configure Polling and Query Interval

To change the default polling frequency or modify the query interval for TLOC data collection, execute the following steps.

Using ssh, log in to SevOne NMS appliance as support.
```
ssh support@<NMS appliance>
```
You need to run as root. Enter the following command to run/switch to root.
```
sudo su
```
Enter the NMS container.
```
nms
```
Using a text editor of your choice, edit /config/collectors/sdwan/Cisco-SDWAN/default-Cisco-SDWAN.yaml file to set the following environment variables and then, save it.
```
vi /config/collectors/sdwan/Cisco-SDWAN/default-Cisco-SDWAN.yaml
```
1. To modify the polling frequency from the default 5-minute interval, adjust the following configuration settings.
```
agent:
  override:
    TLocagent:
      schedule: '@every 5m'

 
```
2. To modify the query interval from the default 50-minute interval, adjust the following configuration settings.
```
vendor:
  cisco_api:
    query_interval: 50mschedule: '@every 5m'

 
```

You can access the TLocAgent logs from the following location.

/var/log/SDWAN/Cisco-SDWAN<Integration_Device_ID>/<Collector-Cisco-SDWAN_Build_Number>/

Important:

TLocAgent pulls data from vManage with a default 50-minute delay due to possible data availability issues.
You can configure the polling frequency and query interval to meet the specific needs of your environment.