summaryrefslogtreecommitdiffstats
path: root/docs/development/requirements/01-intro.rst
blob: bc0e9ba0215871dd4b7ebbd7eb646be601fe8f99 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
.. 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