docs/sections/services/pm-subscription-handler/overview.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3
   4 .. _Overview:
   5
   6 Overview
   7 ========
   8
   9 Introduction
  10 """"""""""""
  11 The PM Subscription Handler (PMSH) is a Python based micro service, which allows for the definition and activation
  12 of PM subscriptions on one or more network function (NF) instances.
  13
  14
  15 Functionality
  16 """""""""""""
  17 PMSH allows for the definition of subscriptions on a network level, which enables the configuration of PM data on a
  18 set of NF instances.
  19 During creation of a subscription, PM reporting configuration and a network function filter will be defined.
  20 This filter will then be used to produce a subset of NF's to which the subscription will be applied.
  21 The NF's in question must have an Active orchestration-status in A&AI.
  22 If an NF matching the filter is registered in ONAP after the microservice has been deployed, the subscription will
  23 be applied to that NF.
  24
  25 Interaction
  26 """""""""""
  27
  28 Config Binding Service
  29 ^^^^^^^^^^^^^^^^^^^^^^
  30
  31 PMSH interacts with the Config Binding Service to retrieve it's configuration information, including the
  32 subscription information.
  33
  34 DMaaP
  35 ^^^^^
  36
  37 PMSH subscribes and publishes to various DMaaP Message Router topics (See :ref:`Topics<Topics>`
  38 for more information on which topics are used).
  39
  40 A&AI
  41 ^^^^
  42
  43 PMSH interacts with A&AI to fetch data about network functions. The ``nfFilter`` is then
  44 applied to this data to produce a targeted subset of NF's.
  45
  46 Policy
  47 ^^^^^^
  48
  49 PMSH interacts indirectly with Policy via DMaaP Message Router to trigger an action on an operational policy defined
  50 by the operator. The operational policy must align with the inputs provided in the event sent from PMSH.
  51
  52 CDS
  53 ^^^
  54 The operational policy will be used to make a request to CDS, which will apply/remove the subscription to/from the NF.
  55 The CDS blue print processor will execute the action over netconf towards the NF.
  56 (See :ref:`DCAE_CL_OUTPUT_Topic<DCAE_CL_OUTPUT_Topic>` for more details)
  57
  58 Multiple CDS Blueprint support
  59 """"""""""""""""""""""""""""""
  60 When PMSH applies the nfFilter during the parsing of the NF data, it will attempt to retrieve the relevant blueprint information
  61 defined in A&AI related to that model.
  62 These are optional parameters in SDC (sdnc_model_name, sdnc_model_version), and can be defined as properties
  63 assignment inputs, then pushed to A&AI during distribution.
  64
  65 If no blueprint information is available, the NF will be skipped and no subscription event sent.
  66
  67 If successful, the sdnc_model_name and sdnc_model_version will be sent as part of the event to the policy framework as
  68 blueprintName and blueprintVersion respectively.
  69 This in turn will be sent from the operational policy towards CDS blueprint processor, to trigger the action for the relevant blueprint.