...
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
DCAE
Data Collection Diagram
Option 1 - RCC/VES Mapper
Data Collection Diagram
If the notification data is received from domain controller in non-VES format, such as, TAPI, and/or other JSON format, RCC is the data collection micro-service and VES Mapper micro-service is needed to convert the alarm notification into VES format.
RestConf Collector (RCC)
In MDONS use case, prior to subscribing to topics to get event notifications. We manually register 'DCAE' in the domain controller (DC). Once registration is successful, system can subscribe to different topics of DC to get event notification. It is mandatory to pass 'notification URL' to DC so that when event occurs it posts notification to that URL.
Jira | ||||||||
---|---|---|---|---|---|---|---|---|
|
Alarm Notification
- TAPI Alarm Notification[TAPI format]
...
Since MSA notification is already in VES format, it could be posted directly on to DMAAP with relevant topic to be consumed by Hulmes directly. If RCC does not support such configuration, then a 1n1 attribute mirroring mapping xml file need to be designed to feed the data into the existing flow. Thus, VES Mapper plays the role of VES event validation as it is required functionality in VES collector.
MS Blueprint
This is the RCC blueprint which defines the initial configuration for alarm collection in MDONS close loop. RCC supports multiple DC connections.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
rcc_policy: rcc_policy: '[{"controller_name":"VirtuoraNC","controller_restapiUrl":"167.254.204.181:8443","controller_restapiUser":"admin","controller_restapiPassword":"admin","controller_accessTokenUrl":"/rest/plat/smapp/v1/oauth/token","controller_accessTokenFile":"./etc/access-token.json","controller_accessTokenMethod":"put","controller_subsMethod":"post","controller_subscriptionUrl":"/cxf/subscriptions","controller_disableSsl":"true","event_details":[{"event_name":"MSA_Alarm_Subscription","event_description":"AlarmEvent","event_sseventUrlEmbed":"false","event_sseventsField":"null","event_sseventsUrl":"null","event_subscriptionTemplate":"./etc/MSA_Alarm_Subscription_template.json","event_unSubscriptionTemplate":"./etc/MSA_Alarm_Unsubscription_template.json","modifyData": "true","modifyMethod": "modifyMSAEvent"]}]' |
RCC_Output Event
This event is the output to be posted on Dmaap by RCC and will be consumed by VES Mapper.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "tapi-notifyid":"example-mappingfile-id.x.1", "notification": [ { "notification-type": "ALARM_EVENT", "target-object-name": [ { "value-name": "node-id", "value": "S100-NODE2" }, { "value-name": "entity-type", "value": "slot" }, { "value-name": "entity-id", "value": "Slot-1/4" } ], "source-indicator": "RESOURCE_OPERATION", "uuid": "76234954-30a2-11e9-a785-dd6c51454c4e", "event-time-stamp": "20190208220426.3Z", "additional-text": "Equipment Removed:Type=PIS1-PG31", "alarm-info": { "service-affecting": "SERVICE_AFFECTING", "probable-cause": "al-types:equipmentRemoved", "is-transient": false, "pervceived-severity": "CRITICAL" }, "additional-info": [ { "value-name": "location", "value": "NEND" }, { "value-name": "direction", "value": "NA" } ], "target-object-identifier": "S100-NODE2:slot:Slot-1/4", "name": [ { "value-name": "alarm-id", "value": "S100-NODE2slotal-types:equipmentRemovedSlot-1/4NANEND" } ] }, ... ... ] } |
VES Mapper
Mapping File
- TAPI Alarm to VES Mapping template
...
- MSA Data are already in VES format. If VES Collector supports Rest API notification mode, MDONS can use VES collector for OpenRoadM data collection from domain controller.
VES Event
Mapper output as an VES event is posted back to Dmaap.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
Option 2 - VES Colloctor
In case the domain controller acts like a VES client that can deliver the notification data in VES format, VES collector micro-service is needed and VES mapper could be skipped in the data collection flow in MDONS closed instance.
...