diff options
author | Maryam Tahhan <maryam.tahhan@intel.com> | 2015-12-15 13:20:46 +0000 |
---|---|---|
committer | Maryam Tahhan <maryam.tahhan@intel.com> | 2015-12-15 13:44:32 +0000 |
commit | ee298f7c945cb3448ed7179409d4ddcd101743b4 (patch) | |
tree | f4e1805607462606fb5d6d956d714f4c0b44aee3 /docs/requirements/02-measuring_telco_traffic_and_performance_KPIs.rst | |
parent | dd3f6c055f48e844cd94167957badd622b0b5730 (diff) |
docs: update SFQM docuementation for Rel B
Add documenation that details SFQM features and work for OPNFV release
B.
Change-Id: I288e944af4f534098bb5a7d378fcc92858d1b199
Signed-off-by: Maryam Tahhan <maryam.tahhan@intel.com>
Diffstat (limited to 'docs/requirements/02-measuring_telco_traffic_and_performance_KPIs.rst')
-rw-r--r-- | docs/requirements/02-measuring_telco_traffic_and_performance_KPIs.rst | 67 |
1 files changed, 67 insertions, 0 deletions
diff --git a/docs/requirements/02-measuring_telco_traffic_and_performance_KPIs.rst b/docs/requirements/02-measuring_telco_traffic_and_performance_KPIs.rst new file mode 100644 index 00000000..ae67ba50 --- /dev/null +++ b/docs/requirements/02-measuring_telco_traffic_and_performance_KPIs.rst @@ -0,0 +1,67 @@ +Measuring Telco Traffic and Performance KPIs +============================================ +This section will look at what SFQM has done to enable Measuring Telco Traffic +and Performance KPIs. + +.. Figure:: stats_and_timestamps.png + + Measuring Telco Traffic and Performance KPIs + +* The very first thing SFQM enabled was a call-back API in DPDK and an + associated application that used the API to demonstrate how to timestamp + packets and measure packet latency in DPDK (the sample app is called + rxtx_callbacks). This was upstreamed to DPDK 2.0 and is represented by + the interfaces 1 and 2 in Figure 1.2. + +* The second thing SFQM implemented in DPDK is the extended NIC statistics API, + which exposes NIC stats including error stats to the DPDK user by reading the + registers on the NIC. This is represented by interface 3 in Figure 1.2. + + * For DPDK 2.1 this API was only implemented for the ixgbe (10Gb) NIC driver, + in association with a sample application that runs as a DPDK secondary + process and retrieves the extended NIC stats. + + * For DPDK 2.2 the API was implemented for igb, i40e and all the Virtual + Functions (VFs) for all drivers. + +Monitoring DPDK interfaces +=========================== +With the features SFQM enabled in DPDK to enable measuring Telco traffic and +performance KPIs, we can now retrieve NIC statistics including error stats and +relay them to a DPDK user. The next step is to enable monitoring of the DPDK +interfaces based on the stats that we are retrieving from the NICs, and relay +the information to a higher level Fault Management entity. To enable this SFQM +has been enabling a number of plugins for collectd. + +collectd is is a daemon which collects system performance statistics periodically +and provides mechanisms to store the values in a variety of ways. It supports +more than 90 different plugins to retrieve platform information, such as CPU +utilization, and is capable of publishing/writing the information is gathers to +a number of endpoints through its write plugins. + +SFQM has been enabling two collectd plugins to collect DPDK NIC statistics and +push the stats to Ceilometer: + +* dpdkstat plugin: A read plugin that retrieve stats from the DPDK extended NIC + stats API. +* ceilometer plugin: A write plugin that pushes the retrieved stats to + Ceilometer. It's capable of pushing any stats read through collectd to + Ceilometer, not just the DPDK stats. + +.. Figure:: monitoring_interfaces.png + + Monitoring Interfaces and Openstack Support + +The figure above shows the DPDK L2 forwarding application running on a compute +node, sending and receiving traffic. collectd is also running on this compute +node retrieving the stats periodically from DPDK through the dpdkstat plugin +and publishing the retrieved stats to Ceilometer through the ceilometer plugin. + +To see this demo in action please checkout: `SFQM OPNFV Summit demo`_ + +Future enahancements to the DPDK stats plugin include: + +* Integration of DPDK Keep Alive functionality. +* Implementation of the ability to retrieve link status. + +.. _SFQM OPNFV Summit demo: https://prezi.com/kjv6o8ixs6se/software-fastpath-service-quality-metrics-demo/ |