summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPiotr Marcinkiewicz <piotr.marcinkiewicz@nokia.com>2021-02-05 09:19:22 +0100
committerPiotr Marcinkiewicz <piotr.marcinkiewicz@nokia.com>2021-02-11 14:56:04 +0100
commit422efeddaa3a4d64862cbccff87d3f632b0a8e6c (patch)
treedc76e1d01f8d8a9f6bbae8fde1833cb2dbc64c1c
parent6132c206cc4a64df2248647326d569393605cf90 (diff)
Add PM-Mapper files processing config description
Issue-ID: DCAEGEN2-2600 Signed-off-by: Piotr Marcinkiewicz <piotr.marcinkiewicz@nokia.com> Change-Id: I2ed21cee5ffe43e4d59492d7a9d003aef0e0265b
-rw-r--r--docs/sections/services/pm-mapper/configuration.rst38
1 files changed, 38 insertions, 0 deletions
diff --git a/docs/sections/services/pm-mapper/configuration.rst b/docs/sections/services/pm-mapper/configuration.rst
index c699a35b..df7423a5 100644
--- a/docs/sections/services/pm-mapper/configuration.rst
+++ b/docs/sections/services/pm-mapper/configuration.rst
@@ -4,6 +4,44 @@
Configuration and Performance
=============================
+Files Processing Configuration
+""""""""""""""""""""""""""""""
+The PM Mapper consumes the 3GPP XML files from DMaaP-DR, and processes them. It is possible to process it in parallel.
+In order to parallel processing, new configuration env has been introduced:
+
+- PROCESSING_LIMIT_RATE (optional, default value: 1) - allows to limit the rate of processing files through channel.
+
+- THREADS_MULTIPLIER (optional, default value: 1) - allows to specify multiplier to calculate the amount of threads.
+
+- PROCESSING_THREADS_COUNT (optional, default value: number of threads available to JVM) - allows to specify number of threads that will be used for files processing.
+
+
+Envs should be specified in section "envs:" in blueprint. Example part of blueprint configuration:
+
+::
+
+ ...
+ pm-mapper:
+ type: dcae.nodes.ContainerizedServiceComponentUsingDmaap
+ interfaces:
+ cloudify.interfaces.lifecycle:
+ create:
+ inputs:
+ ports:
+ - '8443:0'
+ - '8081:0'
+ envs:
+ PROCESSING_LIMIT_RATE: "1"
+ THREADS_MULTIPLIER: "2"
+ PROCESSING_THREADS_COUNT: "3"
+ relationships:
+ - type: dcaegen2.relationships.subscribe_to_files
+ target: pm-feed
+ - type: dcaegen2.relationships.publish_events
+ target: pm-topic
+ ...
+
+
PM Mapper Filtering
"""""""""""""""""""
The PM Mapper performs data reduction, by filtering the PM telemetry data it receives.