Skip to main content

Ubiquiti AirFiber SNMP

Plugin-Pack Assets​

Monitored Objects​

The Plugin-Pack Ubiquiti AirFiber SNMP collects metrics for:

  • Interfaces
  • Load
  • Memory
  • Radios

Discovery rules​

Rule nameDescription
Net-Ubiquiti-Airfiber-SNMP-Interface-NameDiscover network interfaces and monitor bandwidth utilization
Net-Ubiquiti-Airfiber-SNMP-Radio-NameDiscover radio interfaces and monitor bandwidth utilization

Collected Metrics​

Metric nameDescriptionUnit
statusStatus of the interface
interface_name#interface.traffic.in.bitspersecondIncoming traffic going through the interfaceb/s
interface_name#interface.traffic.in.percentagePercentage of the interface's in bandwidth usage%
interface_name#interface.traffic.out.bitspersecondOutgoing traffic going through the interfaceb/s
interface_name#interface.traffic.out.percentagePercentage of the interface's out bandwidth usage%

A regexp filter is available to target a specific interface identifier - ifName [--interface='^eth0$' --name]

Prerequisites​

To control your Ubiquiti AirFiber, the SNMP must be configured.

Setup​

  1. Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Network-Ubiquiti-Airfiber-Snmp
  1. On the Centreon Web interface in "Configuration > Plugin packs > Manager", install the Ubiquiti AirFiber SNMP Plugin-Pack

Host configuration​

  • Add a new Host and fill the IP Address/FQDN, SNMP Version and SNMP Community fields according to the device's configuration
  • Apply the Net-Ubiquiti-Airfiber-SNMP-Custom Host Template

When using SNMP v3, use the SNMPEXTRAOPTIONS Macro to add specific authentication parameters

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_ubiquiti_airfiber_snmp.pl \
--plugin=network::ubiquiti::airfiber::snmp::plugin \
--mode=load \
--hostname=10.30.2.114 \
--snmp-version='2c' \
--snmp-community='ubiquiti_ro' \
--warning-load15='3' \
--critical-load15='7' \
--verbose

Expected command output is shown below:

OK: Load average 0.00 (1m), 0.00 (5m), 0.00 (15m) | 'system.loadaverage.1m.count'=0.00;;;0; 'system.loadaverage.5m.count'=0.00;;;0; 'system.loadaverage.15m.count'=0.00;0:3;0:7;0;

The command above monitors Ubiquiti AirFiber (--plugin=network::ubiquiti::airfiber::snmp::plugin --mode=load) identified by the IP address 10.30.2.114 (--hostname=10.30.2.114). As the Plugin is using the SNMP protocol to request the device, the related community and version are specified (--snmp-version='2c' --snmp-community='ubiquiti_ro').

This command would trigger a WARNING alarm if system load average is over 3 (--warning-load15='3') and a CRITICAL alarm over 7 (--critical-load15='7').

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_ubiquiti_airfiber_snmp.pl \
--plugin=network::ubiquiti::airfiber::snmp::plugin \
--mode=load \
--help

Troubleshooting​

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, ...)

UNKNOWN: SNMP GET Request : Cant get a single value.​

This error message often refers to the following issues:

  • The agent doesn't support the MIB used by the plugin
  • The targeted SNMP OID cannot be fetched because of insufficient privileges on the device. SNMP Agent must be capable of accessing to the enterprise branch: .1.3.6.1.4.1.41112