Skip to main content

Polycom DMA SNMP

Overview​

The Polycom RealPresence Distributed Media Application (DMA) is a unique network-based virtualization application that provides conference manager and call server functionality for managing and distributing calls across collaboration networks.

The RealPresence DMA system is available in an Appliance Edition and a Virtual Edition (packaged as software only) that can be deployed on VMware, Hyper-V, KVM, Amazon AWS or Microsoft Azure cloud.

Plugin-Pack assets​

Monitored objects​

  • DMA Devices (hardware & software)
  • DMA Clusters
  • Attached Clusters, Servers & Device registrations status

Collected metrics​

Metric nameDescriptionUnit
dma.alerts.total.countNumber of alerts.Count

Specify through the --warning-status and --critical-status options which severities increase the total count of alerts.

Prerequisites​

Device Configuration​

Configure the proper SNMP settings on your RealPresence DMA device according to Polycom official documentation: https://documents.polycom.com/bundle/dma-ops-9-0/page/dma-ops-help/snmp/TOC_Configure_SNMP_Settings.htm

Network flows​

The Centreon Poller must be able to reach the UDP/161 SNMP port of the Polycom RealPresence DMA device.

Installation​

  1. Install the Centreon Plugin package on every Centreon Poller expected to monitor Polycom RealPresence DMA devices:
yum install centreon-plugin-Hardware-Devices-Polycom-Dma-Snmp
  1. On the Centreon Web interface, install the Polycom DMA SNMP Plugin-Pack through "Configuration > Plugin packs > Manager" page.

Host configuration​

  • Add a new Host and apply the HW-Device-Polycom-Dma-SNMP-Custom Host Template
  • Fill SNMP Version and Community fields according to the device's configuration

When using SNMP v3, use the SNMPEXTRAOPTIONS Macro to add specific authentication parameters More information in the Troubleshooting SNMP section.

MandatoryNameDescription
SNMPEXTRAOPTIONSConfigure your own SNMPv3 credentials combo

FAQ​

How to test the Plugin 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:

/usr/lib/centreon/plugins/centreon_polycom_dma_snmp.pl \
    --plugin=hardware::devices::polycom::dma::snmp::plugin \
    --mode=clusters \
    --hostname=10.0.0.1 \
    --snmp-version='2c'
    --snmp-community='mysnmpcommunity' \
    --critical-cluster-status='%{cluster_status} =~ /outOfService/i' \
    --critical-license-status='%{license_status} =~ /notinstalled/i' \
    --warning-cluster-license-usage-prct='80' \
    --critical-cluster-license-usage-prct='90' \
    --verbose

Expected command output is shown below: 

OK: Total clusters : 1 - Cluster 'my_dma_cluster_1' Active calls : 78, Free licenses : 722, Licenses percentage usage : 9.75% |
'dma.clusters.total.count'=1;;;0; 'my_dma_cluster_1#dma.cluster.activecalls.count'=78;;;;800 
'my_dma_cluster_1#dma.cluster.licenses.free.count'=722;;;0; 'my_dma_cluster_1#dma.cluster.licenses.usage.percentage'=9.75%;0:80;0:90;0;
Cluster 'my_dma_cluster_1' Active calls : 78, Free licenses : 722, Licenses percentage usage : 9.75%

The command above monitors the clusters attached to a DMA device (--plugin=hardware::devices::polycom::dma::snmp::plugin --mode=clusters) identified by the IP address 10.0.0.1 (--hostname=10.0.0.1). As the Plugin is using the SNMP protocol to request the device, the related community and version are specified (--snmp-version='2c' --snmp-community='mysnmpcommunity').

This command would trigger a WARNING alarm if the current amount of active calls reaches 80% of the total calls authorized by the license (--warning-cluster-license-usage-prct='80') and a CRITICAL alarm over 90% (--critical-cluster-license-usage-prct='90').

A CRITICAL alarm would also be triggered in the following situations:

  • if the cluster reports a Out of Service status (--critical-cluster-status='%{cluster_status} =~ /outOfService/i')
  • if the DMA device reports an invalid license for the cluster (--critical-license-status='%{license_status} =~ /notinstalled/i')

All the options as well as all the available thresholds can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins/centreon_polycom_dma_snmp.pl --plugin=hardware::devices::polycom::dma::snmp::plugin --mode=clusters --help

How to monitor system metrics on the Ploycom RealPresence DMA ?​

Polycom RealPresence DMA are Linux-Based, use the OS-Linux-SNMP-Custom Host Template in addition with the DMA Template to monitor the operating system layer.

UNKNOWN: SNMP GET Request : Timeout​

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

  • The SNMP agent of the device isn't started or is misconfigured
  • An external device is blocking the request (firewall, ...)