YateeNB KPI-related measurements

From YateBTS
(Redirected from KPI-related measurements)
Jump to: navigation, search

This page describes KPI-related measurements implemented in the Legba Yate-based eNodeB.

"KPI-Related Measurements" vs. Actual KPIs

As per the standard, the eNodeB does not produce KPIs directly, but instead produces measurements that can be used to compute KPIs for different sets of eNodeBs.

  • 3GPP 32.425 describes the standard performance measurements made by an eNodeB.
  • 3GPP 32.450 describes the standard KPIs that are computed from the eNodeB measurements.

The calculation of KPIs from raw measurements is normally done by a "middleware" called an Element Manager.

Standard and Vendor-Specific Measurements

Beyond standard measurements specified by 3GPP, vendors are also free to add their own measurements to the eNodeB.

In the Legba implementation, vendor-specific measurements are put into the same measurement groups with the standard measurements and follow a similar naming scheme.

In this documentation, you can tell standard measurements from vendor-specific measurements because the descriptions of standard measurements reference the specifications that define them.

Accessing Measurements

  1. Locally - via Telnet/Rmanager: Measurements are accessed locally via rmanager with the "enb measurements" command or with "status enb". See YateeNB commands for details.
  2. Remotely - via JSON): Yate provides a JSON/HTTP interface for remote monitoring, which is also based on the status enb command. See this page for more information.

Time Period Covered By Measurements

The ENB measurement system is cleared with enb measurements clear or with the clear option on the status enb command.

This clearing begins a new measurement period which continues until the next clearing.

When measurements are reported with enb measurements> or status enb, the report includes the Unix time that the measurement period started ("LastClearTime") and the current Unix time ("CurrentTime").

These times are the last items given in the report.

Measurement Definitions

RRC connection related measurements ("RRC")

Measurements in this group track the reliability of RRC connections.

As of Dec 2017, YateeNB does not implement most of the measurements in this group.

Name Description
RRC.ConnMean Mean number of active RRC connections.
See 3GPP 32.425 Section 4.1.3.1.
RRC.ConnMax Maximum number of active RRC conections.
See 3GPP 32.425 Section 4.1.3.2.

E-RAB related measurements ("ERAB")

An "E-RAB" is the combination of a DRB in the ENB and the corresponding S1 bearer in the EPC. Measurements in this group track E-RAB reliability.


Name Description
ERAB.EstabInitAttNbr.<qci>
ERAB.EstabInitAttNbr.sum
Total number of initial E-RAB UE establishment attempts.
See 3GPP 32.425 Section 4.2.1.1.
ERAB.EstabInitSuccNbr.<qci>
ERAB.EstabInitSuccNbr.sum
Number of successful initial E-RAB UE establishment attempts.
See 3GPP 32.425 Section 4.2.1.2.
ERAB.EstabAddSuccNbr.<qci>
ERAB.EstabAddSuccNbr.sum
Number of successful additional E-RAB UE establishment attempts.
See 3GPP 32.425 Section 4.2.1.5.
ERAB.SessionTimeUE Total UE session time in seconds.
See 3GPP 32.425 Section 4.2.4.1.
ERAB.SessionTimeQCI.<qci>
ERAB.SessionTimeQCI.sum
E-RAB session times in seconds.
See 3GPP 32.425 Section 4.2.4.2.
ERAB.UsageNbrMean.<qci>
ERAB.UsageNbrMean.sum
Average number of active E-RABs.
See 3GPP 32.425 Section 4.2.5.1.
ERAB.UsageNbrMax.<qci>
ERAB.UsageNbrMax.sum
Maximum number of active E-RABs.
See 3GPP 32.425. Section 4.2.5.2.

Handover related measurements ("HO")

As of December 2017, YateeNB does not support handover and does not produce measurements in this group.

Cell level radio bearer QoS related measurements ("DRB")

This group measures performance in the RLC and PDCP layers.

Many parameters in this group are tracked per-QCI.

