Cisco Unified Communications Manager CDR Analysis and Reporting Administration Guide for Cisco Unified Communications Manager, Release 6.0(1)
CDR Search Configuration
Downloads: This chapterpdf (PDF - 411.0KB) The complete bookPDF (PDF - 3.65MB) | Feedback

CDR Search Configuration

Table Of Contents

CDR Search Configuration

Configuring CDR Search by User Extension

Configuring CDR Search by Gateway

Configuring CDR Search by Cause for Call Termination

Viewing Call Termination Details

Configuring CDR Search By Call Precedence Levels

Configuring CDR Search for Malicious Calls

Related Topics


CDR Search Configuration


CAR provides reporting capabilities for three levels of users: administrators, managers, and individual users. Only CAR administrators can use CDR Search.

This chapter contains the following topics:

Configuring CDR Search by User Extension

Configuring CDR Search by Gateway

Configuring CDR Search by Cause for Call Termination

Viewing Call Termination Details

Configuring CDR Search By Call Precedence Levels

Configuring CDR Search for Malicious Calls

Related Topics

Before You Begin

Make sure that you set the Cisco Unified Communications Manager service parameters CDR Enabled Flag and Call Diagnostics Enabled to true (enabled), so the system can generate CDR/CMR data. By default, the system disables these service parameters. For more information about these service parameters, see the "Configuring CDR Service Parameters" section on page 2-2.

All CAR reports use CDR data. Be sure to have the most current CDR data from which your reports are built. By default, CDR data loads daily from midnight to 5 a.m. However, you can set the loading time, interval, and duration as needed. See the "Configuring CAR System Scheduler" section on page 3-6 for more information.


Note After you log in to the CAR main window, the following warning may display if Cisco Unified Communications Manager is also activated: "Warning: In some servers in this cluster the CDR Enabled Flag is false and so CDR entries may not be generated for all the calls made in this cluster."Some clusters have multiple nodes where some of the nodes do not run Cisco Unified Communications Manager services. This warning checks all nodes in the cluster regardless of Cisco Unified Communications Manager service activation status. Ignore the warning after manually checking the CDR Enabled Flag parameter settings for all the Cisco Unified Communications Manager service subscribers.


Configuring CDR Search by User Extension

Only CAR administrators use the CDR Search by User Extension feature.

This section describes how to show the details of CDR data based on a user or extension. You can search CDR data by user or directory number (calling, original called, or final called) to analyze call details for the oldest 100 records that satisfy the search criteria. If more than 100 records are returned, the system truncates the results. You can search for calls by using specific numbers for the period that you specify, which helps you trace calls that are placed from or to any specific numbers for diagnostic or informational purposes. All associated records, such as transfer, mobility, silent monitoring and recording, and conference calls, appear together as a logical group.


Caution Use CAR only during off-peak hours. Otherwise, data collection and report generation could cause performance degradation on the Cisco Unified Communications Manager system.

Procedure


Step 1 Choose CDR > Search > By User Extension.

The CDR Search by User Extension window displays.


Note You can enter a wildcard pattern like "!" or "X" to search on extensions. The "!" represents any n digit that has 0-9 as each of its digits, and the "X" represents a single digit in the range 0-9.


Step 2 Perform one of the following tasks:

To search CDRs based on extensions, enter the extension number in the Extension field and click the Add Extension button.

To search CDRs based on user, click the Search Extension(s) based on User(s) link, enter the first few letters of the first and/or last name in the First Name and/or Last Name fields, and click the Search button. When the results display, click the Select link next to the result that you want to include. Click the Close button.

The extension displays in the Selected Extension(s) box.


Note To delete an item from the Report Criteria box, click the Remove Extension(s) button. You can delete all items from the Report Criteria box by clicking the Remove All Extensions button.


Step 3 Choose the date and time range of the period for which you want to see CDR data for the specified user or extension.When you configure the time range, use Coordinated Universal Time (UTC).

Step 4 Choose whether to run the CDR Search report with grouping or without grouping. If you chose with grouping, check the check box beside With Grouping. The default is specified without grouping


Note With Grouping choice means that the system returns CDR records that match the date and time range for the search are returned and groups them with their associated records. Without Grouping returns all the CDR records that match the date and time range without grouping all the associated records for each call together.


Step 5 Click the OK button.

The CDR-CMR Search Results window displays. The system only displays the oldest 100 records that fall into the date range that you configured in Step 3.

Step 6 To view the CMR data, click the Others button. To view both the CDR and CMR data fields, click the View button.

Step 7 To mail the report to e-mail recipient(s), follow the steps in the "Mailing a Report" section on page 5-14.


Additional Information

See the "Related Topics" section.

Configuring CDR Search by Gateway

Only CAR administrators use the CDR Search by Gateway feature.

This section describes how to search CDR data based on a specific gateway type or on those gateways that use a chosen route pattern.


