summaryrefslogtreecommitdiffstats
path: root/docs/requirements/01-intro.rst
diff options
context:
space:
mode:
authorMaryam Tahhan <maryam.tahhan@intel.com>2017-02-16 14:28:05 +0000
committerMaryam Tahhan <maryam.tahhan@intel.com>2017-02-17 09:35:25 +0000
commit2bb8c4857689cabe69d3d2d3d54dffa78d8f4a9f (patch)
tree75c0b7fdeb5167588fe42d02702fb7d5b354725a /docs/requirements/01-intro.rst
parent47ccd41d789085a2186fc1fb86364d93a20783ef (diff)
docs: moving to new doc structure
Change-Id: I91188deec2bd4e8aa405a9e023acde42b3fb31f7 Signed-off-by: Maryam Tahhan <maryam.tahhan@intel.com>
Diffstat (limited to 'docs/requirements/01-intro.rst')
-rw-r--r--docs/requirements/01-intro.rst183
1 files changed, 0 insertions, 183 deletions
diff --git a/docs/requirements/01-intro.rst b/docs/requirements/01-intro.rst
deleted file mode 100644
index bc0e9ba0..00000000
--- a/docs/requirements/01-intro.rst
+++ /dev/null
@@ -1,183 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) OPNFV, Intel Corporation and others.
-
-Introduction
-============
-Barometer is the project that renames Software Fastpath service Quality Metrics
-(SFQM) and updates its scope which was networking centric.
-
-The goal of SFQM was to develop the utilities and libraries in DPDK to
-support:
-
-* Measuring Telco Traffic and Performance KPIs. Including:
-
- * Packet Delay Variation (by enabling TX and RX time stamping).
- * Packet loss (by exposing extended NIC stats).
-
-* Performance Monitoring of the DPDK interfaces (by exposing
- extended NIC stats + collectd Plugin).
-* Detecting and reporting violations that can be consumed by VNFs
- and higher level management systems (through DPDK Keep Alive).
-
-With Barometer the scope is extended to monitoring the NFVI. The ability to
-monitor the Network Function Virtualization Infrastructure (NFVI) where VNFs
-are in operation will be a key part of Service Assurance within an NFV
-environment, in order to enforce SLAs or to detect violations, faults or
-degradation in the performance of NFVI resources so that events and relevant
-metrics are reported to higher level fault management systems.
-If physical appliances are going to be replaced by virtualized appliances
-the service levels, manageability and service assurance needs to remain
-consistent or improve on what is available today. As such, the NFVI needs to
-support the ability to monitor:
-
-* Traffic monitoring and performance monitoring of the components that provide
- networking functionality to the VNF, including: physical interfaces, virtual
- switch interfaces and flows, as well as the virtual interfaces themselves and
- their status, etc.
-* Platform monitoring including: CPU, memory, load, cache, themals, fan speeds,
- voltages and machine check exceptions, etc.
-
-All of the statistics and events gathered must be collected in-service and must
-be capable of being reported by standard Telco mechanisms (e.g. SNMP), for
-potential enforcement or correction actions. In addition, this information
-could be fed to analytics systems to enable failure prediction, and can also be
-used for intelligent workload placement.
-
-
-All developed features will be upstreamed to Open Source projects relevant to
-telemetry such as `collectd`_ and `Ceilometer`_.
-
-The OPNFV project wiki can be found @ `Barometer`_
-
-Problem Statement
-==================
-Providing carrier grade Service Assurance is critical in the network
-transformation to a software defined and virtualized network (NFV).
-Medium-/large-scale cloud environments account for between hundreds and
-hundreds of thousands of infrastructure systems. It is vital to monitor
-systems for malfunctions that could lead to users application service
-disruption and promptly react to these fault events to facilitate improving
-overall system performance. As the size of infrastructure and virtual resources
-grow, so does the effort of monitoring back-ends. SFQM aims to expose as much
-useful information as possible off the platform so that faults and errors in
-the NFVI can be detected promptly and reported to the appropriate fault
-management entity.
-
-The OPNFV platform (NFVI) requires functionality to:
-
-* Create a low latency, high performance packet processing path (fast path)
- through the NFVI that VNFs can take advantage of;
-* Measure Telco Traffic and Performance KPIs through that fast path;
-* Detect and report violations that can be consumed by VNFs and higher level
- EMS/OSS systems
-
-Examples of local measurable QoS factors for Traffic Monitoring which impact
-both Quality of Experience and five 9's availability would be (using Metro Ethernet
-Forum Guidelines as reference):
-
-* Packet loss
-* Packet Delay Variation
-* Uni-directional frame delay
-
-Other KPIs such as Call drops, Call Setup Success Rate, Call Setup time etc. are
-measured by the VNF.
-
-In addition to Traffic Monitoring, the NFVI must also support Performance
-Monitoring of the physical interfaces themselves (e.g. NICs), i.e. an ability to
-monitor and trace errors on the physical interfaces and report them.
-
-All these traffic statistics for Traffic and Performance Monitoring must be
-measured in-service and must be capable of being reported by standard Telco
-mechanisms (e.g. SNMP traps), for potential enforcement actions.
-
-Barometer updated scope
-=======================
-The scope of the project is to provide interfaces to support monitoring of the
-NFVI. The project will develop plugins for telemetry frameworks to enable the
-collection of platform stats and events and relay gathered information to fault
-management applications or the VIM. The scope is limited to
-collecting/gathering the events and stats and relaying them to a relevant
-endpoint. The project will not enforce or take any actions based on the
-gathered information.
-
-.. image: barometer_scope.png
-
-Scope of SFQM
-=============
-**NOTE:** The SFQM project has been replaced by Barometer.
-The output of the project will provide interfaces and functions to support
-monitoring of Packet Latency and Network Interfaces while the VNF is in service.
-
-The DPDK interface/API will be updated to support:
-
-* Exposure of NIC MAC/PHY Level Counters
-* Interface for Time stamp on RX
-* Interface for Time stamp on TX
-* Exposure of DPDK events
-
-collectd will be updated to support the exposure of DPDK metrics and events.
-
-Specific testing and integration will be carried out to cover:
-
-* Unit/Integration Test plans: A sample application provided to demonstrate packet
- latency monitoring and interface monitoring
-
-The following list of features and functionality will be developed:
-
-* DPDK APIs and functions for latency and interface monitoring
-* A sample application to demonstrate usage
-* collectd plugins
-
-The scope of the project involves developing the relavant DPDK APIs, OVS APIs,
-sample applications, as well as the utilities in collectd to export all the
-relavent information to a telemetry and events consumer.
-
-VNF specific processing, Traffic Monitoring, Performance Monitoring and
-Management Agent are out of scope.
-
-The Proposed Interface counters include:
-
-* Packet RX
-* Packet TX
-* Packet loss
-* Interface errors + other stats
-
-The Proposed Packet Latency Monitor include:
-
-* Cycle accurate stamping on ingress
-* Supports latency measurements on egress
-
-Support for failover of DPDK enabled cores is also out of scope of the current
-proposal. However, this is an important requirement and must-have functionality
-for any DPDK enabled framework in the NFVI. To that end, a second phase of this
-project will be to implement DPDK Keep Alive functionality that would address
-this and would report to a VNF-level Failover and High Availability mechanism
-that would then determine what actions, including failover, may be triggered.
-
-Consumption Models
-===================
-In reality many VNFs will have an existing performance or traffic monitoring
-utility used to monitor VNF behavior and report statistics, counters, etc.
-
-The consumption of performance and traffic related information/events provided
-by this project should be a logical extension of any existing VNF/NFVI monitoring
-framework. It should not require a new framework to be developed. We do not see
-the Barometer gathered metrics and evetns as major additional effort for
-monitoring frameworks to consume; this project would be sympathetic to existing
-monitoring frameworks. The intention is that this project represents an
-interface for NFVI monitoring to be used by higher level fault management
-entities (see below).
-
-Allowing the Barometer metrics and events to be handled within existing
-telemetry frameoworks makes it simpler for overall interfacing with higher
-level management components in the VIM, MANO and OSS/BSS. The Barometer
-proposal would be complementary to the Doctor project, which addresses NFVI Fault
-Management support in the VIM, and the VES project, which addresses the
-integration of VNF telemetry-related data into automated VNF management
-systems. To that end, the project committers and contributors for the Barometer
-project wish to collaborate with the Doctor and VES projects to facilitate this.
-
-.. _Barometer: https://wiki.opnfv.org/display/fastpath
-.. _collectd: http://collectd.org/
-.. _Ceilometer: https://wiki.openstack.org/wiki/Telemetry