E2sm Kpm Tab


The E2SM-KPM (E2 Service Model - Key Performance Matrix) defines functionalities through E2 Control procedures within xApps.

The interface that is designed for communication between DU/CU and Near-Real Time RIC is called E2. The protocol for the communication over E2 interface is called E2AP.

The E2SM-KPM tab is available in RIC Node and RIC Nodal Test Cases. 

Spec Reference : 

 

 

RIC Nodal

RIC Node

Related Measurements

Measurements collected for E2SM related processing are reported on the E2SM Measurements tab.


 

NR Cell Measurements Test Data File

Select to add a Test Data File (TDF) for NR Cell Measurements. Each row in the file is a cell.

Available in RIC Nodal test case. Click to see the definitions for the parameters in this test file. 

NR Cell Measurements Test Data file Definition

Sample file : kpm_meas.csv

See also Applying Test Data FileApplying Test Data File

See Test Data Files for further explanation and sample files. If a sample is not found for the specific TDF, you can obtain a sample file from your Technical Support representative. You may also use the following options to select an existing TDF or create/edit TDF-CSV files (TDF-CSV Editor). 

For most TDF Parameters used for Applying Parameters, each row in the file is the overridden value for a different “Session”, aka a different UE. But some TDFs are done in other dimensions, like Bearers, eNodeBs, Subscribers (2 per UE sometimes) or even Hosts, etc. Tooltips on the TDF Parameter: 

Note that the “ID” is a unique ID. Please Provide the ID when reporting issues with a TDF. For TDFs that do not apply / override Parameters, but instead are just their own configuration or data or media files you won’t see TDF ID row details.

TIP: When including large files, please be aware of memory limitations, since the TDF Editor shares memory with the Client.

NOTE: The available TDF options vary. on the L3-7 | IPSec tab > IKE with RSA Settings you may only select the Certificate TDF from TAS (these are non-CSV TDFs).

In addition, where applicable, any rules for defining TDFs are included in specific Test Cases. (For example, In MME Node test case, see MME Node - Provisioning TDF.)

From the DMF Window, press Shift+Alt+A to display the  Save DMF as Tcl window. Click the Save to File button to save as Tcl file. See additional details on Using the Tcl API.

 

Select/Create a new TDF-CSV

Allows you to create a new TDF by entering a file name that doesn’t already exist or select an existing file by entering a file name that already exists.

Click to open the Select Existing or Create window.

  • Navigate to the relevant library/folder,

  • Enter the name of the file:

  • If the file name already exists, the file is selected and applied in the test case.

  • If the file name does not exist, a message displays that says you are creating a new TDF and the embedded TDF-CSV will be launched.

    • Click Yes to launch the TDF-CSV Editor and create/save the new TDF-CSV.

    • Click No to select a different file

NOTE: If you do not have permission to save in the selected library, an error displays when you try to create a new file.
TIP: You may also navigate to the relevant library/folder and select file, and click OK.

 

Upload a New TDF to TAS

Click to import a new TDF file from your local folder and select in the test Case (instead of having to go to TDF Admin).

  • Navigate to the file on your local folder and select.
  • Then navigate to the location (library) where you want to save it on the TAS. You may rename the file, if required.  

View Edit Selected TDF in TDF-CSV Editor

Available only when you have selected a TDF on TAS. Click to open the selected file in TDF-CSV Editor (in place, that is, within the Test Case).

Edit the file and save. You may also click Save As to save the edited TDF-CSV to a different library and also rename the file, if required.

NOTE: You may also select a TDF from a library to which you do not have write permissions, edit the file as required, and save (Save As) only to a different library with the same file name or a different name.

The only options available are Save As and Cancel.

Open Selected TDF in Standalone TDF-CSV Editor

Available only when you have selected a TDF on TAS. Select to retrieve the CSV file and open it in the stand alone TDF-CSV Editor.

Generate Stub TDF-CSV

TIP: Available only when a CSV specification has been defined for in the Test Case for the TDF widget ( View TDF Actions/Options Menu)

 

