Aller au contenu principal

Ubiquiti AirFiber SNMP

Contenu du Plugin-Pack

Objets supervisés

Le Plugin-Pack Ubiquiti AirFiber SNMP collecte les données pour:

  • Interfaces
  • Load
  • Memory
  • Radios

Règles de découvertes

Nom de la règleDescription
Net-Ubiquiti-Airfiber-SNMP-Interface-NameDécouvre les interfaces réseaux et supervise le statut et l'utilisation de la bande passante
Net-Ubiquiti-Airfiber-SNMP-Radio-NameDécouvre les interfaces radios et supervise le statut et l'utilisation de la bande passante

Métriques collectées

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]

Prérequis

Afin de contrôler votre équipement Ubiquiti AirFiber, le SNMP doit être configuré.

Installation

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Network-Ubiquiti-Airfiber-Snmp
  1. Sur l'interface Web de Centreon, installer le Plugin-Pack Ubiquiti AirFiber SNMP depuis la page "Configuration > Plugin packs > Manager"

Configuration

  • Ajoutez un nouvel Hôte depuis la page "Configuration > Hôtes"
  • Complétez les champs Adresse IP/DNS, Communauté SNMP et Version SNMP
  • Appliquez le Modèle d'Hôte Net-Ubiquiti-Airfiber-SNMP-Custom

Si vous utilisez la version 3 du protocole SNMP, utilisez la Macro SNMPEXTRAOPTIONS afin de renseigner les paramètres d'authentification et de chiffrement adéquats

MandatoryNameDescription
SNMPEXTRAOPTIONSExtra options SNMP

FAQ

Comment puis-je tester le Plugin et que signifient les options des commandes ?

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis un collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/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

La commande devrait retourner un message de sortie de la forme ci-dessous:

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;

Cette commande contrôle le système load-average (--mode=load) d'un équipement Ubiquiti AirFiber ayant pour adresse 10.30.2.114 (--hostname=10.30.2.114) en version 2c du protocol SNMP (--snmp-version='2c') et avec la communauté ubiquiti_ro (--snmp-community='ubiquiti_ro').

Cette commande déclenchera une alarme WARNING si le load-average est supérieur à 3 (--warning-load15='3') et une alarme CRITICAL si supérieur à 7 (--critical-load15='7').

Pour chaque mode, la liste de toutes les métriques, seuils associés et options complémentaires peut être affichée en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins/centreon_ubiquiti_airfiber_snmp.pl \
--plugin=network::ubiquiti::airfiber::snmp::plugin \
--mode=load \
--help

J'obtiens le message d'erreur suivant:

UNKNOWN: SNMP GET Request : Timeout

Si vous obtenez ce message, cela signifie que vous ne parvenez pas à contacter l'équipement sur le port 161, ou alors que la communauté SNMP configurée n'est pas correcte. Il est également possible qu'un firewall bloque le flux.

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

Si vous rencontrez cette erreur, il est probable que les autorisations données à l'agent SNMP soient trop restreintes.

  • L'équipement ne prend pas en charge la MIB utilisée par le Plugin (branche: .1.3.6.1.4.1.41112).
  • L'OID SNMP ciblé ne peut pas être récupéré en raison de privilèges d'équipement insuffisants.