1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. SPDX-License-Identifier: CC-BY-4.0
3 .. Copyright (C) 2019 AT&T
6 RIC Measurement Campaign (MC) Overview
7 =======================================
10 5G EN-DC Measurement and KPI Computation xApp
11 Developed by Rajarajan Sivaraj, Theodore Johnson, Vladislav Shkapenyuk
12 Additional Credits: Matti Hiltunen, Gueyoung Jung, Scott Daniels
14 ---------------------------------
16 MC xApp calculates a number of metrics and KPIs based on X2 messages formatted as protobufs as defined in ric-plt/streaming-protobufs.
18 In the MC xApp, we compute 5G KPIs at customized fine-grained granularities in the following manner:
19 - On a per-UE per-bearer basis
22 - On an NR cell-wide basis
23 - On an NR gNB-wide basis
25 We identify individual UEs across multiple EN-DC sessions by the s1-UL-GTPtunnelEndpoint IE in 3GPP X2AP: SgNB Addition Request message, as long as they remain connected to the same eNB.
26 We identify UE groups based on (i) QCI, (ii) E-RAB-ID, (iii) (QCI, ARP) value pair, etc.
27 We identify NR cell based on the NR-PCI or the Physical Cell Identity
28 We identify the NR gNB based on the gNB ID Information Element (IE) received in the RMR X2AP streaming header
30 The key 3GPP EN-DC X2AP procedures that we handle in the MC xApp include:
35 - Secondary RAT Data Usage Report
37 The metrics are reported periodically as VES events and include metrics such as number of dual connected UEs, duration of dual connections, and signal strength metrics. For a full list of supported metrics see the readme.
39 Internally, MC xApp uses the gs-lite stream processing engine (com/gs-lite).
41 The protobufs are received as RMR messages from UEEC but if no such data producer is available, MC xApp can be run in a simulated mode where the protobuf content is generated locally by the UEEC simulator running in the same container.