Aller au contenu principal

TP-Link SNMP

Vue d'ensemble

TP-link est un fournisseur de solutions réseau.

Le Plugin Pack TP-Link utilise le protocole SNMP pour se connecter, récupérer des informations et les métriques relatives aux équipements de marque TP-Link.

Contenu du Plugin Pack

Objets supervisés

  • CPU
  • Interfaces
  • Mémoire
  • Uptime

Métriques collectées

  • These 3 metrics for CPU core and average utilization
Metric nameDescriptionUnit
cpu.utilization.5s.percentagePercentage of CPU utilization%
cpu.utilization.1m.percentagePercentage of CPU utilization%
cpu.utilization.5m.percentagePercentage of CPU utilization%

Prérequis

La communauté SNMP doit être activée sur l'équipement en mode Read-only.

La communication doit être possible sur le port UDP 161 depuis le collecteur Centreon vers l'équipement TP-Link.

Installation

  1. Installer le Plugin sur tous les collecteurs Centreon devant superviser des équipements TP-Link:
yum install centreon-plugin-Network-Tplink-Snmp
  1. Sur l'interface Web de Centreon, installer le Plugin Pack TP-Link SNMP depuis la page "Configuration > Plugin Packs > Manager"

Configuration

  • Ajoutez un nouvel Hôte depuis la page "Configuration > Hôtes"".
  • Complétez les champs "Nom","Alias" & "IP Address / DNS" correspondant à votre équipement TP-Link
  • Appliquez le Modèle d'Hôte Net-Tplink-SNMP-custom

Comment tester le Plugin en ligne de commande et comment utiliser ses options ?

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_tplink_snmp.pl \
--plugin=network::tplink::snmp::plugin \
--mode=cpu \
--hostname=10.30.2.11 \
--snmp-community=centreon-tplink \
--snmp-version=2c \
--warning-average-5m=90 \
--critical-average-5m=95 \
--verbose

OK: 1 CPU(s) average usage is 7.00 % (5s) 20.00 % (1m) 10.00 % (5m) - CPU '1' usage 7.00 % (5s) 20.00 % (1m) 10.00 % (5m) |
'cpu.utilization.5s.percentage'=7.00%;;;0;100 'cpu.utilization.1m.percentage'=20.00%;;;0;100 'cpu.utilization.5m.percentage'=10.00%;0:90;0:95;0;100
'1#core.cpu.utilization.5s.percentage'=7.00%;;;0;100 '1#core.cpu.utilization.1m.percentage'=20.00%;;;0;100 '1#core.cpu.utilization.5m.percentage'=10.00%;;;0;100
CPU '1' usage 7.00 % (5s) 20.00 % (1m) 10.00 % (5m)

La commande ci-dessus vérifie l'utilisation CPU d'un équipement TP-Link (--mode=cpu). Les informations importantes sont l'adresse IP/FQDN (--hostname=10.30.2.11) et la communauté SNMP configurée sur l'équipement (--snmp-community='centreon-tplink').

Une alarme de type WARNING est déclenchée si l'utilisation moyenne du CPU est supérieure à 90 sur le 5 dernières minutes (--warning-average-5m='90'). Une alarme CRITICAL est quant à elle déclenchée si l'utilisation moyenne du CPU est supérieure à 95 sur le 5 dernières minutes (--critical-average-5m='95').

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande :

/usr/lib/centreon/plugins//centreon_tplink_snmp.pl \
--plugin=network::tplink::snmp::plugin \
--mode=cpu \
--help

Tous les modes disponibles peuvent être affichés via l'option --list-mode :

/usr/lib/centreon/plugins//centreon_tplink_snmp.pl \
--plugin=network::tplink::snmp::plugin \
--list-mode

Diagnostic des erreurs communes

UNKNOWN: SNMP GET Request : Timeout

Si vous obtenez ce message, cela signifie que le collecteur Centreon ne parvient pas à contacter votre équipement TP-Link sur le port UDP 161, ou alors que la communauté SNMP configurée n'est pas correcte.

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. Ce dernier doit avoir accès à la branche entreprise TP-Link: .1.3.6.1.4.1.11863