Viptela SD-WAN Integration Service


This integration is a subscription-based Professional Services engagement. Our Integration Services are offered as subscriptions in order to provide initial setup and ongoing compatibility and maintenance. All standard packages are renewable every 12 months from the date of purchase. Contact Zenoss to request more information regarding this or any other ZenPacks.


Viptela SD-WAN Integration Service

This ZenPack adds SNMP modeling/monitoring for Viptela vedge devices Optionally a vManage device, acting as an endpoint, can use the Viptela REST API to create events based on /dataservice/alarms and create/delete Viptela devices (vedge, vbond, vsmart, vmanage) based on /dataservice/device


Zenoss RM 4.2.5 or greater

ZenPacks.zenoss.ZenPackLib 2.0.0 or greater


Typical SNMP device configuration is needed for Viptela vedge devices

The vManage device, acting as an endpoint, must be added in the device class /Network/Viptela/Endpoint Because it connects to the Viptela REST API, it requires valid values in Configuration Properties. NOTE: The value(s) for these properties are the same you would use to login to the UI of the vManage device

  • zViptelaUsername
  • zViptelaPassword

Optional Configuration Properties used to access the Viptela REST API

  • zViptelaURLScheme
  • zViptelaURLPort
  • zViptelaBulkPageSize (used in alarm retrieval)

Optional Configuration properties used to specify which DeviceClass Viptela devices are created in

  • zViptelaVEdgeDeviceClass (default is /Network/Viptela/VEdge)
  • zViptelaVSmartDeviceClass (default is /Network/Viptela/VSmart)
  • zViptelaVManageDeviceClass (default is /Network/Viptela/VManage)
  • zViptelaVBondDeviceClass (default is /Network/Viptela/VBond)

Optional configuration for skipping https certificates checking

  • viptelahttpspolicy (default is blank or not present)

    Add a configuration option in in the global.conf of zenpython, zenmodeler, zminion services. If the value is set to "insecure", certificates checking on https connections to Viptela Endpoint will be disabled. Like the name suggest this is insecure and the proper work around is to add the necessary trusted roots to Zenoss. Instead of editing global.conf in the 3 services zenpython, zenmodeler, and zminion you can "Edit Variables" in Control Center on the Zenoss Application like "Zenoss.resmgr" and add the value "global.conf.viptelahttpspolicy insecure". Any change requires a restart of zenpython, zenmodeler, zminion services to pick up that change. This approach has been deprecated starting since 1.10.3 andzViptelaHttpsCertValidationshould be used to achieve the same result.

  • zViptelaHttpsCertValidation

    This zProp has been introduced in 1.10.3 version of ZenPack to skip certificate checking. Note: if viptelahttpspolicy is set to False, then it will override zViptelaHttpsCertValidation value.

ViptelaAlarmDataSource Configuration

  • Query (default is Viptela alarms occurring in the last 3 hours) Defines the value of the "query" parameter posted to /dataservice/alarms . Refer to Viptela documentation on what Value are acceptable to the Viptela API.
  • Enable Debug Events (default is disabled) If enabled, creates an event with Severity Debug listing Viptela Alarm Plugin Stats like how many alarms were collected from Viptela endpoint, how many were turned into events and how many were skipped.



  • Update https certificates verification


  • Addendpoint_uuidduring device creation


  • Fix to handle correctly float 'timeout' value in easysnmp


  • Allow changing Viptela Device ID's without impacting Discovery from Endpoint Devices. Previously the Device IDs were used, causing Discovery to break if the Device ID was changed.


  • Add "Enable Debug Events" option to ViptelaAlarmDataSource
  • Add ability to ignore certificate checking on https connections to Viptela Endpoint


  • Create MIB Organizer "Viptela"


    Note: Dependent MIBs SNMPv2-SMI and SNMPv2-TC may need to be manually added

  • The query parameter sent to Viptela Alarms webservice is now configurable

  • New modeler zenoss.snmp.ViptelaDevice for modeling the vEdge device HW TotalMemory


  • Add SNMP modeling and monitoring for vedge devices
  • Discontinue using REST API except for Alarms and Device Discovery
  • Remove a viptela device if it was added by endpoint and is no longer included in the REST API results
  • Split vedge Interface graph into 3 graphs
  • Modernize to use ZenPackLib 2.0


  • Wrap modeler plugin and zenviptela doTask to generate events for uncaught exceptions
  • Change interface RRD type to GAUGE
  • Change zenviptela hub service base class to not inherit unneeded features from the collector framework
  • Hub service to cache proxies for up to 6 hours
  • Alarms include full data returned by vManage


  • Handle missing object ID
  • Change bulk stats look back to 30 minutes
  • Set RRD step for interface stats to 10 minutes
  • Replace CPU stats with load average
  • Set zenviptela RRD heartbeat to 6 * step


  • Move all Viptela API calls to use bulk state and statistics APIs
  • Remove calls which lack bulk API calls:
    • get_tunnels_stats
    • get_tunnels
    • get_hardware_health
    • System Status mem_total
    • BGP neighbor perf
    • Hardware perf
  • Set manufacturer/product to Viptela/device-type
  • Use standard serial number field
  • Flatten device hierarchy and use "Endpoint" sub-class for vManage
    • vManage devices still added as non-endpoints to /Network/Viptela

Components Modeled

  • PS
  • ControlConnection
  • Tunnel
  • Temperature Sensor
  • Fan
  • Interface
  • BGP Neighbor

Device Class Templates


  • Orchestrator
    • Graphs
      • VBond Connections
    • Thresholds
      • VEdge Warning Count
    • Datapoints
      • vsmart_counts
      • vmanage_counts
      • vedge_counts


  • VipBGPNeighbor
    • Thresholds
      • bgp state
    • Datapoints
      • bgpBgpNeighborState
      • bgp_msg_rcvd
      • bgp_msg_sent
      • bgp_outQ
  • VipFan
    • Thresholds
      • fan state
    • Datapoints
      • hardwareEnvironmentStatus
  • VipSystemStatus
    • Graphs
      • Disk
      • Load Average
      • Memory
    • Datapoints
      • systemStatusMin15Avg
      • systemStatusMemUsed
      • systemStatusDiskAvail
      • systemStatusMin1Avg
      • systemStatusMemFree
      • systemStatusMin5Avg
      • systemStatusDiskUsed
  • VipInterface
    • Graphs
      • Drops and Errors
      • Packets
      • Octets
    • Datapoints
      • if-admin-status
      • if-oper-status
      • interfaceRxPackets
      • interfaceTxPackets
      • interfaceTxErrors
      • interfaceRxOctets
      • interfaceRxErrors
      • interfaceRxDrops
      • interfaceTxOctets
      • interfaceTxDrops
  • VipTemperature
    • Thresholds
      • temperature state
    • Datapoints
      • hardwareEnvironmentStatus
  • VipConnection
    • Thresholds
      • control connection state
    • Datapoints
      • controlConnectionsState
  • VipTunnel
    • Thresholds
      • tunnel state
    • Datapoints
      • bfdSessionsListState
  • VipPS
    • Thresholds
      • ps state
    • Datapoints
      • hardwareEnvironmentStatus