Caution Use CAR only during off-peak hours. Otherwise, data collection and report generation could cause performance degradation on the Cisco Unified Communications Manager system.

Procedure


Step 1 Choose CDR > Search > By Gateway.

The CDR Search by Gateway window displays.

Step 2 Perform one of the following tasks:

To display all the gateways that are configured in the system, click Gateway Types in the column on the left side of the window.

To expand the tree structure and display the type of gateway from which you can choose, click the icon next to Gateway types.

To choose a gateway that uses a particular route pattern/hunt pilot, rather than a gateway type, click Route Patterns/Hunt Pilots in the column on the left side of the window. The gateways that are associated to the configured Route Patterns/Hunt Pilots display.

To expand the tree structure and display route pattern/hunt pilot for you to choose, click the icon next to Route Patterns/Hunt Pilots.


Note You can also search for specific route patterns/hunt lists by entering part of the name of the route pattern(s)/hunt pilot(s) in the Route Patterns/Hunt Pilots box in the column on the left side of the window. CAR searches for the route pattern(s)/hunt list(s) that matches the search string.


Step 3 Choose a gateway type from the list.

The gateway name displays in the List of Gateways box.


Note The List of Gateways box will display up to 200 gateways that are configured for the chosen gateway type.


Step 4 In the List of Gateways box, choose the gateways that you want to include in the report.


Note You can generate a report for up to 15 gateways at a time. If you choose more than 15 gateways, you will receive a message that states "Select 15 or fewer gateways to generate new report."


Step 5 To move the chosen gateway to the list of Selected Gateways box, click the down arrow.

The gateway that you chose displays in the Selected Gateways box.

Step 6 Choose the date and time range of the period during which you want to search CDR data. When you configure the time range, use UTC.

Step 7 Choose whether to run the CDR Search report with grouping or without grouping. If you chose with grouping, check the check box beside With Grouping. The default specifies Without Grouping


Note With Grouping means that the system returns CDR records that match the date and time range for the search are returned and grouped with their associated records. Without Grouping returns all the CDR records that match the date and time range without grouping all the associated records for each call together.


Step 8 Click the OK button.

The CDR-CMR Results window displays. The system only displays the oldest 100 records that fall into the date and time range that you configured in Step 6. If more than 100 records are returned, the system truncates the results.

Step 9 To view the CMR data, click the Others button. To view both the CDR and CMR data fields, click the View button.

Step 10 To mail the report to e-mail recipient(s), follow the steps in the "Mailing a Report" section on page 5-14.


Additional Information

See the "Related Topics" section.

Configuring CDR Search by Cause for Call Termination

Only CAR administrators use the CDR Search by Cause for Call Termination feature.

This section describes how to search for information about the cause for termination of a call.

Procedure


Step 1 Choose CDR > Search > By Cause for Call Termination.

The Cause for Call Termination window displays.

Step 2 To search for the cause(s) of the termination of a call, highlight the cause(s) in the list of call termination causes.


Tip You can select more than one cause by clicking the causes that you want while holding down the Ctrl key on your keyboard. You can also select all causes in the list by holding down the Shift key while clicking all causes.


Step 3 With the desired cause(s) highlighted, click the down arrow above the Selected Call Termination Causes box.

The cause(s) that you chose displays in the Selected Call Termination Causes list box.


Note To view a complete list of Call Termination Causes, see the "Call Termination Cause Codes" section on page 10-110


Step 4 Choose the date and time range of the period during which you want to search CDR data. When you configure the time range, use UTC.

Step 5 Choose whether to run the CDR Search report with grouping or without grouping. If you chose with grouping, check the box beside With Grouping. The default specifies Without Grouping


Note With Grouping means that the system returns CDR records that match the date and time range for the search and groups them with their associated records. Without Grouping returns all the CDR records that match the date and time range without grouping all the associated records for each call together.


Step 6 Click OK.

The Call Termination Details window displays the report criteria for which the report was generated, along with the total number of calls that were placed during the given time range as well as how many call legs and the percentage of call legs for each cause code that is selected. The system displays only the oldest 100 records that fall into the date and time ranges that you configured in Step 4. If more than 100 records are returned, the system truncates the results.

Step 7 To view CDRs, see the "Viewing Call Termination Details" section.


Additional Information

See the "Related Topics" section.

Viewing Call Termination Details

This section describes how to view the call termination details.

Before You Begin

Follow the steps in the "Configuring CDR Search by Cause for Call Termination" section to display the Call Termination Details window.

Procedure


Step 1 In the Select CDRs field, check the check box beside the individual CDRs that you want to view or, if you want to view all CDRs in the list, check the Select CDRs check box.

Step 2 After you have chosen the CDRs that you want to view, click View CDRs.

The CDR-CMR Search Results window displays.

