Introduction
Cisco Unified Communications Manager (Unified CM) provides reliable, secure, scalable, and manageable call control and session management. OpsRamp monitors UCM devices via the Cisco AXL/SOAP Performance Monitoring API (PerfMon) and the Control Center Services SOAP API, collecting performance counters, service status, and raising alerts through the gateway.
Supporting UCM Monitoring Models
- Call Manager (CUCM)
- Contact Center Express (UCCX / CCX)
- IM & Presence (Cisco Presence Server)
- Unity Server (Cisco Unity Connection)
Pre-requisites
- A gateway management profile mapped to the resource
- Create credentials with type as HTTP before assigning a template to a resource
- Default port: 8443 (HTTPS). Port 80 is supported for HTTP but HTTPS is strongly recommended
- Create a user with proper permissions: Steps to create a User with required permissions for Cisco UCM monitoring
- The gateway must have network connectivity to the UCM device on the configured port
- TLSv1.2 must be enabled on the UCM device (the gateway enforces TLSv1.2)
Credential Details
| Field | Value | Notes |
|---|---|---|
| Credential Type | HTTP | Required |
| Authentication | HTTP Basic Auth | Username and password sent as Base64-encoded header |
| Scheme | HTTPS (recommended) | HTTP also supported; port 443 auto-upgrades to HTTPS |
| Port | 8443 | Default, configurable per credential |
| Connect Timeout | 90 seconds | Hardcoded in the collector |
| Read Timeout | 120 seconds | Uses credential timeout if greater than 120s |
Discovery
Choose one of the following discovery mechanisms to discover the Cisco UCM resource: - WMI - SSH - SNMP - (Optional) Manually add the resource via Infrastructure > Settings > Resource > Add
Supporting UCM Monitoring Models, Templates, and Monitor Names
| Model Name | Monitor Names | Template Name | Device Type (Hierarchy) |
|---|---|---|---|
| Call Manager | Cisco UC Call Manager, Cisco UC Performance Monitor, Cisco UC Standard Monitor | Cisco-UC-UCM-G2-Latest | Cisco UCM (NetworkDevice >> VOIP >> CiscoUCM) |
| Contact Center Express | Cisco UC Contact Center Express, Cisco UC Performance Monitor, Cisco UC Standard Monitor | Cisco-UC-CCX-G2-Latest | Cisco Contact Center Express (NetworkDevice >> VOIP >> Cisco Contact Center Express) |
| IM & Presence | Cisco UC IM & Presence, Cisco UC Performance Monitor, Cisco UC Standard Monitor | Cisco-UC-IM and Presence-G2-Latest | VOIP Device (NetworkDevice >> VOIP >> Others) |
| Unity Server | Cisco UC Unity Connection, Cisco UC Performance Monitor, Cisco UC Standard Monitor | Cisco-UC-Unity-G2-Latest | Cisco Unity (NetworkDevice >> VOIP >> Cisco Unity) |
| All Models | Cisco UC Services Status Monitor (Manual Selection), Cisco UC Services Status Monitor - All Services | Cisco-UC-Services-G2 | (any UCM device) |
Note
UCM 14.0.0 and later versions are supported from gateway version 16.0.0 onwards. UCM 14.0 support was added from gateway 13.0.0 version or later.Authentication and Connection Behavior
Login Fallback Mechanism
The gateway implements a smart login fallback:
- First attempts connection using the IP address
- If IP-based login fails, falls back to hostname
- The successful connection parameter is cached in
CacheObjStoreto avoid repeated fallback attempts