The Cisco Viptela (SD-WAN) integration allows for the visibility of network devices, links, and application traffic, helping you ensure that your WAN is performing optimally. Upon installation, you can discover Cisco Viptella components, view resource relationships, monitor job metrics, and receive alerts for efficient maintenance.

Prerequisites

  • OpsRamp Classic Gateway 15.0.0 and above
  • OpsRamp Nextgen Gateway 15.0.0 and above
  • It is recommended to use the latest Gateway version to get a full coverage. (Recent bug fixes, enhancements. etc)
  • Customer need to provide Viptela Provider API login credentials
  • The Viptela Manager device should be reachable from the gateway and port (default port - 8443) must be opened.
  • The assigned credentials should have admin privileges to collect all the required data.
  • All URLs used for discovery and monitoring should work with the assigned credentials.

Configure Cisco Viptela (SD-WAN) Integration

Click here to Configure and Install the Cisco Viptela (SD-WAN) Integration
  1. To select your client, navigate to All Clients, and click the Client/Partner dropdown menu.
  2. Navigate to Setup > Account. The Account Details screen is displayed.
  3. Click Integrations. The Installed Integrations screen is displayed with all the installed applications.
    Note: If you do not have any installed applications, you will be navigated to the Available Integrations and Apps page with all the available applications along with the newly created application with the version.
  4. Click + ADD on the Installed Integrations page.
    Note: Search for the integration either by entering the name of the integration in the search bar or by selecting the category of the integration from the All Categories dropdown list.
  5. Click ADD in the Cisco Viptela (SD-WAN) application.
  6. In the Configuration screen, click + ADD. The Add Configuration screen appears.
  7. Enter the following BASIC INFORMATION:


Field NameDescriptionField Type
NameStringEnter the name for the configuration.
Host Name / IP AddressStringEnter the domain name or the IP address of the target system. This is the address that OpsRamp will use to communicate with the device or system being integrated.
Is SecureCheckboxSelect this checkbox if you want the communication between your system and the specified endpoint to be secured using protocols such as HTTPS (HTTP over SSL/TLS).
Default Selection: It is enabled by default. When selected, it signifies that the connection is encrypted, providing an added layer of security to the data being transmitted.
PortIntegerSpecify the port number that OpsRamp will use to connect to the target system.

Note: By default, the port number is 443.

CredentialsStringSelect the credentials required to authenticate OpsRamp with the target system. You can either select the credentials from the dropdown menu or add a new credential.
To add a credential, click +ADD. The ADD CREDENTIAL dialog box appears. Enter the following details:
  1. Credential Type: By default, it is set to APPLICATION.
  2. Name: Enter the name of the application.
  3. Description: Enter the description for the application.
  4. User Name: Enter the user name.
  5. Password: Enter the password.
  6. Confirm Password: Confirm the password.
  7. Click ADD
App Failure NotificationsCheckboxWhen selected, you will be notified in case of an application failure such as Connectivity Exception, Authentication Exception.
Event PollingThe Event Polling field set allows you to configure how the system polls for events or incidents from the target environment.
Alert ConfigurationCheckboxEnable this checkbox to activate alert generation during event polling. When this option is selected, the system will monitor the specified events and trigger alerts according to the defined alerting rules.
CUSTOM ATTRIBUTESThis field set allows you to specify custom metadata or properties that will be associated with the integration. You can choose from predefined custom attributes and assign corresponding values that are relevant to the integration being installed.
Custom AttributeDropdownSelect the custom attribute from the dropdown list.
ValueDropdownEnter or select the corresponding value for the custom attribute.
Resource TypeToggle
  • If you want to select all the resource types, select ALL.
  • If you want to select specific resource types, toggle to SELECT and select the resource types from the list. You can add Filters to the resource types by clicking +FILTERS against each resource type. The following fields appear:
  • Key: Specify the attribute or property of the resource type by which you can filter.
    Example: IP Address
  • Operator: Select the condition that can be applied to the selected key.
    Example: "="
  • Input Value: Enter the specific value that the selected key will be compared against using the chosen operator.
DISCOVERY SCHEDULEToggleThe Discovery Schedule allows you to configure how frequently the discovery process runs to detect and update information about resources within your environment. You can set the schedule to run at different intervals, depending on your needs. The available options are:
  1. None: Select this option if you do not want to schedule any discovery operations. Discovery will not run automatically, and you will need to trigger it manually.
  2. Minutes: Allows you to set the discovery process to run every few minutes. You will be able to select the number of minutes between each discovery run.
  3. Hourly: Schedule the discovery process to run every few hours. You will be able to select the number of hours between each discovery run.
  4. Daily: Choose this option if you want the discovery process to run once a day. You will be able to set the specific time of day when the discovery should occur.
  5. Weekly: Set the discovery process to run on specific days of the week. You will be able to choose the day(s) and the time of day for the discovery run.
  6. Monthly: Schedule the discovery process to run on specific days of the month. You can select the date(s) and time for each monthly discovery.
  1. Click ADD.


The configuration is saved and displayed on the configurations page after you save it.
Note: From the same page, you may Edit and Remove the created configuration.
12. Under the ADVANCED SETTINGS, select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.
Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.
13. Click NEXT.
14. (Optional) Click +ADD to create a new collector. You can either use the pre-populated name or give the name to your collector.
15. Select an existing registered profile.


  1. Click FINISH.
    The integration is installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed integration.

Modify Cisco Viptela (SD-WAN) Integration

Click here to Modify the Configuration

Discover Resources in Cisco Viptela (SD-WAN) Integration

Click here to View the Cisco Viptela (SD-WAN) Details

To discover resources for Cisco Viptela (SD-WAN) Storage:

  1. Navigate to Infrastructure > Search > software-defined-wan > Cisco Viptela (SD-WAN). The Cisco Viptela (SD-WAN) page is displayed.
  2. Select the application on the Cisco Viptela (SD-WAN) page
  3. The RESOURCE page appears from the right.
  4. Click the ellipsis (…) on the top right and select View Details.
  5. Navigate to the Attributes tab to view the discovery details.

View resource metrics

To confirm Cisco Viptela (SD-WAN) monitoring, review the following:

  • Metric graphs: A graph is plotted for each metric that is enabled in the configuration.
  • Alerts: Alerts are generated for metrics that are configured as defined for integration.
  1. Click the Metrics tab to view the metric details for Cisco Viptela (SD-WAN).