Professional Documents
Culture Documents
Management
Administration Guide
Version2.2.R190301
Mobileum, Inc.
20813 Stevens Creek Boulevard, Ste. 200
Cupertino, CA 95014 USA
Phone: +1-408-844-6600
Fax: +1-408-252-1566
www.mobileum.com
LEGAL INFORMATION
© 2019 Mobileum, Inc. All rights reserved. This document is subject to change. This document and the information
herein are provided for the sole use of the intended recipient(s) and for information purposes only. This document
contains contents which are the confidential and proprietary information of Mobileum and/or its licensors. Mobileum
may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering the
subject matter hereof. Unless specifically set forth in a separate written agreement signed by Mobileum, the
furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other
intellectual property. Mobileum, the names of its products, services, and their respective logos are registered trade
or service marks of Mobileum, Inc. This document may not be modified, reproduced, or transmitted in any form or by
any means, electronic or mechanical, for any purpose, without Mobileum’s prior written permission. Mobileum, Inc.
makes no warranty, express or implied, with this document or the information contained herein.
Revision hist or y
Getting started 12
Supported administrative roles 12
Logging in to Mobileum Administrator Studio 13
Security guidelines for using Mobileum Administrator Studio 14
Logging out of Mobileum Administrator Studio 14
Generating dashboards 27
MAP transaction failure dashboard 28
KPIs in the MAP transaction failure dashboard 29
Filters available in the MAP transaction failure dashboard 29
Widgets in the MAP transaction failure dashboard 31
Supported MAP messages and message groups 34
Supported MAP error messages 35
MAP Performance dashboard 37
What details does the MAP Performance dashboard provide? 38
Which KPIs does the MAP Performance dashboard use? 38
Which filters does the RCEM application use to generate the MAP Performance dashboard? 38
Which widgets does the RCEM application display in the MAP Performance dashboard? 39
Diameter failure dashboard 41
KPIs in the Diameter failure dashboard 42
Filters available in the Diameter failure dashboard 42
Widgets in the Diameter failure dashboard 43
Supported Diameter messages and message groups 46
Supported Diameter error messages 46
DIAMETER Performance dashboard 51
What details does the DIAMETER Performance dashboard provide? 51
How does the RCEM application determine successful DIAMETER transactions for a network? 52
RCEM 2.2 Administration Guide
Contents
Which KPIs does each widget display in the DIAMETER Performance dashboard? 53
Which filters does the RCEM application use to generate the DIAMETER Performance dashboard? 53
Which widgets does the RCEM application display in the DIAMETER Performance dashboard? 54
Voice service accessibility dashboard 56
KPIs in the Voice service accessibility dashboard 57
Filters available in the Voice service accessibility dashboard 57
Widgets in the Voice service accessibility dashboard 58
Supported voice service messages 60
Supported voice service error codes 60
Voice connection establishment dashboard 62
KPIs in the Voice connection establishment dashboard 63
Filters available in the Voice connection establishment dashboard 63
Widgets in the Voice connection establishment dashboard 64
Voice connection retainability dashboard 66
KPIs in the Voice connection retainability dashboard 67
Filters available in the Voice connection retainability dashboard 67
Widgets in the Voice connection retainability dashboard 67
Data session establishment dashboard 69
KPIs in the Data session establishment dashboard 70
Filters available in the Data session establishment dashboard 70
Widgets in the Data session establishment dashboard 71
Supported packet data messages 73
Supported packet data error messages 73
Data session retention dashboard 77
KPIs in the Data session retention dashboard 77
Filters available in the Data session retention dashboard 77
Widgets in the Data session retention dashboard 78
Registration dashboards 79
Registration latency dashboard 81
Registration performance dashboard 87
GRQ dashboard 91
KPIs in the GRQ dashboard 91
Filters for generating the GRQ dashboard 93
Widgets in the GRQ dashboard 94
VIP performance dashboard 96
Prerequisites for generating the VIP performance dashboard 96
KPIs in the VIP performance dashboard 97
Filters for generating the VIP performance dashboard 97
Widgets in the VIP performance dashboard 97
Voice usage dashboard 100
KPIs in the Voice usage dashboard 100
Filters for generating the Voice usage dashboard 100
Widgets in the Voice usage dashboard 101
Data usage dashboard 102
KPIs in the Data usage dashboard 102
Filters for generating the Data usage dashboard 102
Widgets in the Data usage dashboard 103
SMS usage dashboard 104
KPIs in the SMS usage dashboard 104
Filters for generating the SMS usage dashboard 104
Widgets in the SMS usage dashboard 105
Unique roamers dashboard 106
KPIs in the Unique roamers dashboard 107
Filters for generating the Unique roamers dashboard 107
Widgets in the Unique roamers dashboard 107
Roamer trip dashboard 109
Important
Effective February 24, 2014, Roamware, Inc. has been renamed Mobileum, Inc. However, this
document may contain references to Roamware, particularly in program artifacts, product and
platform component names, and so on.
This preface describes the purpose of and intended audience for the Roaming Customer Experience
Management 2.2 Administration Guide.It also describes how this guide is organized, publications related to this
guide, conventions used across this guide, and how to contact Mobileum, if required.
Intended audience
This guide is intended for administrators and network planners. Administrators are typically involved in the
operations and maintenance of the RCEMapplication on a daily basis. They also troubleshoot Level 1 (L1)
product issues.
Network planners prepare technical reports about the performance of the RCEMapplication, analyze network
traffic, and so on.
Both administrators and network planners must have advanced experience with the hardware, software, and
network prerequisites described in the “Installation prerequisites” topic of the RCEM2.2 Installation Guide.
Related documents
Table 1 on page x lists and describes the other documents related to this guide.
RCEM 2.2 Administration Guide
Preface
T A B L E 1 : R EL A T ED D OC U M EN T S
Document Description
RCEM 2.2 Installation Describes how to install and configure the RCEM application for Oracle Solaris 9
Guide and 10, and RHEL operating systems.
RCEM 2.2 SNMP Describes the SNMP objects and traps used by the RCEM application.
Reference Guide
Document conventions
Table 2 on page x describes the conventions used in all Mobileum product documentation.
T A B L E 2 : D OC U M EN T C ON VEN T I ON S
Convention Description
Italic nEmphasis
nReferences to other guides and documents
“Quotation Messages displayed on the screen
marks”
Bold n GUI text
n User input
{Fixed A placeholder for something that you must customize. For example, in your environment, replace
Width} {Roamware_Home} with the directory where all Mobileum SDS files are installed.
Fixed Width n Code snippets
n File extensions
n Function names
n CLI text
n Output samples
Fixed Width Target file or directory name in a network path
Bold
Link n Links within a guide
n URL links
n Email addresses
Note The Note admonition describes additional information about a particular topic. Ignoring a note
does not have any negative consequences.
Warning The Warning admonition should not be ignored. Ignoring warnings will most likely cause data
loss.
Tip The Tip admonition describes shortcuts and alternative approaches to a task. Ignoring a tip does
not have any negative consequences.
Important The Important admonition highlights information that might be easily missed, for example,
configuration changes that apply only to the current session, or services that might need restarting
before an update is applied. Ignoring this admonition will not cause data loss but might cause
task rework.
Documentation support
To provide feedback on documentation, send email to docsupport@mobileum.com
Customer support
If you have any problems with, questions on, or feedback about Mobileum products, send email to
customer.support@mobileum.com
Getting started
This topic describes the various administrative roles that the RCEM 2.2 application supports out-of-the-box. It
also lists the steps for logging in to Mobileum Administrator Studio, provides security recommendations for
using Mobileum Administrator Studio, and lists the steps for logging out of Mobileum Administrator Studio.
This guide assumes that you have successfully installed and started the RCEM application. For information
about installing and configuring the RCEM application, refer to the RCEM 2.2 Installation Guide.
T A B L E 3 : D ET A I L S OF SU PPOR T ED A D M I N I ST R A T I VE R OL ES
Default
Default
Group name user Details
password
name
Administrator admin admin@123 Root administrative user for Mobileum Administrator Studio. When you
log in with this administrative role, you can perform the following
actions:
n Create, modify, and delete the following entities:
n Users
n Roles
n Groups
RCEM 2.2 Administration Guide
Chapter 1 - Getting started
Default
Default
Group name user Details
password
name
n Assign users and roles to groups.
n Create, modify, and delete menu structures.
n View audit trails.
n View summary and detail level traces for all the messages.
Note
n You cannot modify the out-of-the-box administrative roles and default user names. However,
you can create custom roles, which may have either the same access rights as the out-of-the-
box roles or custom access rights.
n The default passwords mentioned in Table 3 on page 12 are used only for first-time logins.
Mobileum Administrator Studio prompts you to change these passwords at the time of your first
login.
Important
Mobileum Administrator Studio supports the following browsers:
n Internet Explorer 10
n Mozilla Firefox 32.0
n Google Chrome 44.0
Mobileum Administrator Studio allows you to configure and manage the RCEM application. You must use the
risuser account to Log in to Mobileum Administrator Studio for the first time.
Note
For more information about using Mobileum Administrator Studio, refer to the Mobileum SDS 6.0
User Guide.
Roaming Customer Experience Management (RCEM) is an integrated and real-time monitoring application
that allows a 360-degree view of network, service and customer performance. The application provides near
real-time reports across many Key Performance Indicators (KPIs) covering various aspects of business and
network issues, pertaining to roaming.
RCEM monitors the operation and performance of roaming services as experienced by individual subscribers
in a roaming environment.
RCEM 2.2 Administration Guide
Chapter 2 - Introduction to the RCEM application
RCEM Architecture
F I GU R E 1 : R C E M A R C H I T EC T U R E
n Probe component
n TxnWriter
n SS7TxnWriter
n SIPTxnWriter
n DIATxnWriter
n GTPTxnWriter
n CoSEngine
The following sections describe the components used by the RCEM application:
Probe component
RCEM obtains network traffic feed from the following data sources:
n GTP probe
n Diameter probe
n SIP probe
n DK (SS7) probe
Each of these probes captures the raw network traffic as seen on the roaming links. A state machine layer is
built on top of the probes to combine multiple events of an underlying roaming transaction to generate a
Transaction Data Record (TDR). In case of SS7, it is the TCAP transaction. This state machine layer is either a
plug-in library running on top of the probe binaries (in case of GTP, Diameter, and SIP) or a separate
component (Transaction Writer) that takes feed from the probe over an IP connection. For more information
about probes, refer to the IPProbe 6.0 Installation Guide.
TxnWr it er
The TxnWriter component generates the following types of files:
F I GU R E 2 : E XA M PL E D I SPL A YI N G A SU C C ESSF U L UL T R A N SA C T I ON
n Event file
This file is similar to the detail file but contains the event details for an individual event in a human
readable ASCII format.
Note
You can configure the Anritsu probe for RCEM if it is applicable to your deployment.
Do not configure Mobileum Probes and TxnWriter if you have configured the Anritsu probe on the
specific deployment.
For information about configuring the Anritsu probe, refer to the "Configuring Anritsu Probe" section
in the RCEM 2.2 Installation Guide.
CoSEngine
Note
This configuration is not mandatory and is applicable only if you have installed CoSEngine at a site
where the RCEM application is deployed.
CoSEngine is a module in the Mobileum SDS 7.0 platform. The RCEM application uses CoSEngine for the
following requirements:
n Interacts with the RCEM application by using RPC servers over the TCP/IP interface.
n Responds to the CoS queries that are received from the RCEM application.
n Stores the received subscriber profile and CoS attributes.
n Processes and maps the subscriber profile to a CoS when the RCEM application sends CoS queries for
a subscriber.
n Sends the subscriber profile with the corresponding CoS attributes to the RCEM application.
CoSEngine interacts with the following modules of the RCEM application:
n TxnProcessor interacts with CoSEngine for populating extended information in each master log while
processing for any protocol. For example, to fetch a subscriber's CoS.
n The Trace application supports both internal CoS and the CosEngine component as the sources for CoS
provisioning. The following scenarios are possible:
n If you configure the value of the cos.source.name parameter as sds, the Trace application displays
the internal CoS in the class of subscriber drop-down list. The CoS is determined by the SDS_
SUBSCRIBER_COS_MASTER database table.
n If you configure the value of the cos.source.name parameter as cosengine, the Trace application
displays only those CoSes, in the class of subscriber drop-down list that are determined by the
CoSEngine platform component.
For more information about configuring CoS source for the Trace application, refer to the "Configuring
CoS source for Trace application" section in the RCEM 2.2 Installation Guide.
Note
In both the aforementioned scenarios, the list of CoS excludes those CoS which are configured in
the RI_COS_MASTER table for the currently logged in user.
For information about the RI_COS_MASTER table, refer to "Managing classes of subscribers" on page
24.
n RCEM Dashboards consider CoSEngine platform component as a source for CoS. For more information
about mapping CoSes to RCEM users, refer to "Managing classes of subscribers" on page 24.
n RIS Management considers CoSEngine when CoS information is fetched from CoS source, for
configuring CoS specific thresholds.
For more information about configuring CoSEngine, refer to the "Configuring CoSEngine" section of the
Mobileum SDS 7.0 Installation Guide.
n TxnProcessor
n WISDOM platform:
n HDFS
n Data ingestion job
n Data model job
n Feature factory
n Dynamic dataset manager
n Hive
n Presto
n RCEM dashboards
n Indexer
n Alerter
n Trace
The following sections describe the modules in the RCEM application:
TxnProcessor
The TxnProcessor component processes the log files that the Transaction Writer platform component generates.
The TxnWriter generates the following logs:
WI SDO M plat f or m
The new enriched files are copied to the Hadoop Distributed File System (HDFS) component available in the
WISDOM platform. The RCEM application uses Apache Spark framework to process data real-time.
Subsequently, Spark jobs available in the WISDOM platform, process the files to generate KPIs and the desired
output.
The Apache Spark framework processes the data by using the following jobs and modules:
n HDFS: The Hadoop Distributed File System (HDFS) is data storage used by Hadoop ecosystem. It
employs a NameNode and DataNode architecture to implement a distributed file system.
n Data ingestion job: Data ingestion job fetches the desired data sources from local files system of node
on which the Transaction processor runs and feeds them to HDFS at a predefined location.
n Data model job: Data model job processes the following set of input data sources:
n MAP
n CAP
n ISUP
n Diameter
n SIP
n GTP-C/GTP-MMS
n GTP-U/GTP-DPI
The data model job normalizes, partitions, and stores data sources in a file format called ORC.
n Feature factory: Feature factory job defines and creates the aggregate of data and dumps the aggregate
in Hive tables based on the protocol and granularity (such as, every 15 minutes, hour, day, and month).
n Dynamic dataset manager: The dynamic dataset manager module distinguishes the processed and
unprocessed set of files. The module ensures that each file is processed by jobs such as data model or
feature factory job, only once. Additionally, the dynamic dataset manager module is integrated with the
data model and feature factory jobs.
n Apache Hive: Hive is a data warehousing system to store structured data on HDFS. Hive helps to
process large-scale data and supports SQL-based queries. Hive can run programs both in memory and
on disk.
In RCEM, Hive is used to store metadata of the aggregated tables. When a query is sent to Presto from
the RCEM GUI, Presto fetches the information of metadata from hive meta store and subsequently
processes the query.
The output data generated by the Spark jobs are populated in the Hive tables with the help of SparkSQL.
The aggregated data is stored in Hive tables based on the protocol and granularity (such as, every 15
minutes, hour, day, and month). Hive uses Online Analytical Processing (OLAP) Cubes to store, view,
and analyze data in a multidimensional format.
n Presto: Presto is a distributed SQL engine that is used to query the data sources.
Unlike Hive, Presto runs in the memory only. This functionality allows Presto to run simple queries on
Hadoop in a few hundred milliseconds with more complex queries taking only a few minutes.
In contrast, scanning over an entire dataset using Hive, which relies on Spark jobs, can take anywhere
from several minutes to several hours. Presto has also been proven to be up to seven times more
efficient on the CPU than Hive. In addition, Presto can combine data from multiple sources into a single
query, allowing data analysis across an entire organization.
In RCEM, instead of Hive, Presto is used for analyzing data required by the RCEM dashboards.
RCEM dashboar ds
You can access all RCEM dashboards from the RCEM GUI. You can extract data in each of the dashboards
based on various global filters. The moment a query is submitted in the dashboards, RCEM sends a relevant
query to Presto. Presto then responds with the query result and the same data is displayed in the dashboard in
a graphical or tabular view.
n Segregates quality-related KPIs from business-oriented KPIs (for example, failure rates from usage)
n Provides a multi-dimensional view of the KPIs
n Provides higher level aggregate KPIs based on underlying GRQ KPIs (for example, network quality
score, voice quality score, data quality score, and so on)
Indexer
The RCEM provides the summary files as input to the Indexer component. The Indexer component indexes
these summary files on specified index fields. This helps search these files based on the indexed fields and
return results quickly. The Indexer component uses an in-memory database (Gigabase) that stores the data and
indexes in a proprietary format (DBS files).
RCEM purges the summary files after a couple of days, whereas the DBS files can be stored for a longer
duration based on the operator’s requirements for trace retention. The Indexer also implements a day-wise
partitioning mechanism so that it can restrict searches to specific days as given in the search criteria.
Aler t er
The RCEM application uses Alerter to send alerts to the deploying operators through SMS, SNMP alarms, and
e-mails. The feature factory job provides input to the Alerter. Subsequently, Alerter:
Trace
The Trace application displays the transaction details that are fetched from Indexer. The Trace application
queries the Indexer data source and fetches transaction details for various application activities.
n Fetches and displays on the RCEM GUI, the transaction details that are derived from the extended
summary traces. The extended summary traces that are generated by TxnProcessor, are stored in
Indexer.
n Generates the event and PCAP traces by using the event and detail files, respectively. The event and
detail files are generated by TxnWriter.
The Trace application presents an intuitive search facility to allow searches based on individual IMSIs or GTs.
You can access the Trace application from the RCEM GUI. Using the Trace application, an operator can find
historical data of any transaction. To find the transaction details of the subscriber, operator may use any of the
following filters:
n IMEI
n Subscriber IP Address
n Camel Phase
n Message Type
n Error code
n Protocol
Note
When using the Trace application, some fields are mandatory, such as the following:
When you submit a search query by using the Trace application, the Trace application triggers the Indexer over
an RPC connection. The first level of search is in the DBS files (created by the Indexer) from where the
summarized search results are displayed.
Then the user can fetch event traces or PCAP traces using the event files or PCAP files respectively, for a
transaction. All the events for a transaction are combined to form an event trace and sequence diagrams.
The detail file is used to generate the PCAP traces. You can download the PCAP traces for a transaction. The
PCAP trace represents the information (in a PCAP format file) captured about the raw network traffic.
n SNMP Manager
For example, the RCEM application sends performance notifications to and receives changed threshold
values from the SNMP manager.
n Database
The RCEM application processes database rules and looks up database tables to provide valuable
insights, for the deploying operator, into roamers’ activities and the performance of partner networks.
n Mobileum Administrator Studio
Administrators can use this component to configure thresholds required to send alerts, view the reports
and dashboards provided by the RCEM application, and view the details of a particular transaction in
pcap trace files.
n Probe module
An application that receives MAP messages that are tapped or duplicated from international roaming
links between HPMNs and the deploying VPMN. The RCEM application receives copies of all MAP,
GTP, SIP, and Diameter messages related to international roamers from the Mobileum Probe module.
All these interactions are shown in Figure 3 on page 23.
A class of subscribers (CoS) is a group of subscribers characterized by a common set of services and network
attributes. These services and network attributes determine the type and quality of service available to the
individual members of the CoS.
Mobileum applications such as RCEM use CoS for providing services to the deploying operator’s subscribers.
Managing Class of Subscribers (CoS) refers to identifying and creating CoS for specific policies. You can also
search for, modify, and delete existing CoS configurations specific to the RCEM application in the CoS
Management page in the RCEM application's GUI.
Managing a class of subscribers also refers to creating a CoS and associating it with an individual or a range of
IMSI or MSISDN (belonging to a set of VIP subscribers as defined by the deploying operators).
This configuration helps the RCEM application to identify issues in the services offered to these VIP
subscribers and report them to the deploying operators in a timely manner, thereby helping the deploying
operators to analyze the issues and resolve them on priority.
You can add a CoS in the CoS Management section of Mobileum Administrator Studio. You can also search
for, view, and delete CoS configurations.
Note
For more information about creating and managing a CoS, refer to the Mobileum SDS 7.0 User
Guide.
In addition to adding CoSes, the deploying operators can configure thresholds for KPIs associated with specific
CoSes. When a threshold is breached, the RCEM application raises an alarm to the configured user to alert the
operators. Configure the thresholds in the CoS Threshold Configuration section of Mobileum Administrator
Studio.
For more information about configuring CoS thresholds, refer to "Configuring CoS thresholds" on page 166.
Based on the CoS and CoS thresholds configurations, the RCEM application generates the GRQ dashboard to
provide an analysis of the issues observed by the VIP subscribers.
For information about the GRQ dashboard, refer to "GRQ dashboard" on page 91.
RCEM 2.2 Administration Guide
Chapter 3 - Managing classes of subscribers
If you associate the CoSes to the corresponding RCEM user, that RCEM user cannot view the
CoSes that are mapped to the RI_COS_MASTER database table. The CoSes that are mapped to the RI_
COS_MASTER database table will not be displayed in the CoS filters in the RCEM dashboards and
Class of Subscriber filter in the Trace application.
However, you can view the CoSes that are not mapped to the RI_COS_MASTER database table.
This functionality of the RI_COS_MASTER database table is applicable to the following screens of the
RCEM GUI:
n GRQ threshold
n CoS Management
n CoS Threshold Configuration
n Threshold Configuration
n Dashboards
n Trace
The CoSes that you create in the CoS Management section of Mobileum Administrator Studio are stored in the
SDS_SUBSCRIBER_COS_MASTER database table. However, if you want a CoS that must not appear in the CoS filters
in the RCEM dashboards, you must associate the CoSes to the corresponding users, for example, risuser, in
the RI_COS_MASTER database table.
Note
You must read this note when you want to know about the user-specific CoS association for
Trace application.
The RCEM application supports multiple CoS sources specifically for the Trace application.
Therefore, you can configure the CoS source as one of the following options:
n CoS you create in the CoS Management section of Mobileum Administrator Studio.
n CoS that the CoSEngine platform component computes.
CoS that are computed by the CoSEngine platform component are stored in the SDS_COS_
DEFINITION table.
In the Trace application, you can associate the CoS to the corresponding users, for example,
risuser, in the RI_COS_MASTER database table.
For information about how you can configure CoS sources for Trace application, refer to the
"Configuring CoS source for Trace application" section in the RCEM 2.2 Installation Guide.
Where, <COSID> is the ID of the CoS that you want to associate with the user. The <COSID> is obtained
from the SDS_COS_MASTER database table.
Repeat this step for other CoSes that you want to associate with users in the RI_COS_MASTER database
table.
Note
You must read this note when you want to know about the user-specific CoS association for
Trace application.
CoS that are computed by the CoSEngine platform component are stored in the SDS_COS_DEFINITION
table. You must map CoSes to RCEM users if you want to associate a CoS with a user. You can
associate these CoS or CoS created in step 1 with the user to hide the user-specific CoS information
in the Trace application.
Generating dashboards
The RCEM application provides, to operators, statistics, reports, and dashboards that summarize the
performance of a network, based on the quality of roaming services provided to the subscribers by the partner
networks.
Dashboards are generated with the help of the reporting application that is integrated and accessed through
Mobileum Administrator Studio. You can control the details in a dashboard based on values that you specify in
the report’s search criteria and duration. The dashboards contain widgets that display statistics across various
dimensions.
The widgets provide a unidimensional view of the information. However, if you click any criterion in one widget,
the same criterion is applied in the other widgets to provide a multi-dimensional analysis of the information.
For example, in the MAP transaction failure dashboard, if you click UL in the MAP Txn Failure Rate by
Message Type widget, the dashboard applies the UL filter in the other widgets and refreshes the other widgets
with information corresponding to the UL filter.
The dashboard also allows operators to drill down through the dimensions to display dimension-specific
information in the widgets. The dashboard supports the following drill-down options:
Important
Not all the dashboards in the preceding list are applicable to all the sites. For a list of reports that are
applicable to your deployment, check with your Mobileum PSO representative.
n Region
n Message type
n Error code
n Error causing network
n Time
n Message group
The dashboard helps operators to obtain the cause for the failures and help fix these errors.
n Total transaction count: The total MAP transactions that occurred between the HPMN and VPMN.
n Transaction failure rate: Number of MAP transactions that have failed for a particular dimension.
The transaction failure rate for a particular dimension is computed as follows:
Transactions failed (grouped for a dimension) / Total transactions
T A B L E 4 : F I L T ER S F OR GEN ER A T I N G T H E MAP T R A N SA C T I ON F A I L U R E D A SH B OA R D
Host Name No The name of the host networks for which you want to generate the dashboard.
From the drop-down list, select the required host networks.
Partner Yes Type of roaming partner for which you want to generate the dashboard. Based on the
Type option you select, the dashboard displays aggregated data for that partner type.
The following options are available:
n Countrywise: “Dashboard displays aggregated data based on the partner
countries you specify in the Partner Country field.”
n Networkwise: “Dashboard displays aggregated data based on the partner
networks you specify in the Partner Network field.”
n Nodewise: “Dashboard displays aggregated data based on the partner nodes
you specify in the Partner GT field.”
n Alliancewise: "Dashboard displays aggregated data based on the alliances
that you specify in the Alliance drop-down list.
From the drop-down list, select the required partner type.
Partner No ---
Country Note: This field is applicable only if you select the Countrywise option in the Partner
Type filter.
---
Countries to which the roaming partner networks belong, for which you want to
generate the dashboard.
From the drop-down list, select the required partner countries.
Partner No ---
Network Note: This field is applicable only if you select the Networkwise option in the Partner
Type filter.
---
Names of the partner networks for which you want to generate the dashboard.
From the drop-down list, select the required partner networks.
Partner GT No ---
Note: This field is applicable only if you select the Nodewise option in the Partner
Type filter.
---
GT of a partner network’s node for which you want to generate the dashboard.
Specify the GT (in integer format) in the text box.
Alliance No Note:
n This field is applicable only if you select the Alliancewise option from the
Partner Type filter.
n An alliance is a collection of networks that you create in the Alliance
Management module of the IRDB platform component GUI. You create a
collection based on several properties that a group of networks share. For
example, you create an alliance of networks that support only LTE technology.
Therefore, you create an alliance named LTEalliance. For information about
how to create an alliance, add networks to an alliance, modify an alliance, refer
to the "Alliance Management" chapter of theIRDB 6.0 Administration Guide
n This drop-down list displays only those alliances that you created by using the
Alliance Management module of the IRDB platform component GUI. You
cannot create or modify an alliance in the RCEM application GUI.
---
Alliance to which the roaming partner network belong, for which you want to generate
the dashboard.
From the drop-down list, select the required alliances.
Class of Yes The CoS for which you want to generate the dashboard.
Subscriber From the drop-down list, select the required CoS.
---
Note: You must specify one of the following set of filters for specifying the period to fetch data for the
dashboard:
n Time Granularity, Start date, and End date
n Within last
---
Time Yes Frequency at which you want to view the data in the dashboard.
Granularity The following options are available:
n Hourly
n Daily
n Monthly
Start date Yes Start date of the period for which you want to fetch the data and view in the dashboard.
Perform one of the following actions:
n Type the date in the dd-mm-yyyy format.
n Days
n Weeks
n Months
n Quarters
n Years
From the drop-down list, select the granularity type.
Roamer No Type of roamer for which you want to generate the dashboard.
Type The following options are available:
n Inbound: “Report is generated for inbound roamers from the selected regions.”
n Call
n Fault recovery
n Location management
n Registration
n SMS
n Subscriber management
n USSD
From the drop-down list, select the required message group names.
For a list of the message types included in the groups, refer to "Supported MAP
messages and message groups" on page 34.
MAP No The MAP messages for which you want to generate the dashboard.
Message From the drop-down list, select the required MAP messages.
Type
For a list of supported MAP messages, refer to "Supported MAP messages and
message groups" on page 34.
MAP Error No The MAP error codes for which you want to generate the dashboard.
Code From the drop-down list, select the required MAP error codes.
For a list of supported MAP error codes, refer to "Supported MAP error messages" on
page 35.
Error No Type of network that is responsible for the MAP transaction failures.
Causing The following options are available:
Network n Host: “Dashboard displays the distribution of failures that have occurred
Type because of issues in the host network.”
n Partner: “Dashboard displays the distribution of failures that have occurred
because of issues in the partner networks.”
From the drop-down list, select the required network types.
F I GU R E 4 : M A P T R A N SA C T I ON F A I L U R E D A SH B OA R D
Table 5 on page 33 lists and describes the widgets available in the MAP transaction failure dashboard.
Widget Description
MAP Txn Failure Rate Displays region-wise (partner country, network, node) trend of total MAP transactions
by Region and the transaction failure rate. The widget displays the top 10 partner countries,
networks, or nodes (depending on the criteria you select) that have the most number
of failures. The regions are sorted first on the basis of total transactions and then by
failure rate.
The widget helps the operator to identify the regions where transaction failures are
high.
MAP Txn Failure Rate Displays the trend of total MAP transactions and the transaction failure rate over time
by Time for the selected duration.
MAP Txn Failure Rate Displays the message-wise trend of total MAP transactions and the transaction
by Message Type failure rate. The widget displays the message types with the maximum failure rate.
For a list of the MAP messages that the RCEM application considers for generating
the dashboard, refer to "Supported MAP messages and message groups" on page
34.
MAP Txn Failure Rate Displays the message group-wise trend of total MAP transactions and failure rate.
by Message Group MAP transactions are initiated between the networks to provide services
(registration, call, SMS, and so on) to subscribers. The message types are grouped
together to form specific message groups based on the services offered to the
subscribers.
The widget displays the information for the following message groups:
n Authentication
n Call
n Fault recovery
n Operation and maintenance
n Location management
n Registration
n SMS
n Subscriber management
n USSD
For a list of the MAP message types included in the groups, refer to "Supported MAP
messages and message groups" on page 34.
MAP Txn Failure Rate Displays the distribution of error codes that cause the transaction failures that are
by Error Code observed.
For a list of the MAP error codes supported by the RCEM application, refer to
"Supported MAP error messages" on page 35.
MAP Txn Failure Rate Transaction failures can occur because of issues in either the host network or partner
by Error Causing PLMN networks.
This widget displays the distribution of failures across the following groups:
n host network–induced
n partner network–induced
For example, when a UL (for an outbound subscriber in a non-preferred network) is
rejected by the home operator’s steering application, this failure is categorized as a
host network–induced failure.
MAP Txn Top Failures Displays a detailed list of transaction failures that have occurred during the period
that you have selected.
The top transaction failures table displays the following information:
Widget Description
Columns in the
Description
widget
Partner Network Name of the partner network for which the MAP transaction
Name failures have occurred.
Message Name The MAP message from which the transaction failures have
occurred.
For a list of the MAP messages, refer to "Supported MAP
messages and message groups" on page 34.
Error Code Error codes causing the transaction failures.
For a list of the MAP error codes, refer to "Supported MAP error
messages" on page 35.
Click the error code to generate the trace details.
Error Causing The type of network that causes the transaction failures.
Network Type
Total Transaction Total number of MAP transactions that have occurred between
the host and partner networks for the error codes that have
caused the failure.
38
n "Which widgets does the RCEM application display in the MAP Performance dashboard?" on page 39
n : Total number of MAP transactions that occurred between the home and visited
network.
n : Number of MAP transactions (in percentage) for which an ACK message was
exchanged between the home and visited network. The RCEM application uses the following formula to
determine Success Rate:
n Successful Transaction / Total Transactions * 100
F I GU R E 5 : W I D GET S IN THE M A P P ER F OR M A N C E D A SH B OA R D
As shown in Figure 5 on page 39, the MAP Performance dashboard displays the following widgets:
F I GU R E 6 : M A P TX N S U C C E S S R A TE B Y R E GION W I D GET
n The MAP TXN SUCCESS RATE BY REGION widget displays region-wise trend of total MAP transaction
and success rate of MAP transactions.
n The widget displays the top 10 partner countries, networks, or nodes (depending on the criteria you
select) that have the most number successful MAP transactions. The regions are sorted first on the basis
of total transactions and then by success rate.
n Subsequently, you can drill-down to node-wise distribution
F I GU R E 7 : M A P TX N S U C C E S S R A TE B Y TIM E W I D GET
n The MAP TXN SUCCESS RATE BY TIME widget displays the trend of total MAP transactions and the
transaction success rate over time for the selected duration.
F I GU R E 8 : M A P TX N S U C C E S S R A TE B Y M E S S A GE TY P E W I D GET
n The MAP TXN SUCCESS RATE BY MESSAGE TYPE widget displays the message-wise trend of total
MAP transactions and the transaction success rate. The widget displays the message types with the
maximum success rate. For a list of the MAP messages that the RCEM application considers for
generating the dashboard, refer to "Supported MAP messages and message groups" on page 34.
F I GU R E 9 : M A P TX N S U C C E S S R A TE B Y M E S S A GE GR OU P W I D GET
n The MAP TXN SUCCESS RATE BY MESSAGE GROUP widget displays the message group-wise trend
of total MAP transactions and success rate.
n MAP transactions are initiated between the networks to provide services (registration, call, SMS, and so
on) to subscribers. The message types are grouped together to form specific message groups based on
the services offered to the subscribers. The widget displays the information for the following message
groups:
n Authentication
n Registration
n Subscriber management
n SMS
n Call
n USSD
n Fault Recovery
n Operation and maintenance
For a list of the MAP messages that the RCEM application considers for generating the dashboard, refer to
"Supported MAP messages and message groups" on page 34.
n Region
n Time
n Message type
n Message group
n Error code
n Error causing network
The dashboard helps operators to obtain the cause for the failures and help fix these errors.
n Total transaction count: The total Diameter transactions that occurred between the HPMN and VPMN.
n Transaction failure rate: Number of Diameter transactions that have failed for a particular dimension.
The transaction failure rate for a particular dimension is computed as follows:
Transactions failed (grouped for a dimension) / Total transactions
T A B L E 8 : F I L T ER S F OR GEN ER A T I N G T H E D I A M ET ER F A I L U R E D A SH B OA R D
n Fault recovery
n Subscriber management
From the drop-down list, select the required message group names.
For a list of the message types included in the groups, refer to "Supported
Diameter messages and message groups" on page 46.
DIA Message No The Diameter messages for which you want to generate the dashboard.
Type From the drop-down list, select the required Diameter messages.
For a list of supported Diameter messages, refer to "Supported Diameter
messages and message groups" on page 46.
DIA Error Code No The Diameter error codes for which you want to generate the dashboard.
From the drop-down list, select the required Diameter error codes.
For a list of supported Diameter error codes, refer to "Supported Diameter error
messages" on page 46.
F I GU R E 1 0 : D I A M ET ER F A I L U R E D A SH B OA R D
Table 9 on page 45 lists and describes the widgets available in the Diameter failure dashboard.
T A B L E 9 : W I D GET S IN THE D I A M ET ER F A I L U R E D A SH B OA R D
Widget Description
DIA Txn Failure Rate by Displays host network-wise (in a multi-tenant deployment) distribution of total
Host Diameter transactions and the transaction failure rate.
DIA Txn Failure Rate by Displays region-wise (partner country, network, node) distribution of total Diameter
Region transactions and the transaction failure rate. The widget displays the top 10 partner
countries, networks, or nodes (depending on the criteria you select) that have the
most number of failures. The regions are sorted first on the basis of total transactions
and then by failure rate.
The widget helps the operator to identify the regions where transaction failures are
high.
DIA Txn Failure Rate by Displays the message-wise distribution of total Diameter transactions and the
Message Type transaction failure rate. The widget displays the message types with the maximum
failure rate.
For a list of the Diameter messages that the RCEM application considers for
generating the dashboard, refer to "Supported Diameter messages and message
groups" on page 46.
DIA Txn Failure Rate by Displays the message group-wise distribution of total Diameter transactions and
Message Group failure rate.
Diameter transactions are initiated between the networks to provide services (such
as registration and subscriber management) to subscribers. The message types are
grouped together to form specific message groups based on the services offered to
the subscribers.
The widget displays the information for the following message groups:
n Registration
n Fault recovery
n Subscriber management
For a list of the Diameter message types included in the groups, refer to "Supported
Diameter messages and message groups" on page 46.
DIA Txn Failure Rate by Displays the distribution of Diameter error codes that cause the transaction failures
Error Code that are observed.
For a list of the Diameter error codes supported by the RCEM application, refer to
"Supported Diameter error messages" on page 46.
DIA Txn Failure Rate by The Diameter transaction failures can occur because of issues in either the host
Error Causing PLMN network or the partner networks.
This widget displays the distribution of failures across the following groups:
n Host
n Partner
Partner Network Name Name of the partner network for which the Diameter
transaction failures have occurred.
Message Name The Diameter message from which the transaction failures
Widget Description
have occurred.
For a list of the Diameter messages, refer to "Supported
Diameter messages and message groups" on page 46.
Error Code Error codes causing the transaction failures.
For a list of the Diameter error codes, refer to "Supported
Diameter error messages" on page 46.
Click the error code to generate the trace details.
Error Causing Network The type of network that causes the transaction failures.
Type
Total Transaction Total number of Diameter transactions that have occurred
between the host and partner networks for the error codes
that have caused the failure.
Diameter message
Diameter message name
group
Registration Update Location Request/Answer (ULR/ULA)
Cancel Location Request/Answer (CLR/CLA)
Authentication Information Request/Answer
(AIR/AIA)
Subscriber Management Insert subscriber Data Request/Answer (IDR/IDA)
Delete Subscriber Data Request/Answer (DSR/DSA)
Purge UE Request/Answer (PUR/PUA)
Fault Recovery Reset Request/Answer (RSR/RSA)
Notify Request/Answer (NOR/NOA)
F I GU R E 1 1 : D IA M E TE R SU C C ESS
TI M EO UT er r or s
n The RCEM application monitors ACK messages for a corresponding DIAMETER message for a time out
duration.
n If the RCEM application does not observe an ACK message within the time out duration, the application
identifies such concurrences as TIMEOUT errors and excludes this transaction from the successful
DIAMETER transactions count.
n You can configure the time out duration in the diawriter.max.transaction.timeout.msec parameter
IPProbe.cfg file.
: Total number of DIAMETER transactions that occurred between the home and visited
network.
: Number of DIAMETER transactions (in percentage) for which an ACK message was
exchanged between the home and visited network. The RCEM application uses the following formula to
determine Success Rate:
F I GU R E 1 2 : W I D GET S IN THE D IA M E TE R P ER F OR M A N C E D A SH B OA R D
As shown in Figure 12 on page 54, the DIAMETER Performance dashboard displays the following widgets:
F I GU R E 1 3 : D IA M E TE R TX N S U C C E S S R A TE B Y R E GION W I D GET
n The DIAMETER TXN SUCCESS RATE BY REGION widget displays region-wise trend of total
DIAMETER transaction and success rate of DIAMETER transactions.
n The widget displays the top 10 partner countries, networks, or nodes (depending on the criteria you
select) that have the most number successful DIAMETER transactions. The regions are sorted first on
the basis of total transactions and then by success rate.
F I GU R E 1 4 : D IA M E TE R TX N S U C C E S S TR E N D W I D GET
n The DIAMETER TXN SUCCESS TREND widget displays the trend of total DIAMETER transactions and
the transaction success rate over time for the selected duration.
F I GU R E 1 5 : D IA M E TE R TX N S U C C E S S R A TE B Y M E S S A GE TY P E W I D GET
n The DIAMETER TXN SUCCESS RATE BY MESSAGE TYPE widget displays the message-wise trend of
total DIAMETER transactions and the transaction success rate. The widget displays the message types
with the maximum success rate. For a list of the DIAMETER messages that the RCEM application
considers for generating the dashboard, refer to "Supported Diameter messages and message groups"
on page 46
F I GU R E 1 6 : D IA M E TE R TX N S U C C E S S R A TE B Y M E S S A GE GR OU P W I D GET
n The DIAMETER TXN SUCCESS RATE BY MESSAGE GROUP widget displays the message group-
wise trend of total DIAMETER transactions and success rate.
n DIAMETER transactions are initiated between the networks to provide services (registration, LTE call,
VoLTE data, and so on) to subscribers. The message types are grouped together to form specific
message groups based on the services offered to the subscribers. The widget displays the information
for the following message groups:
n Registration
n Subscriber management
n Fault Recovery
For a list of the DIAMETER messages that the RCEM application considers for generating the dashboard, refer
to "Supported Diameter messages and message groups" on page 46
n Ability of networks to deliver calls to the destination: The dashboard displays this analysis in terms of
the NER KPI. The NER expresses the relationship between the number of international calls that were
successfully delivered to the destination and the total number of international calls between networks.
n Voice call connection speed between networks: Voice call connection speed is measured in terms of
the average PDD time interval KPI. The average PDD provides an estimate of a network’s voice call
connection speed between networks. The dashboard also displays the reasons that cause delays in
voice call connections.
The dashboard also displays the failures observed during voice call transactions and the effect of these failures
on the average PDD and NER values. Analyzing the failures from multiple dimensions is important to fix the
failures. The Voice service accessibility dashboard helps operators to analyze the failures across the following
dimensions:
n Region
n Time
n Error code
n Call type
The dashboard helps operators to obtain the cause for the failures and help fix these errors.
The dashboard displays data for ISUP and CAMEL voice services offered to both inbound and outbound
roamers.
n NER: (Expressed as a percentage value, for international roaming call transactions.) NER expresses the
relationship between the total number of calls and the sum of the number of calls resulting in either of
the following results:
n Answer signal
n User busy (release cause codes: 17)
n Ring but no answer (cause codes: 16 (normal call clearing), 18 (no user responding), 19 (no answer
from user (user alerted)))
n In the case of ISDN, a terminal rejection or unavailability (release cause codes: 21 (call rejected), 27
(destination out of order))
NER is calculated as follows:
[Number of successful call attempts] x 100 / [Number of call attempts]
n PDD: PDD corresponds to the time between sending of complete address information and receipt of call
set-up notification. PDD is computed as the difference in time between the IAM and ACM messages and
is measured in seconds.
Note: The RCEM application does not calculate PDD for CAMEL-based calls.
n Total call count: Number of calls attempted (includes successful and failed attempts) by the roamers in
the specified region and time.
n Count of successful calls: Number of successful calls with the following release cause codes: 16, 17,
18, 19, 21, 27.
F I GU R E 1 7 : V OI C E SER VI C E A C C ESSI B I L I T Y D A SH B OA R D
Table 12 on page 59 lists and describes the widgets available in the Voice service accessibility dashboard.
Widget Description
Service Accessibility Displays region-wise (partner country, network, node) trend of average PDD and NER
by Region values.
The widget helps the operator to identify the regions where the NER values are low
and where the PDD values are high.
Service Accessibility Displays the trend of average PDD and NER values over time for the selected
by Time duration.
Service Accessibility Displays the distribution of voice service error codes that cause the delay in accessing
by Cause Code voice services.
For a list of voice service error codes that are supported by the RCEM application,
Widget Description
Partner Network Name Name of the partner network for which the maximum voice
call count is present.
Roamer Type Type of roamer for which the maximum voice call count is
present.
Call Type Type of call for which the maximum voice call count is
present.
Error Code Error codes that cause voice call failures.
For a list of voice error codes, refer to "Supported voice
service error codes" on page 60.
Total Call Count Number of voice calls that have occurred between the host
and partner networks.
Successful Calls Number of successful calls with the following release cause
Attempted Count codes: 16, 17, 18, 19, 21, 27.
Network Efficiency NER (in percentage value) for the partner network.
Ratio (%)
Average Post Dial Average PDD (in seconds) for the partner network.
Delay (sec)
n Normal or unspecified
n Number changed
n Only restricted digital information bearer capability is available
n Outgoing calls barred within CUG
n Parameter non-existent or not implemented - passed on
n Permanent frame mode connection operational
n Permanent frame mode connection out of service
n Precedence call blocked
n Preemption
n Preemption – circuit reserved for reuse
n Protocol error or unspecified
n Quality of service unavailable
n Recovery on timer expiry
n Requested channel/circuit not available
n Requested facility not implemented
n Requested facility not subscribed
n Resources unavailable or unspecified
n Response to STATUS ENQUIRY
n Send special info tone
n Service or option not available or unspecified
n Service or option not implemented, unspecified
n Subscriber absent
n Switching equipment congestion
n Temporary failure
n Transaction Abort Received
n Transaction Error Received
n Transaction Reject Received
n Unallocated (unassigned) number
n Unknown cause code
n Unknown release cause code
n User busy
n User not member of CUG
n Voice call seizures: Voice call seizure is measured in terms of the ASR KPI. The ASR expresses the
relationship between the number of calls that were successfully answered and the total number of calls.
The dashboard also displays the failures observed during the voice call transactions and the effect of these
failures on the ASR values. Analyzing the failures from multiple dimensions is important to fix the failures. The
Voice service accessibility dashboard helps operators to analyze the failures across the following dimensions:
n Region
n Time
n Error code
n Call type
The dashboard helps operators to obtain the cause of the failures and help fix these errors.
The dashboard displays data for ISUP and CAMEL voice services offered to both inbound and outbound
roamers.
n ASR: (Expressed as a percentage value, for international roaming call transactions.) ASR expresses the
relationship between the number of call attempts that result in an answer signal and the total number of
call attempts. This is a direct measure of the effectiveness of the service being offered onward from the
point of measurement.
ASR is calculated as follows:
[Number of answered international calls] x 100 / [Number of international calls that were
successfully attempted] x 100
n Total call count: Number of calls attempted (includes successful and failed attempts) by the roamers in
the specified region and time.
n Count of successful calls: Number of calls that were answered.
T A B L E 1 3 : F I L T ER S F OR GEN ER A T I N G T H E V OI C E C ON N EC T I ON EST A B L I SH M EN T D A SH B OA R D
F I GU R E 1 8 : V OI C E C ON N EC T I ON EST A B L I SH M EN T D A SH B OA R D
Table 14 on page 65 lists and describes the widgets available in the Voice connection establishment
dashboard.
Widget Description
Connection Displays region-wise (partner country, network, node) trend of ASR value and the count of
Establishment by total and successful calls.
Region
Connection Displays the trend of ASR value and the count of total and successful calls over time for the
Establishment by selected duration.
Time
Widget Description
Connection Displays the distribution of voice service error codes that are causing call failures and, in
Establishment by turn, resulting in reduced ASR values.
Cause Code For a list of voice service error codes supported by the RCEM application, refer to
"Supported voice service error codes" on page 60.
Connection Displays the trend of ASR values over time for the selected call types.
Establishment by The following call types are supported:
Call Type n Mobile Terminated
n Mobile Originated
Voice Connection Displays a detailed list of the top 20 partner networks with the maximum number of call
Establishment counts during the period that you select. It also displays the ASR values corresponding to
the successful calls that were answered.
The voice connection establishment table displays the following information:
Partner Network Name Name of the partner network for which the maximum
voice call count is present.
Roamer Type Type of roamer for which the maximum voice call count
is present.
Call Type Type of call for which the maximum voice call count is
present.
Error Code Error codes that cause voice call failures.
For a list of voice error codes, refer to "Supported voice
service error codes" on page 60.
Total Call Count Number of voice calls that have occurred between the
host and partner networks.
Successful Call Count Number of calls that were answered.
Answer Seizure Ratio (%) ASR (in percentage value) of the partner network.
n Successful call completion: The dashboard displays this information in terms of the CCR KPI. CCR
expresses the relationship between successful calls and successfully established calls that are
intentionally released by the roamers.
n Average duration of call: The dashboard displays the trend in the average duration of international
voice calls that the roamers were involved in.
The dashboard also displays the failures observed during the voice call transactions and the effect of these
failures on the CCR and average call duration values. Analyzing the failures from multiple dimensions is
important to fix the failures. The Voice service retainability dashboard helps operators to analyze the failures
across the following dimensions:
n Region
n Time
n Error code
n Call type
The dashboard helps operators to obtain the cause of the failures and help fix these errors.
The dashboard displays data for ISUP and CAMEL voice services offered to both inbound and outbound
roamers.
n CCR: CCR is the ratio between successful calls and successfully established calls that were
intentionally released by the roamer.
n Average duration of call: Average time between the call answer message (ANM) and the call release
message (REL) in an international call transaction.
n Count of successful calls: Number of calls that were successfully answered.
n Count of intentionally released calls: Number of answered calls that were intentionally released.
T A B L E 1 5 : F I L T ER S F OR GEN ER A T I N G T H E V OI C E C ON N EC T I ON R ET A I N A B I L I T Y D A SH B OA R D
Host Name No For descriptions, refer to ": Filters for generating the MAP transaction failure
Partner Type Yes dashboard" on page 29.
Partner Country No
Partner Network No
Partner GT No
Time Granularity Yes
Start date Yes
End date Yes
Within last Yes
Roamer Type No
Voice Protocol No For descriptions, refer to ": Filters for generating the Voice service
Call Type No accessibility dashboard" on page 58.
Voice Error Code No
F I GU R E 1 9 : V OI C E C ON N EC T I ON R ET A I N A B I L I T Y D A SH B OA R D
Table 16 on page 68 lists and describes the widgets available in the Voice connection retainability dashboard.
T A B L E 1 6 : W I D GET S IN THE V OI C E C ON N EC T I ON R ET A I N A B I L I T Y D A SH B OA R D
Widget Description
Connection Retainability Displays region-wise (partner country, network, node) trend of average duration of
by Region calls and CCR values.
The widget helps the operator to identify the regions where the calls have long
durations and where the CCR values are low.
Connection Retainability Displays the trend of average duration of calls and CCR values over time for the
by Time selected duration.
Connection Retainability Displays the distribution of voice connection error codes that cause the delay in
Widget Description
n Mobile Originated
Voice Connection Displays a detailed list of the top 20 partner networks with the maximum number of
Retainability call counts during the period that you select.
The voice connection retainability table displays the following information:
Partner Network Name of the partner network for which the maximum
Name voice call count is present.
Roamer Type Type of roamer for which the maximum voice call count is
present.
Call Type Type of call for which the maximum voice call count is
present.
Error Code Error codes that cause voice call failures.
For a list of voice error codes, refer to "Supported voice
service error codes" on page 60.
Successful Call Count Number of calls that were answered.
Intentionally Released Number of answered calls that were intentionally
Calls Count released by the roamers.
Average Call Duration Average call duration (in minutes) for the partner network.
(min)
Call Completion Ratio CCR (in percentage value) for the partner network.
(%)
n Region
n Error code
n APN
n Time
n GTP version
The dashboard helps operators to obtain the cause of the failures and help fix these errors.
n Total sessions: Number of packet data sessions that have occurred during the specified period.
n Failed sessions: Number of packet data sessions that have failed to establish during the specified
period.
n Failure rate (%): Packet data sessions that have failed to establish compared to the total data sessions
that have occurred for a particular dimension and specified duration.
The packet data session failure rate for a particular dimension is computed as follows:
Data sessions failed (grouped for a dimension) / Total sessions
n GAN
n UTRAN
n EUTRAN
n GERAN
n HSPA Evolution
n WLAN
n Reserved
n Virtual
GTP Error Code No The GTP error codes for which you want to generate the dashboard.
From the drop-down list, select the required GTP error codes.
For a list of supported GTP error codes, refer to "Supported packet data error
messages" on page 73.
APN No Name of the partner network’s APN for which you want to generate the
dashboard.
From the drop-down list, select the required APNs.
F I GU R E 2 0 : D A T A SESSI ON EST A B L I SH M EN T D A SH B OA R D
Table 18 on page 72 lists and describes the widgets available in the Data session establishment dashboard.
Widget Description
Failure by Displays region-wise (partner country, network, node) trend of total packet data sessions, number
Region of failed sessions, and the sessions failure rate.
The widget displays the top 10 partner countries, networks, or IPs (depending on the criteria you
select) that have the most number of data session failures. The regions are sorted first on the
basis of total sessions and then by session failure rate.
The widget helps the operator to identify the regions where the packet data session failures are
high.
Failure by Displays the trend of total packet data sessions, number of failed sessions, and the sessions’
Time failure rate over time for the selected duration.
Widget Description
Failure by Displays the distribution of error codes that cause the data session registration failures that are
CauseCode observed.
For a list of the packet data error codes supported by the RCEM application, refer to "Supported
packet data error messages" on page 73.
Failure by Displays the distribution of data session registration failures across the APNs that were used by
APN roamers to create the sessions.
The widget displays the top 10 APNs where the maximum data session registration attempts
occurred and the failures in each of these APNs.
Failure by Displays the GTP version-wise trend of total packet data sessions, data session registration
Version failures, and the failure rate.
Failure by Displays the RAT-wise trend of total packet data sessions, data session registration failures, and
Start RAT the failure rate.
n V1 Request IMSI
n V1 Request IMEI
n V1 Request IMSI and IMEI
n V1 No identity needed
n V1 MS refuses (request)
n V1 MS is not GPRS responding (request)
n V1 For future use 6-48
n V1 Cause values reserved for GPRS charging protocol use 49-63
n V1 For future use 64-127
n V1 Request accepted
n New PDP type due to network preference
n V1 APN Congestion
n V1 Bearer handling not supported
n V1 Target access restricted for the subscriber
n V1 UE is temporarily not reachable due to power saving
n V1 Relocation failure due to NAS message redirection
n V1 For future use 234-240
n V1 Cause Values Reserved For Gprs Charging Protocol Use
n V2 Reserved Invalid IE
n V2 Reserved
n V2 Local Detach
n V2 Complete Detach
n V2 RAT changed from 3GPP to Non-3GPP
n V2 ISR deactivation
n V2 Error Indication recvd from RNC/eNodeB/S4-SGSN
n V2 IMSI Detach Only
n V2 Reactivation Requested
n V2 PDN reconnection to this APN disallowed
n V2 Access changed from Non-3GPP to 3GPP
n V2 PDN connection inactivity timer expires
n V2 PGW not responding
n V2 Network Failure
n V2 QoS parameter mismatch
n V2 For Future Use
n V2 Request accepted
n V2 Request accepted partially
n V2 New PDN type due to network preference
n V2 New PDN type due to single address bearer only
n V2 For future use 20-63
n V2 Context Not Found
n V2 Invalid Message Format
n V2 Version not supported by next peer
n V2 Invalid length
n V2 Service not supported
n V2 Mandatory IE incorrect
n V2 Mandatory IE missing
n V2 Not used 71
n V2 System failure
n V2 No resources available
n V2 Semantic error in the TFT operation
n V2 Syntactic error in the TFT operation
n Region
n Error code
n APN
n Time
n GTP version
The dashboard helps operators to obtain the cause for the failures and help fix these errors.
n Total sessions: Number of successful packet data sessions that have occurred during the specified
period.
n Total session drops: Number of packet data sessions that have been dropped without being
intentionally dropped by the roamers during the specified period.
n Drop rate (%): Relationship between packet data sessions that have been dropped (not intentionally by
the roamers) compared to the total successful data sessions that have occurred for a particular
dimension and specified duration.
The packet data drop rate for a particular dimension is computed as follows:
Data sessions dropped (not intentionally dropped by roamers), grouped for a dimension / Total
successful sessions
F I GU R E 2 1 : D A T A SESSI ON R ET EN T I ON D A SH B OA R D
Table 20 on page 79 lists and describes the widgets available in the data session retention dashboard.
Widget Description
Data Session Displays region-wise (partner country, network, node) trend of total successful packet data
Retention sessions, number of dropped sessions, and the sessions drop rate (in percentage value).
Failure by The widget displays the top 10 partner countries, networks, or IPs (depending on the criteria
Region you select) that have the most number of session drops. The regions are sorted first on the
basis of total successful data sessions and then by session drop rate.
The widget helps the operator to identify the regions where the packet data session drops
are high.
Data Session Displays the trend of total successful packet data sessions, number of dropped sessions,
Retention and the sessions’ drop rate (in percentage value) over time for the selected duration.
Failure by Time
Data Session Displays the distribution of error codes that cause the data session drops.
Retention For a list of packet data error codes supported by the RCEM application, refer to "Supported
Failure by packet data error messages" on page 73.
CauseCode
Data Session Displays the distribution of data session drops across the APNs that were used by roamers
Retention to create the data sessions.
Failure by APN The widget displays the top 10 APNs where the maximum data session registrations were
successful and the session drops in each of these APNs.
Data Session Displays the GTP version-wise trend of total successful packet data sessions, number of
Retention dropped sessions, and the sessions’ drop rate (in percentage value).
Failure by
Version
Registration dashboards
The registration dashboards, Registration Latency and Registration Performance, provide country-wise
distribution of registration attempts, registration failures, and the percentage of stuck handsets observed across
different technologies (GSM, GPRS, LTE, GSM_GPRS, and LTE_GSM). It also displays CoS-wise and
registration reject code–wise distribution of the number of registration failures. The dashboard also provides
operators with information about the count of registrations categorized based on the following criteria:
Registration latency
Registration latency is the time taken for one complete successful registration cycle. The registration time is not
calculated for failed registration cycles.
Registration cycle
The registration cycle process begins with the first UL message (corresponding to GSM, GPRS, LTE, or a
combination of GSM and GPRS, or LTE and GSM) from the roamers’ mobile device and ends when there is a
successful UL transaction. A delayed UL transaction might time out as well.
For example, consider an outbound roamer attempting to register with the following networks and status of each
registration attempt.
T A B L E 2 1 : S C EN A R I O F OR R EGI ST R A T I ON C YC L E
1 T1 C1 N1 V1 Reject
2 T2 C1 N1 V1 Reject
3 T3 C1 N1 V1 Reject
4 T4 C1 N1 V1 Reject
5 T5 C1 N2 V2 Reject
6 T6 C1 N2 V2 Reject
7 T7 C1 N2 V2 Reject
8 T8 C1 N2 V2 Reject
9 T9 C1 N3 V3 Success
In the scenario displayed in the table, the registration cycle is completed at the ninth registration attempt,
because the registration is successful at the ninth attempt and the latency for this registration is the difference
between T9 and T1.
A registration attempt is considered failed if there are no further UL messages until timeout.
Table 22 on page 80 lists the scenarios of registration success and failures in different technologies.
GSM attach on the following instances: Successful registration with domain GSM
n first UL only
n failed in multiple instances in one network but finally
successful in another network
GSM attach failed followed by a series of failures and no Failed registration on domain GSM only
followon GSM UL from the same or another network for a (handset stuck)
timeout
GPRS attach on the following instances: Successful registration with domain GPRS
n first UL only
n failed in multiple instances in one network but finally
successful in another network
GSM attach on first UL immediately followed by successful Successful registration with domain
GPRS attach GSM+GPRS
LTE ULR followed by CLR , and a series of ULR–CLR Successful registration with domain LTE only
messages followed by successful ULR on some network and no
followon CLR
LTE attach on preferred network successful followed by GSM Successful registration with domain
attach on same network LTE+GSM
The RCEM application creates MAP-related log files by using the GPRS and GSM UL transaction and
DIAMETER-related log files by using the ULR and CLR messages.
Note
The RCEM application does not identify and view registration cycles for inbound roamers because
the application does not have the visibility over transactions that occur with other networks.
n Network congestion.
n Delay in processing of registration-related messages by home network.
n Deployment of SoR solution, for example NTR application, in a home network.
n Handset-network frequency incompatibility issues. For example, handset that a roamer carries does not
support the frequency that the network offers.
n Manual mode in which the handset is set for network selection. For example, if you have set the handset
to manual network selection, then the handset would not automatically search for networks when the
handset fails to register with a given network.
What is SoR
Steering of Roaming (SoR) is a solution that influences the choice of networks for roamers when roaming
Following are some of the reasons why a telecom operator performs SoR:
n Saves cost for roamers by redirecting roamers to roaming networks that offer lower tariffs for voice and
data services.
n Saves cost for home operators by redirecting roamers to networks that offer competitive tariffs in roaming
agreements.
n Redirects roamers to networks that offer good quality of network coverage and improve QoS to roamers.
n Improves roaming experience.
n Consider an operator, operator a, whose subscribers roam in the US. Operator a intends to deploy an
SoR solution in its network.
n Operator a has roaming agreements with a few operators in the US, for example operator b and operator
c.
n Based on the roaming agreements with both operators b and c, operator a has to pay more Inter-
operator tariff (IOT) to operator b for the services that operator a's roamers use when roaming in network
b compared to IOT that operator a has to pay to operator c for services that operator a's roamers use
when roaming in network c.
n Consequently, operator a prefers operator c over operator b for the services that operator a's roamers
must use when they roam in the US.
n Therefore, operator a deploys SoR in its network and ensures that its roamers use services of operator c
when they roam in the US.
n As a result, operator a saves additional cost that the operator would have incurred if its roamers had
used services of network b.
Registration time expired Subsequent transactions are not received despite the failure of previous
transactions.
Technology changed The currently registered technology is LTE+GSM or LTE only while the next
transaction is a GPRS UL message.
The currently registered technology is GSM+GPRS or GPRS only while the next
transaction is a ULR message.
Country changed The next transaction received from a different country.
Maximum UL messages Threshold for maximum number of UL messages in transaction is breached.
attempted
As described in the aforementioned table, regardless of whether the current transaction fails, both current and
next transaction for a registration cycle is logged.
Note
The RCEM application measures the threshold (maximum count of UL messages in a transaction)
by using the max.ul.attempts parameter (default value: 160).
The Registration Handler class stores the events for a configurable duration. You can modify the
duration by using the reg.cycle.interval parameter (default value: 2 (in minutes)) of the
fsmapp.properties under the [RIS] section
T A B L E 2 3 : E VEN T SEQU EN C E A N D T R A C E
n Registration Count: Number of successful registrations observed by roamers’ mobile devices during
the specified period.
T A B L E 2 4 : F I L T ER S F OR GEN ER A T I N G T H E R EGI ST R A T I ON L A T EN C Y D A SH B OA R D
n GPRS
n LTE
n GSM_GPRS
n LTE_GPRS
F I GU R E 2 2 : R EGI ST R A T I ON L A T EN C Y D A SH B OA R D
Table 25 on page 85 lists and describes the widgets available in the registration latency dashboard.
Widget Description
Registration Displays the distribution of number of successful registrations grouped into different registration
latency time buckets for the selected duration.
Buckets Following time buckets are displayed in the widget:
n < 1 second
Widget Description
n2 to 30 seconds
n31-60 seconds
n 1 to 2 minutes
n > 2 minutes
Registration Displays country-wise distribution of number of successful registrations for the selected duration.
by Region In this view, when you click a particular country, the widget drills-down to display network-wise
distribution of registration count. It displays the information for all networks present in the
selected country. Also, the dashboard applies the selected country filter to the other widgets to
display information for the selected country.
You can further drill down to the node level distribution by clicking a network in this widget. Here,
the widget displays the information for all nodes present in the selected country and network
combination. Also, the dashboard applies the selected network filter to the other widgets to
display information for the selected country and network combination.
Registration Displays technology-wise (GSM, GPRS, LTE, GSM_GPRS, and LTE_GSM) distribution of
by number of successful registrations.
Technology
Registration Displays the trend (every hour, month, day, 15 minutes) of number of successful registrations.
Trend
Registration Displays CoS-wise distribution of number of successful registrations for the selected duration.
by CoS
Registration Displays the distribution of the number of successful registrations with respect to any steering
by Steering application that was involved in the registrations.
Attempted Following scenarios are available:
n Without Steering: “Number of registrations without any steering attempts during
registrations.”
n With Steering: “Number of registrations involving any steering attempts during
registrations.”
Registration Displays the daily list of successful registrations that have occurred in the preceding 15 days and
(last 15 the average registration latency corresponding to the country, technology, CoS, and time bucket
days) combination.
The table displays the following information:
Columns in
Description
the widget
Date The date on which the registrations occurred.
Country Name of the country where the registrations occurred.
Technology Type of technology in which the registrations occurred.
CoS Name of the CoS to which the subscribers belong, for whom the registrations
occurred.
Bucket The registration time bucket into which the registrations are grouped.
Registration Number of successful registrations for the corresponding date, country,
Count technology, CoS, and time bucket combination.
Average Average registration latency of all successful registrations that have occurred
Registration corresponding to the date, country, technology, CoS, and time bucket
Latency combination.
n Total registration attempts: Number of registration attempts by roamers’ mobile devices during the
specified period.
n Failed registrations: Number of registration attempts that failed to register with a partner network during
the specified period.
n Failure rate (%): Relationship between the total number of registration attempts and the number of
failed registrations that have occurred during the specified period.
The registration failure rate for a particular dimension is computed as follows:
[Number of failed registrations / Total registration attempts] * 100
n GPRS
n LTE
n GSM_GPRS
n LTE_GPRS
dashboard.
From the drop-down list, select the required reject codes.
For a list of supported reject codes, refer to the following topics:
n "Supported MAP error messages" on page 35
F I GU R E 2 3 : R EGI ST R A T I ON PER F OR M A N C E D A SH B OA R D
Table 27 on page 89 lists and describes the widgets available in the Registration performance dashboard.
Widget Description
Registration Displays country–wise distribution of number of failed registrations for the selected duration.
Failure By
Region
Registration Displays the trend in registration failures for the selected duration.
Widget Description
Failure Trend
Registration Displays technology–wise (GSM, GPRS, LTE, GSM+GPRS, and LTE+GSM) distribution of
Failure By number of failed registrations.
Technology
Registration Displays CoS–wise distribution of number of failed registrations for the selected duration.
Failure By CoS
REGISTRATION Displays the reasons for which the registration has failed.
FAILURE ---
REASONS Important: In this widget, the RCEM application displays a short text that depicts the reason
for which a registration attempt has failed. This short text is not the standard reject code.
---
Note: The complete reasons' list includes numerous short texts. However, the
RCEM application displays only the top ten reasons in this widget. The following table
displays short texts and the associated descriptions for a few reasons.
REASONS Description
GRQ dashboard
The GRQ dashboard displays adherence of a roaming partner to agreed-on roaming SLAs (configured) against
pre-defined KPIs. The dashboard presents a view on how the roaming partner is performing and its compliance
to the GRQ SLAs. The dashboard provides information about the number of times the KPIs have been breached
by each of the partner networks. It also provides the trend of the frequently breached KPIs and also displays the
alerts that were raised when the thresholds for the GRQ SLAs was breached. The dashboard displays all this
information with respect to the service type you select: voice, SMS, data, or registration.
TA B L E 2 8 : K P IS IN THE GR Q D A SH B OA R D
KPI Description
PDP Context Cut- Percentage of the probability that the PDP context is deactivated unintentionally by the
off (%) roamers.
[Number of PDP context deactivations not initiated by the user] / [Total number
of successfully activated PDP Contexts] x 100
---
Note: If the error indication received is followed by Destination Point Code (DPC), that
context is considered as not terminated intentionally by user.
---
PDP Context Delay Time between successful MAP PDP Context Activation Request and Response
(ms) messages.
PDP GoodPut (%) Ratio between the volume of useful data by the specified duration.
It is the average number of bytes exchanged per second, corrected by filtering
retransmitted packets for GTP sessions based on GTP-U traffic, that is, PDP Throughput –
PDP Packet Loss Count.
PDP Throughput Average packet volume (in bytes per second) exchanged in all GTP sessions based on
(%) GTP-U traffic.
Here, the duration considered is the time period in which data usage was actually
observed, that is, RCEM filters out the silent period—where no data usage is observed.
PDP Packet Loss Number of bytes lost during data transmission in GTP sessions based on TCP
Count (bytes per retransmission mechanisms. This KPI is also calculated based on GTP-U data traffic.
second)
PDP Average time taken to retransmit the lost data packets.
Retransmission
time (ms)
PDP Session Time between the Delete PDP Request and the Create PDP Response messages.
Duration (seconds)
PDP Session Ratio between successful MAP PDP Context activations and attempts.
Success Rate (%)
PDP LTE Average time taken to retransmit the lost LTE data packets.
Retransmission
time (ms)
PDP LTE Average packet volume (in bytes per second) exchanged in all LTE sessions.
Throughput (%) Here, the duration considered is the time period in which data usage was actually
observed, that is, RCEM filters out the silent period—where no data usage is observed.
KPI Description
PDP LTE Goodput Ratio between the volume of useful data by the specified duration.
(%) It is the average number of bytes exchanged per second, corrected by filtering
retransmitted packets for LTE sessions, that is, PDP LTE Throughput – PDP LTE Packet
Loss Count.
PDP LTE Packet Number of bytes lost during data transmission in LTE sessions based on Diameter
Loss Count (bytes retransmission mechanisms.
per second)
GPRS UL Delay Time (in milliseconds) between the GPRS UL request message and the GPRS UL ACK
(ms) message.
This is applicable only for successful transactions.
GPRS UL Success Ratio between successful GPRS UL attempts and the total number of GPRS UL attempts.
Rate (%) [Number of successful GPRS UL attempts] / [Total number of GPRS UL attempts] x
100
GSM UL Delay (ms) Time (in milliseconds) between the MAP UL request message and the MAP UL ACK
message.
This is applicable only for successful transactions.
GSM UL Success Ratio between successful GSM UL attempts and the total number of GSM UL attempts.
Rate (%) [Number of successful GSM UL attempts] / [Total number of GSM UL attempts] x 100
Average Length of Average Length of Call Mobile Originated. The time between reception of call answer
Call MO (seconds) ISUP ANM and call release (ISUP REL) for MO calls.
Average Length of Average Length of Call Mobile Terminated. The time between reception of call answer
Call MT (seconds) ISUP ANM and call release (ISUP REL) for MT calls.
Call completion Ratio between successful calls and successfully established calls that are intentionally
ratio MO (%) released by the subscriber for MO calls.
Call completion Ratio between successful calls and successfully established calls that are intentionally
ratio MT (%) released by the subscriber for MT calls.
Call setup success Ratio between successful calls (reception of ISUP ANM message) and attempts (ISUP
rate MO (%) IAM message) for MO calls.
Call setup success Ratio between successful calls (reception of ISUP ANM message) and attempts (ISUP
rate MT (%) IAM message) for MT calls.
Network Ratio between successful calls (reception of ISUP ACM message) and attempts (ISUP
Effectiveness Ratio IAM message) for MO calls.
MO (%)
Network Ratio between successful calls (reception of ISUP ACM message) and attempts (ISUP
Effectiveness Ratio IAM message) for MT calls.
MT (%)
Post Dial Delay MO Time between sending of complete address information and receipt of call set-up
(ms) notification for MO calls.
Difference of time between the IAM and ACM messages for MO calls.
Post Dial Delay MT Time between sending of complete address information and receipt of call set-up
(ms) notification for MT calls.
Difference of time between the IAM and ACM messages for MT calls.
MO SMS DELAY Average latency for the MO SMS transactions. Latency is calculated as the time between
(ms) SMS SUBMIT and ACK messages.
MO SMS SA (%) Service Accessibility for Mobile Originated SMS. The SA SMS MO is the ratio between
successful SMS-SUBMIT and attempts.
MT SMS DELAY Average latency for Mobile Terminated SMS transactions. Latency is calculated as the
(ms) time duration between successful SMS DELIVER and ACK messages.
MT SMS SA (%) Service Accessibility for Mobile Terminated SMS. The SA SMS MT is the ratio between
the number of successful SMS messages delivered and the number of SMS message
delivery attempts.
SMS End to End Average latency between the MAP-FWD-SM (SMS-Submit) operation and the MAP-
KPI Description
T A B L E 2 9 : F I L T ER S F OR GEN ER A T I N G T H E GR Q D A SH B OA R D
n Data
n Voice
n SMS
F I GU R E 2 4 : GR Q D A SH B OA R D
Table 30 on page 95 lists and describes the widgets available in the GRQ dashboard.
T A B L E 3 0 : W I D GET S IN THE GR Q D A SH B OA R D
Widget Description
Geographical Displays the distribution of GRQ KPI breaches (in percentage value) at the country level.
Distribution of
You can click any country to generate the Networkwise KPI performance dashboard. For
Breaches more information, refer to "Networkwise KPI Performance" on page 96.
Networkwise Displays the top 10 networks with maximum threshold breaches of KPIs for the selected
Breaches service type during the specified period.
Frequently Displays distribution of the KPIs that are frequently breached, specific to the specified service
Breached KPIs type and duration.
Widget Description
Recent Alerts Displays a list of the top 10 alerts that were raised whenever a KPI threshold was breached. It
also displays the actual KPI value when the KPI was breached. The dashboard displays this
information for the specified service type and duration.
Other dashboards generated from the Geographical Distribution of Breaches widget.
Networkwise This dashboard is generated in a new tab when you click a country in the world map of the
KPI Geographical Distribution of Breaches widget.
Performance This dashboard displays information in the following widgets:
n Networkwise KPI Performance: “Displays average values of the KPIs for all networks
in the selected duration.”
n Networkwise KPI Alarms: “Displays the count of breaches for each of the KPIs in the
selected duration.”
You can click any KPI corresponding to a network to generate the KPI trend dashboard. For
more information, refer to "KPI Trend" on page 96.
KPI Trend This dashboard is generated in a new tab when you click a KPI corresponding to a network in
the Networkwise KPI performance dashboard.
Displays the trend in the actual KPI value of a particular network for the specified duration. It
also displays the threshold value for the KPI as a reference in the graph.
n Nature of issue: Dashboard displays distribution of failures across KPI groups (registration, call, SMS,
and data) for different types of technologies where the issues have occurred.
n CoS
1. Configure the VIP subscribers in the CoS Configuration page of the RCEM GUI.
For information about configuring VIP subscribers, refer to "Managing classes of subscribers" on page
24.
2. Define thresholds for various failure and latency KPIs for each of the CoSes in the CoS Threshold
Configuration section of the RCEM GUI.
You can also define the interval for which these KPIs must be monitored.
For information about configuring CoS thresholds, refer to "Configuring CoS thresholds" on page 166.
n Total failures: Number of failures that have occurred with respect to the services offered to a specific
group of customers during the specified period.
T A B L E 3 1 : F I L T ER S F OR GEN ER A T I N G T H E V IP PER F OR M A N C E D A SH B OA R D
n Data
n Call
n SMS
F I GU R E 2 5 : V IP PER F OR M A N C E D A SH B OA R D
Table 32 on page 98 lists and describes the widgets available in the VIP performance dashboard.
Widget Description
Incidents by CoS Displays CoS-wise distribution (in percentage value) of the issues faced in the selected
duration.
Incidents by Displays the list of incidents that have occurred in the selected duration with the
Subscriber following information:
Columns in the
Description
widget
IMSI IMSI of the subscriber who faced the issue recorded in the alert.
MSISDN MSISDN of the subscriber who faced the issue recorded in the
alert.
Widget Description
Columns in the
Description
widget
Class of Subscriber Name of the CoS to which the subscriber belongs.
Incidents Number of incidents that the subscriber has faced.
n Middle circle: Displays the following service types to which the issues belong:
n Registration
n Call
n SMS
n Data
n Outer circle: Displays the following issue types that have occurred:
n Call: 3G Voice
n SMS: 3G Failed
n Destination
n CoS
n Average call duration: Average time between the call answer message (ANM) and the call release
message (REL) in the answered calls.
n Successful call count: Number of calls that were answered.
T A B L E 3 3 : F I L T ER S F OR GEN ER A T I N G T H E V OI C E U SA GE D A SH B OA R D
n Unknown
n NA
F I GU R E 2 6 : V OI C E U SA GE D A SH B OA R D
Table 34 on page 101 lists and describes the widgets available in the Voice usage dashboard.
T A B L E 3 4 : W I D GET S IN THE V OI C E U SA GE D A SH B OA R D
Widget Description
Usage Displays country-wise (and drill-down to network-wise) distribution of the number of successful
distribution calls and the average duration of successful calls in the selected duration.
Usage Displays the trend (monthly, daily, and hourly) of the number of successful calls and the average
trend duration of successful calls in the selected duration.
Usage by Displays the destination-wise distribution (in percentage value) of the average duration of
Destination successful voice calls.
The widget displays information for the following destinations:
n National: “Average duration of successful national calls made by subscribers.”
n Short Code: “Average duration of successful short code calls made by subscribers.”
n Back To Home: “Average duration of calls made to subscribers in their home network.”
n NA
Usage by Displays the CoS-wise distribution (in percentage value) of the average duration of successful
CoS voice calls.
n Region
n RAT type
n CoS
n Average session duration (in min): Average time between the Delete PDP Request and the Create
PDP Response messages.
n Average session usage (in MB): Average amount of data (in MB) used by subscribers (as observed in
the GTP-C and –U messages) in all successfully established packet data sessions.
T A B L E 3 5 : F I L T ER S F OR GEN ER A T I N G T H E DATA U SA GE D A SH B OA R D
n UTRAN
n EUTRAN
n GERAN
n HSPA Evolution
n WLAN
n Reserved
n Virtual
F I GU R E 2 7 : D A T A U SA GE D A SH B OA R D
Table 36 on page 103 lists and describes the widgets available in the Data usage dashboard.
Widget Description
Session Usage Displays the trend (monthly, daily, and hourly) of total and average data usage of
Trend successfully established data sessions in the selected duration.
Session Usage Displays country-wise (and drill-down to network-wise) distribution of total and average data
Distribution usage of successfully established data sessions in the selected duration.
Session Displays the trend (monthly, daily, and hourly) of total and average session duration of
Duration Trend successfully established data sessions in the selected duration.
Session Displays country-wise (and drill-down to network-wise) distribution of total and average
Duration session duration of successfully established data sessions in the selected duration.
Distribution
Session Usage Displays the RAT-wise distribution (in percentage value) of total and average data usage of
Widget Description
n Region
n SMS type
n CoS
n SMS count: Total number of SMS messages sent by roamers in the selected duration.
T A B L E 3 7 : F I L T ER S F OR GEN ER A T I N G T H E SMS U SA GE D A SH B OA R D
F I GU R E 2 8 : S M S U SA GE D A SH B OA R D
Table 38 on page 106 lists and describes the widgets available in the SMS usage dashboard.
Widget Description
SMS Usage Displays country-wise (and drill-down to network-wise) distribution of the number of SMS
Duration messages sent in the selected duration.
SMS Usage Displays the trend (every hour, month, day, 15 minutes) of the number of SMS messages
Trend sent in the selected duration.
SMS Usage by Displays the CoS-wise distribution (in percentage value) of the number of SMS messages
CoS sent.
SMS Usage by Displays the SMS type-wise distribution (in percentage value) of the number of SMS
SMS Type messages sent.
The number of unique roamers is calculated based on the registrations across voice and data services. If a
roamer registers for the first time in a network for either the voice or data service, then that roamer is counted as
a unique roamer for that network for that day.
Unique roamer count is individually maintained for daily and monthly statistics. Here, one subscriber might stay
in the network for more than a day and therefore, will be counted for each day for daily count of unique roamers.
While for monthly, the same roamer will be counted only once for that network. Therefore, the sum of the daily
count of unique roamers for a particular month will not be equal to the monthly count of unique roamers for that
month.
The dashboard provides the details of unique roamers across the following dimensions:
n Voice: Number of roamers who have successfully registered for voice services in a partner network
n Data: Number of roamers who have registered for only GPRS or LTE data services in a partner network
n Voice and data: Number of roamers who have registered for both voice and GPRS or LTE data services
n Host name
n Class of Subscriber
n Start date and end date
n Last x days, weeks, months, quarters, or years
n Periodicity of data to be displayed
For descriptions of the these filters, refer to Table 4 on page 29.
F I GU R E 2 9 : U N I QU E R OA M ER S D A SH B OA R D
Table 39 on page 108 lists and describes the widgets available in the Unique roamers dashboard.
T A B L E 3 9 : W I D GET S IN THE U N I QU E R OA M ER S D A SH B OA R D
Widget Description
Roamer Displays the country-wise distribution of the number of unique roamers in a world map.
Distribution The world map is color-coded based on the number of unique roamers who have successfully
registered during the specified duration.
Clicking a country in this widget applies the country in the other widgets in this dashboard to
display data for the selected country.
Region Displays network-wise distribution of the number of unique roamers.
Distribution
Roamer Displays the message-wise trend of total Diameter transactions and the transaction failure rate.
Trend The widget displays the message types with the maximum failure rate.
For a list of Diameter messages that the RCEM application considers for generating the
dashboard, refer to "Supported Diameter messages and message groups" on page 46.
Whenever a roamer visits a country other than the home country and registers with a partner network, a roaming
trip is started. The roamer might stay in the same network or move and register with other partner networks
(within the same country). For as long as the roamer stays within the same country, all data will be considered
under a single trip (the current trip), which will remain open.
However, if the roamer moves to a partner network in another country, it is considered as a new trip, and
subsequently, the trip in the previous country is considered closed.
n Global-level trip: A trip that a roamer undertakes, starting from the home country and travels to multiple
countries before returning to the home country.
n Country-level trip: A trip that a roamer undertakes starting from one partner network in a country and
travels to multiple networks within the same country.
n Network-level trip: A trip that a roamer undertakes within one partner network.
TA B L E 4 0 : K P IS IN THE R OA M ER T R I P D A SH B OA R D
KPI Description
Trip start time Date and time (in the DD MMM, YYYY HH:MM:SS 24-hour format) when the roamer started the
trip in a partner network.
It is the time when the first UL message is initiated in a network.
Trip end time Date and time (in the DD MMM, YYYY HH:MM:SS 24-hour format) when the roamer ended the
trip in a partner network.
It is the time when a CL message is initiated for a network.
Time Spent (days) Duration (in days) that the roamer spent in a partner network during the trip.
First Country Name of the country where the roamer started the trip.
This is based on the first UL message initiated in a network when the subscriber started
roaming.
Exit Country Country from where the roamer exited before entering the current country.
This is based on the CL message initiated for a network of one country and a subsequent
UL message in a network of another country.
Call Attempts Total number of calls attempted (including successful and failed attempts) by the roamer
in the specified region and time.
Successful Number of call attempts that resulted in an answer signal.
Dropped Number of calls that were dropped, that is, calls that were terminated due to network
issues.
MOU Average usage (in minutes) of voice calls.
KPI Description
SMS Sent Number of SMS messages that the roamer sends during a trip.
Data Session Number of packet data sessions that have occurred during the trip.
Attempts
Failures Number of packet data sessions that have failed to establish during the trip.
Duration (min) Average duration (in minutes) for which the data sessions are active during the trip.
This time is computed as the difference in time between the Delete PDP Request and the
Create PDP Response messages.
Usage (MB) Average amount of data (in MB) used by subscribers in all successfully established
packet data sessions during the trip.
3G Throughput Average packet volume (in Megabits per second) exchanged in all GTP sessions during
(Mbps) the trip.
4G Throughput Average packet volume (in Megabits per second) exchanged in all LTE sessions during
(Mbps) the trip.
Time taken for first Duration (in minutes) the roamer took to initiate the first call after the trip started.
call (min)
Time taken for first Duration (in minutes) the roamer took to initiate the first SMS message after the trip
SMS (min) started.
Time taken for first Duration (in minutes) the roamer took to initiate the first packet data session after the trip
data (min) started.
F I GU R E 3 0 : R OA M ER T R I P D A SH B OA R D
Table 41 on page 111 lists and describes the widgets available in the Roamer trip dashboard.
T A B L E 4 1 : W I D GET S IN THE R OA M ER T R I P D A SH B OA R D
Widget Description
Widget Description
Stay Displays the duration (in hours) a roamer has stayed in all the networks that the roamer registers
Duration during the trip.
(hrs) If you click a particular country in the Countries Visited widget, this widget displays details about
the networks within that country.
Usage Displays network-wise average usage and quality details of the services used by the roamer in a
and particular trip. For a detailed description of the columns in this widget, refer to Table 40 on page
Quality 109.
Roaming Displays details of all the previous trips undertaken by the roamer. It displays the daily average
History usage and quality details of the services used by the roamer during all the previous trips. For a
detailed description of the columns in this widget, refer to Table 40 on page 109.
TA B L E 4 2 : K P IS IN THE I N T ER C ON N EC T S M S D A SH B OA R D
KPI Description
SMS count Number of SMS messages sent by the subscribers in the selected duration.
SRI-SM or MT-FSM count Number of SRI-SM and MT-FSM messages observed in the selected duration.
Successful SMS Number of the SMS messages that were successfully delivered to the
messages subscribers.
Failed SMS messages Number of the SMS messages that were not delivered to the subscribers.
T A B L E 4 3 : F I L T ER S F OR GEN ER A T I N G T H E I N T ER C ON N EC T S M S D A SH B OA R D
F I GU R E 3 1 : I N T ER C ON N EC T S M S D A SH B OA R D
Table 44 on page 114 lists and describes the widgets available in the Interconnect SMS dashboard.
T A B L E 4 4 : W I D GET S IN THE I N T ER C ON N EC T S M S D A SH B OA R D
Widget Description
SMS Trend Displays the trend in the SMS message transactions for the selected subscriber
types in the selected duration.
SMS Distribution by Displays the region-wise distribution of SMS message transactions for the selected
Region subscriber types in the selected duration.
SRI-SM/MT-FSM Displays the region-wise distribution of the count of SRI-SM and MT-FSM messages
Widget Description
TA B L E 4 5 : K P IS IN THE A D VA N C ED PA C K ET D A T A D A SH B OA R D
KPI Description
Average Average packet volume (in megabits per second) exchanged in all GTP and LTE data
Throughput sessions based on GTP-U traffic.
(Mbps) Here, the duration considered is the time period in which data usage was actually
observed, that is, RCEM filters out the silent period—where no data usage is observed.
Average Session Average data (in MB) used by roamers in successfully established packet data sessions.
Usage (MB)
Average Session Average time (in minutes) between the Delete PDP Request and the Create PDP Response
Duration (min) messages for successfully established packet data sessions.
Session Count Number of packet data sessions observed in each of the corresponding predefined buckets
displayed in the widgets.
T A B L E 4 6 : F I L T ER S F OR GEN ER A T I N G T H E A D VA N C ED PA C K ET D A T A D A SH B OA R D
n UTRAN
n EUTRAN
n GERAN
n HSPA Evolution
n WLAN
n Reserved
n Virtual
F I GU R E 3 2 : A D VA N C ED PA C K ET D A T A D A SH B OA R D
Table 47 on page 117 lists and describes the widgets available in the Advanced packet data dashboard.
T A B L E 4 7 : W I D GET S IN THE A D VA N C ED PA C K ET D A T A D A SH B OA R D
Widget Description
n 2–30 Mbps
n 31–60 Mbps
n 61–120 Mbps
Widget Description
n >121 Mbps
Session Usage Distribution of the number of sessions grouped by average data usage buckets. The data is
by Bucket grouped and displayed in the following data usage buckets:
n 0–1 MB
n 2–30 MB
n 31–60 MB
n 61–120 MB
n >121 MB
Session Distribution of the number of sessions grouped by average session duration buckets. The
Duration by data is grouped and displayed in the following session duration buckets:
Bucket n 0–1 mins
n 2–30 mins
n 31–60 mins
n 61–120 mins
n >121 mins
DPI dashboard
The DPI dashboard provides detailed URL- and protocol-wise information about the following data:
TA B L E 4 8 : K P IS IN THE DPI D A SH B OA R D
KPI Description
Average Average packet volume (in megabits per second) exchanged in all GTP and LTE data
Throughput sessions based on GTP-U traffic.
(Mbps) Here, the duration considered is the time period in which data usage was actually observed,
that is, RCEM filters out the silent period—where no data usage is observed.
Total Session Total data (in MB) used by roamers in successfully established packet data sessions. This
Usage (MB) information is displayed, grouped by the following criteria:
n URLs accessed
KPI Description
T A B L E 4 9 : F I L T ER S F OR GEN ER A T I N G T H E DPI D A SH B OA R D
n Secure HTTP
n ICMP
n IP
n NTP
n SSL
n Unknown
From the drop-down list, select the name of the required protocol.
URL No The specific URL for which you want to generate the dashboard.
From the drop-down list, select the name of the required URL.
F I GU R E 3 3 : D P I D A SH B OA R D
Table 50 on page 120 lists and describes the widgets available in the DPI dashboard.
Widget Description
Usage by URL URL-wise distribution of average data usage (in MB) observed in all data
sessions during the selected period.
Throughput by URL URL-wise distribution of average throughput (in Mbps) observed in all data
sessions during the selected period.
Usage by Protocol Protocol-wise distribution of average data usage (in MB) observed in all data
sessions and URLs accessed during the selected period.
Throughput by Protocol Protocol-wise distribution of average throughput (in Mbps) observed in all data
sessions and URLs accessed during the selected period.
n RAT-wise information about the amount of data used and average throughput in the sessions
n Region-wise distribution of amount of data used and the trend of average throughput for all URLs
accessed
KPI Description
Average Average packet volume (in megabits per second) exchanged in all GTP and LTE data
Throughput sessions based on GTP-U traffic.
(Mbps) Here, the duration considered is the time period in which data usage was actually observed,
that is, RCEM filters out the silent period—where no data usage is observed.
Total Session Total data (in MB) used by roamers in successfully established packet data sessions. This
Usage (MB) information is displayed, grouped by the following criteria:
n URLs accessed
F I GU R E 3 4 : D P I B Y T EC H N OL OGY D A SH B OA R D
Table 53 on page 122 lists and describes the widgets available in the DPI dashboard.
Widget Description
RAT-Wise Usage RAT-wise distribution (in percentage) of total data usage observed in all data
sessions during the selected period.
RAT-Wise Throughput RAT-wise trend of average throughput (in Mbps) observed in all data sessions
during the selected period.
Usage Distribution Region-wise (country and corresponding drill-down to networks) distribution of total
data usage (in MB) observed in all data sessions and average throughput (in Mbps)
during the selected period.
Usage Trend Trend in the total data usage (in MB) and average throughput (in Mbps) observed in
all data sessions during the selected period.
displays error messages that have occurred in the transactions. The dashboard helps an operator to assess the
traffic on the signaling SS7 links and displays the trend in data to help configure the network accordingly.
TA B L E 5 4 : K P IS IN THE SCCP C A R R I ER D A SH B OA R D
KPI Description
Total Incoming MSU Number of MSUs received by the partner networks in the selected period.
Total Outgoing MSU Number of MSUs sent to the partner networks in the selected period.
Average Transaction Latency The average latency (in milliseconds) of the MAP messages that are
(ms) exchanged.
T A B L E 5 5 : F I L T ER S F OR GEN ER A T I N G T H E SCCP C A R R I ER D A SH B OA R D
n Subsystem Congestion
n Subsystem Failure
n Unequipped User
n MTP Failure
n Network Congestion
n Unqualified
n Segmentation Failure
n Unauthorized message
n Message Incompatibility
n Undefined
From the drop-down list, select the required SCCP error codes.
F I GU R E 3 5 : S C C P C A R R I ER D A SH B OA R D
Table 56 on page 125 lists and describes the widgets available in the SCCP carrier dashboard.
Widget Description
Transactions by Carrier Carrier-wise percentage share of the transactions that have occurred.
MSU Distribution Partner network-wise distribution of incoming and outgoing MSUs that are
exchanged with the host network.
UDTS Errors Percentage distribution of the UDTS errors that are observed in the MAP
transactions.
Average Transaction MAP message-wise distribution of the average latency that is observed.
Latency(ms)
MSU Trend Displays the trend in MSU transactions that have occurred between the host
network and all partner networks.
KPI Description
Session Usage (MB) Average data (in MB) used by roamers in data sessions of different technologies.
Session Duration (min) Average time (in minutes) spent by roamers in data sessions of different
technologies.
Session Count Number of packet data sessions in the following scenarios:
n Sessions in the same technology and no handover has occurred.
Table 59 on page 127 lists and describes the widgets available in the Session handover analysis dashboard.
Widget Description
Session Count by Technology-wise (2G only, 3G only, 4G only, and 3G to 4G) percentage share
Handover distribution of the data sessions that are observed during the selected period.
Session Count Region-wise (country and corresponding drill-down to networks) distribution of number
Distribution of data observed during the selected period.
Session Duration Technology-wise percentage share distribution of data sessions observed during the
(min) by Technology selected period.
Session Usage (MB) Technology-wise percentage share distribution of average data usage (in MB)
by Technology observed in data sessions during the selected period.
registrations in both technologies (3G and 4G) occur for the same roamer, those registrations are included in
the 4G registrations count.
TA B L E 6 0 : K P IS IN THE F I R ST T I M E R EGI ST R A T I ON D A SH B OA R D
KPI Description
T A B L E 6 1 : F I L T ER S F OR GEN ER A T I N G T H E F I R ST T I M E R EGI ST R A T I ON D A SH B OA R D
F I GU R E 3 7 : F I R ST T I M E R EGI ST R A T I ON D A SH B OA R D
Table 62 on page 129 lists and describes the widgets available in the First time registration dashboard.
Widget Description
Registration Displays the trend in the first-time 3G and 4G registrations that have occurred during the
Count 3G/4G selected period.
Trend
Registration Region-wise (country and corresponding drill-down to networks) distribution of first-time
Count Distribution 3G and 4G registrations that have occurred during the selected period.
NQS dashboard
The Network Quality Score (NQS) dashboard provides a unique insight into the performance of a network by
monitoring key KPIs for each of the outbound roamers. The RCEM application monitors the KPIs across different
services for each of the roamers, to understand the experience of that roamer. This individual roamers’ data is
aggregated to analyze the performance of a network by computing the network quality score for that network.
The subscribers are grouped in to different NQS buckets and the NQS dashboard helps the operator to identify
the least performing networks.
TA B L E 6 3 : K P IS F OR N QS
Thresholds are configured for each of the aforementioned KPIs, and the same are monitored for any breaches
for each of the services configured. Based on the performance of the KPIs in the respective event (voice, SMS,
registration, and data session), a score is computed for the service.
If all the KPIs in a service event are breached, then the score for the service is computed as 0. However, if no
KPIs are beached, the score is computed as 1.
n Voice call event 1: Consider a voice call that is successfully established, the call setup time is within the
threshold, and the call is successfully released by the roamer. In this case, three KPIs were encountered
and no KPI was breached. Therefore, the NQS for this voice call event is computed as 1.
n Voice call event 2: Consider a voice call event that was not established. In this case, only one KPI was
encountered and it was breached. Therefore, the NQS for this voice call event would be 0.
n Data session event: Consider a data session that was successfully established and released by the
roamer. However, the data throughput was found to be less than the threshold and hence, one KPI was
breached out of three that were encountered in the event. Therefore, the NQS for this data session event
would be computed as 2/3 (=0.6).
All the scores that are computed for different services are aggregated to obtain the overall score (or experience)
of a roamer. Based on this overall score, roamers are categorized into the following buckets of NQS scores:
n 0.0-0.2
n 0.2-0.4
n 0.4-0.6
n 0.6-0.8
n 0.8-1.0
Note
If you have configured the weight-related parameters to obtain weighted score, the
RCEM application aggregates the overall score (of experience) of a roamer by including the
weighted score, as well. For information about how a weighted score is computed, refer to the
examples in "Weighted network quality score" on page 133.
The categorization of roamers in to the listed scores helps an operator to identify the networks where the
roamers are worst affected. This also helps the operator to identify the service or segment that is worst
affected.
n "Parameters that the RCEM application uses to compute network quality score" on page 132
n "Using an example, demonstrate scenarios that generate network quality score" on page 132
n cpdd_threshold
n nqs.data.lowThroughput.threshold.3G
n nqs.data.lowThroughput.threshold.LTE
n reg.latency.3G
n reg.latency.LTE
Table 64 on page 133 demonstrates how the RCEM application computes the aggregated network quality
score while the parameter values are configured, as shown:
T A B L E 6 4 : N ET W OR K QU A L I T Y SC OR ES
NQS
No Satisfactory (Total
Whether Satisfactory Success
Scenario No latency? Latency throughput applicable
successful? throughput? flag
flag flag flags / Total
flags)
Subscriber Yes No NA 1 0 NA 1/2=0.5
registers with a
network after
350 seconds
3G call Yes Yes NA 1 1 NA 2/2=1
established in (established
25 seconds within
threshold )
3G call not No NA NA 0 NA NA 0/0=0
established.
LTE data Yes Yes No 1 1 0 2/3=0.6
session (data
successfully session
completed. established
However, the within
throughput was threshold)
1 MBps.
The RCEM application aggregates the individual NQS to compute the final NQS.
Therefore, NQS=
0.5+1+0+0.6
---------------- =0.5
4
n "Paramers that the RCEM application uses to compute weighted score" on page 134
n "For weighted score, what logic you must use while configuring parameters' values " on page 134
n "Using various scenarios, demonstrate how RCEM application generates weighted score" on page 135
n wgt_avg_callSuccess
n wgt_avg_callDropped
n wgt_avg_pdd
n cpdd_threshold
n wgt_avg_sessionAttemptSuccess
n wgt_avg_lowThroughput
n wgt_avg_sessionDropped
n nqs.data.lowThroughput.threshold.3G
n nqs.data.lowThroughput.threshold.LTE
n wgt_avg_regStatus
n wgt_avg_regLatency
n reg.latency.3G
n reg.latency. LTE
Note
The default value of all weight-related parameters is 1. You must modify the values based on
requirements, as described in the "For weighted score, what logic you must use while configuring
parameters' values " on page 134 section.
Table 64 on page 133 demonstrates how the RCEM application computes aggregated weighted scores for LTE
registration while the parameter values are configured, as shown:
n wgt_avg_regStatus=80
n wgt_avg_regLatency=20
n reg.latency.LTE=30
T A B L E 6 5 : W EI GH T ED SC OR ES F OR LTE R EGI ST R A T I ON
Weighted score
Weight 1 * Applicable
Whether Latency flag+...Weight n* Applicable
Scenarios Success flag Latency flag
successful? occurrence? flag n)
-----------------------------------------
---------
Weight 1+...Weight n
LTE No Not applicable 0 0 0
registration
attempt failed
after three
seconds
LTE Yes Yes 1 0 1*80+0*20
registration (Registration -------------- = 0.8
attempt occurred after 80+20
successful 35
after 3.5 milliseconds)
seconds
LTE Yes Yes 1 1 1*80+1*20
registration (Registration -------------- = 1
attempt occurred after 80+20
successful 10
after one milliseconds)
second.
0+0.8+1
---------- =0.6
3
Table 64 on page 133 demonstrates how the RCEM application computes aggregated weighted scores for 3G
data session while the parameter values are configured, as shown:
n wgt_avg_sessionAttemptSuccess=60
n wgt_avg_lowThroughput=15
n wgt_avg_sessionDropped=25
T A B L E 6 6 : W EI GH T ED SC OR ES F OR 3G D A T A SESSI ON
Weighted score
Weight
1*Applicable
No
Whether Satisfactory Success Session Satisfactory flag+...Weight
Scenarios session
successful? throughput flag drop flag throughput n*Applicable flag n)
dropped? ----------------------------
----------------------
Weight
1+...weight n
3G No NA NA 0 NA NA 0
registration
attempt
failed after
five
seconds
3G Yes Yes No 1 1 0 60*1+15*0+25*1
registration ----------------------
attempt 60+15+25
successful.
No data
session = 0.85
were
dropped.
However,
the data
speed was
0.8 MBps.
Yes No No 1 0 0 60*1+15*0+25*0
3G ----------------------
registration 60+15+25
attempt
successful. = 0.6
Several
data
session
were
dropped.
Data speed
was 0.8
MBps.
0+0.85+0.6
-------------- =0.48
3
Table 64 on page 133 demonstrates how the RCEM application computes aggregated weighted scores for
voice call while the parameter values are configured, as shown:
n wgt_avg_callSuccess=40
n wgt_avg_callDropped=40
n wgt_avg_pdd=20
T A B L E 6 7 : W EI GH T ED SC OR ES F OR VOI C E C A L L
Weighted score
Weight 1 * Applicable
Post dial flag+...Weight n*
Whether No post Call Success Call
Scenarios delay Applicable flag n)
successful? dial delay? dropped? flag drop flag --------------------------------
flag
------------------
Weight 1 +
...weight n
Voice call not No NA NA 0 NA NA 0
established
Voice call Yes Yes Yes 1 0 0 40*1+40*0+20*0
established. ---------------------- = 0.4
Post dial 40+40+20
delay not
occurred.
Call dropped.
Yes No No 1 1 1 60*1+15*1+25*1
Voice call (occurred ---------------------- = 1
established. for 4000 60+15+25
Post dial milli
delay of seconds)
duration 4000
milliseconds
occurred.
Call not
dropped.
0+0.4+1
---------- =0.46
3
T A B L E 6 8 : F I L T ER S F OR GEN ER A T I N G T H E N QS D A SH B OA R D
F I GU R E 3 8 : N QS D A SH B OA R D
Table 69 on page 139 lists and describes the widgets available in the NQS dashboard.
T A B L E 6 9 : W I D GET S IN THE N QS D A SH B OA R D
Widget Description
Subscribers by Displays the NQS bucket-wise percentage distribution of subscribers for the selected
Buckets criteria.
The following NQS buckets are available:
n 0.0-0.2
Widget Description
n 0.2-0.4
n 0.4-0.6
n 0.6-0.8
n 0.8-1.0
Region Displays region-wise (partner country and network) distribution of subscribers across the
Distribution selected criteria.
Subscribers by Displays the CoS-wise distribution of subscribers across the selected NQS score, service,
CoS and country (or network).
Subscribers by Displays the service-wise distribution of subscribers across the selected NQS score and
Service country (or network).
Trend Displays the trend of subscribers across the selected criteria.
Subscriber Details Displays IMSI-level details of subscribers (in tabular format) for the selected NQS score
and duration.
The subscriber details table displays the following information:
Columns in
Description
the widget
Date Date on which the subscriber accessed the service.
IMSI IMSI of the subscriber.
CoS Name of the CoS to which the IMSI of the subscriber belongs.
Service Type of service accessed by the subscriber.
Bucket ID The bucket ID corresponding to the NQS score that is computed for the
subscriber and the service accessed.
Score The exact NQS score that is computed for the subscriber.
1 RCEM application n Computes quality score for a CoS (that the NTR application has applied
to a roamer during the redirection activity) and displays the score in the
Network R-CX dashboard.
n Note: The RCEM application merges the CoS (received from Transaction
processor) and applied CoS (received from roamerdata ), and then
computes the quality score based on the applied CoS.
If Then
The overall quality score is satisfactory The RCEM application does not take
and the service for a CoS is not any action.
degraded.
The overall quality score is low and the The RCEM application generates an
service for a CoS is degraded. alarm to notify the operator of the NTR
application and the appropriate
actions, as described in subsequent
stages, are taken.
---
Note: The alarm is generated on the
basis of threshold configurations. For
information about threshold
configuration, refer to "How do you
configure alerts and threshold?" on
page 143.
2 Operator n Receives the alarm and views the overall quality score in the Network R-
CX dashboard for the CoS and country for which the alarm was
generated.
n Opens the Zone Management page of the NTR application GUI from the
STEERING BUSINESS SETTINGS MANAGEMENT widget.
n Modifies the business settings.
Note: The logic to modify business settings is based on the quality score
that the operator views in the Network R-CX dashboard for a CoS and
network. For example, for a CoS and network, NetworkA, the quality score
is low, while NetworkA is a preferred network in the business settings.
Therefore, the operator might modify business settings and configure
NetworkA as a non-preferred network.
Note: When the operator modifies the business settings, the alarm is
cleared.
F I GU R E 3 9 : H I GH - L EVEL W OR K F L OW
F I GU R E 4 0 : A L ER T S A N D T H R ESH OL D
For more information about the alert and threshold configuration, refer to "Configuring thresholds and alerts" on
page 170.
KPI definition
n Hourly
n Daily
n Monthly
Threshold details
User-defined A user configures a pre-defined threshold that is compared with a KPI and an
alarms is raised accordingly.
Historical trend Threshold is computed based on trend in one of the following ways:
n Hourly: For example, a job is running at the fifteenth hour of a day.
Therefore, KPI is computed at the fourteenth hour. In addition, the threshold
will be average of the KPI value of fourteenth hour from previous days.
n Daily: For example, a job is running today. Therefore, KPI is computed for
yesterday. In addition, the threshold will be average of the KPI values of all
days that are day before yesterday.
n Monthly: For example, a job is running in the current month, Therefore, the
KPI is computed for the previous month. In addition, the threshold will be
average of the KPI value of all months that are before previous month.
Alarm severity
Consider a scenario where you configure the threshold value as 1 and the severity percentages, as shown:
n "What information does the Network R-CX dashboard display?" on page 145
n "How is the information populated and displayed in each widget?" on page 146
n "How does the RCEM application compute quality score for each event?" on page 147
n "How does the RCEM application compute aggregated quality score that is displayed in each widget?"
on page 147
n "Which widgets does the RCEM application display in the Network R-CX dashboard" on page 148
n "Which filters are available in the Network R-CX dashboard?" on page 151
1 Probe module Collects the input feeds that contain raw statistical details about voice, SMS, and
data usage.
2 TxnWriter, Process and enhance raw data with the required details.
DiaTxnWriter, and
GTPTxnWriter
3 Transaction Generates the necessary trace files and sends the files to HDFS for processing.
processor
4 RCEM application n Fetches several data from the trace files, such as CoS, IMSI, and so on,
from the trace files and sends the data to feature factory.
n Accesses roamerdata log file and fetches the required details that include
IMSI and applied CoS.
Note: The RCEM application maintains the IMSI-applied CoS mapping
details.
The applied CoS denotes the CoS that the NTR application has applied
to a roamer during a redirection activity. The applied CoS keeps changing
based on the NTR application logic.
For information about how the RCEM application computes aggregated quality
score, refer to "How does the RCEM application compute aggregated quality
score that is displayed in each widget?" on page 147.
For example, if you are viewing minute-wise voice score, the RCEM application aggregates all individual call
scores. For example, in a minute, five calls were attempted, and the individual call scores were 0.3, 0.3, 0.6, 0.6,
and 1. Therefore, the aggregated voice score in that minute is 0.3+0.3+0.6+0.6+1/5=0.5.
F I GU R E 4 2 : W I D GET S IN THE N ET W OR K R - C X D A SH B OA R D
As shown in Figure 41 on page 146, the RCEM application displays the following widgets:
DATA R- CX SCO RE
F I GU R E 4 3 : D A TA R - C X S C OR E
In this widget, the RCEM application displays aggregated quality score for data that is used by roamers in the
partner network.
VO I CE R- CX SCO RE
F I GU R E 4 4 : V OIC E R - C X S C OR E
In this widget, the RCEM application displays aggregated quality score for voice that is used by roamers in the
partner network.
SM S R- CX SCO RE
F I GU R E 4 5 : S M S R - C X S C OR E
In this widget, the RCEM application displays aggregated quality score for SMS messages (sent and received)
that is used by roamers in the partner network.
O VERALL R- CX SCO RE
F I GU R E 4 6 : OV E R A LL R - C X S C OR E
In this widget, the RCEM application displays aggregated weighted score of (voice, SMS, and data)
F I GU R E 4 7 : R OA M E R S ON E A C H N E TWOR K
In this widget, the RCEM application displays total roamers who are registered with a network at a give time.
F I GU R E 4 8 : S TE E R IN G B U S IN E S S S E TTIN GS M A N A GE M E N T
In this widget, the RCEM application provides a mechanism through which you can open the NTR application
GUI to modify business settings for a given CoS and county (zone. The NTR application identifies each country
as a zone.).
F I GU R E 4 9 : F I L T ER S
As shown in Figure 49 on page 151, Table 72 on page 152 lists and describes the filters available for
generating the Network R-CX dashboard.
T A B L E 7 2 : F I L T ER S F OR GEN ER A T I N G T H E N ET W OR K R - C X D A SH B OA R D
n "What details does the Interconnect Voice dashboard provide?" on page 152
n "Which KPIs does the Interconnect Voice dashboard use? " on page 152
n "Which filters does the RCEM application use to generate the Interconnect Voice dashboard?" on page
153
n "Which widgets does the RCEM application display in the Interconnect Voice dashboard?" on page 154
T A B L E 7 3 : K P IS IN TH E IN TE R C ON N E C T V OIC E D A S H B OA R D
KPI Description
KPI Description
seizures. This is a direct measure of the effectiveness of the service being offered
onward from the point of measurement.
[Number of answered calls]
------------------------------------- x 100
[Number of calls that were successfully attempted]
Network Efficiency Ratio expresses, as a percentage, the relationship between
the number of successful calls and the number of attempted calls.
[Number of successful call attempts]
------------------------------------------------ x 100 [Number of attempted calls].
Total duration of the call (in minutes).
n SIP
F I GU R E 5 0 : IN TE R C ON N E C T V OIC E D A S H B OA R D
Table 75 on page 155 lists and describes the widgets available in the Interconnect Voice dashboard.
T A B L E 7 5 : WID GE TS IN TH E IN TE R C ON N E C T V OIC E D A S H B OA R D
Widget Description
Call Analysis Displays the trend (every 15 minutes, hour, day, or month) in the interconnect SIP KPIs in the
Trend selected duration.
Call Analysis Displays the region-wise distribution of interconnect SIP or ISUP KPIs in the selected duration.
by Region
Widget Description
Call Analysis Displays the interconnect carrier-wise distribution of SIP or ISUP KPIs in the selected duration.
by Carrier This widget provides information about the capacity utilization of the interconnect carriers for
calls.
Call Count by Displays the distribution of error messages that are observed in the interconnect SIP or ISUP
Error Code KPIs in the selected duration.
Call Analysis Displays the distribution of the count of incoming and outgoing calls for the selected duration.
by Call
Direction
Call Analysis Displays a detailed list of call transactions that have occurred during the period that you have
selected.
The call analysis table displays the following information:
Event Date Date and time (in the DD-MMM-YYYY 24-hour HH:MM:SS format) at
which the event occurred during the trip.
Country Name of the country where the roamer started the trip.
This is based on the first UL message initiated in a network when
the subscriber started roaming.
Error Code Error codes causing the call failures.
You can click the error code to drill-down to the Trace application if
you want to generate the trace details.
Carrier Domain Domain name of the carrier used during the transaction.
Call Direction Direction of call for which the transaction occurs.
The following options are available:
n Incoming
n Outgoing
Call Attempts Total number of calls attempted (including successful and failed
attempts) by the roamer in the specified region and time.
The Global Roaming Quality (GRQ) SLA configuration module of Mobileum Administrator Studio allows you to
configure KPIs, based on which you can measure the GRQ compliance of a roaming partner through the GRQ
dashboard section of the Mobileum dashboards. For information about the GRQ dashboard, refer to "GRQ
dashboard" on page 91.
T A B L E 7 6 : C OM M ON L Y U SED T ER M S I N GR Q S LA C ON F I GU R A T I ON
Terms Explanation
NER Network Efficiency Ratio expresses, as a percentage, the relationship between the number of
successful calls and the number of attempted calls.
Terms Explanation
operator only configures the network for which the RCEM application learns about the GRQ KPIs.
F I GU R E 5 1 : T H R ESH OL D L EA R N I N G W OR K - F L OW
Table 76 on page 157 describes how the RCEM application uses the dynamic threshold learning feature to
learn and set the GRQ KPI threshold.
T A B L E 7 7 : H OW D YN A M I C T H R ESH OL D L EA R N I N G F EA T U R E W OR K S
1 KPI processing layer n Periodically collects the input data from the probe
interface, aggregates the data into KPIs, and
stores the KPIs in Hive database.
2 Threshold manager Note: The objective of this layer is to learn thresholds
automatically. The threshold manager identifies
appropriate normal values for various KPI values across
dimensions such as network, roamer type, and so on for
the configured networks.
---
n Undergoes an initial learning period when the
input data from the probe interface is processed.
3 KPI monitoring and alarms n Accesses and analyzes the currently computed
KPIs with respect to the set threshold.
n If observes a deviation, notifies the operator
through email, SNMP alarm, or SMS message.
Important
n Before you select a network for auto learning, you must set the GRQ thresholds for a minimum
period of two weeks to ensure that two-week's KPI data is available for auto-learning.
n After you select the Auto Learn checkbox in the Edit Configuration for GRQ SLAs screen, the
RCEM application displays the auto-learnt threshold values that you cannot modify.
n After you select the Auto Learn checkbox, the RCEM application learns about the threshold and
applies the threshold value during the next interval. In addition, till the next interval, the RCEM
application uses the threshold value that was set manually.
F I GU R E 5 2 : GR Q S LA C ON F I GU R A T I ON PA GE
Table 78 on page 161 lists and describes the fields available in the GRQ SLA configuration page.
T A B L E 7 8 : F I EL D S IN THE GR Q S LA C ON F I GU R A T I ON PA GE
Field Description
Host Network Select the host network name from the drop-down list for which the
GRQ SLA KPIs have to be defined.
Roamer Type Select the type of roamer.
The following options are available:
n Inbound
n Outbound
Partner Network Displays the list of partner networks.
Class of Subscriber Displays the list of the class of subscribers.
Select the class of subscriber from the drop-down list for which the
Field Description
Field Description
PDP LTE Throughput Type the LTE PDP throughput value in bytes per second.
PDP LTE Data Loss Type the LTE PDP data loss value in bytes.
PDP LTE Goodput Type the LTE PDP goodput value in bytes per second.
SMS Performance
MO-SMS Success Rate Type the mobile originating SMS success rate percentage value.
MT-SMS Success Rate Type the mobile terminating SMS success rate percentage value.
MO-SMS Latency Type the latency value for mobile originating SMS messages in
milliseconds.
MT-SMS Latency Type the latency value for mobile originating SMS messages in
milliseconds.
End to End SMS Delivery Time Type the value for the end-to-end SMS delivery time in milliseconds.
Threshold Deviation for Alarms-related fields
You can configure the deviations in the GRQ KPIs to be considered for raising minor, major, or critical alarms
whenever a KPI is breached. The deviation considers the percentage increase in the negative KPIs or the
percentage decrease in the positive KPIs threshold value that you configure for KPIs to raise the
corresponding alarm.
You must consider the following conditions when configuring the deviation for sending alarms:
Here, RCEM raises the following alarms based on the success rate value that it computes at the end of 15
minutes:
n a minor alarm if the success rate is below 72 percent but more than 64 percent (that is, 80% minus 10%
= 72%)
n a major alarm if the success rate is below 64 percent (that is, 80% minus 20% = 64%)
n a critical alarm if the success rate is below 56 percent (that is, 80% minus 30% = 56%)
Note: The GSM LU Success rate KPI is considered a positive KPI, that is, RCEM raises an alarm when the
value is below the threshold configured.
---
Example 2: Consider the following configurations for a GRQ SLA for a frequency of 15 minutes and the
deviations that RCEM must consider for raising alarms:
n LTE ULR Delay: 1000 milliseconds
Here, RCEM raises the following alarms based on the average LTE ULR delay value that it computes at the
end of 15 minutes:
n a minor alarm if the ULR delay is more than 1100 milliseconds (that is, 1000 plus 10% = 1100)
n a minor alarm if the ULR delay is more than 1200 milliseconds (that is, 1000 plus 20% = 1200)
n a minor alarm if the ULR delay is more than 1300 milliseconds (that is, 1000 plus 30% = 1300)
Field Description
n No alarm is raised if the ULR delay is between 1000 and 1100 milliseconds
Note: The LTE ULR Delay KPI is considered a negative KPI, that is, RCEM raises an alarm when the value is
more than the threshold configured.
Minor Alarm on deviation Deviation (in percentage) in the GRQ KPI value for which RCEM must
raise a minor alarm.
Major Alarm on deviation Deviation (in percentage) in the GRQ KPI value for which RCEM must
raise a major alarm.
Critical Alarm on deviation Deviation (in percentage) in the GRQ KPI value for which RCEM must
raise a critical alarm.
Common fields
Should Notify Indicates that when the GRQ SLAs configured for a partner network
are breached, RCEM must notify the user about the breach.
Select the check box to enable the notification.
Auto-Learn Indicates whether the dynamic threshold learning feature is enabled
or not. When you select this option, RCEM periodically monitors the
actual value of this threshold for the configured duration and modifies
the threshold value based on the data it obtains during the monitoring
period.
For details about the dynamic threshold learning feature, refer
"Dynamic threshold learning" on page 158.
---
For information about configuring the auto-learn feature, refer to the
"Configuring dynamic threshold learning for GRQ KPIs" section in the
RCEM 2.2 Installation Guide.
Save All Option to save the values that you configured in the fields in a specific
network for all partner networks.
2. To save the changes, click Save.
2. Click the delete ( ) icon in the Available Configurations section corresponding to the partner network
that you want to delete.
3. When prompted, click OK to confirm the deletion.
Mobileum Administrator Studio refreshes the page and displays a message to indicate successful
deletion of the configuration.
The CoS Threshold Configuration section of Mobileum Administrator Studio allows you to configure
thresholds for different KPIs to monitor the performance of VIP subscribers and the monitor window for a
particular CoS. RCEM will monitor these KPIs over the defined window and on threshold breach, sends an
alert to the configured users.
Note
For information related to CoS configuration, refer to the Mobileum SDS 7.0 User Guide.
SDS CoS configuration supports specifying CCNDC or MCCMNC to configure all the MSISDNs or
IMSIs of a particular network. However, to monitor the performance of the VIP subscribers, RCEM
does not support configuring all subscribers of a network as VIP subscribers.
Mobileum Administrator Studio displays the CoS Threshold Configuration page, as shown in Figure 53
on page 167.
F I GU R E 5 3 : C O S T H R ESH OL D C ON F I GU R A T I ON
2. Specify the appropriate information in the relevant fields of the Edit Configuration for CoS Thresholds
section, as described in Table 79 on page 167
T A B L E 7 9 : F I EL D S IN THE C OS T H R ESH OL D C ON F I GU R A T I ON
Fields Descriptions
Fields Descriptions
LTE Failed Packet Threshold (count in integer value) for number of LTE failed packet data session
Data establishment.
3G Data Throughput Threshold (in kilobits per second) for 3G packet data throughput.
(Kbps)
LTE Data Throughput Threshold (in kilobits per second) for LTE data throughput.
(Kbps)
Threshold Threshold value for corresponding performance measures (KPIs). When this value is
breached, RCEM sends an alert to the configured user.
Analysis User The user ID to which the RCEM application must send the alert email and SMS
messages on breach of thresholds.
For information about configuring users, refer to the Mobileum SDS 6.0 User Guide.
Monitoring Interval The interval (in minutes) for which RCEM must monitor the failures.
The minimum value for this field is 15 minutes.
3. To modify the values, click Reset.
4. To save the changes, click Save at the bottom after editing the information.
2. Click the delete ( ) icon corresponding to the CoS that you want to delete.
3. When prompted, click OK to confirm the deletion.
Mobileum Administrator Studio refreshes the page and displays a message to indicate successful
deletion of the configuration.
Configuring thresholds and alerts refers to selecting the KPIs that the RCEM application supports and
configuring thresholds for the selected KPIs, based on which RCEM monitors these thresholds and sends
alerts to the operators.
The RCEM application continuously monitors various KPIs across region, time period, and for various time
granularities. Based on configured thresholds, RCEM sends alerts to the business or operations users when
the thresholds are breached. For example, you can configure RCEM to send an alert if the number of inbound
roamers from a particular network in the last completed month has decreased below a certain threshold. You
can also configure the threshold by comparing the trend for the past few months for inbound roamers from that
network from the RCEM dashboards.
The Threshold Configuration page of the Mobileum Administrator Studio allows the operator to configure the
settings for different KPIs based on which the operator must be alerted. The alerts can be configured to be sent
as SMS messages or email notifications.
RCEM saves details of the alerts it sends in the ri_kpi_alarm_history database table. You can verify the alerts
by checking the details in this database table. For information about correlating alarm details, refer to
"Correlating alarms in the alarm history table" on page 203.
Mobileum Administrator Studio displays the Configured Alerts page, as shown in Figure 54 on page
171.
F I GU R E 5 4 : C ON F I GU R ED A L ER T S PA GE
F I GU R E 5 5 : N EW A L ER T C ON F I GU R A T I ON PA GE
3. Specify the appropriate information in the relevant fields, as described in Table 80 on page 171.
T A B L E 8 0 : F I EL D S IN THE N EW A L ER T C ON F I GU R A T I ON PA GE
Based on the option you select in this field, the KPIs that are available
for this group are populated in the KPI field.
KPI Yes The KPI for which you want to configure the threshold.
The following KPIs are available:
n MAP and LTE S6a signaling:
Partner No Name of the partner network or country (based on the option you select
in the Partner Type field) for which you want to configure the threshold.
---
Note: This field depends on the option you select in the Partner Type
field. For example, if the Partner Type field is set to Network, then this
field displays the list of all host networks present in the system.
---
Class of Yes The CoS for which you want to configure the threshold.
Subscriber From the drop-down list, select the required CoS.
Measure for Yes Criteria corresponding to the KPI and KPI Group combination for which
you want to configure the threshold.
The options that appear in this drop-down list depends on the options
that you select in the KPI Group and KPI drop-down lists.
Measurement Yes The period for which the RCEM must calculate data for the selected
Period KPI.
The following options are available:
n Last 1 hour
n Last 1 day
n Last 1 month
Measurement Yes Type of threshold value that you want to configure.
Type The following options are available:
n Absolute: “Select this option if you want to configure threshold
based on the absolute value of the KPIs.
This is useful for KPIs where the absolute number or value of the
KPI is known. Example, if you know that the approximate
number of outbound roamers is 500,000 and you want an alert
when this number decreases to 400,000, then you can configure
the threshold type as Absolute and the value for the Lower
Threshold Value field as 400,000.”
n Percentage Change: “Select this option if you want to configure
the threshold based on the percentage change in KPI values
compared to the previous KPI value (that is, value of the KPI in
the previous monitoring interval).
Now, because you have configured the lower threshold for this failed messages as -5, from the value
calculated, it is clear that the lower threshold has breached (success ratio has decreased more than 5%) and
hence, the RCEM application sends an alert to the configured user.
---
Upper Threshold No Type the absolute or percentage value for the upper threshold
Value depending on the option you selected in the Measurement Type field.
Acceptable values for percentage change are between 0 to 100.
Upper Threshold No Severity of the alarm that RCEM sends when the upper threshold value
Alarm Breach is breached.
The following options are available:
n Minor
n Major
n Critical
Lower Threshold No Type the absolute or percentage value for the lower threshold
Value depending on the value set in the Measurement Type field.
Acceptable values for percentage change are between 0 to 100.
Lower Threshold No Severity of the alarm that RCEM sends when the lower threshold value
Alarm Breach is breached.
The following options are available:
n Minor
n Major
n Critical
Notification Type Yes Type of alert notification that RCEM must send when the threshold is
breached.
The following options are available:
n Email
n SMS
Notification User Yes Name of the user to whom RCEM must send the alert notification.
4. Depending on whether you want to add the alert configuration details or reset the values, perform one of
the following steps:
a. To add the alert configuration, click Add.
A message appears at the top of the page, confirming that the details have been added successfully.
b. To reset the values and add new details, click Reset.
You have successfully added alert configuration details.
1. In the Configured Alerts page, from the KPI Group drop-down list, select the group for which you want
to view the configured alerts.
2. Click Filter.
The Configured Alerts section displays the details for the alert configurations, as shown in Figure 56 on
page 177.
F I GU R E 5 6 : C ON F I GU R ED A L ER T S SEC T I ON – E XI ST I N G C ON F I GU R A T I ON S
T A B L E 8 1 : F I EL D S I N T H E A VA I L A B L E L I ST OF A L ER T C ON F I GU R A T I ON S
Field Description
Note
You can modify all fields in the Threshold Details section. For more information about fields in this
section, refer toTable 80 on page 171.
4. Depending on whether you want to save the modified alert configuration details or reset the values,
perform one of the following steps:
a. To save the modified details of the alert configuration, click Save.
A message appears at the top of the page, confirming that the details have been modified
successfully.
b. To reset the values and add new details, click Reset.
You have successfully searched for, modified, and deleted an existing alert configuration.
The Trace Reports section of Mobileum Administrator Studio consists of the following reports:
n Trace
n CRM
This topic contains the following subtopics:
Trace
Trace includes the following details:
n The transaction details that are derived from the extended summary traces.
n Displays the event and PCAP traces by using the event and detail files respectively, that are generated
by TxnWriter.
n Historical data of any transaction that an operator can find, by using the appropriate filters.
F I GU R E 5 7 : T R A C E PA GE
2. Specify the appropriate information in the relevant fields as described in Table 82 on page 180:
T A B L E 8 2 : F I L T ER S F OR GEN ER A T I N G T H E TR A C E D A T A SEC T I ON
Field Description
From Select the start date (in the format) by clicking the icon and then enter the start
(DD/MM/YYYY DD/MM/YYYY
HH:MI) time (in the Hour:Minute format) for which the report must be generated.
If you want a day-wise report instead of a report based on time interval, then start time and end
time must be 00:00.
---
Note: Time interval-based trace report must be used for small intervals (around 2–3 hours);
otherwise, the query might take a long time, due to which, the GUI might timeout.
---
To Select the end date (in the format) by clicking the icon and then enter the end
(DD/MM/YYYY DD/MM/YYYY
HH:MI) time (in the Hour:Minute format) for which the report must be generated.
If you want a day-wise report instead of a report based on time interval, then start time and end
time must be 00:00.
---
Note: Time interval-based trace report must be used for small intervals (around 2–3 hours);
otherwise, the query might take a long time, due to which, the GUI might timeout.
---
IMSI Type the IMSI number for which the report should be generated.
MSISDN Type the MSISDN number for which the report should be generated.
Application Select the appropriate application from the drop-down list.
The following options are available:
n MAP: “Displays the report for the MAP protocol.”
T A B L E 8 3 : O T H ER F I L T ER S ( I N C L U D I N G A PPL I C A T I ON F I L T ER S ) F OR GEN ER A T I N G T H E TR A C E
D A T A SEC T I ON
Field Description
Class of The CoS for which you want to generate the dashboard.
Subscriber From the drop-down list, select the required CoS.
Roamer Type of roamer for which you want to generate the dashboard. The following options are
Type available: n Inbound: “Report is generated for inbound roamers from the selected regions.” n
Outbound: “Report is generated for outbound roamers to the selected regions.” From the drop-
down list, select the required roamer type.
Host Name of the host network for which you want to configure the threshold.
Network
Partner Countries to which the roaming partner networks belong, for which you want to generate the
Country dashboard. From the drop-down list, select the required partner countries.
Partner Names of the partner networks for which you want to generate the dashboard. From the drop-
Network down list, select the required partner networks.
IMEI IMEI number of the subscriber’s mobile device.
---
Note: For security purpose, the RCEM application uses the masking feature that provides an
option to cover a few digits of the subscribers' IMSI, MSISDN, and IMEI. The RCEM application
provides the masking feature for Indexer (Tracer) and dashboard. For information about how to
enable the masking feature, refer to the description of the IMSI field.
Service Act Select the required service act.
Service Act refers to the actions that the service has performed. An action is specific to the
service it belongs to.
Note: There could be several actions in addition to those that are configured and displayed in the
Service Act drop-down list. Based on requirements and service's (Mobileum application)
capability, Mobiluem might modify the action list that are currently displayed in the Service Act
drop-down list.
Call Type Type of call for which you want to generate the dashboard. The following options are available:
n Mobile Terminated
n Mobile Originated
Field Description
GUI.
RIS-Trace-CAP
Host Global Type the GT for the host network for which the report has to be generated.
Title
Partner Type the GT for the partner network for which the report has to be generated.
Global Title
CAMEL The phase of the CAMEL protocol for which you want to generate the trace report.
Phase The following options are available:
n 1, 2, 3
Result Code Displays the result code generated for the given transaction.
Following are example of result codes that are available:
n Access information discarded(43)
n Call rejected(21)
n Incomplete Transaction(-1)
Note: The complete list includes numerous types of result codes that are displayed in the RCEM
GUI.
RIS-Trace-GTP
Host Node Type the IP address for the host network for which the report has to be generated.
IP
Partner Type the IP address for the partner network for which the report has to be generated.
Node IP
APN APN for which you want to generate the trace report.
RAT The Radio Access Technology (RAT) involved in the packet data sessions.
The following options are available:
n GAN
n UTRAN
n EUTRAN
n GERAN
n HSPA Evolution
n WLAN
n Reserved
n Virtual
Subscriber Type the address of the subscriber.
IP address
Session Filter the number of dropped out sessions by selecting the session drop status.
Drop Status The following options are available:
n Dropped
n Not dropped
Usage Displays the distribution of data usage done in the session, grouped into different usage buckets.
Bucket The session is categorized in the following buckets:
n 0-1MB
n 2-30MB
n 31-60MB
n 61-120MB
n >121MB
Duration Distribution of the duration of the session grouped by average duration buckets. The data is
Bucket grouped and displayed in the following duration buckets:
n 0-1mins
n 2-30mins
n 31-60mins
Field Description
n 61-120mins
n >121mins
Throughput Distribution of the number of sessions grouped by average throughput buckets. The data is
Bucket grouped and displayed in the following throughput buckets:
n 0-1Mbps
n 2-30Mbps
n 31-60Mbps
n 61-120Mbps
n >121Mbps
Start Select the start technology on which the session was started.
Technology For example, a user starts using mobile data service on an LTE technology. After some time the
session switches to 3G due to:
n Lack of connectivity
n LTE
Result Code Displays the result code generated for the given transaction.
Following are the example of result codes that are available:
n V1 Invalid Correlation-ID(225)
n V1 IMSI not known(194)
Note: The complete list includes numerous types of result codes that are displayed in the RCEM
GUI.
RIS-Trace-SIP
Result Code Displays the result code generated for the given transaction.
Following are the example of result codes that are available:
n Alternative Service(380)
n Bad Extension(420)
Note: The complete list includes numerous types of result codes that are displayed in the RCEM
GUI.
Call Indicates the direction of the SIP voice call in the event.
Directions The following values are supported:
n Outgoing
n Incoming
Carrier Type the carrier domain for which you want to generate the Trace.
Domain Carrier domain identifies the partner carrier with which the host network has arrangements to
carry the interconnect traffic.
Example: Carrier domain is derived from the host part of the Calling or Called URI depending
upon the call direction.
NSW.SYD.TATA.COM is an example of a carrier domain of the called party.
Note: The domain name provides information about the carrier location. A typical SIP URI has
the form sip:username@domainname, where domainname requires DNS SRV records to locate the
servers for SIP domain.
Example, 1456750011918437417378@IDD.NSW.OPTUS.COM.AU denotes the value of the called party,
where 1456750011918437417378 is the SIP username and IDD.NSW.OPTUS.COM.AU is the carrier
domain name.
Field Description
RIS-Trace-DIAMETER_S6a
Host Node Type the address (URL) of the host node.
Address
(URL)
Partner Type the address (URL) of the partner node.
Node
Address
(URL)
Message Displays the type of message used in the transaction.
Type The following options are available:
n AIR
n CCR
n CLR
n DSR
n IDR
n NOR
n PUR
n RAR
n RSR
n ULR
Result Code Displays the result code generated for the given transaction.
Following are the example of result codes that are available:
n DIAMETER ADC RULE EVENT(5148)
n DIAMETER APPLICATION UNSUPPORTED(3007)
Note: The complete list includes numerous types of result codes that are displayed in the RCEM
GUI.
RIS-Trace-REGISTRATION
Registration Displays the distribution of number of successful registrations grouped into different registration
Latency time buckets for the selected duration. Following time buckets are displayed in the widget:
Bucket n 1-2 min(s)
n 2-30 sec(s)
n 31-60 sec(s)
n <1 sec(s)
n >2 min(s)
Registration Displays the registration domain.
Domain The following options are available:
n GPRS
n GSM
n GSM_GPRS
n LTE_GSM
Result Code Displays the result code generated for the given transaction.
Following are the example of result codes that are available:
n Busy Subscriber(45)
n Call Barred(13)
Note: The complete list includes numerous types of result codes that are displayed in the RCEM
GUI.
Note
The Application filters are optional and you can apply them if you want to drill down to the exact
search results.
3. Click Search.
Mobileum Administrator Studio displays the Trace report, as shown in Figure 58 on page 186.
F I GU R E 5 8 : R C E M T R A C E - R ESU L T S PA GE
RCEM displays the Trace information across the following sections and widgets:
n Section: Assess
RCEM displays the following widgets in the Asses section:
n Timeline
n Event History
Assess
The Assess section of the Trace report displays individual events that have occurred during a subscriber’s
roaming trip across all services and networks. It also displays details about each transaction that has occurred
within a particular event. For example, for a successful GSM attach event, details about individual message
transactions in this event are also displayed.
Figure 59 on page 188 displays the widgets in the Assess section of the Trace report.
Table 84 on page 188 lists and describes the widgets displayed in the Assess section of the Trace report.
Widget
Description
name
Timeline Displays events on a time graph grouped by the service to which the events belong. The events are
displayed as dots in the following colors to indicate the status of that event:
n Green ( ): “Indicates a successful event.”
n Red ( ): “Indicates a failed event.”
Widget
Description
name
Event Displays an overview of all the events that have occurred during the trip for the subscriber.
History The event history table displays the following information:
n Time: “Date and time (in the DD-MMM-YYYY 24-hour HH:MM:SS format) at which the event
occurred during the trip.”
n Event: “Description of the event that has occurred.”
---
Note:
n To view details of the transactions of an event, click the ellipsis icon corresponding to the
event.
n To view the message details in an event, select the corresponding check box and then click
Show Event. For more information, refer to "Event details" on page 189.
n To generate the pcap file for the event, select the corresponding check box and then click
Export PCAP. Moreover, the Export PCAP option will not available if you have enabled the
masking feature of IMSI or MSISDN (PII Masking feature).
n To view the event details in the CSV format, select the corresponding check box and then
click Export Event As CSV.
---
F I GU R E 6 0 : C OL U M N S IN THE E VEN T D ET A I L S T A B L E
Table 85 on page 190 describes the various columns displayed in the trace report:
Date Date and time (in the DD-MM-YYYY 24-hour HH:MM:SS format) at which the transaction
occurred for the event.
Protocol Name of the protocol that was involved in the transaction.
The following values are supported:
n ISUP
n MAP
n CAMEL
n GTP
n SIP
n Diameter
Version Version of the CAP, GTP, and Diameter call sessions.
Event Name of the event
Tcap Txn Type Type of TCAP transaction present in the event.
The following values are supported:
n BEGIN
n CONTINUE
n END
Tcap Comp Type Type of TCAP component present in the event.
The following options are supported:
n NONE
n INVOKE
n RESULT
n ERROR
n REJECT
IMSI IMSI of the subscriber involved in the transaction.
---
Note: For security purpose, the RCEM application uses the masking feature that
provides an option to cover a few digits of the subscribers' IMSI, MSISDN, and IMEI.
The RCEM application provides the masking feature for Indexer (Tracer) and
dashboard.
To ensure that masking feature works properly, you must configure and enable the
feature. For information about how to configure, refer to the "Configuring the masking
feature" section in the RCEM 2.2 Installation Guide.
Follow these steps to enable the masking feature for Indexer (Tracer):
1. Log in to the Mobileum Administrator Studio by using the admin credentials.
2. From the Application menu at the top left, select System Administration.
3. On the left, click the Application management ( )icon.
4. Under the List of applications section, click Indexer.
5. In the Authorization data section at the bottom left, select the user group for
which you want to enable the masking feature.
6. In the pii.masking.reqd text box, type yes and click Save.
Note: The masking feature is enabled or disabled at the group level only. If you
have configured the masking feature by following the steps available in the
"Configuring the masking feature" section of the RCEM 2.2 Installation Guide,
the RCEM application enables the feature for all groups by default. Therefore, if
you want to disable the feature for a group, make sure you type no in the
pii.masking.reqd text box for that group.
Important: The aforementioned steps enable the masking feature for Indexer (Tracer)
only. If you want to enable the feature for RCEM dashboard, you must follow similar
steps for dashboard, as well. Therefore, to enable the feature for dashboard, while
selecting the application under List of applications section, make sure you click
Dashboard. The remaining steps are identical.
MSISDN/Cg-MSISDN MSISDN of the subscriber or the calling party.
Cd-MSISDN MSISDN of the called party.
MSC/VLR Address of the MSC-VLR.
OTID/CIC/EndToEndID Source transaction ID, CIC of the carrier trunk, or end-to-end ID for the event.
DTID Destination transaction ID for the event.
SM TxnId Transaction ID generated by the state machine for this event.
Host Node GT of the subscriber’s host network.
Partner Node GT of the partner network where the subscriber is roaming.
Host GT SSN/Port SSN value present in the GT or the port number of the subscriber’s host network.
Partner GT SSN/Port SSN value present in the GT or the port number of the subscriber’s partner network.
Host GT NP/IP Numbering plan (NP) present in the GT or the IP address of the host network.
Address
Partner GT NP/IP Numbering plan (NP) present in the GT or the IP address of the partner network.
Address
Invoke Id/RPUI ID of the TCAP invoke component or the RP UI address
Address
GMSC PC/Host Point code (PC) or the realm address of the host network’s GMSC.
Realm
Carrier PC/Partner PC or the realm address of the partner carrier.
Realm
Carrier Id ID of the partner carrier.
Direction Indicates the direction of the message in the event.
The following values are supported:
n 1: “Outgoing”
n 2: “Incoming”
MSU Size Size (in bytes) of the event’s MSU.
Cause code Code of the error that has occurred in the event.
APN Name of the APN accessed in the event.
IMEI IMEI number of the subscriber’s mobile device.
Note
If the feed is coming from the Anritsu Probe, there is no option to view or download the PCAP files or
sequence diagrams of the events that are displayed in the Trace field.
CRM
CRM generates a CRM report that provides details about a subscriber’s activity during a roaming trip. The
details include the following:
n Current location of the subscriber, if the subscriber is currently roaming. This information is obtained
from the open trip data for that subscriber.
n Trip details (including countries visited, time spent in each country, quality of the services provided by
partner networks, usage of the subscriber across services, history of all previous roaming trips by the
subscriber.)
n Simplified information displaying the details about the Roaming status, Roaming activities , Usage per
services (Data, Voice, or SMS) across visited countries, Quality scores per service across visited
countries, and Roaming history of the subscriber.
F I GU R E 6 1 : C R M PA GE
2. Specify the appropriate information in the relevant fields, as described in Table 86 on page 192:
Filter Description
From Start date and time (in the DD-MMM-YYYY HH:MM 24-hour format) for which you want to generate the
report.
To End date and time (in the DD-MM-YYYY HH:MM 24-hour format) for which you want to generate the
report.
IMSI IMSI for which you want to generate the report.
MSISDN MSISDN for which you want to generate the report.
Note
n All the filters mentioned are applicable to generate and view the Roaming Activity section in
CRM.
n Only IMSI and MSISDN filters are applicable to generate and view the Roaming Status and
Learn sections.
3. Click Search.
Mobileum Administrator Studio displays the CRM report, as shown in Figure 62 on page 194.
F I GU R E 6 2 : C R M – R ESU L T S PA GE
RCEM displays the CRM report information across the following sections and widgets:
n Section: Roaming Status
n Section: Roaming Activity
RCEM displays the following widgets in the Roaming Activitysection:
n Timeline
n Event History
n Section: Learn
RCEM displays the following widgets in the Learn section under the Trip Details subsection:
n Time Spent
n Trip Service Quality
n Trip Usage
n Roaming History
This topic contains the following subtopics:
Roaming Status
Figure 63 on page 195 displays the Roaming Status section of the CRM report.
F I GU R E 6 3 : I N F OR M A T I ON IN THE R OA M I N G S T A T U S SEC T I ON
The Roaming Status section of the CRM report displays the following details by using the open trip data of a
roamer:
Note
n RCEM displays information in this section only if the open trip details are present for the roamer,
that is, only if the roamer is currently roaming.
n If no data is present in the open trip details, that is, if the roamer is not currently roaming, then in
the Roaming Status section, a message appears informing that the IMSI or MSISDN is not
roaming.
n Billing ID: MSISDN of the roamer
n Name of the CoS to which the roamer belongs. This is indicated by the icon.
n Timestamp: Date and time (in the MM/DD/YYYY 24-hour HH:MM:SS format) of the roamer’s first entry to
that country.
n Name of the current country where the roamer is present.
Roaming Activity
The Roaming Activity section of the CRM report displays individual events that have occurred during a
subscriber’s roaming trip across all services and networks. It also displays details about each transaction that
has occurred within a particular event. For example, for a successful GSM attach event, details about individual
message transactions in this event are also displayed.
Figure 64 on page 197 displays the widgets in the Roaming Activity section of the CRM report.
Table 87 on page 197 lists and describes the widgets displayed in the Roaming Activity section of the CRM
report.
Widget
Description
name
Timeline Displays events on a time graph grouped by the service to which the events belong. The events are
displayed as dots in the following colors to indicate the status of that event:
Widget
Description
name
n Green ( ): “Indicates a successful event.”
n Red ( ): “Indicates a failed event.”
Event Displays an overview of all the events that have occurred during the trip for the subscriber.
History The event history table displays the following information:
n Time: “Date and time (in the DD-MMM-YYYY 24-hour HH:MM:SS format) at which the event
occurred during the trip.”
n Event: “Description of the event that has occurred.”
---
Note:
n To view details of the transactions of an event, click the ellipsis icon corresponding to the
event.
n To view the message details in an event, select the corresponding check box and then click
Show Event. For more information, refer to "Event details" on page 198.
n To generate the pcap file for the event, select the corresponding check box and then click
Export PCAP.
n To view the event details in the CSV format, select the corresponding check box and then
click Export Event As CSV.
---
F I GU R E 6 5 : C OL U M N S IN THE E VEN T D ET A I L S T A B L E
Table 88 on page 198 lists and describes the columns in the Event Details table.
Date Date and time (in the DD-MM-YYYY 24-hour HH:MM:SS format) at which the transaction
occurred for the event.
Protocol Name of the protocol that was involved in the transaction.
The following values are supported:
n ISUP
n MAP
n CAMEL
n GTP
n SIP
n Diameter
Version Version of the protocol that was involved in the event.
Event Name of the event
Tcap Txn Type Type of TCAP transaction present in the event.
The following values are supported:
n BEGIN
n CONTINUE
n END
Tcap Comp Type Type of TCAP component present in the event.
The following options are supported:
n NONE
n INVOKE
n RESULT
n ERROR
n REJECT
IMSI IMSI of the subscriber.
MSISDN/Cg-MSISDN MSISDN of the subscriber or the calling party.
Cd-MSISDN MSISDN of the called party.
MSC/VLR Address of the MSC-VLR.
OTID/CIC/EndToEndID Source transaction ID, CIC of the carrier trunk, or end-to-end ID for the event.
DTID Destination transaction ID for the event.
SM TxnId Transaction ID generated by the state machine for this event.
Host Node GT of the subscriber’s host network.
Partner Node GT of the partner network where the subscriber is roaming.
Host GT SSN/Port SSN value present in the GT or the port number of the subscriber’s host network.
Partner GT SSN/Port SSN value present in the GT or the port number of the subscriber’s partner network.
Host GT NP/IP Numbering plan (NP) present in the GT or the IP address of the host network.
Address
Partner GT NP/IP Numbering plan (NP) present in the GT or the IP address of the partner network.
Address
Invoke Id/RPUI ID of the TCAP invoke component or the RP UI address
Address
GMSC PC/Host Point code (PC) or the realm address of the host network’s GMSC.
Realm
Carrier PC/Partner PC or the realm address of the partner carrier.
Realm
Carrier Id ID of the partner carrier.
Direction Indicates the direction of the message in the event.
The following values are supported:
n 1: “Outgoing”
n 2: “Incoming”
MSU Size Size (in bytes) of the event’s MSU.
Cause code Code of the error that has occurred in the event.
Learn
The Learn section of the CRM report displays information about both the open trip and all previous closed trip
details of a roamer. The Time Spent, Trip Service Quality, and Trip Usage widgets always display the current
open trip details of a subscriber, unless a user clicks a specific trip in the Roaming History widget to view the
details of a subscriber’s previous closed trips.
Figure 66 on page 200 displays the widgets in the Learn section of the CRM report.
Table 89 on page 201 lists and describes the widgets displayed in the Learn section of the CRM report.
Widget
Description
name
Time Displays the percentage distribution of the time spent by a subscriber in various countries in a
Spent roaming trip.
---
Note: By default, this widget always displays details from a subscriber’s current open roaming trip. If
the subscriber is not roaming any longer, then this widget displays details from the subscriber’s last
closed roaming trip.
---
Trip Displays the subscriber’s level of satisfaction (in color-coded boxes) across the services that the
Service subscriber has accessed in all networks in a country during a trip.
Quality Details about the level of satisfaction are obtained from the network quality score that RCEM
computes for a subscriber based on predefined KPIs. For more information about the network quality
score, refer to "NQS dashboard" on page 129.
Trip Displays the country-wise details of total usage (in tabular format) of all the services that the
Usage subscriber has accessed in networks of that country during the trip.
The trip usage table displays the following information:
n Country Name: “Name of the country where the subscriber has accessed a service during
the trip.”
n Data Usage (MB): “Total amount of data (in megabytes) used by the subscriber when in that
country.”
n MOU (MT Calls): “Total number of minutes of MT calls received by the subscriber when in
that country.”
n MOU (MO Calls): “Total number of minutes of MO calls made by the subscriber when in that
country.”
n SMS: “Total number of SMS messages sent by the subscriber when in that country.”
Roaming Displays a consolidated view (in tabular format) of a subscriber’s roaming trips (open and closed)
History with details about the roaming start and end time, and start and end country.
The roaming history table displays the following information:
n Start Time: “Date and time (in the MM/DD/YYYY 24-hour HH:MM:SS format) when the subscriber
started the roaming trip.”
n End Time: “Date and time (in the MM/DD/YYYY 24-hour HH:MM:SS format) when the subscriber
ended the roaming trip.”
n Duration (days): “Number of days that the subscriber’s trip lasted.”
n Start Country: “Name of the country where the subscriber’s roaming trip started.”
n End Country: “Name of the country where the subscriber’s roaming trip ended.”
n Trip Details: “Provides a link to view the details about a particular trip (open or closed) in the
following widgets in this section:
n Time Spent
n Trip Usage”
An input of 919820% for the MSISDN field will match all the MSISDNs starting with 919820, such as
919820000001, 919820, and 919820555555.
An input of 919_20% for the MSISDN field will match the following MSISDNs: 919x20% --> where x could be
any character.
You can use the escape character (\) to search for strings that contain wildcard (% or _) characters.
Examples:
To search for a string that contains % (for example, ICICI%BANK), you can use an input of ICICI\%BANK, where
the escape character (\) is included before %.
To search for a string that contains _ (for example, ICICI_BANK), you can use an input of ICICI\_BANK, where
the escape character (\) is included before _.
To search for a string that contains % and \ (ICICI\BANK%HOME), you can use as input of ICICI\\BANK\%HOME,
where the escape character (\) is entered before % and \.
If the input value contains wildcard (% or _) characters and you want to search for strings containing \, you must
use \\.
Example:
To search for ICICI\BANK123 or ICICI\BANK1 or ICICI\BANKHOME, use the following input string:
ICICI\\BANK%
If the input value does not contain any wildcard characters (neither % nor _) then \ will not be treated as an
escape character.
Example:
If the input string is 'ICICI\BANK', the search results will show all the strings that match the input string. Here,
pattern matching will not be used.
The RCEM application sends alarms whenever a KPI is breached. RCEM computes the breach based on the
threshold configuration that the operator defines in the Threshold Configuration page of the RCEM GUI. For
information about configuring thresholds, refer to "Configuring thresholds and alerts" on page 170.
RCEM also saves details about all alarms in the ri_kpi_alarm_history database table. It also saves details of
multiple instances of the same alarm depending on the status of the alarm (cleared or raised) and the type of
threshold that is breached (lower or upper).
You can correlate details of the alarms by checking the following columns that are present in the ri_kpi_alarm_
history database table:
n TIMESTAMP: Date and time when the alarm is raised (or cleared).
n ALARM_CLEARED: Indicates whether the alarm was raised or cleared for a KPI. The following values are
applicable:
n 0: Alarm is raised
n 1: Alarm is cleared
n ALARM_TYPE: Indicates the type of threshold that is breached. The following values are applicable:
n 0: Lower threshold is breached
n 1: Upper threshold is breached
n ALERT_MESSAGE: Description of the alarm.
Consider the following scenarios where both the lower and upper thresholds for a KPI are configured in the
GUI and these thresholds are breached at different instances of time:
1. In the current processing cycle of the Alerter component (at timestamp 1): Lower threshold for the KPI is
breached. RCEM raises an alarm for the lower threshold breach and saves this information in the alarm
history table with the values; ALARM_CLEARED = 0 and ALARM_TYPE = 0.
2. In the next processing cycle of the Alerter component (at timestamp 2): The same KPI is breached,
however, for the upper threshold. Here, RCEM performs the following actions:
a. Because the KPI value does not breach the lower threshold at this instance, RCEM clears the alarm
that it had previously raised (for lower threshold breach) and updates the existing entry in the alarm
RCEM 2.2 Administration Guide
Appendix A - Correlating alarms in the alarm history table
Note
Before you begin, make sure you have completed the following steps:
n Take a backup of Oracle tables and the files that could be modified.
n The steps to upgrade the Trace application is applicable only if the CRM application is not
enabled for any user login, for example risuser, under the RIS user group. If the
CRM application is enabled already, follow these steps to disable CRM:
n Make sure that you have completed the RCEM 2.2 installation, as given in the RCEM 2.2
Installation Guide.
n Make sure that the environment variables such as ROAMWARE_HOME and CATALINA_HOME are set
through the setup.sh file.
n To remove CRM entry from the iMAS menu, run the following commands on Oracle database
schema that is configured as the default pool in the imaslight.properties file:
Important: Make sure that only one row is deleted after you run the following commands:
RCEM 2.2 Administration Guide
Appendix B - Upgrading the Trace application
n Commit ;
1. Run the following commands on Oracle database schema that is configured as the default pool in the
imaslight.properties file:
n DELETE FROM APPAUTHORIZATION WHERE APPID = 's61' and GRPID = 'RIS' ;
n Insert into APPAUTHORIZATION (APPID,AUTHCODE,GRPID,AUTHVALUE,GRANTED) values
('s61','app.allowed.list','RIS','159_Verizon','Y');
n Insert into APPAUTHORIZATION (APPID,AUTHCODE,GRPID,AUTHVALUE,GRANTED) values
('s61','db.pool.name','RIS','default','Y');
Important: Make sure that only one row is updated after you run the following commands:
n Update MENUDATA set MENUAPPID = 's61' where KEY = 10501 and DN = '000000' ;
n Commit ;
n Add the following configurations for each indexer that you want to configure:
Note:The following configurations are applicable when you have only one indexer. If there are
multiple indexers, you must ensure that similar configuration for each indexer is added.
n rpc.server.1.host=127.0.0.1
n rpc.server.1.name=RISIndexer
n rpc.server.1.type=1
n rpc.server.1.port=10538
n rpc.server.1.module=300
n rpc.server.1.size=1
b. Add or update (if required) the following configurations under the [Indexer] section:
# Limited IMSITracer input/output fields :
#-----------------------------------------
ristrace.fixed.input.column.names=IMSI,MSISDN,Class_of_Subscriber,Roamer_Type,Host_
Network,Partner_Country,Partner_Network,IMEI,Service_ID,Call_Type
ristrace.fixed.input.column.pii.tag=imsi,msisdn,NA,NA,NA,NA,NA,imei,NA,NA
ristrace.fixed.input.column.descriptions=IMSI,MSISDN,Class of Subscriber,Roamer Type,Host
Network,Partner Country,Partner Network,IMEI,Service Act,Call Type
ristrace.fixed.output.column.names=sequenceNumber,DateTime,IMSI,MSISDN,Message_
Type,Partner_Name,Error_Code
# Configure below entry for comma separated list of rpc module ids of indexers configured
and to be queried :
#---------------------------------------------------------
ristracer-indexers.module.list=300
c. Add the following section if you want to configure the CoS source as CoS Management module or
CoSEngine platfrom component:
Note: If you do not add the following texts, the RCEM application will use the CoS Management
module as the default source for CoS and login user-specific CoS association will be used to
populate the Class of Subscriber drop-down list in the Trace application. For details about CoS
source configuration, refer to the "Configuring CoS source for Trace application", section in the
RCEM 2.2 Installation Guide.
[RIS]
# Valid cos source names are "sds" or "cosengine"
cos.source.name=
# Database pool to fetch COS information (pool "default" will be used by default)
cos.source.db.pool.name=
# Configure COS feature name/s (comma separated) for populating COS, if 'cosengine' is
used as COS source
cos.feature.names=
3. Make sure that the ristrace_verizon.properties and ris22.jar files are available in the ROAMWARE_
HOME/indexerConfig and CATALINA_HOME/webapps/ROOT/WEB-INF/lib directories respectively.
Important
Make sure that the ristrace_verizon.properties and ris22.jar files are from the latest RCEM 2.2
package that you have installed.
n The steps in this section is applicable in a scenario where you have upgraded the Trace
application (by following the steps that are available in the aforementioned section) and have
disabled the CRM application. Therefore, you must follow the steps in this section if you want to
enable the CRM application after you have upgraded the Trace application.
n Make sure that you have taken a backup of Oracle tables and the files that could be modified.
n Make sure that you have completed the RCEM 2.2 installation, as given in the RCEM 2.2
Installation Guide
To enable CRM for a user under the group other than 'RIS'
Note
For information about how to create a user group, user under a group, menu, and access, refer to
the "Managing usergroups" , "Managing users", "Managing menu" and "Managing access rights"
chapters respectively in the Mobileum SDS 6.0 User Guide.
1. In the iMAS admin GUI, create iMAS menu for the CRM application, as shown in the following steps that
use a sample root node name as CRM Root.
Note: You can create a menu tree for the CRM application of your choice:
Important: The Application label must be set to Indexer, which must have the app ID as s61.
2. In the iMAS admin GUI, create menu access for the CRM application, as shown in the following steps
that use a sample menu access that is named as CRMAccess:
Note:You can create an access ID (of your choice) that has access to the CRM application.
n Create menu access named CRMAccess and assign the CRM application (that you created the menu
for in the previous step) to CRMAccess.
3. In the iMAS admin GUI, create a user group named RISCRM that is assigned with menu access (created
in the previous step) as Access Name and root node name (created in step 1) as Menu Id, as shown in
the following steps:
Note: You can create a different user group that is assigned with Access Name and Menu Id that are
created in previous steps.
n Create a group ID/name as RISCRM with Access Name as CRMAccess and Menu Id as CRM Root.
4. In the iMAS admin GUI, create a user assigned to the user group (created in the previous step), as
shown in the following steps:
Note: You can create the user with the name of your choice that must be assigned to user group
(created in the previous step).
n Create a user name as crmuser, under the user group RISCRM that you created in the previous step.
5. Run the following commands on Oracle database schema that is configured as the default pool in the
imaslight.properties file:
Note
The commands uses the group ID (user group) that you created in previous steps. Therefore,
RISCRM is used as the group ID in the following commands.
n Add the following configurations for each indexer that you want to configure:
Note:The following configurations are applicable when you have only one indexer. If there are
multiple indexers, you must ensure that similar configuration for each indexer is added.
n rpc.server.1.host=127.0.0.1
n rpc.server.1.name=RISIndexer
n rpc.server.1.type=1
n rpc.server.1.port=10538
n rpc.server.1.module=300
n rpc.server.1.size=1
crm.fixed.output.column.names=DateTime,TxnDetails
crm.fixed.output.column.descriptions=DateTime,TxnDetails
crm.fixed.input.column.names=IMSI,MSISDN
crm.fixed.input.column.descriptions=IMSI,MSISDN
#---------------------------
crm.timeline.group.names=Registration,Voice,Data,SMS
crm.timeline.group.descriptions=Registration,Voice,Data,SMS
#-----------------------------------------
crm.other.column.names=Startdate,Enddate,Product,Column,Value,Search,Other
Filters,Assess,TimeLine,Event History,Application Filters,Application,Transaction
Details,Event Details,Apply,Export CSV,Table,Zoom In,Zoom Out,Move Left,Move Right,Show
Event,Export Event As CSV,Export PCAP,Clear
crm.other.column.descriptions=From,To,Product,Column,Value,Search,Other Filters,Roaming
Activity,TimeLine,Event History,Application Filters,Application,Transaction
Details,Event Details,Apply,Export CSV,Table,Zoom In,Zoom Out,Move Left,Move Right,Show
Event,Export Event As CSV,Export PCAP,Clear
# Configure below entry for comma separated list of rpc module ids of indexers
configured and to be queried
#--------------------------------------------------------------------------------------
--------------------
ristracer-indexers.module.list=300
7. Make sure that the riscrm.properties and ris22.jar files are available in the ROAMWARE_
HOME/indexerConfig and CATALINA_HOME/webapps/ROOT/WEB-INF/lib directories respectively.
Important
Make sure that the riscrm.properties and ris22.jar files are from the latest RCEM 2.2 package
that you have installed. In addition, you might ignore the ris22.jar file if you have already fetched
the latest file from the RCEM 2.2 package while upgrading the Trace application.
Wireshark is tool that helps you analyze fields of packets that several protocols support. Wireshark parses the
packets and displays, in its GUI, the meaning of each packet fields. This appendix section contains settings that
you must configure to view DIAMETER pcap.
To configure settings
1. Open Wireshark and click Edit.
2. Click Preferences. The Wireshark . Preferences screen appears.
3. On the left, expand Protocol and click DLT_USER.
4. On the right, for Encapsulations Table, click Edit.The User DLTS Table screen appears.
5. Click the ( ) Create a new entry button. A new appears inside the table.
6. Under the DLT column, double click the value to enable a drop-down list, and then select the DLT=152
option.
7. Under the Payload protocol column, double click the blank value to enable the text box, and then type
diameter.
8. Click OK and then click OK to apply the settings.
You have successfully configured the DIAMETER pcap settings.
D
This topic summarizes the new, modified, and deprecated features in each release of the RCEM 2.2
application and provides pointers to additional information about these features. Where appropriate, it
discusses the enhancements made to this document itself.
Additions
No feature has been added in this release of the RCEM application.
Modifications
Information about generating a trace report has been modified. Example, screen-shots, related information have
been updated, restructuring has been done, and new protocols have been added. For more information, refer
"Trace " on page 179.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
The following documentation enhancements have been made in this release of the RCEM application:
n Information about the Interconnect Voice dashboard has been added. For more information, refer
"Interconnect Voice dashboard" on page 152.
n Information about the Hub dashboard has been deprecated.
n Information about generating a CRM report has been modified. Example, screen-shots and the related
information have been updated. For more information, refer "CRM" on page 192.
n Information about modifying and configuring a GRQ SLA configuration has been modified. Example,
information about MOS has been added. For more information, refer "Configuring GRQ SLAs" on page
157.
n Screen-shot of the GRQ dashboard has been updated. Example, the country-wise distribution has been
modified from percentile to percentage basis. For more information, refer "Widgets in the GRQ
dashboard" on page 94.
n Information about managing class of subscribers has been modified. For more information, refer to
"Managing classes of subscribers" on page 24.
n Information about the time-granularity of 15 minutes has been added in the "Generating dashboards" on
page 27 section.
n Information about upgrading the Trace application has been modified. Example, fields under the
[Indexer] section have been updated. For more information, refer to "Upgrading the Trace application"
on page 205.
Additions
No feature has been added in this release of the RCEM application
Modifications
The functionality of the RI_COS_MASTER database table has been modified in this release of the RCEM
application. For information about the functionality of RI_COS_MASTER database table, refer "Managing classes of
subscribers" on page 24.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
The following documentation enhancements have been made in this release of the RCEM application:
n Information about the RCEM architecture has been added. For more information, refer "Introduction to
the RCEM application" on page 15.
n Information about a note specifying the feed coming from the Anritsu probe has been added. For more
information, refer "Trace " on page 179.
Additions
No feature has been added in this release of the RCEM application
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
Section for the MAP Performance dashboard has been added. For more information, refer "MAP Performance
dashboard" on page 37.
Additions
No feature has been added in this release of the RCEM application
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
This document has been rebranded.
Additions
No feature has been added in this release of the RCEM application
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
Section for Registration dashboards has been updated. For example, added the information for reasons for
registration latency, reasons why an operator deploys SoR, and so on. For more information, refer "Registration
dashboards" on page 79.
Additions
n SMS Status filter has been added for the SMS Usage dashboard. For more information, refer "Filters for
generating the SMS usage dashboard" on page 104.
n Dynamic threshold learning feature has been added. For more information, refer "Dynamic threshold
learning" on page 158.
n Masking feature has been added. For more information, refer to the description for IMSI field in "Trace "
on page 179.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
Definition for PDD and ASR have been updated. For more information, refer "Configuring GRQ SLAs" on page
157.
Additions
Trace application has been upgraded. For information about how to upgrade the Trace application, refer
"Upgrading the Trace application" on page 205.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
No document-specific enhancement has been made in this release of the RCEM application. However, details
about features added, modified, or deprecated in this release are documented appropriately, as discussed in
the previous sections.
Additions
n Network R-CX dashboard has been added. For more information, refer "Network R-CX dashboard for
the Steer to Quality feature" on page 140.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
No document-specific enhancement has been made in this release of the RCEM application. However, details
about features added, modified, or deprecated in this release are documented appropriately, as discussed in
the previous sections.
Additions
No feature has been added in this release of the RCEM application.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
Description for the REGISTRATION FAILURE REASONS widget has been updated. For more information, refer
to Table 27 on page 89.
Additions
n The RCEM application supports weighted score for the NQS dashboard. For more information, refer
"Computing network quality score" on page 129.
n DIAMETER Performance dashboard has been added. For more information, refer "DIAMETER
Performance dashboard" on page 51.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
No document-specific enhancement has been made in this release of the RCEM application. However, details
about features added, modified, or deprecated in this release are documented appropriately, as discussed in
the previous sections.
Additions
No feature has been added in this release of the RCEM application.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
The Mapping CoSes to RCEM users section has been added.
Additions
The RCEM application supports the Alliance option, as well, as a filter to generate applicable dashboards such
as SMS usage, MAP transaction failure, and so on. For more information, refer to "Filters available in the MAP
transaction failure dashboard" on page 29.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
No document-specific enhancement has been made in this release of the RCEM application. However, details
about features added, modified, or deprecated in this release are documented appropriately, as discussed in
the previous sections.
Additions
No feature has been added in this release of the RCEM application.
Modifications
No feature has been modified in this release of the RCEM application.
Deprecations
No feature has been deprecated in this release of the RCEM application.
Documentation enhancements
The following section has been added:
End of document