To view the media information and the CDR-CMR dump records, click the Others and View links. See the "Understanding the CDR Search Results" section on page 11-48 for information on how to read CDR search results reports.

Step 3 To print information that displays on the window, click the Edit button in your browser. Right-click the Select All button to highlight the section of the report that you want to print. Click the Print button.

Step 4 To mail the report in an e-mail, click Send Report and follow the procedure that is described in the "Mailing a Report" section on page 5-14.


Additional Information

See the "Related Topics" section.

Configuring CDR Search By Call Precedence Levels

Only CAR administrators use the CDR Search by Call Precedence Levels feature.

This section describes how to search for calls according to call precedence.

Procedure


Step 1 Choose CDR > Search > By Call Precedence Level.

The CDR Search by Precedence Levels window displays.

Step 2 In Select Precedence Levels, check the check box(es) for the call precedence level(s) on which you want to search as described in Table 8-1.

Table 8-1 Call Precedence Levels 

Voice Quality
Description

Flash Override

Highest precedence setting for MLPP calls.

Flash

Second highest precedence setting for MLPP calls.

Immediate

Third highest precedence setting for MLPP calls.

Priority

Fourth highest precedence setting for MLPP calls.

Routine

Lowest precedence setting for MLPP calls.



Note To check the check boxes of every precedence level, click Select All. To clear the check boxes, click Clear All.


Step 3 In the From Date field, choose the date and time from which you want CDRs searched. When you configure the time range, use UTC.

Step 4 In the To Date field, choose the date and time to which you want CDRs searched.

Step 5 Choose whether to run the CDR Search report With Grouping or Without Grouping. If you chose With Grouping, check the check box beside With Grouping. The default specifies Without Grouping


Note With Grouping means that the system returns CDR records that match the date and time range for the search are returned and groups them with their associated records. Without Grouping returns all the CDR records that match the date and time range without grouping all the associated records for each call together.


Step 6 Click OK.

The Call Precedence Details window displays and shows the call precedence levels and values, number of call legs, and percentage of call legs.

Step 7 In the Select CDRs column, check the check box(es) of the CDR(s) at which you want to look.

Step 8 Click View CDRs.

The CDR-CMR Search by Precedence Levels - CDR-CMR Search Results window displays. The system displays only the oldest 100 records that fall into the date and time ranges that you configured in Step 3 and Step 4. If more than 100 records are returned, the system truncates the results.

Step 9 To view the CMR data, click the Others button. To view both the CDR and CMR data fields, click the View button.

Step 10 To mail the report to e-mail recipient(s), click Send Report and follow the steps in the "Mailing a Report" section on page 5-14.


Additional Information

See the "Related Topics" section.

Configuring CDR Search for Malicious Calls

Only CAR administrators use the CDR Search for Malicious Calls feature.

This section describes how to search for malicious calls.

Procedure


Step 1 Choose CDR > Search > Malicious Calls.

The CDR Search for Malicious Calls window displays.

Step 2 Perform one of the following tasks:

In the Select Extension(s) box, enter an extension in the Extension field and click Add Extension.

The extension of the user displays in the Selected Extension(s) box.

To search for a user extension, click the Search Extension(s) based on User(s) link, enter the first few letters of the first and/or last name in the First Name and/or Last Name fields, and click the Search button. When the results display, click the Select link next to the result that you want to include. The extension number that is associated with the user appears in the Selected Extension(s) box. Click the Close button.


Note To remove an extension, highlight the extension(s) that you want removed and click Remove Extension(s). To remove all extensions, click Remove All Extensions.


Step 3 Choose the date and time range of the period when you want to search CDR data. When you configure the time range, use UTC.

Step 4 Choose whether to run the CDR Search report With Grouping or Without Grouping. If you chose with grouping, check the box beside With Grouping. The default is Without Grouping


Note With Grouping means that the system returns CDR records that match the date and time range for the search and groups them with their associated records. Without Grouping returns all the CDR records that match the date and time range without grouping all the associated records for each call together.


Step 5 Click OK.

The CDR-CMR Search Results window displays. The system only displays the oldest 100 records that fall into the date and time ranges that you configured in Step 3. If more than 100 records are returned, the system truncates the results.

Step 6 To view the CMR data, click the Others button. To view both the CDR and CMR data fields, click the View button.

Step 7 To mail the report to e-mail recipient(s), follow the steps in the "Mailing a Report" section on page 5-14.


Additional Information

See the "Related Topics" section.

Related Topics

Understanding the CDR Search Results, page 11-48

Media Information, page 11-49

CDR and CMR Dump Tables, page 11-49

Mailing a Report, page 5-14

Configuring CDR Search by User Extension

Configuring CDR Search by Gateway

Configuring CDR Search by Cause for Call Termination

Viewing Call Termination Details

Configuring CDR Search By Call Precedence Levels

Configuring CDR Search for Malicious Calls

Call Termination Cause Codes, page 10-110