Real-Time System Data View Guide
Real-Time System Data View Guide
FUNCTION SPECIFICATION
© Ericsson GmbH 2021. All rights reserved. No part of this document may be
reproduced in any form without the written permission of the copyright owner.
Disclaimer
The contents of this document are subject to revision without notice due to
continued progress in methodology, design and manufacturing. Ericsson shall
have no liability for any error or damage of any kind resulting from the use of
this document.
Trademark List
All trademarks mentioned herein are the property of their respective owners.
These are shown in the document Trademark Information.
Contents
1 Revision Information 1
2 Overview 3
3 Function 5
3.1 General 5
3.2 Real-Time SIs Polling and Reporting 5
3.3 Real-Time Graphical Representation 15
3.4 Operation and Maintenance 16
4 Operational Conditions 21
4.1 Operation and Maintenance Reference Information 21
4.2 Capabilities 22
Glossary 23
Reference List 25
1 Revision Information
— Rev. A
— Rev. A
— Rev. C
— Rev. B
— Rev. A
2 Overview
The function ‘‘Real-Time System Data View’’ (RTSDV) provides the ability to
report a predefined set of System Indicators (SIs) in real-time. SIs are data
provided by real-time measurements of essential characteristics of a node
collected according to RTSDV Framework solution principles. RTSDV Framework
contains different suites used for the purposes of performance management.
These suites are running on a data server independently to collect and visualize
SIs obtained from network nodes in real-time. Either of RTSDV Framework suites
can be used or both of them.
The Real-time System View (RSV) Suite collects and visualizes SIs that can be
used to evaluate system stability and performance. It is possible to define upper
or lower thresholds, so that the user is alerted through RSV Suite when an SI
exceeds or recedes the critical levels.
The Call Drop Analyzer (CDA) Suite collects and visualizes SIs that can point to
abnormal call failures. Based on samples collected, CDA Suite provides real-time
indication about potential node or network issues.
Dependencies
Table 1
Function Specifications Procedural Information
Real-Time System Data View Managing the Real-Time System Data
View
Real-Time System Data View, Activate
Real-Time System Data View,
Deactivate
For further information on the RSV Suite see the video in Figure 2.
3 Function
3.1 General
The ‘‘RTSDV’’ function is based on polling a CP and reporting predefined SIs to
the RTSDV Framework suite. The Suite requests SI data from the CP using a
proprietary protocol over UDP. The CP is configured to receive these requests
on a specific UDP socket and provides the values of the requested SIs in the
response. The SI data collected are used for the graphical representation of the
corresponding SI s in real-time.
— Provision of all necessary information for the client(s) to create and update
the Graphical User Interface (GUI)
For more information on the log files see Section 3.4.5 on page 19.
When ‘‘RTSDV’’ function is not active Real-Time System Data Request messages
are discarded by the CP. During restart, no request reaches the CP, since the UDP
socket is closed and re-initiated.
(1)
SI Name SI Abbreviation SI Description
Number of Calls in Tpr Traffic level counter for
pre-alerting internal resources in
position pre-alerting
Pre-alerting indicates
that a call has seized
internal resources and
call setup is progressing
without knowing if it
will be successful or not.
Number of incoming SIP Sipi Traffic level counter for
calls incoming SIP calls
Number of outgoing SIP Sipo Traffic level counter for
calls outgoing SIP calls
SPU Load Spu SPU load in the last 100
ms interval in percent
Total Number of Calls Tar Traffic level counter for
resources in position
alerting or speech
(1) The SI abbreviation is used as title for each SI in the graphical representation.
Table 4 presents the SI Set that is recommended to be defined in RSV Suite based
on the node type that is polled.
(1)
SI Name SI Abbreviation SI Description
Message initiated call gMsg Latest logged message
release on A-Interface that initiate abnormal
call release on
A-Interface
Global route number for gRop Global route number
A-Interface over which message is
received on A-Interface
Latest Cause Code uCau External Cause
collected on Iu-Interface Code that trigger
abnormal call release on
Iu-Iinterface
Message direction on uDir Message direction on
Iu-Interface Iu-Interface
Message initiated call uMsg Latest logged message
release on Iu-Iinterface that initiate abnormal
call release on
Iu-Interface
Global route number for uRop Global route number
Iu-Interface over which message is
received on Iu-Interface
EOS codes Eos Latest EOS codes
EOS codes to be shown
are selected out of a
predefined list.
(1) The SI abbreviation is used as title for each SI in the graphical representation.
(1)
SI Name SI Abbreviation SI Description
Latest Cause Code lCau External Cause
collected on Sv-interface Code that trigger
abnormal call release on
Sv-interface
Message direction on lDir Message direction on
Sv-interface Sv-interface
Message initiated call lMsg Latest logged message
release on Sv-interface that initiate abnormal
call release on
Sv-interface
Host pointer for lRep Pointer to Host Data on
Sv-interface Sv-interface
(1) The SI abbreviation is used as title for each SI in the graphical representation.
(1)
SI Name SI Abbreviation SI Description
Message initiated call siMsg Latest logged message
release on SIP-I interface that initiate abnormal
call release on SIP-I
interface
Global route number for siRop Global route number
SIP-I interface over which message
is received on SIP-I
interface
(1) The SI abbreviation is used as title for each SI in the graphical representation.
(1)
SI Name SI Abbreviation SI Description
Message initiated call siMsg Latest logged message
release on SIP-I interface that initiate abnormal
call release on SIP-
interface
Global route number for siRop Global route number
SIP-I interface over which message
is received on SIP-I
interface
(1) The SI abbreviation is used as title for each SI in the graphical representation.
Table 11 SI values
(1)
SI Abbreviation Description SI values
gDir, uDir,sDir, ssDir, SIs representing 1 = Message coming to
siDir, lDir message direction MSC
2 = Message going from
MSC
gMsg Latest message initiated 1 = BSSMAP CLEAR
abnormal call release on COMMAND
A-interface
2 = BSSMAP CLEAR
REQUEST
(2)
5 = MO DTAP
DISCONNECT
(2)
6 = MO DTAP
RELEASE
7 = MT DTAP
DISCONNECT
8 = MT DTAP RELEASE
(2)
13 = MO DTAP
RELEASE COMPLETE
14 = MT DTAP RELEASE
COMPLETE
17 = DTAP CM SERVICE
REJECT
(1)
SI Abbreviation Description SI values
uMsg Latest message initiated 3 = RANAP RELEASE
abnormal call release on COMMAND
Iu-interface
4 = RANAP RELEASE
REQUEST
(2)
9 = MO RANAP/NAS
DISCONNECT
(2)
10 = MO RANAP/NAS
RELEASE
11 = MT RANAP/NAS
DISCONNECT
12 = MT RANAP/NAS
RELEASE
(2)
15 = MO RANAP/NAS
RELEASE COMPLETE
16 = MT RANAP/NAS
RELEASE COMPLETE
18 = RANAP/NAS CM
SERVICE REJECT
lMsg Latest message initiated 26 = PS TO CS
abnormal call release on RESPONSE
Sv-interface
27= PS TO CS COMPLET
E NOTIFICATION
29 = PS TO CS CANCEL
NOTIFICATION
sMsg, ssMsg, siMsg Latest message initiated 300-399 = REDIRECTIO
abnormal call release on N MESSAGES
SIP and SIP-I interface
400-499 = CLIENT
ERROR MESSAGES
500-599 = SERVER
ERROR MESSAGES
600-699 = GLOBAL
FAILURE MESSAGES
1004 = BYE
1005 = CANCEL
(1)
SI Abbreviation Description SI values
gCau Latest Cause Code for For more information
A-Interface refer to FSA-Interface,
Section H: Base Station
System Management
Application Part,
BSSMAP Message
Formats and Coding
and FS A/Iu-Interface,
Section K: DTAP and
RANAP/NAS, Message
Formats and Coding for
Call Control and Call
Related Supplementary
Service Procedures
uCau Latest Cause Code for Iu For more information
- Interface refer to FS Iu-Interface,
Section H: Radio Access
Network Application
Part, RANAP, Message
Formats and Coding
and FS A/Iu-Interface,
Section K: DTAP and
RANAP/NAS, Message
Formats and Coding for
Call Control and Call
Related Supplementary
Service Procedures
sCau, ssCau, sICau Latest Cause Code for For more information
SIP and SIP-I interface refer to AI List of
Cause Code and
Location Information
Mappings
lCau Latest Cause Code for For more information
Sv-interface about IE Type "SRVCC
Cause" refer to FS
Sv-Interface, General
Aspects, Message
Formats and Coding
for SRVCC
(1) The SI abbreviation is used as title for each SI in the graphical representation.
(2) Under MO calls are also considered DRVCC calls and A/Iu-interface messages during and
after SRVCC procedure (For more information about SRVCC procedure refer to FSs LTE to GSM
Handover (SRVCC). LTE to WCDMA Handover (SRVCC) and PS to CS SRVCC for
Additional Call)
— A remote desktop
— The OSS
The remote desktop or the OSS are acting as a thin client display center, just for
the remote graphical representation of the SI data provided by the Data Server
via SSH tunneling.
Optionally, if Gnuplot is installed on display center data collected by CDA suite can
be displayed in forms of charts.
Up to 2000 samples of each SI (if available) are saved in a ring buffer and are
used for the calculation of the average SI value for the graphical representation in
Mean Mode. The CP responses are correlated to the sent requests in a depth of
these 2000 past requests. Responses to older requests are discarded.
If response message is not received for a polling request message, this is visible in
the graphical representation as zero values. This also applies to the restart and to
any communication failure between the CP and the Data Server.
A possible clock adjustment in the CP is not visible in the presented graph. Time
differences in such cases are visible only through the timestamps of the logged
events.
RSV Suite uses different colors for the background of the displayed graph
depending on certain events:
— Red color in case that the instant SI value exceeds a predefined upper
threshold.
RSV Suite represent these events in another tab of the main window including
the following data:
— The CP name
Only the last 86400 events, if available, can be displayed in the window.
The ‘‘RTSDV’’ function is activated by the AXE parameter SISFNC from the AXE
parameter set OMSRC. The administration of the function is performed as described
in Section 3.4.3 on page 17.
In order to be possible for node to provide SI values for the SIs requested by
RTSDV Framework Suites, the SIs must be activated through the proprietary
command RVSIS .
‘‘RTSDV’’ function is deactivated by the AXE parameter SISFNC from the AXE
parameter set OMSRC. The administration of the function is performed as described
in Section 3.4.3 on page 17.
In order to be possible for node to not provide SI values for the SIs requested by
RTSDV Framework Suites, the SIs must be deactivated through the proprietary
command RVSIR.
Administration in MSC-S
After the activation of the function in the CP, it is possible to create and
administer a socket by commands RVSOI and RVSOC. These commands enable the
communication between the CP and the Data Server. Once the socket is created,
the configured socket data can be verified through the answer printout REAL TIME
VIEW SOCKET DATA. In order the socket to become functional, it needs to be
deblocked by command RVSBE.
The following commands are part of the administration of the ‘‘RTSDV’’ function:
The activation status of an SI can be verified through the answer printout REAL
TIME VIEW USER DATA by ordering the proprietary command RVSIP.
The default DSCP value for this function is CS2 (which equals to value 16). For
more information refer to User Guide Managing IP Integration.
— IP address
— Port Number
— CP Name
— CPU Type
Additionally, the following optional information can be filled for every suite
configuration:
— Upper and lower thresholds per SI . (only applicable for RSV Suite)
In case that a graphical representation of EOS codes is also requested, the EOS
Codes configuration file can also be edited. One EOS code can be requested and
matched to a preselected set of EOS codes.
All running processes on the Data Server can be listed by ordering the command
listKill.
For more information, refer to User Guide Managing the Real-Time System Data
View.
The answer printout REAL TIME VIEW SOCKET DATA includes the following data:
— Socket Identity
— Socket State
Additionally, the following socket data can also be printed in answer printout
REAL TIME VIEW SOCKET DATA depending on optional parameters given in
command RVSOP:
— Local IP address
— Remote IP address
In case no response is received, then the log file is not updated. This also applies to
the restart and to any communication failure between the CP and the Data Server.
— [Link] automatic archive file includes the network event log files
of the week.
4 Operational Conditions
Table 12
Commands in MSC-S
RVSOI
RVSOE
RVSOC
RVSOP
RVSOR
RVSBI
RVSBE
Table 13
RSV suite commands in Data Server
startRsvtool
startRsvGui
listKill
backupDirDB
rsvShowThr
Table 14
CDA suite commands in Data Server
startCdatool
startCdaGui
listKill
backupDirDB
cdaEos
cdaCause
cdaShowLog
cdaShowRep
cdaStatNetwork
Table 15
AXE Parameters
SISFNC
Output Elements
Table 16
Printouts
REAL TIME VIEW SOCKET DATA Answer Printout
4.2 Capabilities
Capabilities for each RTSDV Framework suite:
— A history of the last 2000 samples (if available) per SI are used to calculate
the average SI value for the graphical representation in Mean Mode.
— The interval between the polling request messages has a lower limit of 10
ms and an upper limit of 86400 sec.
— Only the last 86400 events, if available, can be displayed in the window.
Glossary
AXE OSS
Public Telephone Exchange System Operations Support System
BSSMAP PS
Base Station System Management Application Packet switched
Part
RANAP
CDA Radio Access Network Application Part
Call Drop Analyzer
RSV
CP Real-time System View
Central Processor
RTSDV
CS Real-Time System Data View
Circuit switched
SI
DRVCC System Indicator
Dual Radio Voice Call Continuity
SIP
DSCP Session Initiation Protocol
Differentiated Services Code Point
SPU
DTAP Signal Processor Unit
Direct Transfer Application Part
SRVCC
EOS Single Radio Voice Call Continuity
End Of Selection
SSH
GUI Secure Shell
Graphical User Interface
TSC-S
IP Transit Switching Center Server
Internet Protocol
VM
IPU Virtual Machine
Instruction Processor Unit
UDP
MO User Datagram Protocol
Mobile Originating
MT
Mobile Terminating
MSC-S
MSC Server
Reference List
[12] Sv-Interface, General Aspects, Message Formats and Coding for SRVCC
FUNCTION SPECIFICATION