The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
You can use the Cisco Prime Collaboration reports to identify problem areas, locate most commonly used and least used endpoints, and determine ideal locations and required endpoint types for future deployment.
Update data source credentials. See Data Source Credentials Updation.
(For voice call reports) Categorize calls, add Dial Plan, configure Gateway Codes. See Call Classification.
Configure SFTP. See Configure SFTP Settings.
Unified CM devices must be in managed state.
Cisco Prime Collaboration must be added as billing server in Unified CM.
Cisco Prime Collaboration collects from Cisco Unified CM clusters . It sends SNMP traps when the voice quality of a call fails to meet a user-defined quality threshold.
Cisco Unified CM calculates the MOS value for an entire call using the Cisco Voice Transmission Quality (CVTQ) algorithm. At the termination of a call, Cisco Unified CM stores the data in Call Detail Records (CDRs) and Call Management Records (CMRs) (for more information on CDR and CMR, see the Cisco Unified Communications Manager Call Detail Records Administration Guide.
To provide the credentials for Unified Communications Manager publisher servers, you must:
Any problem that prevents Cisco Prime Collaboration from contacting and connecting to data sources can interrupt the collection and analysis of call data and configuration data. Use the information on the Data Source Management page to:
Cisco Prime Collaboration uses call classification to categorize calls in Call Detail Record (CDR) reports.
Cisco Prime Collaboration determines whether a call fits in system-defined call categories by analyzing the following data:
The following table lists system-defined call category types and names, and describes the calls included in the category type.
Category Type | Description | Category Name | ||
Voicemail | Calls to or from voicemail. | Unity
Voicemail—Calls that meet system-defined criteria for a voicemail call, such as
calls to and from
Cisco Unity Connection.
|
||
Conference | Calls to or from a conferencing system. |
Conference Bridge—Calls that meet system-defined criteria for a call involving
a conference bridge.
|
||
ICT | Calls to or from an intercluster trunk (ICT). | |||
VG/Trunk-Outgoing | Calls to
a voice gateway or a trunk; only OffNet calls are included.
|
|||
VG/Trunk-Incoming | Includes calls from a voice gateway or a trunk; only OffNet calls are included. | |||
Tandem | A tandem call occurs when both endpoints are voice gateways or trunks. | Tandem. | ||
OnNet Trunk | Calls
where one endpoint is a trunk and the call is not an OffNet call.
For example, the trunk could be used to connect to WebEx or to a PBX. |
|||
Internal | Calls that do not fall into any of the above categories. For example, calls where one endpoint is an IP phone and the other endpoint is a voice gateway and the call is not an OffNet call. | Internal. | ||
Unknown | For system-related reasons, Prime Collaboration could not determine the device type of the endpoints. | Unknown. |
Cisco Prime Collaboration places a call in the user-defined call category if:
A call is considered to be OffNet when at least one endpoint is a gateway or a trunk and when any of the following is also true of the endpoint:
The Call Classification parameter is set to Offnet in the gateway configuration—or the trunk configuration—in Unified CM (Administration).
The endpoint is an analog gateway.
Any call that does not meet the criteria for an OffNet call is considered to be an OnNet call.
You can create a call category when you add a dial pattern to a dial plan.
A dial plan must have a unique name, can include a set of toll-free numbers, and must include a set of dial patterns. A dial pattern identifies a call category name and type and specifies the rule or pattern that a directory number must match for the call to be included in the category.
Cisco Prime Collaboration provides a default dial plan as a starting point from which you can define your own dial plans. The default dial plan includes default dial patterns: call category names, types, and rules. As you configure a dial plan, you can update the call categories and add, modify, and delete the rules that are specified in the default dial plan.
You can create multiple dial plans. You can assign only one dial plan to each cluster, but you can assign the same dial plan to multiple clusters.
To add a dial plan, choose .
To assign a dial plan, choose .
When you add a dial plan, a copy of the default dial plan is displayed for you to update. You can:
Define your own call category names; however, you must select from the available call category types
Add, update, or delete dial patterns
Changes that you make while configuring a dial plan have no effect on the default dial plan, which is based on the North American Numbering Plan (NANP).
The following table provides the default dial plan values.
Condition | No. of Chars | Default Pattern | Call Category Name | Call Category Type | Explanation | Priority |
> | 3 | 011! | International | International | If the number of digits dialed is greater than 3 and starts with 011, the call is classified as International. | 1 |
= | 7 | ! | Local | Local | If the number of digits dialed is equal to 7 and the pattern is ! (more than one digit; in this case, 7 digits), the call is classified as Local. | 2 |
= | 10 | T! | Toll Free | Toll Free | If the number of digits dialed is equal to 10 and the pattern is T! (more than one digit; in this case, a 10-digit number that starts with a toll-free number that is defined in the dial plan), the call is classified as Toll Free. | 3 |
= | 10 | G! | Local | Local | If the number of digits dialed is equal to 10 and the pattern is G! (more than one digit; in this case, a 10-digit number that starts with a gateway code that has been defined in Cisco Prime Collaboration), the call is classified as Local. | 4 |
= | 10 | ! | Long Distance | Long Distance | If the number of digits dialed is equal to 10 and the pattern is ! (more than one digit; in this case, a 10-digit number), the call is classified as Long Distance. | 5 |
= | 11 | T! | Toll Free | Toll Free | If the number of digits dialed is equal to 11 and the pattern is T! (more than one digit; in this case, an 11-digit number that starts with a toll-free number that is defined in the dial plan), the call is classified as Toll Free. | 6 |
= | 11 | XG! | Local | Local | If the number of digits dialed is equal to 11 and the pattern is XG! (more than one digit; in this case, an 11-digit number that starts with any single digit followed by a gateway code that has been defined in Cisco Prime Collaboration), the call is classified as Local. | 7 |
= | 11 | ! | Long Distance | Long Distance | If the number of digits dialed is equal to 11 and the pattern is ! (more than one digit; in this case, an 11-digit number), the call is classified as Long Distance. | 8 |
Note | Cisco Prime Collaboration classifies the call as Toll Free if the toll-free code is defined in the dial plan that is assigned to the cluster. |
You can add a dial pattern to a dial plan that you want to add or edit.
Cisco Prime Collaboration Applies Dial Patterns of This Category Type... | To the Directory Number that is the... | In a Call That Is in This System-Defined Category... |
---|---|---|
Destination | VG/Trunk-Outgoing | |
Source | ||
Cisco Prime Collaboration uses the gateway codes that you configure to determine the call classification for an external call.
Note | To view the gateways for which gateway codes are already configured, select clusters and click View. |
If you are using Unified Communications Manager to monitor calls, you must configure SFTP settings.
Step 1 | Choose . |
Step 2 | Enter the required information. For field descriptions, see the table for SFTP Settings Page - Field Descriptions. |
Step 3 | Click Yes. |
The following table describes the fields in the SFTP Settings page.
The following administrative reports are available:
CDR reports displays call details such as call category type, call class, call duration, termination type, call release code, and so on. You can cross launch CMR reports from ServiceQualityThresholdCrossed alarm(provided the alarm is supported) . The report loads up to 40 records initially, you can scroll down to view more records.
You can select any grade from the generated report to view the details of CMR reports for that particular CDR Record in an inline CMR (popover).
CMR report generate reports that include all call data from the clusters or reports that include a subset of call data.
The following table describes the fields of CDR call reports.
Field | Description |
Grade |
|
Cluster ID | Unified Communications Manager cluster. |
Caller/Called |
|
Caller Video/Called Video |
|
Call Class | One of these: Note For more information, see Understand OffNet and OnNet Calls. |
Time Period | Date and time that the call started with respect to the Cisco Prime Collaboration server local time zone (not the time zone in which Cisco Unified CM resides). The maximum time limit is 7 days. . |
Call Duration(s) |
Length of the call, in seconds. |
Call Category Names | A comma-separated list of the categories to which the call belongs. For more information, see Call Classification and Call Category Creation. |
Call Category Types | A comma-separated list of the category types to which the call categories belongs. For more information see Call Classification and Call Category Creation. |
The following table describes the fields of CMR reports.
Field | Description |
MOS | Average
MOS value during the sample duration. The value might be N/A or not available
if the sample duration is very short.
MOS reflects the experience of the listener. |
Minimum MOS | The
minimum MOS score within the sample duration.
The value might be N/A or not available if the sample duration is very short. |
Grade |
|
Caller/Called |
|
Listener DN/IP |
Identifies the endpoint-called or caller-for which MOS and impairment details
are reported; one of these:
|
Jitter (ms) | Milliseconds of jitter during the sample duration. |
Packet Loss | Number of packets lost due to network transmission during the sample duration. Computed based on observed RTP sequence number analysis. |
Max Jitter (ms) | Maximum milliseconds of jitter during the sample duration. |
Conceal Seconds |
Number of seconds that have concealment events (lost frames) from the start of the voice stream (includes severely conceal seconds). |
Severely Conceal Seconds |
Number of seconds during which a significant amount of concealment (greater than fifty milliseconds) was observed. |
Conceal Ratio |
Ratio of concealment frames to total frames. |
Latency |
Delay |
Cluster | Unified Communications Manager cluster. |
Time Period | Date and time that the call started with respect to the Cisco Prime Collaboration server local time zone (not the time zone in which the Unified Communications Manager resides). |
Call Duration(s) |
Length of the call, in seconds. |
Caller Termination Cause |
String that describes why the call was terminated on the caller endpoint |
Called Termination Cause |
String that describes why the call was terminated on the called endpoint. See Call termination cause codes section in Cisco Unified Communications Manager Call Details Record Administration Guide for the cause codes for failed calls. |
Video attributes |
|
Severely Conceal Seconds Ratio (%) |
A metric to measure the voice quality. It is the ratio of Severely Conceal seconds(SCS) and total call duration. |
Conceal Seconds Ratio (%) |
A metric to measure the network quality. It is the ratio of Conceal seconds(CS) and total call duration. |
Note | All the columns may not appear in CDR & CMR reports by default. To view other fields, click settings button and choose columns. |
You can filter the fields of report using Quick Filter options. For more information, see the Quick Filter section in Filters.
The CDR & CMR report can be exported in both CSV and PDF format. The maximum number of records that can be exported to a PDF file is 30,000. The maximum number of records that you can export to CSV is 200,000.
To export the report, click the Export tool button in the right-hand pane of the report window. If your client system seems unresponsive when you try to export files, see Troubleshoot File Download Issues.
The supported video codecs in CDR & CMR report are listed in the following:
To generate CDR & CMR call report:
Issue: CDR & CMR report displays Grade as N/A.
Recommended Action: Check if Severely Conceal Seconds Ratio value is not received from the endpoint or CMRs are not present.
Issue: Severely Conceal Seconds Ratio is x% and call is graded as Poor Call but in actual the call is not a poor call.
Recommended Action: You can configure threshold values for Severely Conceal Seconds Ratio from Voice Call Grade Page under CDR Analysis Settings.
Issue: Call grading is incorrect.
Recommended Action: Cross check the threshold values for Severely Conceal Seconds Ratio against Severely Conceal Seconds Ratio value in the CMR Report for the calls.
Issue: CDR/CMR Records are not received.
Recommended Action: Perform one of the following:
Add PCA as billing server in the Unified CM, if it is not added.
When you add PCA as billing server, check the resend on failure option in the Unified CM to avoid any failure of CDR delivery.
Check if CDR repository manager or CDR agent services are up in Unified CM.
If you try to export a report or other data to a file from Cisco Prime Collaboration and either the export dialog box or the window that prompts you to save the export file does not appear, use these procedures to try to fix the problem.
Command or Action | Purpose | |
---|---|---|
Step 1 | If you set the custom levels of security in Internet Explorer to medium or greater, the option, Automatic prompt to file download, is disabled. If you try to download a PDF or CSV file to a client system where Adobe Acrobat Reader or Microsoft Excel not installed, nothing happens. The PDF file or the spreadsheet is not displayed nor is a window that prompts you to save the file. To enable file download windows to display, do this on your desktop: | |
Step 2 | If you are using Internet Explorer, Automatic prompt to file download is enabled, and the window that prompts you to save the file still does not appear, do this: |