Skip to main content

Versa SNMP

Overview​

Versa Networks provides secure cloud IP architecture. In particular, SD-WAN that aims to phase out conventional WAN infrastructures.

The Centreon Plugin-Pack relies on the SNMP protocol to query and collect status and metrics of the Versa equipments.

Plugin-Pack assets​

Monitored objects​

  • CPE
  • Branch
  • Gateway

Discovery Rules​

Rule NameDescription
Net-Versa-SNMP-Ipsec-NameDiscover IPSec tunnels and monitor traffic and packets
Net-Versa-SNMP-Sdwan-NameDiscover SDWAN rules and monitor traffic/hits
Net-Versa-SNMP-Traffic-NameDiscover network interfaces and monitor bandwidth utilization
Net-Versa-SNMP-Packet-Errors-NameDiscover network interfaces and monitor packet errors/discard

Collected metrics​

Metric nameDescriptionUnit
statusStatus of the peers
peer.update.last.secondsLast update by peers

Prerequisites​

Device Configuration​

The SNMP agent must be configured and running on the Versa Networks device. Please refer to the manufacturer documentation to achieve this.

Network flows​

The Centreon Poller must be able to reach the UDP/161 SNMP port of the Versa Networks device.

Installation​

  1. Install the Centreon Plugin package on every Centreon Poller expected to monitor Versa Networks devices:
yum install centreon-plugin-Network-Versa-Snmp
  1. On the Centreon Web interface, install the Versa SNMP Plugin-Pack through "Configuration > Plugin packs > Manager" page.

Host configuration​

  • Add a new Host and apply the Net-Versa-SNMP-Custom Host Template
  • Fill the SNMP Version and Community fields according to the device's configuration

When using SNMP v3, use the SNMPEXTRAOPTIONS Macro to add specific authentication parameters More information in the Troubleshooting SNMP section.

MandatoryNameDescription
SNMPEXTRAOPTIONSConfigure your own SNMPv3 credentials combo

FAQ​

How to test the Plugin and what are the main options for ?​

Once the Plugin installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command:

/usr/lib/centreon/plugins/centreon_versa_snmp.pl \
--plugin=network::versa::snmp::plugin \
--mode=devices \
--hostname=10.0.0.1 \
--snmp-version='2c' \
--snmp-community='mysnmpcommunity' \
--warning-sessions-active-prct='80' \
--critical-sessions-active-prct='90' \
--verbose

Expected command output is shown below:

OK: Device '0' cpu load: 8.00 %, memory used: 10.00%, sessions active: 0 (1000000), sessions failed: 0 (1000000) |
'0#device.cpu.utilization.percentage'=8.00%;;;0;100 '0#device.memory.usage.percentage'=10.00%;;;0;100
'0#device.sessions.active.count'=0;;;0;1000000 '0#device.sessions.active.percentage'=0.00%;0:80;0:90;0;100
'0#device.sessions.failed.count'=0;;;0;1000000 '0#device.sessions.active.percentage'=0.00%;;;0;100
Device '0' cpu load: 8.00 %, memory used: 10.00%, sessions active: 0 (1000000), sessions failed: 0 (1000000)

The command above monitors a Versa Networks device usage (--plugin=network::versa::snmp::plugin --mode=devices) identified

by the IP address 10.0.0.1 (--hostname=10.0.0.1). As the Plugin is using the SNMP protocol to request the device, the related community and version are specified (--snmp-version='2c' --snmp-community='mysnmpcommunity').

This command would trigger a WARNING alarm if the active sessions used raise over 80% of the device session capacity (--warning-sessions-active-prct='80') and a CRITICAL alarm over 90% (--critical-sessions-active-prct='90').

For each Plugin mode, all the options as well as all the available thresholds can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins/centreon_versa_snmp.pl --plugin=network::versa::snmp::plugin --mode=devices --help

UNKNOWN: SNMP GET Request : Timeout​

If you get this message, you're probably facing one of theses issues:

  • The SNMP agent of the device isn't started or is misconfigured
  • An external device is blocking the request (firewall, ...)