Name Description
DRB.PdcpSduBitrateDl.<qci>
DRB.PdcpSduBitrateDl.sum
DRB.PdcpSduBitrateDl.max
DL bit rate in kbit/sec.
See 3GPP Section 4.4.1.1.
DRB.PdcpSduBitrateUl.<qci>
DRB.PdcpSduBitrateUl.sum
DRB.PdcpSduBitrateUl.max
UL bit rate in kbit/sec.
See 3GPP Section 4.4.1.2.
DRB.PdcpSduDelayDl.<qci>
DRB.PdcpSduDelay.sum
Delay on DL from PDCP to transmission in ms.
See 3GPP Section 4.4.3.1.
DRB.PdcpSduDropRateDl.<qci>
DRB.PdcpSduDropRateDl.sum
See 3GPP Section 4.4.3.2.
DRB.PdcpSduAirLossRateDl.<qci>
DRB.PdcpSduAirLossRateDl.sum
See 3GPP Section 4.4.4.1.
DRB.PdcpSduLossRateUl.<qci>
DRB.PdcpSduLossRateUl.sum
UL packet loss rate in percent x100.
See 3GPP Section 4.4.4.2.
DRB.IPLatDl.<qci> See 3GPP Section 4.4.5.1.
DRB.IPThpDl.<qci>
DRB.IPThpDl.sum
See 3GPP Section 4.4.6.1.
The sum is a vendor-specific addition.
DRB.IPThpUl.<qci>
DRB.IPThpUl.sum
See 3GPP Section 4.4.6.2.
The sum is a vendor-specific addition.
DRB.UEActiveDl.sum
DRB.UEActiveUl.sum
See 3GPP 32.425 Section 4.4.2.
DRB.RlcDlStatusPdus
DRB.RlcDlPdus.AM
DRB.RlcDlPdus.UM
DRB.RlcDlPdus.TM
DRB.RlcDlPdus.sum
Number of RLC PDUs sent on DL.
DRB.RlcDlStatusBytes
DRB.RlcDlBytes.AM
DRB.RlcDlBytes.UM
DRB.RlcDlBytes.TM
DRB.RlcDlBytes.sum
Number of bytes sent on RLC in DL.
DRB.RlcDlSdus
Number of DL SDUs and DL SDU bytes consumed from by RLC from PDCP.
DRB.RlcDlRtx
DRB.RlcDlRtxBytes
Number of DL PDUs and DL PDU bytes retransmitted by RLC.
DRB.RlcUlSdus
DRB.RlcUlSduBytes
Number of SDUs and SDU bytes produced by UL RLC into PDCP.
DRB.RlcUlPdus
DRB.RlcUlPduBytes
Number of PDUs and number of bytes received in UL by RLC, not counting rejected PDUs.
DRB.RlcUlNacks Number of UL RLC PDUs for which RLC generated a NACK.
DRB.RlcUlRtxBytes Number of bytes retransmitted in UL by RLC.
DRB.RlcUlPdusRejected
DRB.RlcUlPdusRejectedBtes
Number of UL PDUs received and rejected by RLC and the number of bytes in those rejected PDUs.
These are usually RLC PDUs with duplicated sequence numbers.
DRB.PdcpDlSdus
DRB.PdcpDlSduBytes
Number of DL PDCP PDUs and the number of bytes in those PDUs, delivered from PDCP to RLC in DL.
DRB.PdcpDlSdusDropped
DRB.PdcpDlSduBytesDropped
Number of DL PDCP SDUs that were dropped and the number of bytes in those SDUs.
These are usually dropped due to excessive delay in the DL.
DRB.PdcpUlSdus
DRB.PdcpUlSduBytes
Number of UL PDCP PDUs and the number of bytes in those PDUs, delivered from RLC to PDCP in UL.
DRB.PdcpUlSdusDropped Number of UL PDCP SDUs that were dropped in the UE.
These are usually dropped due to excessive delay in the UL.

Radio resource utilization related measurements ("RRU" and "TB")

"RRU" Group

Name Description
RRU.PrbTotDl Total PRBs scheduled by the MAC in DL.
See 3GPP 32.425 Section 4.5.3.
RRU.PrbTotUl Total PRBs scheduled by the MAC in UL.
See 3GPP 32.425 Section 4.5.4.
RRU.RachPreambleAMean Total number of PRACH preambles from set "A".
See 3GPP 32.425 Section 4.5.5.1.
RRU.RachAccessDelay.Bin<index>
RRU.RachAccessDelayAvg
PRACH delays in TAC units.
One TAC unit is 0.52 microseconds.
See 3GPP 32.425 Section 4.5.5.3.
RRU.RachDedicatedPreamblesAssigned Percentage of PRACH subframes (x100) when all available PRACH preambles are in use.
See 3GPP 32.425 Section 4.5.5.6.
RRU.PrbCongestionDl Percentage of subframes (x100) when all DL PRBs are allocated. See 3Gpp 32.425 4.5.9.1.
RRU.PrbCongestionUl Percentage of subframes (x100) when all UL PRBs are allocated. See 3Gpp 32.425 4.5.9.2.
RRU.RachRx Total number of PRACH events detected.
RRU.RachMsg3Rx Total number of msg3 events detected.
RRU.PdcchCongestion Percentage of subframes (x100) where DCIs were dropped due to congestion in PDCCH.
RRU.PucchSnr PUCCH SNR in dB.
RRU.PucchRssi PUCCH RSSI in dB relative to receiver saturation.
RRU.PuschSnr PUSCH SNR in dB.
RRU.PuschRssi PUSCH RSSI in dB relative to receiver saturation.
RRU.UlMcs.<mcs>
RRU.UlMcsAvg
MCS values used in UL.
RRU.DlMcs.<mcs>
RRU.DlMcsAvg
MCS values used in DL.

