PerfMon Getting Started

The PerfMon service is included in the installation of Cisco Unified Communications Manager (Cisco Unified CM) software. The minimum requirements for using and testing PerfMon service are:

  1. A Cisco Unified CM infrastructure or the Dedicated Lab in the Cisco Sandbox
  2. A registered phone (optional)
  3. A CTI application (optional)

The PerfMon service is included in the installation of Cisco Unified Communications Manager (Unified CM) software.

PerfMon Service Activation

PerfMon Service Activation is handled in Cisco Unified Serviceability.

Before making a PerfMon request, ensure the SOAP - Performance Monitoring APIs service is running.

Follow these steps to verify the service is running:

  1. From the Cisco Unified CM Administration window, select Cisco Unified Serviceability.Then click Go.
  2. Select Tools > Control Center - Network Services.
  3. Scroll down to the SOAP Services section to verify SOAP - Performance Monitoring APIs is running.

If needed, other services can be activated or deactivated.

To activate and configure the SOAP - Performance Monitoring APIs service on all the nodes in an environment with a cluster of nodes, review Cluster service activation recommendations.

Application User Configuration

All Serviceability APIs use HTTP 1.0 Basic access authentication which requires username and password credentials. Create an application user in Cisco Unified CM, then use those credentials to authenticate the PerfMon requests.

For configuring an application user, refer to Application User Setup.

Application users are assigned to Access Control Groups. An application user can be assigned to:

  • An existing group
  • A newly configured group
Assigning a User to an Existing Group

To assign an application user to an existing group, select the Standard CCM Server Monitoring group, which is the default group.

Roles are assigned to groups, and users in that group are assigned roles belonging to that group. For example, Standard CCM Server Monitoring group has the three roles assigned to it. This image shows the user being associated to the group which contains those roles.

Assigning a User to a New Group

To create a new group, refer to Access Control Group Setup. Then verify the roles for that new group include at least the Standard CCM Admin Users and Standard SERVICEABILITY roles.

Application Preparation

Your application can use the WSDL file to generate the proper SOAP requests. The WSDL files are located on every Cisco Unified CM Publisher and Subscriber node. Download the WSDL for PerfMon at the following URL:

https://<server>:8443/perfmonservice2/services/PerfmonService?wsdl

With the SOAP - Performance Monitoring APIs service activated, a user created, and WSDL consumed, you are ready to make the first request. Use SoapUI to test, become familiar with, and gain a better understanding of the APIs.