Skip to main content

Cisco Telepresence System SNMP

Overview​

Cisco Telepresence System is part of the Cisco Unified Communication suite to offer high quality collaboration tools with video and audio capabilities.

Plugin-Pack assets​

Monitored objects​

  • Peripherals status and metrics
  • Calls history and streams

Monitored metrics​

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

In addition to global metrics above, the following metrics are monitoring for audio, video and content mediatype:

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%

Prerequisites​

The SNMP service must be installed and configured on the Cisco CTS Device. The Centreon Pollers must as well be able to reach the CTS over the UDP/161 port.

More information about how to configure your CTS can be found in the official documentation: https://www.cisco.com/c/en/us/td/docs/video/cuct/1_1/english/configuration/guide/maint.html.

Setup​

  1. Install the Centreon Plugin package on every Centreon poller expected to monitor Cisco CTS ressources:
yum install centreon-plugin-Hardware-Devices-Cisco-Cts-Snmp
  1. On the Centreon Web interface, install the Cisco CTS Centreon Plugin-Pack on the "Configuration > Plugin Packs > Manager" page

Configuration​

  • Log into Centreon and add a new Host through "Configuration > Hosts".
  • Fill the "Name", "Alias", "IP Address / DNS", "Snmp Community" and "Snmp version" fields according to your device's configuration
  • Select the HW-Device-Cisco-Cts-SNMP.

When using SNMP v3, use the SNMPEXTRAOPTIONS Macro to add specific auth parameters

MandatoryNameDescription
SNMPEXTRAOPTIONSConfigure your own SNMPv3 credentials combo

FAQ​

How to check in the CLI that the configuration is OK and what are the main options for ?​

Once the plugin installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command (some of the parameters such as --snmp-community have to be adjusted):

/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

Expected command output is shown below:

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

In this example, the Plugin gets the number of physical peripherals and their operating status (--plugin=hardware/devices/cisco/cts/snmp/plugin.pm --mode=peripherals) by requesting the Cisco Telepresence MIB on the Cisco CTS Device.

This command would trigger a CRITICAL alarm if the number of detected peripherals is less than 13 --warning-total='13:').

All the available thresholds parameters can be displayed by adding the --help parameter to the command:

/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​

If you get this message, you're probably facing one of theses issues:

  • Your SNMP isn't started or misconfigured on the Cisco CTS device
  • An external device is blocking your request (firewall, ...)

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

This message generally means that SNMP privileges are not wide enough for the mode/plugin to work properly or that the polled device doesn't support CISCO-TELEPRESENCE-MIB.