Opens an example context specific test data parametersexample context specific test data parameters, which you may save as a .CSV file or open in the TDF-CSV Editor.

 

Launch Standalone TDF-CSV Editor

Click to open a blank TDF-CSV Editor.

The Launch Standalone TDF-CSV editor options handles very large TDFs that may use too much Client memory if opened within the Test Case/in the embedded editor.  You may set the standalone TDF-CSV Editor memory high to edit large TDFs.

Tcl Parameters: E2smKpmNrCellMeasCfgFile

gNB-CU-UP Measurements Test Data File

Select to add a Test Data File (TDF) for gNB-CU-UP Measurements. Each row in the file is a cell.

Available in RIC Nodal test case. Click to see the definitions for the parameters in this test file. 

KPM gNBCUUP Measurements Test Data file Definition

Sample file : gnbcuupmeas.csv

See also Applying Test Data FileApplying Test Data File

Tcl Parameters: E2smKpmGnbCuUpMeasMeasCfgFileEn

Tcl Parameters: E2smKpmGnbCuUpMeasMeasCfgFile

Number of Subscription Details

Select the Number of Subscription Details. Available in the RIC Node test case.

Range : 1 to 16

Default : 1

Tcl Parameters: E2smKpmNumSubs

 

Subscription 

Event Trigger Style

Select the Event trigger Style.

Options : Periodic Report

Tcl Parameters: E2smKpmSubEvtTrigStyle_1

Reporting Period  

Select the Reporting period in minutes.

Options : 1, 5, 15, 30, 60

Default : 5

Tcl Parameters: E2smKpmSubRptPeriod_1

 

Select the Number of Actions. Available in the RIC Node test case.

Range : 1 to 16

Default : 1

Tcl Parameters: E2smKpmSubNumActs_1

 

Actions 

Action Type

Select the Action Type.

Options : Report

Tcl Parameters: E2smKpmSubActType_1_1

RIC Style Type

Select the RIC Stype Type. Each RIC Style Type has its own Action Definition Format, which is described below.

Options :

E2 Node Measurement, E2 Node Measurement for a single UE,

E2 Node Measurement for multiple UEs

Default : E2 Node Measurement

Tcl Parameters: E2smKpmSubActStyleType_1_1

 

Select the Number of Measurement Infos. Available in the RIC Node test case.

Range : 1 to 16

Default : 1

Tcl Parameters: E2smKpmSubActMeasInfosNum_1_1

Report details for 

E2 Node Measurement, E2 Node Measurement for a single UE, E2 Node Measurement for multiple UEs.

E2 Node Measurement :

Select the Measurement Type : Click Select for pop-up table that list the KPM Measurements types - See list of KPM Measurements in this table.

Tcl Parameters: E2smKpmSubActMeasInfoType_1_1_1

 

Select the Number of Labels

Range : 1 to 16

Default : 1

Tcl Parameters: E2smKpmSubActMeasInfoLabelsNum_1_1_1

Select the Label Name and Value.

Options for Label Name :

PLMN ID (default). Range : 6 hex characters, QoS - Range 1 to 255,

SNSSAI - Range : either 2 or 8 hex characters

Tcl Parameters: E2smKpmSubActMeasInfoLabelsValue_1_1_1

 

Select the Number of Bins for Distribution Bin X

Range : 1 to 16

Default : 1

Tcl Parameters: E2smKpmSubActMeasInfoBinXNum_1_1_1

Enter the Start Value and Value.

Range : 0 to 4294967295

Tcl Parameters: E2smKpmSubActMeasInfoBinX_1_1_1_1

 

 

 

NR Cell Measurements Test Data File Parameter Definitions : 

Each row is a NR cell.

