From 2bb8c4857689cabe69d3d2d3d54dffa78d8f4a9f Mon Sep 17 00:00:00 2001 From: Maryam Tahhan Date: Thu, 16 Feb 2017 14:28:05 +0000 Subject: docs: moving to new doc structure Change-Id: I91188deec2bd4e8aa405a9e023acde42b3fb31f7 Signed-off-by: Maryam Tahhan --- docs/requirements/01-intro.rst | 183 ----------------------------------------- 1 file changed, 183 deletions(-) delete mode 100644 docs/requirements/01-intro.rst (limited to 'docs/requirements/01-intro.rst') 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 -- cgit 1.2.3-korg