Polycom HDX SNMP
Vue d'ensemble​
La solution Polycom HDX vous permet d'établir des visioconférences HD flexibles pour des communications de qualité en environnement professionnel. Rapide et simple à implémenter, le système Polycom HDX répond idéalement aux besoins des professionnels de l'enseignement, de la santé, du commerce et de l'industrie et de la collaboration à la demande.
Le connecteur de supervision Centreon utilise le protocole SNMP pour se connecter et récupérer informations et métriques relatives aux équipements Polycom HDX.
Contenu du connecteur de supervision​
Objets supervisés​
- Systèmes de conférences Polycom HDX
Métriques collectées​
- Cpu-Detailed
- Interfaces
- Load
- Memory
- Uptime
- ViewStation-Statistics
Metric name | Description | Unit |
---|---|---|
cpu.user.utilization.percentage | CPU User utilization | % |
cpu.nice.utilization.percentage | CPU Nice utilization | % |
cpu.system.utilization.percentage | CPU System utilization | % |
cpu.idle.utilization.percentage | CPU Idle utilization | % |
cpu.wait.utilization.percentage | CPU Wait utilization | % |
cpu.kernel.utilization.percentage | CPU Kernel utilization | % |
cpu.interrupt.utilization.percentage | CPU Interrupt utilization | % |
cpu.softirq.utilization.percentage | CPU SoftIrq utilization | % |
cpu.steal.utilization.percentage | CPU Steal utilization | % |
cpu.guest.utilization.percentage | CPU Guest utilization | % |
cpu.guestnice.utilization.percentage | CPU Guest Nice utilization | % |
Metric name | Description | Unit |
---|---|---|
status | Status of the interface | |
interface.traffic.in.bitspersecond | Incoming traffic going through the interface. | b/s |
interface.traffic.in.percentage | Incoming traffic going through the interface. | b/s |
interface.traffic.out.bitspersecond | Outgoing traffic going through the interface. | b/s |
Vous pouvez restreindre ce contrôle sur une interface donnée en spécifiant le nom de l'interface à superviser
(par exemple --interface='^eth0$'
) conjointement avec le paramètre --name
.
Metric name | Description |
---|---|
load1 | System load 1 minute-sample |
load5 | System load 5 minutes-sample |
load15 | System load 15 minutes-sample |
Metric name | Description | Unit |
---|---|---|
memory.usage.bytes | Memory usage on the device. | B |
memory.free.bytes | Free memory on the device. | B |
memory.usage.percentage | Percentage of Memory usage on the device. | % |
memory.buffer.bytes | Buffered Memory allocation. | B |
memory.cached.bytes | Cached Memory allocation. | B |
memory.shared.bytes | Shared Memory allocation. | B |
Metric name | Description | Unit |
---|---|---|
system.uptime.seconds | System uptime | s |
Metric name | Description | Unit |
---|---|---|
viewstation.h323.packet.loss.percentage | The current combined (audio/video) average percentage packet loss when in an H.323 call | % |
viewstation.h323.jitter.milliseconds | The current combined (audio/video) cumulative average jitter (in ms) when in an H.323 call. | ms |
viewstation.h323.latency.count | The current average latency based on round trip delay when in an H.323 call. |
Prérequis​
Configuration SNMP de l'équipement​
Sur l'Ă©quipement Polycom HDX, configurez et activez l'agent SNMP en suivant ces Ă©tapes:
- Connectez-vous Ă l'interface Web d'administration de l'Ă©quipement
- Dans le menu, sélectionnez System > Manage > Credentials
- Configurez les paramètres SNMP en spécifiant la version et la communauté à utiliser
Installation​
- Online License
- Offline License
- Installer le Plugin sur chaque collecteur Centreon devant superviser des Ă©quipements Polycom HDX:
yum install centreon-plugin-Hardware-Devices-Polycom-Hdx-Snmp
- Sur l'interface Web de Centreon, installer le connecteur de supervision Polycom HDX SNMP depuis la page Configuration > Gestionnaire de connecteurs de supervision
- Installer le Plugin sur chaque collecteur Centreon devant superviser des Ă©quipements Polycom HDX:
yum install centreon-plugin-Hardware-Devices-Polycom-Hdx-Snmp
- Installer le RPM du connecteur de supervision sur le serveur Centreon Central:
yum install centreon-pack-hardware-devices-polycom-hdx-snmp
- Sur l'interface Web de Centreon, installer le connecteur de supervision Polycom HDX 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 Communauté SNMP et Version SNMP
- Appliquez le Modèle d'Hôte HW-Device-Polycom-Hdx-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.
Mandatory | Name | Description |
---|---|---|
SNMPEXTRAOPTIONS | Extra 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_polycom_hdx_snmp.pl \
--plugin=hardware::devices::polycom::hdx::snmp::plugin \
--mode=viewstation-stats \
--hostname=10.0.0.1 \
--snmp-version='2c' \
--snmp-community='mysnmpcommunity' \
--warning-h323-packet-loss='5' \
--critical-h323-packet-loss='10'
La commande devrait retourner un message de sortie de la forme ci-dessous:
OK: View Station Phone Number: '0123456789' Stats: H323 Packet Loss 1.00 %, H323 (audio/video) Jitter 30.00 ms, H323 (audio/video) Latency 4.00 |
'h323-packet-loss'=1.00%;;;0;100 'h323-jitter'=30.00ms;;;0;100 'vs_latency'=4.00;;;0;100
Dans cet exemple, le Plugin récupère les statistiques de sessions d'un équipement Polycom HDX (--plugin=hardware::devices::polycom::hdx::snmp::plugin --mode=viewstation-stats
)
identifié par l'adresse IP 10.0.0.1 (--hostname=10.0.0.1
). Les paramètres de communauté et de version SNMP (--snmp-version='2c' --snmp-community='mysnmpcommunity'
)
correspondants sont renseignés afin de pouvoir joindre l'équipement.
Une alarme WARNING sera ainsi déclenchée si le taux moyen de packet-loss des sessions H323 est supérieur à 5% (---warning-h323-packet-loss='5'
);
l'alarme sera de type CRITICAL au delà de 10% de ce même taux observé (--critical-h323-packet-loss='10'
).
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_polycom_hdx_snmp.pl --plugin=hardware::devices::polycom::hdx::snmp::plugin --mode=viewstation-stats --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 Polycom HDX sur le port UDP/161, ou que la communauté SNMP configurée n'est pas correcte. Il est également possible qu'un pare-feu bloque le flux.
UNKNOWN: SNMP GET Request : Cant get a single value.​
Les causes de cette erreur peuvent ĂŞtre les suivantes:
- cet équipement ne supporte ou n'embarque pas la MIB utilisée par ce mode
- les autorisations données à l'utilisateur en SNMP sont trop restreintes.