Aller au contenu principal

Cisco Telepresence System SNMP

Vue d'ensemble

Les équipements Cisco Teléprésence font partie de la suite de solutions et matériels Communications unifiées proposées par Cisco.

Contenu du Plugin-Pack

Objets supervisés

  • Les statuts des Périphériques
  • L'historique des Appels et leurs métriques de performances

Métriques collectées

Metric nameDescriptionUnit
calls.total.unknown.countCalls count having unknown status
calls.total.other.countCalls count having other status
calls.total.internal.error.countCalls count encountering internal error
calls.total.local.disconnected.countCalls count being locally disconnected
calls.total.remote.disconnected.countCalls count being remotely disconnected
calls.total.network.congestion.countCalls count facing network congestion
calls.total.media.negotiation.failure.countCalls count having media negotiation failure
calls.total.security.config.mismatched.countCalls count encountering security issues
calls.total.incompatible.remote.endpoint.countCalls count facing incompatible remote device
calls.total.service.unavailable.countCalls count having unknown status
calls.total.remote.terminated.error.countCalls count ending because of remote error

En plus des métriques globales ci-dessus, des métriques propres à chaque mediatype (audio, video, content) sont disponibles:

Metric nameDescriptionUnit
mediatype#calls.streams.active.maxjitter.millisecondsActive calls maximum jitter measurmentms
mediatype#calls.streams.active.traffic.inDownload Bandwidth utilization by ongoing callsB/s
mediatype#calls.streams.active.traffic.outUpload Bandwidth utilization by ongoing callsB/s
mediatype#calls.streams.active.packetloss.in.countPacket Loss In on ongoing calls
mediatype#calls.streams.active.packetloss.out.countPacket Loss Out on ongoing calls
mediatype#calls.streams.active.packetloss.in.percentagePacket Loss In rate on ongoing call%
mediatype#calls.streams.active.packetloss.out.percentagePacket Loss Out rate on ongoing call%

Prérequis

Le Service SNMP doit être activé et configuré sur l'équipement Cisco CTS cible.

Le Collecteur Centreon doit être en mesure d'atteindre le Cisco CTS Device via le port UDP/161.

Afin d'obtenir plus d'information sur la configuration SNMP, il est recommandé de se référer à la documentation officielle de Cisco pour ces équipements: https://www.cisco.com/c/en/us/td/docs/video/cuct/1_1/english/configuration/guide/maint.html.

Installation

  1. Installer le Plugin sur tous les collecteurs Centreon devant superviser des ressources Cisco CTS:
yum install centreon-plugin-Hardware-Devices-Cisco-Cts-Snmp
  1. Sur l'interface Web de Centreon, installer le Plugin-Pack Cisco CTS depuis la page "Configuration > Plugin packs > Manager"

Configuration

  • Connecter vous à Centreon et ajouter un nouvel Hôte via la page "Configuration > Hôtes".

  • Remplir les champs "Nom", "Alias", "Adresse IP / DNS", "Communauté Snmp" et "Version Snmp" selon la configuration de l'équipement

  • Ajouter le modèle HW-Device-Cisco-Cts-SNMP.

    Si vous utilisez SNMP v3, configurer la macro SNMPEXTRAOPTIONS avec les paramètres adéquats

MandatoryNameDescription
SNMPEXTRAOPTIONSConfigure your own SNMPv3 credentials combo

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 votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine (certaines options comme --snmp-community doivent être ajustées en fonction du contexte):

/usr/lib/centreon/plugins/centreon_cisco_cts_snmp.pl \
--plugin=hardware/devices/cisco/cts/snmp/plugin.pm \
--mode=peripherals \
--hostname='10.2.15.12' \
--snmp-version=2c \
--snmp-community='snmp-community' \
--critical-total='13:' \
--verbose

La commande doit retourner un message de sortie similaire à celui ci-dessous :

OK: Total peripherals: 13 - All peripherals are ok | 'peripherals.total.count'=13;;;0;
Peripheral 'UP_LINK' status: noErrorPeripheral 'MIC -- front_center' status: noError
Peripheral 'MIC -- front_left' status: noError
Peripheral 'MIC -- front_right' status: noError
Peripheral 'MIC BOARD -- mic_array_board' status: noError
Peripheral 'MAIN_CAM -- Serial=XXXXX39,PID=CTS-5K-CAM-CLSTR,Hardware_ver=03.00,Firmware=0,BuildTime=year:2016,week:19' status: noError
Peripheral 'DISPLAY_LEFT -- Serial=XXXXX39,Hardware_ver=,Model=CTS-5K-70-G1 ,Manufacturer=CIS(0x0d33),AppCode_Ver=(unsupported)' status: noError
Peripheral 'DISPLAY_RIGHT -- Serial=XXXXX39,Hardware_ver=,Model=CTS-5K-70-G1 ,Manufacturer=CIS(0x0d33),AppCode_Ver=(unsupported)' status: noError
Peripheral 'AUX_DISPLAY_LEFT -- Serial=XXXXX39,Hardware_ver=,Model=CTS-5K-70-G1 ,Manufacturer=CIS(0x0d33),AppCode_Ver=(unsupported)' status: noError
Peripheral 'AUX_DISPLAY_CENTER -- Serial=XXXXX39,Hardware_ver=,Model=CTS-5K-70-G1 ,Manufacturer=CIS(0x0d33),AppCode_Ver=(unsupported)' status: noError
Peripheral 'AUX_DISPLAY_RIGHT -- Serial=XXXXX39,Hardware_ver=,Model=CTS-5K-70-G1 ,Manufacturer=CIS(0x0d33),AppCode_Ver=(unsupported)' status: noError
Peripheral 'UI_DEVICE -- MAC address : 00:11:EE:9Y:48:15 Version : 11-0-1KKPL-437' status: noError
Peripheral 'MAIN_DISPLAY -- Serial=XXXXX39,Hardware_ver=,Model=CTS-5K-70-G1 ,Manufacturer=CIS(0x0d33),AppCode_Ver=(unsupported)' status: noError

Dans cet exemple, le Plugin récupère le nombre de périphérique detecté ainsi que leur statut (--plugin=hardware/devices/cisco/cts/snmp/plugin.pm --mode=peripherals)

Cette commande déclenchera une alerte CRITICAL si le nombre de périphériques détéctés est inférieur à 13 (--warning-total='13:').

L'ensemble des seuils disponibles peut être affiché en utilisant l'option --help à la fin de la commande:

/usr/lib/centreon/plugins/centreon_cisco_cts_snmp.pl \
--plugin=hardware/devices/cisco/cts/snmp/plugin.pm \
--mode=peripherals \
--help

UNKNOWN: SNMP GET Request : Timeout

Si vous obtenez ce message, cela signifie que vous ne parvenez pas à contacter l'équipement Cisco sur le port UDP/161, ou alors que la communauté SNMP configurée n'est pas correcte.

Il est également possible qu'un équipement tiers (Pare-feu, ...) bloque la requête effectuée par le Plugin.

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

Les causes de cette erreur peuvent être les suivantes:

  • cet équipement ne supporte pas la MIB CISCO-TELEPRESENCE-MIB utilisée par ce mode
  • les autorisations données à l'utilisateur en SNMP sont trop restreintes.
  • L'agent SNMP doit être en mesure d'accéder à la branche entreprise Cisco: .1.3.6.1.4.1.9