summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorsteven stark <ss820f@att.com>2018-02-20 09:12:31 -0800
committersteven stark <ss820f@att.com>2018-02-20 09:14:36 -0800
commitb99190d811216df92a86e64e80b5469f680a5f37 (patch)
treeabbbcc0d246e9848241c837d0c4c791a9ec98e2b
parenta3ecd1b13cbe2c2c9406acf0357ddbbb29975c5f (diff)
VNFRQTS - doc8 trailing whitespace
Removed trailing whitespace from RSTs doc8 output: Total files scanned = 10 Total files ignored = 0 Total accumulated errors = 1429 Detailed error counts: - doc8.checks.CheckCarriageReturn = 0 - doc8.checks.CheckIndentationNoTab = 9 - doc8.checks.CheckMaxLineLength = 1388 - doc8.checks.CheckNewlineEndOfFile = 2 - doc8.checks.CheckTrailingWhitespace = 0 - doc8.checks.CheckValidity = 30 Change-Id: I4eac2c586f5afbd37c46380101f1b27e92204233 Issue-ID: VNFRQTS-139 Signed-off-by: steven stark <ss820f@att.com>
-rw-r--r--docs/Chapter4.rst2
-rw-r--r--docs/Chapter6.rst2
-rw-r--r--docs/Chapter7.rst314
3 files changed, 159 insertions, 159 deletions
diff --git a/docs/Chapter4.rst b/docs/Chapter4.rst
index 94f5269..4435eab 100644
--- a/docs/Chapter4.rst
+++ b/docs/Chapter4.rst
@@ -873,7 +873,7 @@ DevOps Requirements
* R-39650 The VNF **SHOULD** provide the ability to test incremental growth of the VNF.
* R-14853 The VNF **MUST** respond to a "move traffic" [2]_ command against a specific VNFC, moving all existing session elsewhere with minimal disruption if a VNF provides a load balancing function across multiple instances of its VNFCs. Note: Individual VNF performance aspects (e.g., move duration or disruption scope) may require further constraints.
* R-06327 The VNF **MUST** respond to a "drain VNFC" [2]_ command against a specific VNFC, preventing new session from reaching the targeted VNFC, with no disruption to active sessions on the impacted VNFC, if a VNF provides a load balancing function across multiple instances of its VNFCs. This is used to support scenarios such as proactive maintenance with no user impact.
-* R-64713 The VNF **SHOULD** support a software promotion methodology from dev/test -> pre-prod -> production in software, development & testing and operations.
+* R-64713 The VNF **SHOULD** support a software promotion methodology from dev/test -> pre-prod -> production in software, development & testing and operations.
f. VNF Develop Steps
=======================
diff --git a/docs/Chapter6.rst b/docs/Chapter6.rst
index b0fb17a..ad672b6 100644
--- a/docs/Chapter6.rst
+++ b/docs/Chapter6.rst
@@ -1,7 +1,7 @@
**6. Infrastructure Requirements**
=====================================
-This Amsterdam release of the requirements is targeted for those implementations that consist of Network Clouds: Vanilla OpenStack (based on Ocata_) and commercial Clouds for example: OpenStack (including `Titanium - Mitaka from Wind River`_ and `VIO - Ocata from VMware`_). Future versions of ONAP are envisioned to include other targeted cloud infrastructure implementations, for example, on-premise private cloud, public cloud, or hybrid cloud implementations, and related network backends, e.g. `Microsoft Azure`_ et al.
+This Amsterdam release of the requirements is targeted for those implementations that consist of Network Clouds: Vanilla OpenStack (based on Ocata_) and commercial Clouds for example: OpenStack (including `Titanium - Mitaka from Wind River`_ and `VIO - Ocata from VMware`_). Future versions of ONAP are envisioned to include other targeted cloud infrastructure implementations, for example, on-premise private cloud, public cloud, or hybrid cloud implementations, and related network backends, e.g. `Microsoft Azure`_ et al.
.. _Ocata: https://releases.openstack.org/ocata/
.. _Titanium - Mitaka from Wind River: https://www.windriver.com/products/titanium-cloud/
diff --git a/docs/Chapter7.rst b/docs/Chapter7.rst
index 38e42f2..ff2eccb 100644
--- a/docs/Chapter7.rst
+++ b/docs/Chapter7.rst
@@ -252,16 +252,16 @@ NETCONF RFCs.
VNF REST APIs
-------------
-Healthcheck is a command for which no NETCONF support exists. Therefore, this must be supported using a RESTful interface (defined in this section) or
+Healthcheck is a command for which no NETCONF support exists. Therefore, this must be supported using a RESTful interface (defined in this section) or
with a Chef cookbook/Ansible playbook (defined in sections `Chef Standards and Capabilities`_ and `Ansible Standards and Capabilities`_).
-HealthCheck Definition: The VNF level HealthCheck is a check over the entire scope of the VNF.
-The VNF must be 100% healthy, ready to take requests and provide services, with all VNF required
-capabilities ready to provide services and with all active and standby resources fully ready with
-no open MINOR, MAJOR or CRITICAL alarms. NOTE: A switch may need to be turned on, but the VNF
+HealthCheck Definition: The VNF level HealthCheck is a check over the entire scope of the VNF.
+The VNF must be 100% healthy, ready to take requests and provide services, with all VNF required
+capabilities ready to provide services and with all active and standby resources fully ready with
+no open MINOR, MAJOR or CRITICAL alarms. NOTE: A switch may need to be turned on, but the VNF
should be ready to take service requests or be already processing service requests successfully.
-The VNF must provide a REST formatted GET RPCs to support Healthcheck queries via the GET method
+The VNF must provide a REST formatted GET RPCs to support Healthcheck queries via the GET method
over HTTP(s).
The port number, url, and other authentication information is provided
@@ -408,10 +408,10 @@ Ansible Standards and Capabilities
ONAP will support configuration of VNFs via Ansible subject to the
requirements and guidelines defined in this section.
-Ansible allows agentless management of VNFs/VMs/VNFCs via execution of ‘playbooks’
-over ssh. The ‘playbooks’ are a structured set of tasks which contain all the necessary
-data and execution capabilities to take the necessary action on one or more target VMs
-(and/or VNFCs) of the VNF. ONAP will utilize the framework of an Ansible Server that
+Ansible allows agentless management of VNFs/VMs/VNFCs via execution of ‘playbooks’
+over ssh. The ‘playbooks’ are a structured set of tasks which contain all the necessary
+data and execution capabilities to take the necessary action on one or more target VMs
+(and/or VNFCs) of the VNF. ONAP will utilize the framework of an Ansible Server that
will host and run playbooks to manage VNFs that support Ansible.
**VNF Configuration via Ansible Requirements**
@@ -423,7 +423,7 @@ will host and run playbooks to manage VNFs that support Ansible.
* R-35401 The VNF **MUST** support SSH and allow SSH access to the Ansible server for the endpoint VM(s) and comply with the Network Cloud Service Provider guidelines for authentication and access.
* R-82018 The VNF **SHOULD** load the SSH key onto VNF VM(s) as part of instantiation. This will allow the Ansible Server to authenticate to perform post-instantiation configuration without manual intervention and without requiring specific VNF login IDs and passwords.
- CAUTION: For VNFs configured using Ansible, to eliminate the need for manual steps, post-instantiation and pre-configuration, to upload of SSH keys, SSH keys loaded during (heat) instantiation shall be preserved and not removed by (heat) embedded scripts.
+ CAUTION: For VNFs configured using Ansible, to eliminate the need for manual steps, post-instantiation and pre-configuration, to upload of SSH keys, SSH keys loaded during (heat) instantiation shall be preserved and not removed by (heat) embedded scripts.
* R-92866 The VNF **MUST** include as part of post-instantiation configuration done by Ansible Playbooks the removal/update of SSH keys loaded through instantiation to support Ansible. This may include download and install of new SSH keys.
* R-91745 The VNF **MUST** update the Ansible Server and other entities storing and using the SSH key for authentication when the SSH key used by Ansible is regenerated/updated.
@@ -453,38 +453,38 @@ The Ansible Server will determine if a playbook invoked to execute a VNF action
* R-43353 The VNF **MUST** return control from Ansible Playbooks only after tasks are fully complete, signaling that the playbook completed all tasks. When starting services, return control only after all services are up. This is critical for workflows where the next steps are dependent on prior tasks being fully completed.
Detailed examples:
-
+
StopApplication Playbook – StopApplication Playbook shall return control and a completion status only after VNF application is fully stopped, all processes/services stopped.
StartApplication Playbook – StartApplication Playbook shall return control and a completion status only after all VNF application services are fully up, all processes/services started and ready to provide services. NOTE: Start Playbook should not be declared complete/done after starting one or several processes that start the other processes.
-
+
HealthCheck Playbook:
-
+
SUCCESS – HealthCheck success shall be returned (return code 0) by a Playbook or Cookbook only when VNF is 100% healthy, ready to take requests and provide services, with all VNF required capabilities ready to provide services and with all active and standby resources fully ready with no open MINOR, MAJOR or CRITICAL alarms.
-
+
NOTE: In some cases, a switch may need to be turned on, but a VNF reported as healthy, should be ready to take service requests or be already processing service requests successfully.
-
+
A successful execution of a health-check playbook shall also create one file per VNF VM, named using IP address or VM name followed by “_results.txt (<hostname>_results.txt) to indicate health-check was executed and completed successfully, example: 1xx.2yy.zzz.105_results.txt, with the following contents:
-
+
"status”:"healthy”
Example:
-
+
$ cat 1xx.2yy.zzz.105_results.txt
"status”:"healthy”
-
+
FAILURE – A health check playbook shall return a non-zero return code in case VNF is not 100% healthy because one or more VNF application processes are stopped or not ready to take service requests or because critical or non-critical resources are not ready or because there are open MINOR, MAJOR or CRITICAL traps/alarms or because there are issues with the VNF that need attention even if they do not impact services provided by the VNF.
-
+
A failed health-check playbook shall also create one file per VNF VM, named using Playbook Name plus IP address or VM name, followed by “_results.txt to indicate health-check was executed and found issues in the health of the VNF. This is to differentiate from failure to run health-check playbook or tasks to verify the health of the VNF, example: 1xx.2yy.zzz.105_results.txt, with the following contents:
-
+
"status”:"unhealthy”
-
+
Example:
-
+
$ cat 1xx.2yy.zzz.105_results.txt
-
+
"status”:"unhealthy”
-
+
See `VNF REST APIs`_ for additional details on HealthCheck.
ONAP Controller / Ansible API Usage
@@ -493,16 +493,16 @@ ONAP Controller / Ansible API Usage
This section outlines the workflow that ONAP Controller invokes when it receives an action request against an Ansible managed VNF.
#. When ONAP Controller receives a request for an action for an AnsibleManaged VNF, it retrieves the corresponding template (based on **action** and **VNF**) from its database and sets necessary values (such as an Id, NodeList, and EnvParameters) from either information in the request or data obtained from other sources. This is referred to as the payload that is sent as a JSON object to the Ansible server.
- #. The ONAP Controller sends a request to the Ansible server to execute the action.
+ #. The ONAP Controller sends a request to the Ansible server to execute the action.
#. The ONAP Controller polls the Ansible Server for result (success or failure). The ONAP Controllers has a timeout value which is contained in the template. If the result is not available when the timeout is reached, the ONAP Controller stops polling and returns a timeout error to the requester. The Ansible Server continues to process the request.
ONAP Controller APIs and Behavior
---------------------------------
-ONAP Controllers such as APPC expose a northbound API to clients which offer a set of commands. The following commands are expected to be supported
-on all VNF’s if applicable, either directly (via the Netconf interface) or indirectly (via a Chef or Ansible server). There are additional commands
-offered to northbound clients that are not listed here, as these commands either act internally on the Controller itself or depend upon network cloud
+ONAP Controllers such as APPC expose a northbound API to clients which offer a set of commands. The following commands are expected to be supported
+on all VNF’s if applicable, either directly (via the Netconf interface) or indirectly (via a Chef or Ansible server). There are additional commands
+offered to northbound clients that are not listed here, as these commands either act internally on the Controller itself or depend upon network cloud
components for implementation (thus, these actions do not put any special requirement on the VNF provider).
The following table summarizes how the VNF must act in response to
@@ -609,42 +609,42 @@ Table 10. Planned ONAP Controller Functions
| QuiesceTraffic, | Quiesces traffic (stops traffic gracefully) and resume traffic on the VNF. These commands do not stop the application processes (which is done using StopApplication). |
| ResumeTraffic | |
+------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-
-
+
+
d. Monitoring & Management
===========================
-This section addresses data collection and event processing functionality that is directly
-dependent on the interfaces provided by the VNFs’ APIs. These can be in the form of asynchronous
-interfaces for event, fault notifications, and autonomous data streams. They can also be
-synchronous interfaces for on-demand requests to retrieve various performance, usage,
+This section addresses data collection and event processing functionality that is directly
+dependent on the interfaces provided by the VNFs’ APIs. These can be in the form of asynchronous
+interfaces for event, fault notifications, and autonomous data streams. They can also be
+synchronous interfaces for on-demand requests to retrieve various performance, usage,
and other event information.
-The target direction for VNF interfaces is to employ APIs that are implemented
-utilizing standardized messaging and modeling protocols over standardized transports.
-Migrating to a virtualized environment presents a tremendous opportunity to eliminate
-the need for proprietary interfaces for VNF provider equipment while removing the traditional
-boundaries between Network Management Systems and Element Management Systems. Additionally,
-VNFs provide the ability to instrument the networking applications by creating event
-records to test and monitor end-to-end data flow through the network, similar to what
-physical or virtual probes provide without the need to insert probes at various points
-in the network. The VNF providers must be able to provide the aforementioned set of required
+The target direction for VNF interfaces is to employ APIs that are implemented
+utilizing standardized messaging and modeling protocols over standardized transports.
+Migrating to a virtualized environment presents a tremendous opportunity to eliminate
+the need for proprietary interfaces for VNF provider equipment while removing the traditional
+boundaries between Network Management Systems and Element Management Systems. Additionally,
+VNFs provide the ability to instrument the networking applications by creating event
+records to test and monitor end-to-end data flow through the network, similar to what
+physical or virtual probes provide without the need to insert probes at various points
+in the network. The VNF providers must be able to provide the aforementioned set of required
data directly to the ONAP collection layer using standardized interfaces.
Data Model for Event Records
----------------------------
-This section describes the data model for the collection of telemetry data from VNFs
-by Service Providers (SPs) to manage VNF health and runtime lifecycle. This data
-model is referred to as the VNF Event Streaming (VES) specifications. While this
-document is focused on specifying some of the records from the ONAP perspective,
-there may be other external bodies using the same framework to specify additional
-records. For example, OPNFV has a VES project that is looking to specify records
-for OpenStack’s internal telemetry to manage Application (VNFs), physical and
-virtual infrastructure (compute, storage, network devices), and virtual infrastructure
-managers (cloud controllers, SDN controllers). Note that any configurable parameters
-for these data records (e.g., frequency, granularity, policy-based configuration)
-will be managed using the “Configuration” framework described in the prior sections
+This section describes the data model for the collection of telemetry data from VNFs
+by Service Providers (SPs) to manage VNF health and runtime lifecycle. This data
+model is referred to as the VNF Event Streaming (VES) specifications. While this
+document is focused on specifying some of the records from the ONAP perspective,
+there may be other external bodies using the same framework to specify additional
+records. For example, OPNFV has a VES project that is looking to specify records
+for OpenStack’s internal telemetry to manage Application (VNFs), physical and
+virtual infrastructure (compute, storage, network devices), and virtual infrastructure
+managers (cloud controllers, SDN controllers). Note that any configurable parameters
+for these data records (e.g., frequency, granularity, policy-based configuration)
+will be managed using the “Configuration” framework described in the prior sections
of this document.
The Data Model consists of:
@@ -653,22 +653,22 @@ The Data Model consists of:
Technology Independent and Technology Specific records sections of
the data model.
-- Technology Independent Records: This version of the document specifies
- the model for Fault, Heartbeat, State Change, Syslog, Threshold Crossing
- Alerts, and VNF Scaling* (short for measurementForVfScalingFields – actual
- name used in JSON specification) records. In the future, these may be
- extended to support other types of technology independent records. Each
- of these records allows additional fields (name/ value pairs) for extensibility.
- The VNF provider can use these VNF Provider-specific additional fields to provide
+- Technology Independent Records: This version of the document specifies
+ the model for Fault, Heartbeat, State Change, Syslog, Threshold Crossing
+ Alerts, and VNF Scaling* (short for measurementForVfScalingFields – actual
+ name used in JSON specification) records. In the future, these may be
+ extended to support other types of technology independent records. Each
+ of these records allows additional fields (name/ value pairs) for extensibility.
+ The VNF provider can use these VNF Provider-specific additional fields to provide
additional information that may be relevant to the managing systems.
-- Technology Specific Records: This version of the document specifies the model
- for Mobile Flow records, Signaling and Voice Quality records. In the future,
- these may be extended to support other types of records (e.g. Network Fabric,
- Security records, etc.). Each of these records allows additional fields
- (name/value pairs) for extensibility. The VNF providers can use these VNF-specific
- additional fields to provide additional information that may be relevant to the
- managing systems. A placeholder for additional technology specific areas of
+- Technology Specific Records: This version of the document specifies the model
+ for Mobile Flow records, Signaling and Voice Quality records. In the future,
+ these may be extended to support other types of records (e.g. Network Fabric,
+ Security records, etc.). Each of these records allows additional fields
+ (name/value pairs) for extensibility. The VNF providers can use these VNF-specific
+ additional fields to provide additional information that may be relevant to the
+ managing systems. A placeholder for additional technology specific areas of
interest to be defined in the future documents has been depicted.
|image0|
@@ -694,24 +694,24 @@ The data structure for event records consists of:
Common Event Header
~~~~~~~~~~~~~~~~~~~~~
-The common header that precedes any of the domain-specific records contains
-information identifying the type of record to follow, information about
-the sender and other identifying characteristics related to timestamp,
-sequence number, etc.
+The common header that precedes any of the domain-specific records contains
+information identifying the type of record to follow, information about
+the sender and other identifying characteristics related to timestamp,
+sequence number, etc.
Technology Independent Records – Fault Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The Fault Record, describing a condition in the Fault domain, contains
-information about the fault such as the entity under fault, the
+The Fault Record, describing a condition in the Fault domain, contains
+information about the fault such as the entity under fault, the
severity, resulting status, etc.
Technology Independent Records – Heartbeat Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The Heartbeat Record provides an optional structure for communicating
-information about heartbeat or watchdog signaling events. It can
-contain information about service intervals, status information etc.
+The Heartbeat Record provides an optional structure for communicating
+information about heartbeat or watchdog signaling events. It can
+contain information about service intervals, status information etc.
as required by the heartbeat implementation.
Note: Heartbeat records would only have the Common Event Header block.
@@ -721,73 +721,73 @@ implementation.
Technology Independent Records – State Change Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The State Change Record provides a structure for communicating information
-about data flow through the VNF. It can contain information about state
-change related to physical device that is reported by VNF. As an example,
+The State Change Record provides a structure for communicating information
+about data flow through the VNF. It can contain information about state
+change related to physical device that is reported by VNF. As an example,
when cards or port name of the entity that has changed state.
Technology Independent Records – Syslog Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The Syslog Record provides a structure for communicating any type of
-information that may be logged by the VNF. It can contain information
+The Syslog Record provides a structure for communicating any type of
+information that may be logged by the VNF. It can contain information
about system internal events, status, errors, etc.
Technology Independent Records – Threshold Crossing Alert Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The Threshold Crossing Alert (TCA) Record provides a structure for
-communicating information about threshold crossing alerts. It can
-contain alert definitions and types, actions, events, timestamps
+The Threshold Crossing Alert (TCA) Record provides a structure for
+communicating information about threshold crossing alerts. It can
+contain alert definitions and types, actions, events, timestamps
and physical or logical details.
Technology Independent Records - VNF Scaling Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The VNF Scaling\* (short for measurementForVfScalingFields –
-actual name used in JSON specification) Record contains information
-about VNF and VNF resource structure and its condition to help in
+The VNF Scaling\* (short for measurementForVfScalingFields –
+actual name used in JSON specification) Record contains information
+about VNF and VNF resource structure and its condition to help in
the management of the resources for purposes of elastic scaling.
Technology Independent Records – otherFields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The otherFields Record defines fields for events belonging to the
-otherFields domain of the Technology Independent domain enumeration.
-This record provides a mechanism to convey a complex set of fields
-(possibly nested or opaque) and is purely intended to address
-miscellaneous needs such as addressing time-to-market considerations
-or other proof-of-concept evaluations. Hence, use of this record
-type is discouraged and should be minimized.
+The otherFields Record defines fields for events belonging to the
+otherFields domain of the Technology Independent domain enumeration.
+This record provides a mechanism to convey a complex set of fields
+(possibly nested or opaque) and is purely intended to address
+miscellaneous needs such as addressing time-to-market considerations
+or other proof-of-concept evaluations. Hence, use of this record
+type is discouraged and should be minimized.
Technology Specific Records – Mobile Flow Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The Mobile Flow Record provides a structure for communicating
-information about data flow through the VNF. It can contain
-information about connectivity and data flows between serving
+The Mobile Flow Record provides a structure for communicating
+information about data flow through the VNF. It can contain
+information about connectivity and data flows between serving
elements for mobile service, such as between LTE reference points, etc.
Technology Specific Records – Signaling Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The Signaling Record provides a structure for communicating information
-about signaling messages, parameters and signaling state. It can
-contain information about data flows for signaling and controlling
-multimedia communication sessions such as voice and video calls.
+The Signaling Record provides a structure for communicating information
+about signaling messages, parameters and signaling state. It can
+contain information about data flows for signaling and controlling
+multimedia communication sessions such as voice and video calls.
Technology Specific Records – Voice Quality Fields
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The Voice Quality Record provides a structure for communicating information
-about voice quality statistics including media connection information,
-such as transmitted octet and packet counts, packet loss, packet delay
-variation, round-trip delay, QoS parameters and codec selection.
+The Voice Quality Record provides a structure for communicating information
+about voice quality statistics including media connection information,
+such as transmitted octet and packet counts, packet loss, packet delay
+variation, round-trip delay, QoS parameters and codec selection.
Technology Specific Records – Future Domains
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The futureDomains Record is a placeholder for additional technology
-specific areas of interest that will be defined and described
+The futureDomains Record is a placeholder for additional technology
+specific areas of interest that will be defined and described
in the future documents.
Data Structure Specification of the Event Record
@@ -800,30 +800,30 @@ Listener <https://github.com/att/evel-test-collector/tree/master/docs/att_interf
Transports and Protocols Supporting Resource Interfaces
-------------------------------------------------------
-Delivery of data from VNFs to ONAP must use the common transport mechanisms and protocols
-for all VNFs as defined in this document. Transport mechanisms and protocols have been
-selected to enable both high volume and moderate volume datasets, as well as asynchronous
-and synchronous communications over secure connections. The specified encoding provides
-self-documenting content, so data fields can be changed as needs evolve, while minimizing
+Delivery of data from VNFs to ONAP must use the common transport mechanisms and protocols
+for all VNFs as defined in this document. Transport mechanisms and protocols have been
+selected to enable both high volume and moderate volume datasets, as well as asynchronous
+and synchronous communications over secure connections. The specified encoding provides
+self-documenting content, so data fields can be changed as needs evolve, while minimizing
changes to data delivery.
-The term ‘Event Record’ is used throughout this document to represent various forms of
-telemetry or instrumentation made available by the VNF including, faults, status events,
-various other types of VNF measurements and logs. Headers received by themselves must be
-used as heartbeat indicators. Common structures and delivery protocols for other types of
-data will be given in future versions of this document as we get more insight into data
+The term ‘Event Record’ is used throughout this document to represent various forms of
+telemetry or instrumentation made available by the VNF including, faults, status events,
+various other types of VNF measurements and logs. Headers received by themselves must be
+used as heartbeat indicators. Common structures and delivery protocols for other types of
+data will be given in future versions of this document as we get more insight into data
volumes and required processing.
-In the following sections, we provide options for encoding, serialization and data
-delivery. Agreements between Service Providers and VNF providers shall determine which
-encoding, serialization and delivery method to use for particular data sets. The selected
+In the following sections, we provide options for encoding, serialization and data
+delivery. Agreements between Service Providers and VNF providers shall determine which
+encoding, serialization and delivery method to use for particular data sets. The selected
methods must be agreed to prior to the on-boarding of the VNF into ONAP design studio.
VNF Telemetry using VES/JSON Model
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The preferred model for data delivery from a VNF to ONAP DCAE is the JSON driven model as depicted in Figure 2.
-
+
|image1|
Figure 2. VES/JSON Driven Model
@@ -833,25 +833,25 @@ VNF providers will provide a YAML artifact to the Service Provider that describe
* standard VES/JSON model information elements (key/values) that the VNF provides
* any additional non-standard (custom) VES/JSON model information elements (key/values) that the VNF provides
-Using the semantics and syntax supported by YAML, VNF providers will indicate specific conditions that may
-arise, and recommend actions that should be taken at specific thresholds, or if specific conditions
-repeat within a specified time interval.
-
-Based on the VNF provider's recommendations, the Service Provider may create additional YAML artifacts
-(using ONAP design Studio), which finalizes Service Provider engineering rules for the processing of
-the VNF events. The Service Provider may alter the threshold levels recommended by the VNF providor,
-and may modify and more clearly specify actions that should be taken when specified conditions arise.
-The Service Provider-created version of the YAML artifact will be distributed to ONAP applications
+Using the semantics and syntax supported by YAML, VNF providers will indicate specific conditions that may
+arise, and recommend actions that should be taken at specific thresholds, or if specific conditions
+repeat within a specified time interval.
+
+Based on the VNF provider's recommendations, the Service Provider may create additional YAML artifacts
+(using ONAP design Studio), which finalizes Service Provider engineering rules for the processing of
+the VNF events. The Service Provider may alter the threshold levels recommended by the VNF providor,
+and may modify and more clearly specify actions that should be taken when specified conditions arise.
+The Service Provider-created version of the YAML artifact will be distributed to ONAP applications
by the Design framework.
VNF Telemetry using YANG Model
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-In addition to the JSON driven model described above, a YANG driven model can also be
+In addition to the JSON driven model described above, a YANG driven model can also be
supported, as depicted in Figure 3.
|image2|
-
+
Figure 3. YANG Driven Model
VNF providers will provide to the Service Provider the following YANG model artifacts:
@@ -864,7 +864,7 @@ VNF providers will provide to the Service Provider the following YANG model arti
* sensor paths
* subscription bindings
- * path destinations
+ * path destinations
* delivery frequency
* transport mechanisms
* data encodings
@@ -873,47 +873,47 @@ VNF providers will provide to the Service Provider the following YANG model arti
* YANG helper or decoder functions that automate the conversion between YANG model data types to VES/JSON information elements
* OPTIONAL: YANG Telemetry modules in JSON format per RFC 7951
-Using the semantics and syntax supported by YANG, VNF providers will indicate specific conditions that may
-arise, and recommend actions that should be taken at specific thresholds, or if specific conditions
-repeat within a specified time interval.
+Using the semantics and syntax supported by YANG, VNF providers will indicate specific conditions that may
+arise, and recommend actions that should be taken at specific thresholds, or if specific conditions
+repeat within a specified time interval.
-Based on the VNF provider's recommendations, the Service Provider may create additional YAML artifacts
-(using ONAP design Studio), which finalizes Service Provider engineering rules for the processing
-of the VNF events. The Service Provider may alter the threshold levels recommended by the
-VNF provider, and may modify and more clearly specify actions that should be taken when specified
-conditions arise. The Service Provided-created version of the YAML will be distributed to ONAP
+Based on the VNF provider's recommendations, the Service Provider may create additional YAML artifacts
+(using ONAP design Studio), which finalizes Service Provider engineering rules for the processing
+of the VNF events. The Service Provider may alter the threshold levels recommended by the
+VNF provider, and may modify and more clearly specify actions that should be taken when specified
+conditions arise. The Service Provided-created version of the YAML will be distributed to ONAP
applications by the Design framework.
-Note: While supporting the YANG model described above, we are still leveraging the VES JSON
-based model in DCAE. The purpose of the diagram above is to illustrate the concept only and
+Note: While supporting the YANG model described above, we are still leveraging the VES JSON
+based model in DCAE. The purpose of the diagram above is to illustrate the concept only and
not to imply a specific implementation.
VNF Telemetry using Google Protocol Buffers
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-In addition to the data delivery models described above, support for delivery of VNF telemetry
-using Google Protocol Buffers (GPB) can also be supported, as depicted in Figure 4.
+In addition to the data delivery models described above, support for delivery of VNF telemetry
+using Google Protocol Buffers (GPB) can also be supported, as depicted in Figure 4.
-VNF providers will provide to the Service Provider the additional following artifacts to
-support the delivery of VNF telemetry to DCAE via the open-source gRPC mechanism using
+VNF providers will provide to the Service Provider the additional following artifacts to
+support the delivery of VNF telemetry to DCAE via the open-source gRPC mechanism using
Google's Protocol Buffers:
* the YANG model artifacts described in support of the "VNF Telemetry using YANG Model"
* valid definition file(s) for all GPB / KV-GPB encoded messages
-* valid definition file(s) for all gRPC services
+* valid definition file(s) for all gRPC services
* gRPC method parameters and return types specified as Protocol Buffers messages
|image3|
-
+
Figure 4. Protocol Buffers Driven Model
-Note: if Google Protocol Buffers are employed for delivery of VNF telemetry, Key-Value
-Google Protocol Buffers (KV-GPB) is the preferred serialization method. Details of
-specifications and versioning corresponding to a release can be found
+Note: if Google Protocol Buffers are employed for delivery of VNF telemetry, Key-Value
+Google Protocol Buffers (KV-GPB) is the preferred serialization method. Details of
+specifications and versioning corresponding to a release can be found
at: `VES Event Listener <https://github.com/att/evel-test-collector/tree/master/docs/att_interface_definition>`__.
-Note: While supporting the VNF telemetry delivery approach described above, we are
-still leveraging the VES JSON based model in DCAE. The purpose of the diagram above
+Note: While supporting the VNF telemetry delivery approach described above, we are
+still leveraging the VES JSON based model in DCAE. The purpose of the diagram above
is to illustrate the concept only and not to imply a specific implementation.
Monitoring & Management Requirements
@@ -929,7 +929,7 @@ Content delivered from VNFs to ONAP is to be encoded and serialized using JSON:
**JSON**
-* R-19624 The VNF **MUST** encode and serialize content delivered to ONAP using JSON (RFC 7159) plain text format. High-volume data
+* R-19624 The VNF **MUST** encode and serialize content delivered to ONAP using JSON (RFC 7159) plain text format. High-volume data
is to be encoded and serialized using `Avro <http://avro.apache.org/>`_, where the Avro [5]_ data format are described using JSON.
- JSON plain text format is preferred for moderate volume data sets (option 1), as JSON has the advantage of having well-understood simple processing and being human-readable without additional decoding. Examples of moderate volume data sets include the fault alarms and performance alerts, heartbeat messages, measurements used for VNF scaling and syslogs.