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 > Gestionnaire de connecteurs de supervision

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 SNMP en version 3, vous devez configurer les paramètres spécifiques associés via la macro SNMPEXTRAOPTIONS. Plus d'informations dans la section Troubleshooting SNMP.

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