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) 2023 Nordix
14 The task of the PM File Converter is to convert PM Measurement report files,
15 (XML formatted according to 3GPP TS 32.432 and 3GPP TS 32.435) into Json.
17 The component receives objects from kafka that indicates that new PM Report files
18 are collected from the RAN. The event is sent by the Data File Collector.
20 The XML file is read from the storage, converted to Json, gzipped and stored.
22 A Json object indicating that a new Json PM Measurement report is available is sent on
23 a Kafka topic to be picked up by other components for further processing,
25 .. image:: ./Architecture.png
30 This product is a part of :doc:`NONRTRIC <nonrtric:index>`.
38 The Json format of the PM measurement follows the same structure as the input XML format (defined by 3GPP).
40 Here follows an example:
42 .. code-block:: javascript
48 "eventId":"9efa1210-f285-455f-9c6a-3a659b1f1882",
49 "eventName":"perf3gpp_gnb-Ericsson_pmMeasResult",
50 "sourceName":"O-DU-1122",
51 "reportingEntityName":"",
52 "startEpochMicrosec":951912000000,
53 "lastEpochMicrosec":951912900000,
54 "timeZoneOffset":"+00:00"
57 "perf3gppFieldsVersion":"1.0",
58 "measDataCollection":{
59 "granularityPeriod":900,
60 "measuredEntityUserName":"RNC Telecomville",
61 "measuredEntityDn":"SubNetwork=CountryNN,MeContext=MEC-Gbg-1,ManagedElement=RNC-Gbg-1",
62 "measuredEntitySoftwareVersion":"",
66 "sMeasInfoId":"PM=1,PmGroup=NRCellDU_GNBDU"
70 "succImmediateAssignProcs"
75 "measObjInstId":"RncFunction=RF-1,UtranCell=Gbg-997",
76 "suspectFlag":"false",
85 "measObjInstId":"RncFunction=RF-1,UtranCell=Gbg-998",
86 "suspectFlag":"false",
95 "measObjInstId":"RncFunction=RF-1,UtranCell=Gbg-999",
113 *************************
114 Output File Ready Message
115 *************************
117 Here follows an example of the sent object indicating that a new Json file is available.
118 It only contains the name of the stored file. The name of the bucket and the minio endpoint
119 must be known by the event receiver.
121 .. code-block:: javascript
124 "filename": "xyz.json.gzip"
128 ************************
129 Input File Ready Message
130 ************************
132 Below follows an example of an input File Ready Message. The
133 message is sent by the Data File Collector. The only elements used by this component are sourceName, name and
136 .. code-block:: javascript
139 "productName":"RnNode",
140 "vendorName":"Ericsson",
141 "lastEpochMicrosec":151983,
142 "sourceName":"5GRAN_DU",
143 "startEpochMicrosec":15198378,
144 "timeZoneOffset":"UTC+05:00",
145 "compression":"gzip",
146 "fileFormatType":"org.3GPP.32.435#measCollec",
147 "fileFormatVersion":"V10",
148 "name":"5GRAN_DU/A20220418.1900-1915_seliitdus00487.xml",
149 "changeIdentifier":"PM_MEAS_FILES",
150 "objectStoreBucket":"ropfiles"