summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorVijay Venkatesh Kumar <vv770d@att.com>2021-03-10 04:26:29 +0000
committerGerrit Code Review <gerrit@onap.org>2021-03-10 04:26:29 +0000
commitbcbf98beec6118acad4584d99ebef900f386690b (patch)
tree4ab9bd8a3dc11579fd5ca0e75b0ec2d9b14b824a /docs
parenta6587fb86e78e6262b8dc3d395b95375473247b1 (diff)
parentceaf6701059f7a1ac21d9ec93fc1116ea1676bd9 (diff)
Merge "Add doc for kpi-ms"
Diffstat (limited to 'docs')
-rw-r--r--docs/sections/services/kpi-computation-ms/arch.PNGbin0 -> 32610 bytes
-rw-r--r--docs/sections/services/kpi-computation-ms/blueprint-list.pngbin0 -> 55773 bytes
-rw-r--r--docs/sections/services/kpi-computation-ms/configuration.rst42
-rw-r--r--docs/sections/services/kpi-computation-ms/index.rst34
-rw-r--r--docs/sections/services/kpi-computation-ms/installation.rst95
-rw-r--r--docs/sections/services/kpi-computation-ms/kpi-log.PNGbin0 -> 179791 bytes
-rw-r--r--docs/sections/services/kpi-computation-ms/kpi_computation_ms_overview.rst126
-rw-r--r--docs/sections/services/serviceindex.rst3
8 files changed, 299 insertions, 1 deletions
diff --git a/docs/sections/services/kpi-computation-ms/arch.PNG b/docs/sections/services/kpi-computation-ms/arch.PNG
new file mode 100644
index 00000000..e6bee344
--- /dev/null
+++ b/docs/sections/services/kpi-computation-ms/arch.PNG
Binary files differ
diff --git a/docs/sections/services/kpi-computation-ms/blueprint-list.png b/docs/sections/services/kpi-computation-ms/blueprint-list.png
new file mode 100644
index 00000000..7c5875ac
--- /dev/null
+++ b/docs/sections/services/kpi-computation-ms/blueprint-list.png
Binary files differ
diff --git a/docs/sections/services/kpi-computation-ms/configuration.rst b/docs/sections/services/kpi-computation-ms/configuration.rst
new file mode 100644
index 00000000..59fe784c
--- /dev/null
+++ b/docs/sections/services/kpi-computation-ms/configuration.rst
@@ -0,0 +1,42 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+Configuration
+=============
+
+KPI Computation MS expects to be able to fetch configuration directly from consul service in following JSON format:
+
+.. code-block:: json
+ {
+ "pollingInterval": 20,
+ "aafUsername": "dcae@dcae.onap.org",
+ "streams_publishes": {
+ "kpi_topic": {
+ "type": "message-router",
+ "dmaap_info": {
+ "topic_url": "https://message-router.onap.svc.cluster.local:3905/events/unauthenticated.DCAE_KPI_OUTPUT"
+ }
+ }
+ },
+ "trust_store_pass_path": "/opt/app/kpims/etc/cert/trust.pass",
+ "cid": "kpi-cid",
+ "cg": "kpi-cg",
+ "streams_subscribes": {
+ "performance_management_topic": {
+ "aaf_password": "demo123456!",
+ "type": "message-router",
+ "dmaap_info": {
+ "topic_url": "https://message-router.onap.svc.cluster.local:3905/events/org.onap.dmaap.mr.PERFORMANCE_MEASUREMENTS"
+ },
+ "aaf_username": "dcae@dcae.onap.org"
+ }
+ },
+ "trust_store_path": "/opt/app/kpims/etc/cert/trust.jks",
+ "pollingTimeout": 60,
+ "cbsPollingInterval": 60,
+ "aafPassword": "demo123456!",
+ "kpi.policy": "{\"domain\":\"measurementsForKpi\",\"methodForKpi\":[{\"eventName\":\"perf3gpp_CORE-AMF_pmMeasResult\",\"controlLoopSchemaType\":\"SLICE\",\"policyScope\":\"resource=networkSlice;type=configuration\",\"policyName\":\"configuration.dcae.microservice.kpi-computation\",\"policyVersion\":\"v0.0.1\",\"kpis\":[{\"measType\":\"AMFRegNbr\",\"operation\":\"SUM\",\"operands\":\"RM.RegisteredSubNbrMean\"}]},{\"eventName\":\"perf3gpp_AcmeNode-Acme_pmMeasResult\",\"controlLoopSchemaType\":\"SLICE\",\"policyScope\":\"resource=networkSlice;type=configuration\",\"policyName\":\"configuration.dcae.microservice.kpi-computation\",\"policyVersion\":\"v0.0.1\",\"kpis\":[{\"measType\":\"UpstreamThr\",\"operation\":\"SUM\",\"operands\":\"GTP.InDataOctN3UPF\"},{\"measType\":\"DownstreamThr\",\"operation\":\"SUM\",\"operands\":\"GTP.OutDataOctN3UPF\"}]}]}",
+ "dmaap.server": ["message-router"]
+ }
+
+During ONAP OOM/Kubernetes deployment this configuration is created from KPI Computation MS Cloudify blueprint.
diff --git a/docs/sections/services/kpi-computation-ms/index.rst b/docs/sections/services/kpi-computation-ms/index.rst
new file mode 100644
index 00000000..fb93564b
--- /dev/null
+++ b/docs/sections/services/kpi-computation-ms/index.rst
@@ -0,0 +1,34 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+
+Kpi Computation MS
+==================
+
+.. Add or remove sections below as appropriate for the platform component.
+
+
+Kpi Computation MS overview and functions
+-----------------------------------------
+
+.. toctree::
+ :maxdepth: 1
+
+ ./kpi_computation_ms_overview.rst
+
+
+Kpi Computation MS Installation Steps
+-------------------------------------
+
+.. toctree::
+ :maxdepth: 1
+
+ ./installation.rst
+
+Kpi Computation MS Configurations
+---------------------------------
+
+.. toctree::
+ :maxdepth: 1
+
+ ./configuration.rst
diff --git a/docs/sections/services/kpi-computation-ms/installation.rst b/docs/sections/services/kpi-computation-ms/installation.rst
new file mode 100644
index 00000000..eda1ae82
--- /dev/null
+++ b/docs/sections/services/kpi-computation-ms/installation.rst
@@ -0,0 +1,95 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. _kpi-installation:
+
+
+Installation
+============
+
+Kpi Computation MS can be deployed using cloudify blueprint using bootstrap container of an existing DCAE deployment.
+
+Deployment Pre-requisites
+~~~~~~~~~~~~~~~~~~~~~~~~~
+- DCAE and DMaaP pods should be up and running.
+
+- PM mapper service should be running.
+
+- Make sure that cfy is installed and configured to work with the Cloudify deployment.
+
+
+Deployment steps
+~~~~~~~~~~~~~~~~
+Execute bash on the bootstrap Kubernetes pod.
+
+ kubectl -n onap exec -it <dcaegen2-dcae-bootstrap> bash
+
+Validate Blueprint
+------------------
+Before the blueprints uploading to Cloudify manager, the blueprints shoule be validated first through the following command.
+ .. code-block :: bash
+
+ #cfy blueprint validate /bluerints/k8s-kpi-ms.yaml
+
+Upload the Blueprint to Cloudify Manager.
+-----------------------------------------
+After validating, we can start to proceed blueprints uploading.
+ .. code-block :: bash
+
+ #cfy blueprint upload -b kpi-ms /bluerints/k8s-kpi-ms.yaml
+
+Verify Uploaded Blueprints
+--------------------------
+Using "cfy blueprint list" to verify your work.
+ .. code-block :: bash
+
+ #cfy blueprint list
+
+You can see the following returned message to show the blueprints have been correctly uploaded.
+ .. image :: ./blueprint-list.png
+
+
+Verify Plugin Versions
+----------------------
+If the version of the plugin used is different, update the blueprint import to match.
+ .. code-block :: bash
+
+ #cfy plugins list
+
+Create Deployment
+-----------------
+Here we are going to create deployments for both feeder and admin UI.
+ .. code-block :: bash
+
+ #cfy deployments create -b kpi-ms kpi-ms
+
+Launch Service
+--------------
+Next, we are going to launch the KPI-MS.
+ .. code-block :: bash
+
+ #cfy executions start -d kpi-ms install
+
+
+Verify the Deployment Result
+----------------------------
+The following command can be used to list the kpi-ms logs.
+
+ .. code-block :: bash
+
+ #kubectl logs <kpi-pod> -n onap
+
+The output should looks like.
+ .. image :: ./kpi-log.PNG
+
+Uninstall
+---------
+Uninstall running component and delete deployment
+ .. code-block :: bash
+
+ #cfy uninstall kpi-ms
+
+Delete Blueprint
+----------------
+ .. code-block :: bash
+
+ #cfy blueprints delete kpi-ms \ No newline at end of file
diff --git a/docs/sections/services/kpi-computation-ms/kpi-log.PNG b/docs/sections/services/kpi-computation-ms/kpi-log.PNG
new file mode 100644
index 00000000..e8584bc6
--- /dev/null
+++ b/docs/sections/services/kpi-computation-ms/kpi-log.PNG
Binary files differ
diff --git a/docs/sections/services/kpi-computation-ms/kpi_computation_ms_overview.rst b/docs/sections/services/kpi-computation-ms/kpi_computation_ms_overview.rst
new file mode 100644
index 00000000..9e733e0f
--- /dev/null
+++ b/docs/sections/services/kpi-computation-ms/kpi_computation_ms_overview.rst
@@ -0,0 +1,126 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+ International License. http://creativecommons.org/licenses/by/4.0
+
+.. _docs_kpi_computation_ms_overview:
+
+Introduction
+""""""""""""
+
+**Kpi Computation MS** is a software component of ONAP that does calucaltion in accordance with the formula defined dynamically. The service include the features:
+ Subscribe original PM data from DMaaP.
+ Do KPI computation based on KPI formula which can be got from config policies and the formula can be configued dynamically.
+ Publish KPI results on DMaaP.
+ Receive request for specific KPI computation (future scope) on specific ‘objects’ (e.g., S-NSSAI, Service).
+
+Architecture
+------------
+The internal architecture of Kpi Computation MS is shown below.
+
+.. image:: ./arch.PNG
+
+Functionality
+"""""""""""""
+Kpi Computation MS will do calculation based on the PM data that is VES format. publish KPI result as VES events on a DMaaP Message Router topic for consumers that prefer such data in VES format.
+Kpi Computation MS receives PM data by subscribing to a Message Router topic.
+
+Flows:
+1. KPI Computation MS will get PM data VES format from DMaaP
+2. Other modules (e.g., SO/OOF/Slice Analysis MS) can also request KPI-MS for KPI calculation (Future scope beyond H-release).
+3. KPI Computation MS will support for periodical KPI Computation. Period may be specified by a requestor optionally, if nothing is specified, KPI computation MS will continue computation until an explicit stop trigger is received.
+4. The KPI result which genertate by kpi computation will be published to DMaaP.
+
+Verification
+""""""""""""
+Publish a file to the PM-Mapper using the following example curl:
+ curl -k -X PUT https://dcae-pm-mapper:8443/delivery/<filename> -H 'X-DMAAP-DR-META:{"productName": "AcmeNode","vendorName": "Acme","lastEpochMicrosec": "1538478000000","sourceName": "oteNB5309","startEpochMicrosec": "1538478900000","timeZoneOffset": "UTC+05:00","location": "ftpes://127.0.0.1:22/ftp/rop/A20161224.1045-1100.bin.gz","compression": "gzip","fileFormatType": "org.3GPP.32.435#measCollec","fileFormatVersion": "V9"}' -H "Content-Type:application/xml" --data-binary @<filename> -H 'X-ONAP-RequestID: 12345' -H 'X-DMAAP-DR-PUBLISH-ID: 12345'
+
+Example type A file:
+ <?xml version="1.0" encoding="utf-8"?>
+ <measCollecFile xmlns="http://www.3gpp.org/ftp/specs/archive/32_series/32.435#measCollec">
+ <fileHeader dnPrefix="www.google.com" vendorName="CMCC" fileFormatVersion="32.435 V10.0">
+ <fileSender localDn="some sender name"/>
+ <measCollec beginTime="2020-06-02T12:00:00Z"/>
+ </fileHeader>
+ <measData>
+ <managedElement swVersion="r0.1" localDn="UPFMeasurement"/>
+ <measInfo measInfoId="UPFFunction0">
+ <job jobId="job10"/>
+ <granPeriod endTime="2020-06-02T12:15:00Z" duration="PT900S"/>
+ <repPeriod duration="PT900S"/>
+ <measType p="1">GTP.InDataOctN3UPF.08_010101</measType>
+ <measType p="2">GTP.OutDataOctN3UPF.08_010101</measType>
+ <measValue measObjLdn="some measObjLdn">
+ <r p="1">10</r>
+ <r p="2">20</r>
+ <suspect>false</suspect>
+ </measValue>
+ </measInfo>
+ <measInfo measInfoId="UPFFunction1">
+ <job jobId="job10"/>
+ <granPeriod endTime="2020-06-02T12:15:00Z" duration="PT900S"/>
+ <repPeriod duration="PT900S"/>
+ <measType p="1">GTP.InDataOctN3UPF.08_010101</measType>
+ <measType p="2">GTP.OutDataOctN3UPF.08_010101</measType>
+ <measValue measObjLdn="some measObjLdn">
+ <r p="1">30</r>
+ <r p="2">40</r>
+ <suspect>false</suspect>
+ </measValue>
+ </measInfo>
+ </measData>
+ <fileFooter>
+ <measCollec endTime="2020-06-02T12:15:00Z"/>
+ </fileFooter>
+ </measCollecFile>
+
+Curl the topic on Message Router to retrieve the published event:
+
+ curl -k https://message-router:3905/events/unauthenticated.DCAE_KPI_OUTPUT/$ConsumerGroup/$ID
+
+Example message output:
+ {
+ "event": {
+ "commonEventHeader": {
+ "domain": "perf3gpp",
+ "eventId": "432fa910-feed-4c64-9532-bd63201080d8",
+ "eventName": "perf3gpp_AcmeNode-Acme_pmMeasResult",
+ "lastEpochMicrosec": 1591100100000,
+ "priority": "Normal",
+ "reportingEntityName": "",
+ "sequence": 0,
+ "sourceName": "oteNB5309",
+ "startEpochMicrosec": 1591099200000,
+ "version": 4.0,
+ "vesEventListenerVersion": "7.1",
+ "timeZoneOffset": "UTC+05:00"
+ },
+ "perf3gppFields": {
+ "perf3gppFieldsVersion": "1.0",
+ "measDataCollection": {
+ "granularityPeriod": 1591100100000,
+ "measuredEntityUserName": "",
+ "measuredEntityDn": "UPFMeasurement",
+ "measuredEntitySoftwareVersion": "r0.1",
+ "measInfoList": [{
+ "measInfoId": {
+ "sMeasTypesList": "SLICE"
+ },
+ "measTypes": {
+ "sMeasTypesList": ["UpstreamThr08_010101"]
+ },
+ "measValuesList": [{
+ "suspectFlag": false,
+ "measResults": [{
+ "p": 1,
+ "sValue": "40"
+ }]
+ }]
+ }]
+ }
+ }
+ }
+ }
+
+Interaction
+"""""""""""
+Kpi Computation MS interacts with the Config Binding Service to get configuration information. \ No newline at end of file
diff --git a/docs/sections/services/serviceindex.rst b/docs/sections/services/serviceindex.rst
index 0a968c91..10c2bd1b 100644
--- a/docs/sections/services/serviceindex.rst
+++ b/docs/sections/services/serviceindex.rst
@@ -24,4 +24,5 @@ DCAE Service components
./restconf/index.rst
./tcagen2-docker/index.rst
./datalake-handler/index.rst
- ./slice-analysis-ms/index.rst \ No newline at end of file
+ ./slice-analysis-ms/index.rst
+ ./kpi-computation-ms/index.rst \ No newline at end of file