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β
- Calls
- Peripherals
Metric name | Description | Unit |
---|---|---|
calls.total.unknown.count | Calls count having unknown status | |
calls.total.other.count | Calls count having other status | |
calls.total.internal.error.count | Calls count encountering internal error | |
calls.total.local.disconnected.count | Calls count being locally disconnected | |
calls.total.remote.disconnected.count | Calls count being remotely disconnected | |
calls.total.network.congestion.count | Calls count facing network congestion | |
calls.total.media.negotiation.failure.count | Calls count having media negotiation failure | |
calls.total.security.config.mismatched.count | Calls count encountering security issues | |
calls.total.incompatible.remote.endpoint.count | Calls count facing incompatible remote device | |
calls.total.service.unavailable.count | Calls count having unknown status | |
calls.total.remote.terminated.error.count | Calls count ending because of remote error |
In addition to global metrics above, the following metrics are monitoring for audio, video and content mediatype:
Metric name | Description | Unit |
---|---|---|
mediatype#calls.streams.active.maxjitter.milliseconds | Active calls maximum jitter measurment | ms |
mediatype#calls.streams.active.traffic.in | Download Bandwidth utilization by ongoing calls | B/s |
mediatype#calls.streams.active.traffic.out | Upload Bandwidth utilization by ongoing calls | B/s |
mediatype#calls.streams.active.packetloss.in.count | Packet Loss In on ongoing calls | |
mediatype#calls.streams.active.packetloss.out.count | Packet Loss Out on ongoing calls | |
mediatype#calls.streams.active.packetloss.in.percentage | Packet Loss In rate on ongoing call | % |
mediatype#calls.streams.active.packetloss.out.percentage | Packet Loss Out rate on ongoing call | % |
Metric name | Description | Unit |
---|---|---|
peripherals.total.count | Number of pysical entity on the CTS | |
Peripheral Status | Operating status of each peripheral (MIC, CAM, DISPLAY) |
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β
- Online License
- Offline License
- Install the Centreon Plugin package on every Centreon poller expected to monitor Cisco CTS ressources:
yum install centreon-plugin-Hardware-Devices-Cisco-Cts-Snmp
- On the Centreon Web interface, install the Cisco CTS Centreon Plugin-Pack on the "Configuration > Plugin Packs > Manager" page
- Install the Centreon Plugin package on every Centreon poller expected to monitor Cisco CTS applications:
yum install centreon-plugin-Hardware-Devices-Cisco-Cts-Snmp
- Install the Centreon Plugin-Pack RPM on the Centreon Central server:
yum install centreon-pack-hardware-devices-cisco-cts-snmp
- 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 authentication parameters More information in the Troubleshooting SNMP section.
Mandatory | Name | Description |
---|---|---|
SNMPEXTRAOPTIONS | Configure 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.