Parameter Name Value Range Description
NRCellDU    
DRB_RlcSduTransmittedVolumeDL Int  
DRB_RlcSduTransmittedVolumeUL Int  
DRB_PerDataVolumeDLDist_1  Int  
DRB_PerDataVolumeDLDist_2 Int  
DRB_PerDataVolumeDLDist_3 Int  
DRB_PerDataVolumeDLDist_4 Int  
DRB_PerDataVolumeULDist_1 Int  
DRB_PerDataVolumeULDist_2 Int  
DRB_PerDataVolumeULDist_3 Int  
DRB_PerDataVolumeULDist_4 Int  
DRB_RlcPacketDropRateDLDist  Int  
L1M_DL-SS-RSRP Float  
L1M_DL-SS-SINR Float  
L1M_UL-SRS-RSRP Float  
DRB_AirIfDelayDl Float  
DRB_AirIfDelayDist_1 Int  
DRB_AirIfDelayDist_2 Int  
DRB_AirIfDelayDist_3 Int  
DRB_AirIfDelayDist_4 Int  
DRB_AirIfDelayUl Float  
DRB_RlcDelayUl Float  
RRU_PrbTotDl 0 <= VALUE <= 100  
RRU_PrbTotUl 0 <= VALUE <= 100  
RRU_PrbTotDlDist_1 Int  
RRU_PrbTotDlDist_2 Int  
RRU_PrbTotDlDist_3 Int  
RRU_PrbTotDlDist_4 Int  
RRU_PrbTotUlDist_1 Int  
RRU_PrbTotUlDist_2 Int  
RRU_PrbTotUlDist_3 Int  
RRU_PrbTotUlDist_4 Int  
RRU_PrbUsedDl Int  
RRU_PrbAvailDl Int  
RRU_PrbUsedUl Int  
RRU_PrbAvailUl Int  
RRU_MaxPrbUsedDl Int  
RRU_MaxPrbUsedUl Int  
RRU_PrbTotDlMimo 0 <= VALUE <= 100  
RRU_PrbTotUlMimo 0 <= VALUE <= 100  
RRU_PrbTotSdmDl 0 <= VALUE <= 100  
RRU_PrbTotSdmUl 0 <= VALUE <= 100  
DRB_UEThpDl Float  
DRB_UEThpDlDist_1 Int  
DRB_UEThpDlDist_2 Int  
DRB_UEThpDlDist_3 Int  
DRB_UEThpDlDist_4 Int  
DRB_UEThpUl Float  
DRB_UEThpUlDist_1  Int  
DRB_UEThpUlDist_2 Int  
DRB_UEThpUlDist_3  Int  
DRB_UEThpUlDist_4  Int  
DRB_UEUnresVolDl  0 <= VALUE <= 100  
DRB_UEUnresVolUl  0 <= VALUE <= 100  
DRB_MeanActiveUeDl Int  
DRB_MaxActiveUeDl Int  
DRB_MeanActiveUeUl Int  
DRB_MaxActiveUeUl Int  
DRB_RlcPacketDropRateDl  Int  
DRB_RlcSduLatencyDl Float  
DRB_RlcSduDelayDl Float  
     
NRCellCU    
DRB_PacketLossRateULDist Int  
DRB_DelayDlNgranUeDist_1 Int  
DRB_DelayDlNgranUeDist_2 Int  
DRB_DelayDlNgranUeDist_3 Int  
DRB_DelayDlNgranUeDist_4 Int  
DRB_DelayUlNgranUeDist_1 Int  
DRB_DelayUlNgranUeDist_2 Int  
DRB_DelayUlNgranUeDist_3 Int  
DRB_DelayUlNgranUeDist_4 Int  
DRB_PdcpPacketDropRateDl  Int  

 

KPM Measurements

The measurements models for E2SM-KPM service model support. The measurements are grouped into the following measurement object classes.

 NRCellDU

