Aller au contenu principal

Ubiquiti UniFi SNMP

Contenu du Pack

Objets supervisés

Le Pack Ubiquiti UniFi collecte les données pour:

  • Cpu
  • Disks
  • Interfaces
  • Load
  • Memory
  • Swap
  • Uptime
  • Virtual Access Points

Règles de découvertes

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

Métriques collectées

Metric nameDescriptionUnit
cpu.user.utilization.percentageCPU User utilization%
cpu.nice.utilization.percentageCPU Nice utilization%
cpu.system.utilization.percentageCPU System utilization%
cpu.idle.utilization.percentageCPU Idle utilization%
cpu.wait.utilization.percentageCPU Wait utilization%
cpu.kernel.utilization.percentageCPU Kernel utilization%
cpu.interrupt.utilization.percentageCPU Interrupt utilization%
cpu.softirq.utilization.percentageCPU SoftIrq utilization%
cpu.steal.utilization.percentageCPU Steal utilization%
cpu.guest.utilization.percentageCPU Guest utilization%
cpu.guestnice.utilization.percentageCPU Guest Nice utilization%

Prérequis

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

Le flux SNMP UDP/161 doit être ouvert entre le Collecteur et l'équipement.

Installation

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Network-Ubiquiti-Unifi-Snmp
  1. Sur l'interface Web de Centreon, installer le Pack Ubiquiti UniFi SNMP depuis la page Configuration > Plugin Packs > Gestionnaire

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

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_unifi_snmp.pl \
--plugin=network::ubiquiti::unifi::snmp::plugin \
--mode=disks \
--hostname=10.30.2.114 \
--snmp-version='2c' \
--snmp-community='ubiquiti_ro' \
--filter-disk-path='^/$' \
--warning-usage-prct='90' \
--critical-usage-prct='95' \
--verbose

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

OK: Partition '/' usage total: 46.82 GB used: 26.41 GB (56.40%) free: 20.41 GB (43.60%), Inodes used: 2 % | 'storage.partitions.count'=1;;;0; '/#storage.space.usage.bytes'=28356739072B;;;0;50273779712 '/#storage.space.free.bytes'=21917040640B;;;0;50273779712 '/#storage.space.usage.percentage'=56.40%;0:90;0:95;0;100 '/#storage.inodes.usage.percentage'=2%;;;0;100
Partition '/' usage total: 46.82 GB used: 26.41 GB (56.40%) free: 20.41 GB (43.60%), Inodes used: 2 %

Cette commande contrôle les disques (--mode=disks) d'un équipement Ubiquiti UniFi 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 l'utilisation disque est supérieur à 90% (--warning-usage-prct='90') et une alarme CRITICAL si supérieur à 95% (--critical-usage-prct='95').

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_unifi_snmp.pl \
--plugin=network::ubiquiti::unifi::snmp::plugin \
--mode=disks \
--help

Diagnostique

Diagnostique des plugins