aboutsummaryrefslogtreecommitdiffstats
path: root/docs/report/dpdk_performance_tests
diff options
context:
space:
mode:
Diffstat (limited to 'docs/report/dpdk_performance_tests')
-rw-r--r--docs/report/dpdk_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst61
-rw-r--r--docs/report/dpdk_performance_tests/comparisons/current_vs_previous_release.rst51
-rw-r--r--docs/report/dpdk_performance_tests/comparisons/index.rst13
-rw-r--r--docs/report/dpdk_performance_tests/csit_release_notes.rst115
-rw-r--r--docs/report/dpdk_performance_tests/index.rst2
-rw-r--r--docs/report/dpdk_performance_tests/throughput_trending.rst17
6 files changed, 145 insertions, 114 deletions
diff --git a/docs/report/dpdk_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst b/docs/report/dpdk_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst
new file mode 100644
index 0000000000..c148b0619c
--- /dev/null
+++ b/docs/report/dpdk_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst
@@ -0,0 +1,61 @@
+3n-Skx vs. 3n-Hsw Testbeds
+--------------------------
+
+Relative comparison of |dpdk-release| Testpmd and L3fwd packet
+throughput (NDR, PDR and MRR) is calculated for the same tests executed
+on 3-Node Skylake (3n-skx) and 3-Node Haswell (3n-hsw) physical testbed
+types, in 1-core, 2-core and 4-core configurations.
+
+NDR Comparison
+~~~~~~~~~~~~~~
+
+NDR throughput comparison between testbeds is available in CSV and
+pretty ASCII formats:
+
+ - `CSV NDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-ndr.csv>`_,
+ - `ASCII NDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-ndr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor dpdk performance job 3n-hsw`_ and
+ `FD.io test executor dpdk performance job 3n-skx`_
+ with RF result
+ files csit-dpdk-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
+
+PDR Comparison
+~~~~~~~~~~~~~~
+
+PDR throughput comparison between testbeds is available in CSV and
+pretty ASCII formats:
+
+ - `CSV PDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-pdr.csv>`_,
+ - `ASCII PDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-pdr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor dpdk performance job 3n-hsw`_ and
+ `FD.io test executor dpdk performance job 3n-skx`_
+ with RF result
+ files csit-dpdk-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
+
+MRR Comparison
+~~~~~~~~~~~~~~
+
+MRR throughput comparison between testbeds is available in CSV and
+pretty ASCII formats:
+
+ - `CSV MRR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-mrr.csv>`_,
+ - `ASCII MRR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-mrr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor dpdk performance job 3n-hsw`_ and
+ `FD.io test executor dpdk performance job 3n-skx`_
+ with RF result
+ files csit-vpp-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_. \ No newline at end of file
diff --git a/docs/report/dpdk_performance_tests/comparisons/current_vs_previous_release.rst b/docs/report/dpdk_performance_tests/comparisons/current_vs_previous_release.rst
new file mode 100644
index 0000000000..6a7829ac8a
--- /dev/null
+++ b/docs/report/dpdk_performance_tests/comparisons/current_vs_previous_release.rst
@@ -0,0 +1,51 @@
+Current vs. Previous Release
+----------------------------
+
+Relative comparison of DPDK Testpmd and L3fwd packet throughput (NDR,
+PDR and MRR) between |dpdk-release| and DPDK-18.02 (measured for |csit-
+release| and |csit-release-1| respectively) is calculated from results
+of tests running on 3-Node Intel Xeon Haswell testbeds (3n-hsw) in
+1-core, 2-core and 4-core (MRR only) configurations.
+
+Listed mean and standard deviation values are computed based on a series
+of the same tests executed against respective DPDK releases to verify
+test results repeatability, with percentage change calculated for mean
+values.
+
+NDR Comparison
+~~~~~~~~~~~~~~
+
+NDR throughput comparison between releases is available in CSV and pretty
+ASCII formats:
+
+ - `CSV 1t1c NDR changes <../_static/dpdk/performance-changes-1t1c-ndr.csv>`_,
+ - `CSV 2t2c NDR changes <../_static/dpdk/performance-changes-2t2c-ndr.csv>`_,
+ - `ASCII 1t1c NDR changes <../_static/dpdk/performance-changes-1t1c-ndr.txt>`_,
+ - `ASCII 2t2c NDR changes <../_static/dpdk/performance-changes-2t2c-ndr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor dpdk performance job 3n-hsw`_
+ with RF result
+ files csit-dpdk-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
+
+PDR Comparison
+~~~~~~~~~~~~~~
+
+PDR throughput comparison between releases is available in CSV and pretty
+ASCII formats:
+
+ - `CSV 1t1c PDR changes <../_static/dpdk/performance-changes-1t1c-pdr.csv>`_,
+ - `CSV 2t2c PDR changes <../_static/dpdk/performance-changes-2t2c-pdr.csv>`_,
+ - `ASCII 1t1c PDR changes <../_static/dpdk/performance-changes-1t1c-pdr.txt>`_,
+ - `ASCII 2t2c PDR changes <../_static/dpdk/performance-changes-2t2c-pdr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor dpdk performance job 3n-hsw`_
+ with RF result
+ files csit-dpdk-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
diff --git a/docs/report/dpdk_performance_tests/comparisons/index.rst b/docs/report/dpdk_performance_tests/comparisons/index.rst
new file mode 100644
index 0000000000..ace3baf091
--- /dev/null
+++ b/docs/report/dpdk_performance_tests/comparisons/index.rst
@@ -0,0 +1,13 @@
+
+.. raw:: latex
+
+ \clearpage
+
+Comparisons
+=============
+
+.. toctree::
+
+ current_vs_previous_release
+ 3n-skx_vs_3n-hsw_testbeds
+
diff --git a/docs/report/dpdk_performance_tests/csit_release_notes.rst b/docs/report/dpdk_performance_tests/csit_release_notes.rst
index 9fe1ce3c50..e0e20289b0 100644
--- a/docs/report/dpdk_performance_tests/csit_release_notes.rst
+++ b/docs/report/dpdk_performance_tests/csit_release_notes.rst
@@ -13,8 +13,7 @@ Changes in |csit-release|
- **MRR Throughput**: MRR (Maximum Receive Rate) test code has now
configurable trial duration and number of consecutive executions.
Coverage of MRR tests has been extended across more test
- scenarios. MRR tests are used for continuous performance trending
- and for comparison between DPDK releases.
+ scenarios. MRR tests are used for continuous performance trending.
- **MLRsearch Throughput**: MLRsearch algorithm has been introduced
for all NDR and PDR throughput tests. All tests that previously
@@ -38,118 +37,6 @@ Changes in |csit-release|
- **Performance trending**: Added continuous performance trending with
anomaly detection and analysis for DPDK.
-Performance Changes
--------------------
-
-Relative performance changes in measured NDR, PDR and MRR packet
-throughput in |csit-release| are calculated against the test results
-from |csit-release-1| report, for tests running on 3-Node Intel Xeon
-Haswell testbeds (3n-hsw) in 1-core, 2-core and 4-core (MRR only)
-configurations.
-
-Listed mean and standard deviation values are computed based on a series
-of the same tests executed against respective VPP releases to verify
-test results repeatability, with percentage change calculated for mean
-values.
-
-NDR Changes
-~~~~~~~~~~~
-
-NDR throughput changes between releases are available in CSV and pretty
-ASCII formats:
-
- - `CSV 1t1c NDR changes <../_static/dpdk/performance-changes-1t1c-ndr.csv>`_,
- - `CSV 2t2c NDR changes <../_static/dpdk/performance-changes-2t2c-ndr.csv>`_,
- - `ASCII 1t1c NDR changes <../_static/dpdk/performance-changes-1t1c-ndr.txt>`_,
- - `ASCII 2t2c NDR changes <../_static/dpdk/performance-changes-2t2c-ndr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor dpdk performance job 3n-hsw`_
- with RF result
- files csit-dpdk-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-PDR Changes
-~~~~~~~~~~~
-
-PDR throughput changes between releases are available in CSV and pretty
-ASCII formats:
-
- - `CSV 1t1c PDR changes <../_static/dpdk/performance-changes-1t1c-pdr.csv>`_,
- - `CSV 2t2c PDR changes <../_static/dpdk/performance-changes-2t2c-pdr.csv>`_,
- - `ASCII 1t1c PDR changes <../_static/dpdk/performance-changes-1t1c-pdr.txt>`_,
- - `ASCII 2t2c PDR changes <../_static/dpdk/performance-changes-2t2c-pdr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor dpdk performance job 3n-hsw`_
- with RF result
- files csit-dpdk-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-Skx vs. Hsw Comparison
-----------------------
-
-Relative performance changes in measured packet throughput on 3-Node Skx testbed
-are calculated against the results measured on 3-Node Hsw testbed.
-
-NDR Comparison
-~~~~~~~~~~~~~~
-
-NDR throughput changes between testbeds are available in a CSV and pretty ASCII
-formats:
-
- - `CSV 1c NDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-ndr.csv>`_,
- - `ASCII 1c NDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-ndr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor dpdk performance job 3n-hsw`_ and
- `FD.io test executor dpdk performance job 3n-skx`_
- with RF result
- files csit-dpdk-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-PDR Comparison
-~~~~~~~~~~~~~~
-
-PDR throughput changes between testbeds are available in a CSV and pretty ASCII
-formats:
-
- - `CSV 1c PDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-pdr.csv>`_,
- - `ASCII 1c PDR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-pdr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor dpdk performance job 3n-hsw`_ and
- `FD.io test executor dpdk performance job 3n-skx`_
- with RF result
- files csit-dpdk-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-MRR Comparison
-~~~~~~~~~~~~~~
-
-MRR throughput changes between testbeds are available in a
-CSV and pretty ASCII formats:
-
- - `CSV 1c MRR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-mrr.csv>`_,
- - `ASCII 1c MRR comparison <../_static/dpdk/performance-compare-testbeds-3n-hsw-3n-skx-mrr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor dpdk performance job 3n-hsw`_ and
- `FD.io test executor dpdk performance job 3n-skx`_
- with RF result
- files csit-vpp-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
Known Issues
------------
diff --git a/docs/report/dpdk_performance_tests/index.rst b/docs/report/dpdk_performance_tests/index.rst
index 3aa32435f0..07632b6368 100644
--- a/docs/report/dpdk_performance_tests/index.rst
+++ b/docs/report/dpdk_performance_tests/index.rst
@@ -7,5 +7,7 @@ DPDK Performance
csit_release_notes
packet_throughput_graphs/index
packet_latency_graphs/index
+ comparisons/index
+ throughput_trending
test_environment
documentation
diff --git a/docs/report/dpdk_performance_tests/throughput_trending.rst b/docs/report/dpdk_performance_tests/throughput_trending.rst
new file mode 100644
index 0000000000..2b45f4bdaf
--- /dev/null
+++ b/docs/report/dpdk_performance_tests/throughput_trending.rst
@@ -0,0 +1,17 @@
+Throughput Trending
+-------------------
+
+In addition to reporting throughput comparison between DPDK releases,
+CSIT provides regular performance trending for DPDK release branches:
+
+#. `Performance Dashboard <https://docs.fd.io/csit/master/trending/introduction/index.html>`_
+ - per DPDK test case throughput trend, trend compliance and summary of
+ detected anomalies.
+
+#. `Trending Methodology <https://docs.fd.io/csit/master/trending/methodology/index.html>`_
+ - throughput test metrics, trend calculations and anomaly
+ classification (progression, regression).
+
+#. `DPDK Apps Trendline Graphs <https://docs.fd.io/csit/master/trending/trending/dpdk.html>`_
+ - weekly DPDK Testpmd and L3fwd MRR throughput measurements against
+ the trendline with anomaly highlights and associated CSIT test jobs. \ No newline at end of file