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 |
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.
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
Select the Number of Actions. Available in the RIC Node test case. Range : 1 to 16 Default : 1 Tcl Parameters: E2smKpmSubNumActs_1
Actions
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 |
The measurements models for E2SM-KPM service model support. The measurements are grouped into the following measurement object classes.
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 |
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 |