Support Center Home


Cisco Unified Call Manager (CUCM) API Monitoring

Overview

LogicMonitor’s Cisco Unified Call Manager (CUCM) API monitoring package leverages Cisco’s Performance Monitoring API, also referred to as PerfMon API, to monitor and alert on the status of services, resources, calls, and other high-level metrics.

Compatibility

As of the January 2021, LogicMonitor’s CUCM monitoring package is known to be compatible with:

  • All known versions with support for perfmonservice2 endpoints.

As Cisco releases newer versions of CUCM, LogicMonitor will test and extend coverage as necessary.

Setup Requirements

Add Resources Into Monitoring

Add your Call Manager host into monitoring. For more information on adding resources into monitoring, see Adding Devices. Credentials with sufficient permissions to access the PerfMon API must be added as properties to this host in order for these modules to apply and monitoring to start (details in the following two sections).

Obtain Credentials

LogicMonitor must provide the appropriate credentials in order to successfully access the Call Manager resource’s data. These credentials are stored as properties on the resource in LogicMonitor and must provide full read access to the PerfMon API.

Assign Properties to Resources

The following custom properties must be set on the CUCM resource within LogicMonitor. For more information on setting properties, see Resource and Instance Properties.

Property Value
cucm.api.user PerfMon REST API username
cucm.api.pass PerfMon REST API password
cucm.api.port The TCP port on which CUCM exposes the PerfMon API. By default, LogicMonitor attempts access on port 8443 but this property can be used to configure access via a different port.

Import LogicModules

From the LogicMonitor public repository, import all CUCM API LogicModules, which are listed in the LogicModules in Package section of this support article. If these LogicModules are already present, ensure you have the most recent versions.

Once the LogicModules are imported (assuming all previous setup requirements have been met), data collection will automatically commence.​

Troubleshooting

If the LogicModules fail to apply, the initial LogicModule to check is the addCategory_CiscoCUCMAPI PropertySource as it tests and verifies access before other LogicModules apply. Look for errors in the debug output to diagnose. The most common errors are incorrect credentials or permissions.

LogicModules in Package

LogicMonitor’s package for CUCM API monitoring consists of the following LogicModules. For full coverage, please ensure that all of these LogicModules are imported into your LogicMonitor platform.

Name Type Description
addCategory_CiscoCUCMAPI PropertySource Identifies if the host is a CUCM device with PerfMon API access. Assigns a value of “CiscoCUCMAPI” to the system.categories property of the host if valid.
Cisco_CUCM_LBM DataSource Monitors the Location Bandwidth Manager.
Cisco_CUCM_MTPDeviceStatistics DataSource Provides resource information for Media Termination Point devices.
Cisco_CUCM_Replication DataSource Provides information on replicates and their current state.
Cisco_CUCM_Services DataSource Monitors control center services.
Cisco_CUCM_SIP DataSource Provides SIP information for audio and video calls.
Cisco_CUCM_SystemPerformance DataSource Monitors various global system performance metrics.

When setting static datapoint thresholds on the various metrics tracked by this package’s DataSources, LogicMonitor follows the technology owner’s best practice KPI recommendations. If necessary, we encourage you to adjust these predefined thresholds to meet the unique needs of your environment. For more information on tuning datapoint thresholds, see Tuning Static Thresholds for Datapoints.

In This Article