From 0e967e28aa53a4288006d3b27f2a8feee1e04d64 Mon Sep 17 00:00:00 2001 From: Michal Banka Date: Wed, 14 Apr 2021 09:29:35 +0200 Subject: Add stndDefined domain docs Change-Id: If61d0b649907c18e2c82ab5a6fa8617edee11e7d Signed-off-by: Michal Banka Issue-ID: DCAEGEN2-2702 --- docs/sections/apis/ves-hv/index.rst | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'docs/sections/apis/ves-hv/index.rst') diff --git a/docs/sections/apis/ves-hv/index.rst b/docs/sections/apis/ves-hv/index.rst index c3ccfa0c..c82391d4 100644 --- a/docs/sections/apis/ves-hv/index.rst +++ b/docs/sections/apis/ves-hv/index.rst @@ -41,7 +41,7 @@ Payload is binary-encoded, using Google Protocol Buffers (GPB) representation of .. literalinclude:: VesEvent.proto :language: protobuf -HV-VES makes routing decisions based mostly on the content of the **Domain** parameter in the VES Common Event Header. +HV-VES makes routing decisions based on the content of the **domain** field or **stndDefinedNamespace** field in case of stndDefined events. The PROTO file, which contains the VES CommonEventHeader, comes with a binary-type Payload (eventFields) parameter, where domain-specific data should be placed. Domain-specific data are encoded as well with GPB. A domain-specific PROTO file is required to decode the data. @@ -49,15 +49,15 @@ data should be placed. Domain-specific data are encoded as well with GPB. A doma API towards DMaaP ================= -HV-VES Collector forwards incoming messages to a particular DMaaP Kafka topic based on the domain and configuration. Every Kafka record is comprised of a key and a value. In case of HV-VES: +HV-VES Collector forwards incoming messages to a particular DMaaP Kafka topic based on the domain (or stndDefinedNamespace) and configuration. Every Kafka record is comprised of a key and a value. In case of HV-VES: - **Kafka record key** is a GPB-encoded `CommonEventHeader`. - **Kafka record value** is a GPB-encoded `VesEvent` (`CommonEventHeader` and domain-specific `eventFields`). In both cases raw bytes might be extracted using ``org.apache.kafka.common.serialization.ByteArrayDeserializer``. The resulting bytes might be further passed to ``parseFrom`` methods included in classes generated from GPB definitions. WTP is not used here - it is only used in communication between PNF/VNF and the collector. -By default, **HV-VES** will use routing defined in **k8s-hv-ves.yaml-template** in **dcaegen2/platform/blueprints project**. -Currently there is one domain->topic mapping defined: perf3gpp->HV_VES_PERF3GPP +By default, **HV-VES** will use routing defined in **k8s-hv-ves.yaml-template** in **dcaegen2/platform/blueprints project** when deployed using Cloudify. +In case of Helm deployment routing is defined in values.yaml file in HV-VES Helm Chart. .. _supported_domains: @@ -65,7 +65,10 @@ Currently there is one domain->topic mapping defined: perf3gpp->HV_VES_PERF3GPP Supported domains ================= -As for now **HV-VES** supports only **perf3gpp** domain +Domains that are currently supported by HV-VES: + +- perf3gpp - basic domain to Kafka topic mapping +- stndDefined - specific routing, when event has this domain, then stndDefinedNamespace field value is mapped to Kafka topic For domains descriptions, see :ref:`domains_supported_by_hvves` -- cgit 1.2.3-korg