Skip to main content

Ubiquiti AirFiber SNMP

Monitoring Connector Assets​

Monitored Objects​

The Monitoring Connector 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 > Monitoring Connector Manager, install the Ubiquiti AirFiber SNMP Monitoring Connector

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 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_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