Using Call Classification Feature with Cisco Unified Service Monitor 2.3 and Cisco Unified Service Statistics Manager 1.3
PDF(970.9 KB) View with Adobe Reader on a variety of devices
Updated:June 22, 2010
This document highlights suggested best practices for field personnel and customers. It will enable you to effectively leverage Service Monitor and Service Statistics Manager to enhance the call classification based on the call detail records collected from the Communications Manager.
Service Monitor and Service Statistics Manager are monitoring applications that are part of the Unified Communications Management Suite.
Service Monitor is designed to alert/report on end user experience from various data sources in the network such as the Cisco 1040, Communications Manager and Network Analysis Module. Enhanced thresholds and reporting enables Service Monitor users to identify network points that contribute to voice degradation thus enabling quicker troubleshooting for problem resolution.
Service Statistics Manager is designed for long term reporting and trend analysis for performance management of Unified Communications network managed by Operations Manager and Service Monitor. Users can also generate detailed reports on call classification based on the call detail record
Service monitor is tightly integrated with Cisco Unified Service Statistics Manager. CUSM provides call information to CUSSM for long term trending and reporting purposes. This information is provided in the form of CDR and CMR records.
Call Classification - What is New in Service Monitor 2.3 and Service Statistic Manager 1.3
Service Statistics Manager provides detailed reports on call classification based on the call detail record to enable administrators identify various call patterns based on the UC dial plan. Call classification allows system administrators to understand the types of calls made by the users to provide them guidance on the usage pattern of the UC infrastructure. Call types including Local, International, Conference, etc. are useful to understand the usage patterns related to the network bandwidth used as well as to monitor the overall call activity. The system administrator uses such reports to communicate to the management on the usage as well as to request expansion based on usage.
There are known limitations in the way Service Statistics Manager classifies calls in its 1.2 and earlier versions. Since CUSM provides call information (CDR) to CUSSM for long term trending and reporting purposes, it makes sense to move the call classification configuration and call classification logic into Service Monitor to enable Service Statistics Manager a pure reporting product. Hence the below changes are made in Service Monitor 2.3 and Service Statistics Manager 1.3:
• Dial plan configuration user interface is no longer available in Service Statistics Manager 1.3
• User shall setup call classifications in Service Monitor 2.3
• Service Monitor 2.3 provides call classification data for Service Statistics Manager 1.3 reporting
• Service Monitor 2.3 also includes on demand short term CDR reports. These reports will enable users to view individual calls that fall under certain type(s) of calls.
• Service Monitor CDR reports are used for troubleshooting purposes and Service Statistics Manager reports are used for long term and capacity planning.
There is no mechanism for Service Monitor 2.3 to inherit the dial plan setup defined in Service Statistics Manager 1.0, 1.1, 1.2. User need to manually recreate the call classification in Service Monitor 2.3. Before you upgrade Service Statistics Manager to 1.3, consider making a record of the dial plans, gateway codes, toll-free numbers, and service numbers that you would like to configure in Service Monitor 2.3. Before you recreate the call classification in Service Monitor 2.3, please review the below sections and keep the below differences in mind:
• Call category types and names used in Service Monitor are different from those used previously in Service Statististics Manager.
• Dial plans are assigned on a per cluster basis in Service Monitor.
• Toll-free numbers and service numbers are configured in each dial plan in Service Monitor. (You can configure a service number in Service Monitor as a dial pattern that you assign to the Service category.)
Understanding Call Classification in Service Monitor 2.3
For the users who defined dial plan in Service Statistics Manager prior to 1.3 and need to recreate dial plan in Service Monitor 2.3, please be aware the below deferences:
Service Monitor categorizes calls using System-defined Categories and User-defined Categories. A call might belong to multiple call categories. For example, an outgoing call through a voice gateway is categorized into the VG/Trunk-Outgoing system-defined category. The same call could also be categorized as a Long Distance call. If so, Service Monitor includes the call in both categories. When you view data for such a call in the CDR Call report, all applicable call categories are listed in the report.
Understanding How Service Monitor 2.3 Places a call into System-defined Categories
Service Monitor determines whether a call fits in system-defined categories by analyzing CDRs and other Unified Communications Manager data, such as the following:
• The device types of the source and target endpoints.
• The direction of the call: incoming or outgoing.
• The protocol: H.323, MGCP, or SIP.
Table 1 below lists system-defined call category types and names, and describes the calls included in the category type.
Table 1. System-Defined Call Categories in Service Monitor 2.3
Calls to or from voicemail.
Unity Voicemail - Calls fall in this category if any of the source or destination device type is a Unity or Unity Connection.
Calls to or from a conferencing system
Conference Bridge - Calls fall in this category if any of the source or destination device type is a conference bridge.
Calls to or from an intercluster trunk (ICT).
• ICT GK Controlled - ICT calls that are gatekeeper controlled
• ICT Non-GK Controlled - ICT calls that are not gatekeeper controlled
Calls fall under this category if any of the source or destination device type is InterCluster Trunk
Calls to a voice gateway or a trunk; only OffNet calls are included.
• MGCP Gateway Outgoing - Calls to an MGCP voice gateway
• H.323 Gateway Outgoing - Calls to an H.323 voice gateway
• H.323 Trunk Outgoing - Calls to an H.323 trunk
• SIP Trunk Outgoing - Calls to a SIP trunk
Calls fall under this category if destination device type indicates a Voice Gateway or a trunk and the configuration of that gateway or trunk in CM is `Offnet'
Calls from a voice gateway or a trunk; only OffNet calls are included.
• MGCP Gateway Incoming - Calls from an MGCP voice gateway
• H.323 Gateway Incoming - Calls from an H.323 voice gateway
• H.323 Trunk Incoming - Calls from an H.323 trunk
• SIP Trunk Incoming - Calls from a SIP trunk
Calls fall under this category if source device type indicates a Voice Gateway or a trunk and the configuration of that gateway or trunk in CM is `Offnet'.
A tandem call occurs when both endpoints are voice gateways or trunks.
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.
• OnNet H.323 Trunk
• OnNet SIP Trunk
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.
For system-related reasons, Service Monitor could not determine the device type of the endpoints.
Understanding How Service Monitor Places a Call under User-defined Categories
Service Monitor evaluates whether a call belongs in a user-defined call category, provided that:
• The call has already been categorized as an Internal or VG/Trunk-Outgoing call
• A user-defined dial plan is assigned to the cluster in which the call occurred
The following category types are available for creating custom categories
• Toll Free
• Long distance
For each of the pre-defined user categories (Emergency, Service, Toll Free, Local, Long distance, International), the category type is the same as the default category name. Apart from the pre-defined user categories, two more category types are available for creating new custom categories. Those are
• Voicemail: to account for calls to legacy Voice mail system
• Conference: to account for conferences which are scheduled like meet-me conference, Web-Ex or Meeting place conference
No default call category names are defined for Voicemail and Conference. To use these call category types for user-defined categories, you must add call category names to them. For example, users can create a custom category `Octel Voice mail' and assign it a category type of `Voicemail', or create a category `Calls to WebEx' with a category type of Conference.
These category types are not only useful for creating custom categories but they also help the system determine which dial pattern matches should be applied to source directory numbers and which to the destination directory numbers.
The dial pattern match will be applied to the calls classified under system category `VG outgoing', `Internal' and `OnNet Trunk'
All dial pattern (with any category tag) match will be applied to the destination directory number for VG or Trunk Outgoing calls. Only the dial pattern with category tags `Voicemail' and `Conference' will be applied to the source directory numbers for VG or Trunk Outgoing calls.
For Internal calls and OnNet Tunks calls, only the dial pattern with category tags `Voicemail' and `Conference' will be applied, and to both the source and destination directory numbers.
Understanding OffNet and OnNet Calls
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 Communications Manager (Administration).
• In Unified Communications Manager, both of the following are true:
– Call Classification parameter is set to System Default in the gateway or trunk configuration.
– System Default service parameter is set to Offnet.
• 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.
• The correctness of call classification depends on CM administrator correctly configuring the call class (Offnet/Onnet) for VGs and trunk on the CM configuration page. There is a chance that the CM administrator does not pay attention to this configuration parameter, and just chooses the default values which may not be the correct value. In such scenarios, the calls may get classified incorrectly till the misconfiguration is corrected.
• All ICT calls will be classified as OnNet call
Configuring Call Classification in Service Monitor 2.3
To configure call classification, perform the following tasks:
• Configure at least one dial plan.
• Assign a dial plan to each cluster.
• Configure gateway codes.
Configuring User-Defined Dial Plans
A dial plan includes 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. A dial pattern is assigned with a priority so only one call category is applied from a user-defined dial plan.
Service Monitor 2.3 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. For more information on default dial plan, see Understanding the default Dial Plan section on User Guide for Cisco Unified Service monitor 2.3.
To configure a user-defined dial plan, click
ConfigurationàCall Classification ->
Dial Plan Configuration, which opens the default dial plan, after supplying
Dial Plan Name,Toll Free Number(s), and
Dial Patterns, you can update the dial patterns by updating the call categories and add, modify, and delete the rules that are specified in the default dial plan. To update a dial pattern, click
Edit from the Add Dial Plan page and define the fields such as
Conditions, Number of Digits, Pattern, and
Call Category Name.
Note: You can also manage call category names by selecting Configuration > Call Classification > Call Category
Figure 1 below shows how to configure a user-defined dial plan with Service Monitor
Figure 1. Configure User-Defined Dial Plan with Service Monitor 2.3
Assigning a User-Defined Dial Plan to a Cluster
Service Monitor 2.3 supports the Dial Plan configuration per cluster. You can assign the same dial plan to all clusters or assign a different dial plan to each cluster that has been added to Service Monitor. To
Assign a dial plan to a cluster, click
Dial Plan Assignment under
Configuration à Call Classification, select Dial Plan for each cluster and click
Update Dial Plan Assignment.
Configuring Gateway Codes
Service Monitor uses the gateway codes that you configure to determine the call classification for an external call: whether it is local or long distance. Gateway code is usually tied with area code. For example, if your gateway connect to local PSTN with area code 408, you can configure 408 as a gateway code for this gateway, then define a dial pattern such as "If the number of digits dialed is equal to 10 and the pattern is G!". SM will look at the called device name (if it is this gateway), then look at the dialed number, if it matches with area code, it will classified this call as local. So in Service Monitor 2.3, gateway endpoint name is part of "G" pattern match
To configure Gateway code, select
Configuration > Call Classification > Gateway Code. The Gateway Code Summary page opens, select a cluster and click
Manage Gateway Code. If the gateways that you are interested in do not appear on the Manage Gateway Code page, click
Search to search gateways by providing route group name, gateway name or area code as below:
• To find a specific gateway, enter the gateway name only.
• To find gateways that belong to a specific route group, enter the route group name only.
• To find all gateways on a cluster (this list can be long) leave all entry fields blank.
• To find all gateways for which a particular gateway code is already configured, enter a gateway code only.
After the gateways that match the search criteria are added to the table, select one or more gateways, enter codes, separated by commas, in the Gateway Code field, click
Apply and then click
Close. To review the gateways for which gateway codes are configured in Service Monitor, select clusters and click
View on the Gateway Summary page to open a Gateway Code Configuration Report which displays the gateway names along with their gateway codes configured.
Figure 2 below shows how to configure gateway codes with Service Monitor
Figure 2. Configure Gateway Codes with Service Monitor 2.3
Using CDR Call Reports in Service Monitor 2.3
Service Monitor 2.3 provides on demand short term CDR reports. These reports will enable users to view individual calls that fall under certain type(s) of calls for troubleshooting purposes. For example, for a SIP trunk deployment, you can use Service Monitor 2.3 to report failed SIP trunk calls, OnNet/OffNet SIP trunk calls and Incoming/Outgoing SIP trunk calls.
To generate a CDR Call Reports, one can click
Generate Report after defining the "CDR Call Report Filter" under
Reports àCDR Call Reports
Figure 3. Generating CDR Call Report in Service Monitor 2.3
Figure 4. CDR Call Report in Service Monitor 2.3
The `Call Category Names' column in the report above contains a comma separated list of all the categories to which call belongs. The `Termination Type' determines whether the call was a successful or a failed call. The columns are user configurable through the Column Selector tool.
Using Call Traffic Reports in Service Statistics Manager 1.3
Service Statistics Manager provides Call Traffic reports for long term and capacity planning. To generate out-of-box daily traffic report, one can click
Day of week under
Reports Tab to understand the types of calls made by the users at system level. You can also define a customized traffic summary report to just include certain call categories for selected clusters.
Figure 5. Traffic Summary Report in Service Statistics Manager 1.3
• In upgrade scenario, call classification data from Service Statistics Manager 1.2 will be purged only after 3 month. It is suggested to use dialy/weekly report instead of during the first 3 month to get consistent data.
To view individual calls that fall under certain type(s) of calls, you can create Customer Graphs on Call Volume for selected call categories. Goto
Customer Graph-> Select the Graph type-> Select the Group Filter->Select
Call Volume -> Click
Next-> Select Monitor Element-> Click
Apply, then one can select one or a few call categories form the attributes listed and click Generate Graph after defining the other graphing options.
Figure 7. Call Volume Customized Graph in Service Statistics Manager 1.3
• User-defined call category names do not appear in SSM for report generation and graph creation, but the data for them is aggregated and appears under the call category type in SSM.
• As Service Monitor is classifying calls into multiple categories, the total sum of calls in each category in SSM reports may be more than the total number of calls. This behavior is different from previous SSM behavior where the sum of calls under each category yields the total number of calls