"TB" Group

Uplink sideː

Name Description
TB.TotNbrUl
TB.TotNbrUlBytes
Total number of TBs received, not including HARQ RTX.
See 3GPP 32.425 Section 4.5.7.3.
"Bytes" count is vendor-specific addition.
TB.ErrNbrUl
TB.ErrNbrUlBytes
Total number of TBs failing CRC check, not including HARQ RTX.
See 3GPP 32.425 Section 4.5.7.4.
"Bytes" count is vendor-specific addition.
TB.TotNbrUlSched
TB.TotNbrUlSchedBytes
Total number of TBs scheduled in UL and total bytes carried in those TBs, including HARQ RTX and decoding failures.
TB.PuschUlFer Average TB decode failure rate on PUSCH, including HARQ RTX.
TB.HarqUlRtx
TB.HarqUlRtxBytes
Total number of TB used for HARQ RTX and bytes carried.
TB.MacUlMces Total number of MAC Control Elements received in UL.
TB.MacUlPdus
TB.MacUlPduBytes
Total number of MAC UL PDUs received and total bytes carried.
TB.MacUlSdus
TB.MacUlSduBytes
Total number of MAC UL SDUs (RLC PDUs) received and total bytes carried.
TB.UlEmptyBsr Count of UL "long" BSRs reporting zero bytes.
TB.PhyTotalUlBytes Total number of bytes received from PHY, including MAC MCEs, padding, and HARQ RTX.
TB.DroppedNbrUl Count of UL TBs that were scheduled but not decoded due to late processing.


Downlink sideː

Name Description
TB.TotNbrDl
TB.TotNbrDlBytes
Total number of TBs sent on DL, not counting HARQ RTX.
See 3GPP 32.425 Section 4.5.7.2.
Bytes count is vendor-specific addition.
TB.UnansweredDlHarq Total number of DL TBs for which no HARQ feedback was received.
TB.PucchNackConf HARQ feedback confidence, the percent (x100) of PDSCH TBs where the ENB received HARQ feedback.
TB.ErrNbrDl Total number of DL TBs for which UE reported HARQ NACK, not including HARQ RTX.
TB.AllNacksDl
TB.AllAcksDl
Total counts of HARQ ACKs and NACKs for TBs sent on PDSCH.
TB.HarqDlRtx
TB.HarqDlRtxBytes
Total count of DL HARQ RTX TBs and the bytes carried in those TBs.
TB.MacDlMces Total count of MAC MCEs sent on DL.
TB.MacDlPdus
TB.MacDlPduBytes
Total number of MAC PDUs (TBs) scheduled on DL PDSCH and the bytes carried in those PDUs.
TB.MacDlSdus
TB.MacDlSduBytes
Total number of MAC SDUs (RLC PDUs) scheduled on DL PDSCH and the bytes carried in those PDUs.
TB.PhyTotalDlBytes Total number of bytes sent on PDSCH, including MAC MCEs and HARQ RTX.
TB.DroppedNbrDl Count of DL TBs that were scheduled but not transmitted due to late processing.

UE-associated logical S1-connection related measurements ("S1SIG")

Measurements in this group track the reliability of UE connections in S1AP.

Name Description
S1SIG.ConnEstabAtt Number of S1AP connection attempts.
See 3GPP 32.425 Section 4.6.1.1.
S1SIG.ConnEstabSucc Number of successful S1AP connections.
See 3GPP 32.425 Section 4.6.1.2.

Paging related measurements ("PAG")

Measurements in this group track the reliability of paging operations.

Name Description
PAG.ReceivedNbr Number of paging messages received by the eNodeB.
See 3GPP 32.425 Section 4.7.1.1.
PAG.DiscardedNbr Number of paging messages dropped without transmission by the eNodeB.
See 3GPP 32.425 Section 4.7.1.2.

Measurements related to equipment resources ("EQPT")

Measurements in this group track the health and status of hardware.

The standard measurements in this group are outside the scope of the YateeNB module.

Name Description
EQPT.LateSubframes Number of subframes dropped due to heavy CPU loaading.

Common LAs of overlapping RAT's coverage ("RRC")

As of 21 Dec 2017, YateeNB does not produce measurements in this group.

RF Measurements ("CARR")

Measurements in this group tack radio channel quality.

Name Description
CARR.WBCQIDist.Bin<cqi> Number of times each CQI was received.
See 32.425 Section 4.10.1.1.
CARR.TADist.Bin<tac> Number of times each timing advance value was used.
Values are in TAC units, 0.52 microseconds per unit.
See 32.425 Section 4.10.2.
CARR.DlCapacity Average DL capacity in bits/element.
CARR.UlCapacity Average UL capacity in bits/element.