Measurement Name  Measurement Type Name  Distribution Measurement Bin  Subcounter Labels Measurement Type  Comments
DL Transmitted Data Volume DRB.RlcSduTransmittedVolumeDL   PLMN ID, QoS, SNSSAI Integer/int  
UL Transmitted Data Volume DRB.RlcSduTransmittedVolumeUL   PLMN ID, QoS, SNSSAI Integer/int  
Distribution of Percentage of DL Transmitted Data Volume to Incoming Data Volume DRB.PerDataVolumeDLDist Y PLMN ID, QoS, SNSSAI Integer/int If support Distribution Measurement Bin, a sequence of bin range needs to be defined for this measurement based on the specification
Distribution of Percentage of UL Transmitted Data Volume to Incoming Data Volume DRB.PerDataVolumeULDist Y PLMN ID, QoS, SNSSAI Integer/int  
Distribution of DL Packet Drop Rate DRB.RlcPacketDropRateDLDist Y QoS, SNSSAI Integer/int Only 1 bin is supported
DL Synchronization Signal based Reference Signal Received Power (SS-RSRP) L1M.DL-SS-RSRP   SSB Real/float  
DL Synchronization Signal based Signal to Noise and Interference Ratio (SS-SINR) L1M.DL-SS-SINR   SSB Real/float  
UL Sounding Reference Signal based Reference Signal Received Power (SRS-RSRP) L1M.UL-SRS-RSRP     Real/float  
Average delay DL air-interface DRB.AirIfDelayDl   PLMN ID, QoS, SNSSAI float  
Distribution of delay DL air-interface DRB.AirIfDelayDist Y PLMN ID, QoS, SNSSAI int  
Average delay UL on over-the-air interface DRB.AirIfDelayUl   PLMN ID, QoS, SNSSAI float  
Average RLC packet delay in the UL DRB.RlcDelayUl   PLMN ID, QoS, SNSSAI float  
DL Total PRB Usage RRU.PrbTotDl     int  
UL Total PRB Usage RRU.PrbTotUl     int  
Distribution of DL Total PRB Usage RRU.PrbTotDlDist Y   int  
Distribution of UL total PRB usage RRU.PrbTotUlDist Y   int  
Mean DL PRB used for data traffic RRU.PrbUsedDl   PLMN ID, QoS, SNSSAI int  
DL total available PRB RRU.PrbAvailDl     int  
Mean UL PRB used for data traffic  RRU.PrbUsedUl   PLMN ID, QoS, SNSSAI int  
UL total available PRB RRU.PrbAvailUl     int  
Peak DL PRB used for data traffic RRU.MaxPrbUsedDl   QoS, SNSSAI int  
Peak UL PRB used for data traffic  RRU.MaxPrbUsedUl   QoS, SNSSAI int  
PDSCH PRB Usage per cell for MIMO RRU.PrbTotDlMimo     int  
PUSCH PRB Usage per cell for MIMO RRU.PrbTotUlMimo     int  
SDM PDSCH PRB Usage RRU.PrbTotSdmDl     int  
SDM PUSCH PRB Usage RRU.PrbTotSdmUl     int  
Average DL UE throughput in gNB DRB.UEThpDl   PLMN ID, QoS, SNSSAI float  
Distribution of DL UE throughput in gNB DRB.UEThpDlDist Y PLMN ID, QoS, SNSSAI int  
Average UL UE throughput in gNB DRB.UEThpUl   PLMN ID, QoS, SNSSAI float  
Distribution of UL UE throughput in gNB DRB.UEThpUlDist Y PLMN ID, QoS, SNSSAI int  
Percentage of unrestricted DL UE data volume in gNB DRB.UEUnresVolDl   PLMN ID, QoS, SNSSAI int  
Percentage of unrestricted UL UE data volume in gNB DRB.UEUnresVolUl    PLMN ID, QoS, SNSSAI int  
Mean number of Active UEs in the DL per cell DRB.MeanActiveUeDl   PLMN ID, QoS, SNSSAI int  
Max number of Active UEs in the DL per cell DRB.MaxActiveUeDl   PLMN ID, QoS, SNSSAI int  
Mean number of Active UEs in the UL per cell DRB.MeanActiveUeUl   PLMN ID, QoS, SNSSAI int  
Max number of Active UEs in the UL per cell DRB.MaxActiveUeUl   QoS, SNSSAI int  
DL Packet Drop Rate in gNB-DU DRB.RlcPacketDropRateDl    QoS, SNSSAI int  
Average IP Latency DL in gNB-DU DRB.RlcSduLatencyDl   QoS, SNSSAI float  
Average delay DL in gNB-DU DRB.RlcSduDelayDl   PLMN ID, QoS, SNSSAI float  

 

