From 637eb126bb4ed30df61a293e03d36bd8ad5265e5 Mon Sep 17 00:00:00 2001 From: Maciek Konstantynowicz Date: Fri, 17 Aug 2018 15:31:08 +0100 Subject: [PATCH] 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 --- .../comparisons/3n-skx_vs_3n-hsw_testbeds.rst | 61 ++++++++ .../comparisons/current_vs_previous_release.rst | 51 +++++++ .../dpdk_performance_tests/comparisons/index.rst | 13 ++ .../dpdk_performance_tests/csit_release_notes.rst | 115 +-------------- docs/report/dpdk_performance_tests/index.rst | 2 + .../dpdk_performance_tests/throughput_trending.rst | 17 +++ docs/report/index.html.template | 4 + docs/report/introduction/introduction.rst | 95 +++++++------ .../comparisons/3n-skx_vs_3n-hsw_testbeds.rst | 61 ++++++++ .../comparisons/current_vs_previous_release.rst | 76 ++++++++++ .../vpp_performance_tests/comparisons/index.rst | 13 ++ .../vpp_performance_tests/csit_release_notes.rst | 157 --------------------- docs/report/vpp_performance_tests/index.rst | 2 + .../vpp_performance_tests/throughput_trending.rst | 17 +++ 14 files changed, 369 insertions(+), 315 deletions(-) create mode 100644 docs/report/dpdk_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst create mode 100644 docs/report/dpdk_performance_tests/comparisons/current_vs_previous_release.rst create mode 100644 docs/report/dpdk_performance_tests/comparisons/index.rst create mode 100644 docs/report/dpdk_performance_tests/throughput_trending.rst create mode 100644 docs/report/vpp_performance_tests/comparisons/3n-skx_vs_3n-hsw_testbeds.rst create mode 100644 docs/report/vpp_performance_tests/comparisons/current_vs_previous_release.rst create mode 100644 docs/report/vpp_performance_tests/comparisons/index.rst create mode 100644 docs/report/vpp_performance_tests/throughput_trending.rst 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 `_ + - per DPDK test case throughput trend, trend compliance and summary of + detected anomalies. + +#. `Trending Methodology `_ + - throughput test metrics, trend calculations and anomaly + classification (progression, regression). + +#. `DPDK Apps Trendline Graphs `_ + - 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 `_ - - per VPP test case throughput trend, trend compliance and summary of - detected anomalies. - -#. `Trending Methodology `_ - - throughput test metrics, trend calculations and anomaly - classification (progression, regression, outlier). - -#. `Trendline Graphs `_ - - 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 `_ + - per VPP test case throughput trend, trend compliance and summary of + detected anomalies. + +#. `Trending Methodology `_ + - throughput test metrics, trend calculations and anomaly + classification (progression, regression). + +#. `Trendline Graphs `_ + - per VPP build MRR throughput measurements against the trendline + with anomaly highlights and associated CSIT test jobs. \ No newline at end of file -- 2.16.6