Cisco Unified Communications Manager Call Detail Records Administration Guide
Understanding Call Management Records
Downloads: This chapterpdf (PDF - 364.0KB) The complete bookPDF (PDF - 1.83MB) | Feedback

Understanding Call Management Records

Table Of Contents

Understanding Call Management Records

CMR Processing

Configuring CMRs

CPU Utilization

Related Topics

Related Documentation


Understanding Call Management Records


This chapter describes the format and logic of the call management records (CMRs) that the Cisco Unified Communications Manager Release 7.0(1) system generates. You can use this information for post-processing activities such as generating billing records and network analysis. The chapter describes how to access the CMR files.

When you install your system, CMRs remain disabled by default. You can enable or disable CMRs at any time that the system is in operation. You do not need to restart Cisco Unified Communications Manager for the change to take effect. The system responds to all changes within a few seconds. The system enables CMR or diagnostic data separately from CDR data.

This chapter contains the following topics:

CMR Processing

Configuring CMRs

CPU Utilization

Related Topics

Related Documentation

CMR Processing

The CMR records store information about the quality of the streamed audio of the call.

When Cisco Unified Communications Manager places or receives a call, the system generates a CDR record when the call terminates. The system writes the CDR to a flat file (text file). Inside the Cisco Unified Communications Manager, the call control process generates CDR records. The system writes records when significant changes occur to a given call, such as ending the call, transferring the call, redirecting the call, splitting the call, joining a call, and so forth.

When CMR records are enabled, the number of records that are written varies by type of call and the call scenario. When Diagnostics are enabled, the device generates CMR records for each call. The system writes one CMR record for each IP phone that is involved in the call or for each Media Gateway Control Protocol (MGCP) gateway. The system sends these records to EnvProcessCdr where they get written to flat files.

The Cisco Unified Communications Manager generates CMR records but does not perform any post processing on the records. The system writes the records to comma-delimited flat files and periodically passes them to the CDR Repository. The CMR files represent a specific filename format within the flat file.

Filename Format

The following example shows the full format of the filename: tag_clusterId_nodeId_datetime_seqNumber

tag—Identifies the type of file, either CDR or CMR.

clusterId—Identifies the cluster or server where the Cisco Unified Communications Manager database exists.

nodeId—Identifies the node.

datetime—Specifies UTC time in yyyymmddhhmm format.

seqnumber—Specifies sequence number.

An example of the filename follows:

cmr_Cluster1_02_200404061011_6125


Note For Cisco Unified Communications Manager Business Edition installations, the value that is assigned to the clusterId equals 01.


Flat File Format

The CMR flat files have the following format:

Line 1—List of field names in comma separated format.

Line 2—List of field types in comma separated format.

Line 3—Data in comma separated format.

Line 4—Data in comma separated format.

The following example shows a flat file:

Line1-"cmrRecordType","globalCallID_callManagerId","globalCallID_callId","origLegCallIdent
ifier",...
Line2-INTEGER,INTEGER,INTEGER,INTEGER,...
Line3-1,1,388289,17586046,...
Line4-1,1,388293,17586054,...

Configuring CMRs

You can configure CMRs on the Service Parameters Configuration window in Cisco Unified Communications Manager Administration. To access the Service Parameters Configuration window, open Cisco Unified Communications Manager Administration and choose System -> Service Parameters. Choose the Advanced button to display the complete list of Service Parameters. Select the Call Diagnostics Enabled parameter.

This parameter determines whether the system generates CMRs, also called call diagnostic records. Valid values specify Disabled (do not generate CMRs), Enabled Only When CDR Enabled Flag is True (generate CMRs only when the CDR Enabled Flag service parameter is set to True), or Enabled Regardless of CDR Enabled Flag (generates CMRs without regard to the setting in the CDR Enabled Flag service parameter). This represents a required field. The default value specifies Disabled.

CPU Utilization

Cisco has performed basic testing to measure CPU utilization when CDRs and/or CMRs are enabled. The CPU utilization testing was measured on subscribers and was not measured on the publishers. Your actual results can vary because of the CDR Loader settings and the CDR Management settings for external billing servers. Table 7-1 displays the results of these tests.


Note Be aware that these tests were performed with Cisco Unified Communications Manager Release 7.0(1).


Table 7-1 CDR and CMR CPU Utilization

CDRs and CMRs Enabled/Disabled
Average % Increase in Cisco Unified CM CPU Utilization
Average % Increase in Total CPU Utilization
Average % I/O wait
% Increase in Cisco Unified CM CPU
% Increase in Total CPU
% Increase I/O wait

CDRs disabled, CMRs disabled

6.5

9.7

0.41

-

-

-

CDRs enabled, CMRs disabled

6.7

10.0

0.44

3.2

4.2

8.1

CDRs disabled, CMRs enabled

6.7

10.0

0.43

2.5

3.3

5.2

CDRs enabled, CMRs enabled

6.9

10.4

0.45

6.3

7.8

12.1


Related Topics

Chapter 8, "Cisco Call Management Records Field Descriptions"

Chapter 9, "Cisco Call Management Records K-Factor Data"

Chapter 10, "Cisco Call Management Record Examples"

Related Documentation

The following documents contain additional information related to CMRs:

Cisco Unified Serviceability Administration Guide

CDR Analysis and Reporting Administration Guide