aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorMaciek Konstantynowicz <mkonstan@cisco.com>2018-08-17 15:31:08 +0100
committerMaciek Konstantynowicz <mkonstan@cisco.com>2018-08-17 19:42:08 +0100
commit637eb126bb4ed30df61a293e03d36bd8ad5265e5 (patch)
tree63f7eaf43be188060c47eba215d45b8221127e29 /docs
parent908bc54fd36b636382a6c76c351cb85483f80d8e (diff)
report 18.07: moved performance change/compare sections out of rls notes to separate sections for vpp and dpdk.
Change-Id: If620cd894ea906baf0391617e5440e34f7136c37 Signed-off-by: Maciek Konstantynowicz <mkonstan@cisco.com>
Diffstat (limited to 'docs')
-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
-rw-r--r--docs/report/index.html.template4
-rw-r--r--docs/report/introduction/introduction.rst95
-rw-r--r--docs/report/vpp_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst61
-rw-r--r--docs/report/vpp_performance_tests/comparisons/current_vs_previous_release.rst76
-rw-r--r--docs/report/vpp_performance_tests/comparisons/index.rst13
-rw-r--r--docs/report/vpp_performance_tests/csit_release_notes.rst157
-rw-r--r--docs/report/vpp_performance_tests/index.rst2
-rw-r--r--docs/report/vpp_performance_tests/throughput_trending.rst17
14 files changed, 369 insertions, 315 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
diff --git a/docs/report/index.html.template b/docs/report/index.html.template
index 66aa54d752..ad61073b09 100644
--- a/docs/report/index.html.template
+++ b/docs/report/index.html.template
@@ -20,6 +20,8 @@ CSIT 18.07
vpp_performance_tests/throughput_speedup_multi_core/index
vpp_performance_tests/packet_latency_graphs/index
vpp_performance_tests/http_server_performance/index
+ vpp_performance_tests/comparisons/index
+ vpp_performance_tests/throughput_trending
vpp_performance_tests/test_environment
vpp_performance_tests/documentation/index
@@ -31,6 +33,8 @@ CSIT 18.07
dpdk_performance_tests/csit_release_notes
dpdk_performance_tests/packet_throughput_graphs/index
dpdk_performance_tests/packet_latency_graphs/index
+ dpdk_performance_tests/comparisons/index
+ dpdk_performance_tests/throughput_trending
dpdk_performance_tests/test_environment
dpdk_performance_tests/documentation
diff --git a/docs/report/introduction/introduction.rst b/docs/report/introduction/introduction.rst
index c88aeb4e30..e5fa19b08d 100644
--- a/docs/report/introduction/introduction.rst
+++ b/docs/report/introduction/introduction.rst
@@ -20,22 +20,21 @@ files are also provided.
|csit-release| report contains following main sections and sub-sections:
-#. **Introduction**: general introduction to CSIT project.
+#. **Introduction**: General introduction to CSIT project.
- - **Introduction**: this section.
- - **Test Scenarios Overview**: a brief overview of test scenarios
+ - **Introduction**: This section.
+ - **Test Scenarios Overview**: A brief overview of test scenarios
covered in this report.
- - **Physical Testbeds**: description of physical testbeds.
- - **Performance Test Methodology**: benchmarking methodologies.
+ - **Physical Testbeds**: Description of physical testbeds.
+ - **Performance Test Methodology**: Benchmarking methodologies.
#. **VPP Performance**: VPP performance tests executed in physical
FD.io testbeds.
- - **Overview**: tested logical topologies, test coverage and naming
+ - **Overview**: Tested logical topologies, test coverage and naming
specifics.
- - **Release Notes**: changes in |csit-release|, added tests,
- performance changes, environment or methodology changes, known
- issues.
+ - **Release Notes**: Changes in |csit-release|, added tests,
+ environment or methodology changes, known issues.
- **Packet Throughput**: NDR, PDR throughput graphs based on results
from repeated same test job executions to verify repeatibility of
measurements.
@@ -45,67 +44,75 @@ files are also provided.
graphs based on results from test job executions.
- **HTTP/TCP Performance**: HTTP/TCP VPP test server performance
graphs.
- - **Test Environment**: performance test environment configuration.
- - **Documentation**: documentation of K8s Pod/Container orchestration
+ - **Comparisons**: Performance comparisons between VPP releases and
+ between different testbed types.
+ - **Throughput Trending**: References to continuous VPP performance
+ trending.
+ - **Test Environment**: Performance test environment configuration.
+ - **Documentation**: Documentation of K8s Pod/Container orchestration
in CSIT and pointers to CSIT source code documentation for VPP
performance tests.
#. **DPDK Performance**: DPDK performance tests executed in physical
FD.io testbeds.
- - **Overview**: tested logical topologies, test coverage.
- - **Release Notes**: changes in |csit-release|, known issues.
+ - **Overview**: Tested logical topologies, test coverage.
+ - **Release Notes**: Changes in |csit-release|, known issues.
- **Packet Throughput**: NDR, PDR throughput graphs based on results
from repeated same test job executions to verify repeatibility of
measurements.
- **Packet Latency**: Latency graphs based on results from test job
executions.
- - **Test Environment**: performance test environment configuration.
- - **Documentation**: pointers to CSIT source code documentation for
+ - **Comparisons**: Performance comparisons between DPDK releases and
+ between different testbed types.
+ - **Throughput Trending**: References to regular DPDK performance
+ trending.
+ - **Test Environment**: Performance test environment configuration.
+ - **Documentation**: Pointers to CSIT source code documentation for
DPDK performance tests.
#. **VPP Functional**: VPP functional tests executed in virtual FD.io
testbeds.
- - **Overview**: tested virtual topologies, test coverage and naming
+ - **Overview**: Tested virtual topologies, test coverage and naming
specifics;
- - **Release Notes** - changes in |csit-release|, added tests,
+ - **Release Notes**: Changes in |csit-release|, added tests,
environment or methodology changes, known issues.
- - **Test Environment**: functional test environment configuration.
- - **Documentation**: pointers to CSIT source code documentation for
+ - **Test Environment**: Functional test environment configuration.
+ - **Documentation**: Pointers to CSIT source code documentation for
VPP functional tests.
#. **Honeycomb Functional**: Honeycomb functional tests executed in
virtual FD.io testbeds.
- - **Overview**: tested virtual topologies, test coverage and naming
+ - **Overview**: Tested virtual topologies, test coverage and naming
specifics;
- - **Release Notes** - changes in |csit-release|, known issues.
- - **Test Environment**: functional test environment configuration.
- - **Documentation**: pointers to CSIT source code documentation for
+ - **Release Notes**: Changes in |csit-release|, known issues.
+ - **Test Environment**: Functional test environment configuration.
+ - **Documentation**: Pointers to CSIT source code documentation for
Honeycomb functional tests.
#. **NSH_SFC Functional**: NSH_SFC functional tests executed in
virtual FD.io testbeds.
- - **Overview**: tested virtual topologies, test coverage and naming
+ - **Overview**: Tested virtual topologies, test coverage and naming
specifics;
- - **Release Notes** - changes in |csit-release|, known issues.
- - **Test Environment**: functional test environment configuration.
- - **Documentation**: pointers to CSIT source code documentation for
+ - **Release Notes**: Changes in |csit-release|, known issues.
+ - **Test Environment**: Functional test environment configuration.
+ - **Documentation**: Pointers to CSIT source code documentation for
NSH_SFC functional tests.
#. **DMM Functional**: DMM functional tests executed in
virtual FD.io testbeds.
- - **Overview**: tested virtual topologies, test coverage and naming
+ - **Overview**: Tested virtual topologies, test coverage and naming
specifics;
- - **Release Notes** - changes in |csit-release|, known issues.
- - **Test Environment**: functional test environment configuration.
- - **Documentation**: pointers to CSIT source code documentation for
+ - **Release Notes**: Changes in |csit-release|, known issues.
+ - **Test Environment**: Functional test environment configuration.
+ - **Documentation**: Pointers to CSIT source code documentation for
DMM functional tests.
-#. **Detailed Results**: detailed result tables auto-generated from CSIT
+#. **Detailed Results**: Detailed result tables auto-generated from CSIT
test job executions using RF (Robot Framework) output files as
sources.
@@ -115,19 +122,19 @@ files are also provided.
NDR/PDR throughput.
- **DPDK Performance**: DPDK Testpmd and L3fwd NDR/PDR throughput
and latency.
- - **VPP Functional**: detailed VPP functional results.
- - **Honeycomb Functional**: detailed HoneyComb functional results.
- - **NSH_SFC Functional**: detailed nsh-plugin functional results.
- - **DMM Functional**: detailed DMM functional results.
+ - **VPP Functional**: Detailed VPP functional results.
+ - **Honeycomb Functional**: Detailed HoneyComb functional results.
+ - **NSH_SFC Functional**: Detailed nsh-plugin functional results.
+ - **DMM Functional**: Detailed DMM functional results.
#. **Test Configuration**: VPP DUT configuration data based on VPP API
Test (VAT) Commands History auto-generated from CSIT test job
executions using RF output files as sources.
- - **VPP Performance NDR/PDR**: configuration data.
- - **VPP Performance MRR**: configuration data.
- - **VPP K8s Container Memif**: configuration data.
- - **VPP Functional**: configuration data.
+ - **VPP Performance NDR/PDR**: Configuration data.
+ - **VPP Performance MRR**: Configuration data.
+ - **VPP K8s Container Memif**: Configuration data.
+ - **VPP Functional**: Configuration data.
#. **Test Operational Data**: VPP DUT operational data auto-generated
from CSIT test job executions using RFoutput files as sources.
@@ -135,12 +142,12 @@ files are also provided.
- **VPP Performance NDR/PDR**: VPP `show run` outputs under test
load.
-#. **CSIT Framework Documentation**: description of the overall FD.io
+#. **CSIT Framework Documentation**: Description of the overall FD.io
CSIT framework.
- - **Design**: framework modular design hierarchy.
- - **Test naming**: test naming convention.
- - **Presentation and Analytics Layer**: description of PAL CSIT
+ - **Design**: Framework modular design hierarchy.
+ - **Test naming**: Test naming convention.
+ - **Presentation and Analytics Layer**: Description of PAL CSIT
analytics module.
- **CSIT RF Tags Descriptions**: CSIT RF Tags used for test suite and
test case grouping and selection.
diff --git a/docs/report/vpp_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst b/docs/report/vpp_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst
new file mode 100644
index 0000000000..c9e0bbbb99
--- /dev/null
+++ b/docs/report/vpp_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst
@@ -0,0 +1,61 @@
+3n-Skx vs. 3n-Hsw Testbeds
+--------------------------
+
+Relative comparison of |vpp-release| 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 comparison between testbed types is available in CSV and pretty
+ASCII formats:
+
+ - `CSV NDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-ndr.csv>`_,
+ - `ASCII NDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-ndr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor vpp performance job 3n-hsw`_ and
+ `FD.io test executor vpp performance job 3n-skx`_
+ with RF result
+ files csit-vpp-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
+
+PDR Comparison
+~~~~~~~~~~~~~~
+
+PDR comparison between testbed types is available in CSV and pretty
+ASCII formats:
+
+ - `CSV PDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-pdr.csv>`_,
+ - `ASCII PDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-pdr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor vpp performance job 3n-hsw`_ and
+ `FD.io test executor vpp performance job 3n-skx`_
+ with RF result
+ files csit-vpp-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
+
+MRR Comparison
+~~~~~~~~~~~~~~
+
+MRR comparison between testbed types is available in CSV and pretty
+ASCII formats:
+
+ - `CSV MRR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-mrr.csv>`_,
+ - `ASCII MRR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-mrr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor vpp performance job 3n-hsw`_ and
+ `FD.io test executor vpp performance job 3n-skx`_
+ with RF result
+ files csit-vpp-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
diff --git a/docs/report/vpp_performance_tests/comparisons/current_vs_previous_release.rst b/docs/report/vpp_performance_tests/comparisons/current_vs_previous_release.rst
new file mode 100644
index 0000000000..c2a87dc2ab
--- /dev/null
+++ b/docs/report/vpp_performance_tests/comparisons/current_vs_previous_release.rst
@@ -0,0 +1,76 @@
+Current vs. Previous Release
+----------------------------
+
+Relative comparison of VPP packet throughput (NDR, PDR and MRR) between
+|vpp-release| and |vpp-release-1| (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 VPP releases to verify
+test results repeatability, with percentage change calculated for mean
+values. Note that the standard deviation is quite high for a small
+number of packet throughput tests, what indicates poor test results
+repeatability and makes the relative change of mean throughput value not
+fully representative for these tests. The root causes behind poor
+results repeatability vary between the test cases.
+
+NDR Comparison
+~~~~~~~~~~~~~~
+
+NDR throughput comparison between releases is available in CSV and pretty
+ASCII formats:
+
+ - `CSV 1t1c NDR changes <../_static/vpp/performance-changes-1t1c-ndr.csv>`_,
+ - `CSV 2t2c NDR changes <../_static/vpp/performance-changes-2t2c-ndr.csv>`_,
+ - `ASCII 1t1c NDR changes <../_static/vpp/performance-changes-1t1c-ndr.txt>`_,
+ - `ASCII 2t2c NDR changes <../_static/vpp/performance-changes-2t2c-ndr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor vpp performance job 3n-hsw`_,
+ with RF result
+ files csit-vpp-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/vpp/performance-changes-1t1c-pdr.csv>`_,
+ - `CSV 2t2c PDR changes <../_static/vpp/performance-changes-2t2c-pdr.csv>`_,
+ - `ASCII 1t1c PDR changes <../_static/vpp/performance-changes-1t1c-pdr.txt>`_,
+ - `ASCII 2t2c PDR changes <../_static/vpp/performance-changes-2t2c-pdr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor vpp performance job 3n-hsw`_,
+ with RF result
+ files csit-vpp-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
+
+MRR Comparison
+~~~~~~~~~~~~~~
+
+MRR throughput comparison between releases is available in CSV and pretty
+ASCII formats:
+
+ - `CSV 1t1c MRR changes <../_static/vpp/performance-changes-1t1c-mrr.csv>`_,
+ - `CSV 2t2c MRR changes <../_static/vpp/performance-changes-2t2c-mrr.csv>`_,
+ - `CSV 4t4c MRR changes <../_static/vpp/performance-changes-4t4c-mrr.csv>`_,
+ - `ASCII 1t1c MRR changes <../_static/vpp/performance-changes-1t1c-mrr.txt>`_,
+ - `ASCII 2t2c MRR changes <../_static/vpp/performance-changes-2t2c-mrr.txt>`_,
+ - `ASCII 4t4c MRR changes <../_static/vpp/performance-changes-4t4c-mrr.txt>`_.
+
+.. note::
+
+ Test results have been generated by
+ `FD.io test executor vpp performance job 3n-hsw`_,
+ with RF result
+ files csit-vpp-perf-|srelease|-\*.zip
+ `archived here <../_static/archive/>`_.
diff --git a/docs/report/vpp_performance_tests/comparisons/index.rst b/docs/report/vpp_performance_tests/comparisons/index.rst
new file mode 100644
index 0000000000..a9179c6900
--- /dev/null
+++ b/docs/report/vpp_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/vpp_performance_tests/csit_release_notes.rst b/docs/report/vpp_performance_tests/csit_release_notes.rst
index c9df5478bc..0318e7a01e 100644
--- a/docs/report/vpp_performance_tests/csit_release_notes.rst
+++ b/docs/report/vpp_performance_tests/csit_release_notes.rst
@@ -54,163 +54,6 @@ Changes in |csit-release|
- **General Code Housekeeping**: Ongoing RF keywords optimizations,
removal of redundant RF keywords.
-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. Note that the standard deviation is quite high for a small
-number of packet throughput tests, what indicates poor test results
-repeatability and makes the relative change of mean throughput value not
-fully representative for these tests. The root causes behind poor
-results repeatability vary between the test cases.
-
-NDR Changes
-~~~~~~~~~~~
-
-NDR throughput changes between releases are available in CSV and pretty
-ASCII formats:
-
- - `CSV 1t1c NDR changes <../_static/vpp/performance-changes-1t1c-ndr.csv>`_,
- - `CSV 2t2c NDR changes <../_static/vpp/performance-changes-2t2c-ndr.csv>`_,
- - `ASCII 1t1c NDR changes <../_static/vpp/performance-changes-1t1c-ndr.txt>`_,
- - `ASCII 2t2c NDR changes <../_static/vpp/performance-changes-2t2c-ndr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor vpp performance job 3n-hsw`_,
- with RF result
- files csit-vpp-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/vpp/performance-changes-1t1c-pdr.csv>`_,
- - `CSV 2t2c PDR changes <../_static/vpp/performance-changes-2t2c-pdr.csv>`_,
- - `ASCII 1t1c PDR changes <../_static/vpp/performance-changes-1t1c-pdr.txt>`_,
- - `ASCII 2t2c PDR changes <../_static/vpp/performance-changes-2t2c-pdr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor vpp performance job 3n-hsw`_,
- with RF result
- files csit-vpp-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-MRR Changes
-~~~~~~~~~~~
-
-MRR throughput changes between releases are available in CSV and pretty
-ASCII formats:
-
- - `CSV 1t1c MRR changes <../_static/vpp/performance-changes-1t1c-mrr.csv>`_,
- - `CSV 2t2c MRR changes <../_static/vpp/performance-changes-2t2c-mrr.csv>`_,
- - `CSV 4t4c MRR changes <../_static/vpp/performance-changes-4t4c-mrr.csv>`_,
- - `ASCII 1t1c MRR changes <../_static/vpp/performance-changes-1t1c-mrr.txt>`_,
- - `ASCII 2t2c MRR changes <../_static/vpp/performance-changes-2t2c-mrr.txt>`_,
- - `ASCII 4t4c MRR changes <../_static/vpp/performance-changes-4t4c-mrr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor vpp performance job 3n-hsw`_,
- with RF result
- files csit-vpp-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-Skx vs. Hsw Comparison
-----------------------
-
-Relative performance comparison in measured NDR, PDR and MRR packet
-throughput is calculated for tests executed on 3-Node Skylake (3n-skx)
-and 3-Node Haswell (3n-hsw) physical testbed types in 1-core
-configurations.
-
-NDR Comparison
-~~~~~~~~~~~~~~
-
-NDR comparison between testbed types is available in CSV and pretty
-ASCII formats:
-
- - `CSV 1c NDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-ndr.csv>`_,
- - `ASCII 1c NDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-ndr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor vpp performance job 3n-hsw`_ and
- `FD.io test executor vpp performance job 3n-skx`_
- with RF result
- files csit-vpp-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-PDR Comparison
-~~~~~~~~~~~~~~
-
-PDR comparison between testbed types is available in CSV and pretty
-ASCII formats:
-
- - `CSV 1c PDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-pdr.csv>`_,
- - `ASCII 1c PDR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-pdr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor vpp performance job 3n-hsw`_ and
- `FD.io test executor vpp performance job 3n-skx`_
- with RF result
- files csit-vpp-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-MRR Comparison
-~~~~~~~~~~~~~~
-
-MRR comparison between testbed types is available in CSV and pretty
-ASCII formats:
-
- - `CSV 1c MRR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-mrr.csv>`_,
- - `ASCII 1c MRR comparison <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-mrr.txt>`_.
-
-.. note::
-
- Test results have been generated by
- `FD.io test executor vpp performance job 3n-hsw`_ and
- `FD.io test executor vpp performance job 3n-skx`_
- with RF result
- files csit-vpp-perf-|srelease|-\*.zip
- `archived here <../_static/archive/>`_.
-
-Throughput Trending
--------------------
-
-In addition to reporting throughput changes between VPP releases, CSIT
-provides continuous performance trending for VPP master branch:
-
-#. `VPP Performance Dashboard <https://docs.fd.io/csit/master/trending/introduction/index.html>`_
- - per VPP 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, outlier).
-
-#. `Trendline Graphs <https://docs.fd.io/csit/master/trending/trending/index.html>`_
- - per VPP build MRR throughput measurements against the trendline
- with anomaly highlights, with associated CSIT test jobs.
-
Known Issues
------------
diff --git a/docs/report/vpp_performance_tests/index.rst b/docs/report/vpp_performance_tests/index.rst
index abef2c8667..888be08ac2 100644
--- a/docs/report/vpp_performance_tests/index.rst
+++ b/docs/report/vpp_performance_tests/index.rst
@@ -9,5 +9,7 @@ VPP Performance
throughput_speedup_multi_core/index
packet_latency_graphs/index
http_server_performance/index
+ comparisons/index
+ throughput_trending
test_environment
documentation/index
diff --git a/docs/report/vpp_performance_tests/throughput_trending.rst b/docs/report/vpp_performance_tests/throughput_trending.rst
new file mode 100644
index 0000000000..c2ca421d57
--- /dev/null
+++ b/docs/report/vpp_performance_tests/throughput_trending.rst
@@ -0,0 +1,17 @@
+Throughput Trending
+-------------------
+
+In addition to reporting throughput comparison between VPP releases,
+CSIT provides continuous performance trending for VPP master branch:
+
+#. `VPP Performance Dashboard <https://docs.fd.io/csit/master/trending/introduction/index.html>`_
+ - per VPP 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).
+
+#. `Trendline Graphs <https://docs.fd.io/csit/master/trending/trending/index.html>`_
+ - per VPP build MRR throughput measurements against the trendline
+ with anomaly highlights and associated CSIT test jobs. \ No newline at end of file