| TSP Lab | GTPCStat - PDP/Session Activation Statistics module | GTPCStat |
|---|
| Menu | Menu item | Shortcut(s) | Meaning |
|---|---|---|---|
| [File] | |||
| Load state |
| Load a previously saved memory dump | |
| Save state |
| Save the memory content into a dump file (both context and open transaction statistics memories) | |
| Reload IMSI prefix | Reload IMSI prefix - IMSI name assignment list for open transaction statistics | ||
| Reload Operator prefix | Reload IP address - operator name assignment list | ||
| Reload blacklist file | Reload APN blacklist | ||
| Reload EC file | Reload EC lists | ||
| Log counters |
| Save counters into log file | |
| Save counters |
| Save counters into CSV file | |
| Exit |
| Close the program | |
| [Tools] | |||
| Start processing |
| Enable data processing | |
| Stop processing |
| Disable processing | |
| Clear state |
| Reset internal states to initial value. | |
| Flush state |
| Send messages from internal buffers to output channels | |
| Clear counters |
| Reset counters to zero | |
| Settings |
| Set INI file settings from menu | |
| Save settings |
| Save current settings into the INI file | |
| [Help] | |||
| Help |
| Currently not used | |
| About |
| Show information about the program |
The "Log" view shows the latest log lines on the screen with their timestamps. The counters of the views are logged every quarter hour. The log level can be set through a drop-down list (Off, Normal, Detailed, Debug), the initial level is defined in the INI file. If the INI file does not exist (first-start without INI file), the default value is 'Normal'.
To search in the log entries, there is a 'Find' text-field. The 'next' button applies the text search and jumps to the next match.
Each log entry has a category, which is represented by the following icons:
Information about the operation
Warning: probably unplanned event occurred
Error: unplanned error during operationSections in views can be collapsed and expanded using the triangle button at the right up corner of the sections.
Counters in the "GTP-C Assembler proxy" section
Counters in the "GTP-C context creation statistics" section
This view shows the currently used input and output connections. Both input and output connections can be defined in INI file before starting the program,
as well as during operation.
Details of connections can be collapsed and expanded using the "expand" triangle button at the right up corner of the connections.
): opens the 'Create connection' dialogue window
): opens the list of the recently used connections
): clears the recently used connections list
): copies history to clipboard
): closes and drops the connection
(button is active when processing is disabled)
Connections of the PDP/Session Activation Statistics module
The "Terminal" provides direct access to the core logic using commands. Available commands are listed on the right. Typically used for debug purposes.
The PDP/Session Activation Statistics
Description
| Value | RAT Type | Classification |
|---|---|---|
| 1 | UTRAN | 2G/3G |
| 2 | GERAN | 2G/3G |
| 3 | WLAN | 4G |
| 4 | GAN | 2G/3G |
| 5 | HSPA Evolution | 2G/3G |
| 6 | EUTRAN (WB-E-UTRAN) | 4G |
| 7 | Virtual | 4G |
| 8 | EUTRAN-NB-IoT | 4G |
Operator identification
Operators are identified based on their MCC/MNC or IP address. The applied rules are the followings.
This list contains MCC/MNC values and the names assigned to them. They are used to identify the subscribers and the operators.
MCC is a 3 digit number and MNC is a 2 or 3 digit number.
Names defined in this list must be found on the Operator - IP list (exactly with the same spelling), as well, so the program is able to combine cases when same operator is identified based on MCC/MNC and IP address.
Some example entries of IMSIPref.cfg:
26203 GERMANY-E-PLUS 26207 GERMANY-O2 26208 GERMANY-O2 26201 GERMANY-T-MOBILE 26202 GERMANY-VODAFONE
It contains the list of IP addresses of SGSNs and the assigned operator names.
IP addresses can be defined by:
Some example entries of OpPrefIP.cfg:
61.5.207.0/28 AFGHANISTAN-AWCC 61.5.207.16/28 AFGHANISTAN-AWCC 121.58.160.0/24 AFGHANISTAN-ETISALAT 203.174.27.112/28 AFGHANISTAN-TDAC 109.234.232.0/27 ALBANIA-AMC 79.106.255.64/28 ALBANIA-EAGLE 81.26.200.0/26 ALBANIA-PLUS 79.171.51.0/28 ALBANIA-VODAFONE 79.171.51.16/28 ALBANIA-VODAFONE 79.171.51.64/29 ALBANIA-VODAFONEIf during loading this list any IP address collides with an already loaded one then it is logged and the statistics process is disabled.
This list contains pairs of IMSIPrefNames and APNs which are excluded from the statistics.
Some example entries of OpBlack.cfg:
UK-EE_GBROR eezone UK-EE_GBROR everywhere
These lists define the EC values which are appended to the statistics entries of the daily statistics files. Different values are defined for inbound and outbound cases. When the IMSI is not 21630*, then the inbound list is used, otherwise the outbound one is applied. The IMSIPrefName (inbound case) and the OpPrefName (outbound case) are used for selecting the proper EC values from the lists. If the 'Name' is not found in the corresponding list then the "*** default ***" entry is applied.
The EC lists related INI entries
Some example entries of Sga-LUcollectorCSPS_E1E2E3_inbound.ini
Note: The first character must be a comma so that the statistics file structure remains consistent.
[E1E2E3 inbound] GAMBIA-AFRICELL = ,95,9,any text *** default *** = ,80,6,text2 UKRAINE-KYIVSTAR = ,75,7,text3Some example entries of Sga-LUcollectorCSPS_E1E2E3_outbound.ini
[E1E2E3 outbound] GAMBIA-AFRICELL = ,90,9,any text *** default *** = ,88,6,textA UKRAINE-KYIVSTAR = ,82,7,textB
Statistics files contain comma separated values and are saved into CSV files in every quarter hour. GTPv0 and GTPv1 'Create PDP context' transactions are contracted while GTPv2 'Create session' transactions are counted separately.
The file names of the 15-minute statistics are the following:
Gn_2G3G_YYYYMMDD_hhmm.csv Gn_4G_YYYYMMDD_hhmm.csvDate and time indicate the beginning of the statistics period.
The structure of 15-minute statistics file is the following:
Time(GMT), IMSIPrefCode, IMSIPrefName, OpPrefName, APN, Total, CG0, CG1, CG2, CG3, CG4, CG5, CG6, CG7, CG8, CG9, CGX, TO, CPDPOK, Per, IMSIOK
07:00, 21630, MT, Germany-D1, INT, 25, 1, 2, 0, 0, 0, 0, 0, 0, 0, 0, 1, 10, 11, 44.0, 10
07:00, 49885, Germany-D1, MT, BB, 30, 2, 6, 10, 2, 0, 0, 0, 0, 0, 0, 27, 1, 2, 6.7, 2
07:00, 49875, Germany-D2, MT, BB, 40, 3, 5, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 30, 75.0, 30
Fields of 15-minute statistics file:
When an IMSI, an MCC/MNC or an IP address cannot be found in the corresponding list then the IMSIPrefName or the OpPrefName field would be "unknown" and this case is logged:
"Missing prefix from imsipref table (IMSI): 21630123456789012345", "Missing prefix from imsipref table (MCC/MNC): 21630", "Missing prefix from oprefip table: 192.168.100.100", respectively, with the value.
When during the MCC/MNC based operator identification an operator is found in the IMSI prefix list with its MCC/MNC but not found in IP address list an error message will appear:
"Missing prefix from oprefip table for MCC/MNC: 21630" and the OpPrefName field will be "unknown".
Statistics files contain comma separated values and are saved into CSV files in every day. GTPv0 and GTPv1 'Create PDP context' transactions are contracted while GTPv2 'Create session' transactions are counted separately.
The file names of the daily statistics are the following:
Gn_2G3G_Day_YYYYMMDD.csv Gn_4G_Day_YYYYMMDD.csvDate indicates the beginning of the statistics period.
The structure of daily statistics file is the following:
IMSIPrefName, OpPrefName, APN, Total, CG0, CG1, CG2, CG3, CG4, CG5, CG6, CG7, CG8, CG9, CGX, TO, CPDPOK, Per, IMSIOK, EC1, EC2, EC3
MT, Germany-D1, INT, 25, 1, 2, 0, 0, 0, 0, 0, 0, 0, 0, 1, 10, 11, 44.0, 10, 45, 45, 45
Germany-D1, MT, BB, 30, 2, 6, 10, 2, 0, 0, 0, 0, 0, 0, 27, 1, 2, 6.7, 2, 45, 45, 45
Germany-D2, MT, BB, 40, 3, 5, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 30, 75.0, 30, 45, 45, 45
Fields of daily statistics file:
When an IMSI, an MCC/MNC or an IP address cannot be found in the corresponding list then the IMSIPrefName or the OpPrefName field would be "unknown" and this case is logged:
"Missing prefix from imsipref table (IMSI): 21630123456789012345", "Missing prefix from imsipref table (MCC/MNC): 21630", "Missing prefix from oprefip table: 192.168.100.100", respectively, with the value.
When during the MCC/MNC based operator identification an operator is found in the IMSI prefix list with its MCC/MNC but not found in IP address list an error message will appear:
"Missing prefix from oprefip table for MCC/MNC: 21630" and the OpPrefName field will be "unknown".
Those 'Create PDP context' and 'Create session' transactions which are unsuccessful due to timing out are listed into a separate CSV file. These lists are generated for each day.
Timeout_YYYYMMDD.csvDate indicates the beginning of the statistics period.
The structure of timed out transaction list:
Date&Time, SeqNum, IMSI, IMSIPrefName, IPAddr_src, OPName_src, IPAddr_dst, OPName_dst, APN
2015.04.01 23:43:55.386, 16533, 234330303588888, UK-EE_GBROR, 212.051.099.130, HUNGARY-T-MOBILE, 149.254.005.176, UK-EE_GBRME, everywhere
2015.04.01 23:44:13.209, 2985, 234330425634343, UK-EE_GBROR, 212.051.099.130, HUNGARY-T-MOBILE, 149.254.005.176, UK-EE_GBRME, everywhere
Fields of timed out transaction list:
| Section | Entry | Example | Meaning |
|---|---|---|---|
| [Log] | |||
| LogFilesPath | d:\LogFiles | Path of the log files | |
| LogDetailLevel | 1 | Log detail level at startup: 0: Off 1: Normal 2: Detailed 3: Debug | |
| [Counters] | |||
| ClearOnWrite | false | Clear counters after history file written | |
| HistoryFile | D:\LogFiles\GTPCStat.csv | The path of the counter history file | |
| HistoryPeriod | 15 | The counter history file writing period in minutes | |
| [Input] | |||
| RestoreChannels | true | Restores the active channels after restart | |
| SortingQueueDelay | 0 | The sorting queue delay in milliseconds | |
| SortingQueueLength | 0 | The maximum size of the sorting queue | |
| StoragePointerFilePath | D:\DataFiles-7700 | Path for optional storage pointer files (Sga-7700.xxx), if MUFI2 input is used | |
| SynchronizedIO | false | The input and the output channels will be synchronized | |
| GTPAssembler_socket | socket-adg://127.0.0.1:17002?listen=1 | Definition of the listening TCP socket for incoming connection from GTP-C Assembler module | |
| [Output] | Output connection is not used in this application | ||
| RestoreChannels | false | Restores the active channels after restart | |
| SortingQueueDelay | 0 | The sorting queue delay in milliseconds | |
| SortingQueueLength | 0 | The maximum size of the sorting queue | |
| output_connection_name | output_connection_specification | Definition of the output connection | |
| [GTPCStat] | |||
| APNBlackListFile | opblack.cfg | Path and file name for the APN blacklist file containing APNs to exclude from the context creation success statistics | |
| Caption | Gw2 | The given text will appear in the title bar of the program window | |
| DailyStatInterval | 1440 | The interval of the daily statistics in minutes | |
| ECInboundFile | e:\GTP-CDR\Sga-LUcollectorCSPS_E1E2E3_inbound.ini | Path and file name for inbound EC list file | |
| ECInboundSection | E1E2E3 inbound | Defines the section name for inbound EC list within the EC1EC2EC3file_Inbound file | |
| ECOutboundFile | e:\GTP-CDR\Sga-LUcollectorCSPS_E1E2E3_outbound.ini | Path and file name for outbound EC list file | |
| ECOutboundSection | E1E2E3 outbound | Defines the section name for outbound EC list within the EC1EC2EC3file_Outbound file | |
| IMSIPrefFile | imsipref.cfg | Path and file name for the IMSI prefix file (IMSI codes/ranges and IMSI names) | |
| OpPrefIPFile | opprefip.cfg | Path and file name for the operator - IP address file (IP addresses/ranges/subnets and operator names) | |
| StatDelimiter | , | The delimiter used to separate values in the output files | |
| StatisticsDir | e:\GTP-CDR\StatFiles | Path for the output statistics file. If this entry is not set or left out then the PDP activation statistics feature of disabled. | |
| TimeoutDir | e:\GTP-CDR\StatFiles_TO | Path and file name for the list of the timed out create transactions. If this entry is not set or left out then the timed out transaction list feature of disabled. | |
| TransactionTimeout | 40 | The transaction timeout applied in GTP-C assembler in seconds | |
| [CauseGroups] | |||
| CauseGroup0..9 | v0:209, v0:220, v1:209, v1:220, v2:92-96 | List of cause values to be counted into the same group. Format: GroupName = (<version>:<cause value> | <version>:<cause value from>-<cause value to>) | |
| [State] | |||
| AutoStart | true | Initial state of data processing. Possible values: true|false. | |
| StateFile | GTPStat.state | The path of the state file | |
| [RemoteUI] | |||
| TCPHost | 10.111.122.135 | Local IP address for command interface | |
| TCPPort | 16002 | Local TCP port for command interface |