NRCellCU

Measurement Name  Measurement Type Name  Distribution Measurement Bin  Subcounter Labels Measurement Type  Comments
Distribution of UL Packet Loss Rate DRB.PacketLossRateULDist Y QoS, SNSSAI Integer/int Only 1 bin is supported
Distribution of DL delay between NG-RAN and UE DRB.DelayDlNgranUeDist Y PLMN ID, QoS, SNSSAI int  
Distribution of UL delay between NG-RAN and UE DRB.DelayUlNgranUeDist Y PLMN ID, QoS, SNSSAI int  
DL PDCP SDU Drop rate in gNB-CU-UP DRB.PdcpPacketDropRateDl   QoS, SNSSAI int  

 

GNBCUUP

Class Measurement Name  Measurement Type Name  Bin Size

Subcounter

Labels 

Measurement Type 
GNBCUUP Average PDCP re-ordering delay in the UL  DRB.PdcpReordDelayUl   PLMN ID, QoS, SNSSAI float
GNBCUUP Distribution of DL delay between NG-RAN and UE DRB.DelayDlNgranUeDist 16 PLMN ID, QoS, SNSSAI integer
GNBCUUP Distribution of UL delay between NG-RAN and UE DRB.DelayUlNgranUeDist 16 PLMN ID, QoS, SNSSAI integer
GNBCUUP Average DL GTP packet delay between PSA UPF and NG-RAN GTP.DelayDlPsaUpfNgranMean   5QI, SNSSAI float
GNBCUUP Distribution of DL GTP packet delay between PSA UPF and NG-RANDL packet delay between NG-RAN and PSA UPF GTP.DelayDlPsaUpfNgranDist 16 5QI, SNSSAI integer
GNBCUUP Incoming GTP Data Packet Loss in gNB over N3 GTP.InDataPktPacketLossN3gNB   QoS, SNSSAI integer
GNBCUUP UL PDCP SDU Loss Rate DRB.PacketLossRateUl   QoS, SNSSAI integer
GNBCUUP UL F1-U Packet Loss Rate DRB.F1UPacketLossRateUl   QoS, SNSSAI integer
GNBCUUP DL PDCP SDU Drop rate in gNB-CU-UP DRB.PdcpPacketDropRateDl   QoS, SNSSAI integer
GNBCUUP Average delay DL in CU-UP DRB.PdcpSduDelayDl   PLMN ID, QoS, SNSSAI float
GNBCUUP Average delay DL on F1-U DRB.PdcpF1DelayDl   PLMN ID, QoS, SNSSAI float
GNBCUUP Distribution of delay DL in CU-UP DRB.PdcpSduDelayDlDist 16 PLMN ID, QoS, SNSSAI integer
GNBCUUP Distribution of delay DL on F1-U DRB.GtpF1DelayDlDist 16 PLMN ID, QoS, SNSSAI integer
GNBCUUP

DL PDCP PDU Data Volume

QosFlow.PdcpPduVolumeDL   PLMN ID, QoS, SNSSAI integer
GNBCUUP

UL PDCP PDU Data Volume

QosFlow.PdcpPduVolumeUl   PLMN ID, QoS, SNSSAI integer
GNBCUUP

DL PDCP SDU Data Volume

QosFlow.PdcpSduVolumeDl   PLMN ID, QoS, SNSSAI  integer
GNBCUUP

UL PDCP SDU Data Volume

QosFlow.PdcpSduVolumeUL   PLMN ID, QoS, SNSSAI  integer

^ Back to Top