Contributors:

  • Rajarajan Shivaraj (lead of metrics design)
  • Theodore Johnson
  • Vladislav Shkapenyuk
  • Gueyoung Jung
  • Scott Daniels

Summary:

MC xApp calculates a number of metrics and KPIs based on X2 messages formatted as protobufs as defined in /ric-plt/streaming-protobufs.

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.

Internally, MC xApp uses the gs-lite stream processing engine (com/gs-lite).

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.

Click here for  Detailed documentation

  • No labels

4 Comments

  1. Rakesh Mhapsekar

    Can you pls. elaborate on "Signal strength metrics"? whether the metrics will be captured from UE or small cells?

    1. Rajarajan Sivaraj

      Signal strength metrics talk about the RSRP (mandatory), RSRQ and SINR (optional) of the UEs (capable of LTE-NR Dual Connectivity or EN-DC) with respect to the mmwave NR cells of the gNBs.

      There are 2 X2AP messages which provide this information:

      1. SgNB Addition Request: This message contains the MeNB to SgNB container, which further contains the CG-ConfigInfo, which points to the "candidateCellInfoListMN" that includes "MeasResult2NR" IE - this contains the cell-specific RSRP (mandatory), RSRQ and SINR (optional) fields containing values as reported by the UE to the primary LTE master eNB (the UE reports NR cell values to the LTE master eNB as inter-RAT B1 neighbors in this message).
      2. RRCTransfer: This message contains the NR RRC Container, embedded inside the id-UENRMeasurement IE, which includes the UL-DCCH message with NR RRC measurements reported by the UE to the LTE eNB. This IE is called "MeasurementReport" containing "MeasResults", which further contains "measResultServingMOList" and "measResultNeighcells" - these 2 fields contain signal strength measurement reports of the UE (again, mandatory RSRP and optional RSRQ/SINR) w.r.t the serving NR cell and neighbor NR cells.

      Hence, these are measurements reported by the UE to the master eNB, and then forwarded to the SgNB from the master eNB over X2AP. With E2AP being envisioned as an extension of X2AP, the RIC gets access to these measurements by interfacing with the gNB over E2. 

  2. Kamil Kociszewski

    hi,
    do someone meet problem during onboard like me and solve it?

    root@nr-ric:~/dep/xapps/ric-app-mc/xapp-descriptor# dms_cli onboard config.json ~/dep/xapps/embedded-schema.json
    2021-10-04 09:37:32,492 - DEBUG - '/playpen/bin/container_start.sh' is not of type 'array' - xapp_onboarder.api.onboard
    {
    "error_message": "'/playpen/bin/container_start.sh' is not of type 'array'",
    "error_source": "config-file.json",
    "status": "Input payload validation failed"
    }

    1. setare alagheband

      I think you can solve it by using [] on both side of the line "/playpen/bin/container_start.sh"

      for me it works.