X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fvpp_performance_tests%2Fcsit_release_notes.rst;h=d1045bff75922d72897ad9044cc4ee9824e92efb;hp=d029bd0e74fcca4cd000f316c8b0618daee15c9c;hb=0da2c5e0d0bd852d50d4f9c4ecdd13d0c4effb5a;hpb=1c66ee7e4d3c0ac6375c1c5ca15bc349d8cb3bfa diff --git a/docs/report/vpp_performance_tests/csit_release_notes.rst b/docs/report/vpp_performance_tests/csit_release_notes.rst index d029bd0e74..d1045bff75 100644 --- a/docs/report/vpp_performance_tests/csit_release_notes.rst +++ b/docs/report/vpp_performance_tests/csit_release_notes.rst @@ -8,61 +8,66 @@ Changes in CSIT |release| - **Container Topologies Orchestrated by K8s with VPP memif tests** - - Added tests with VPP in L2 Cross-Connect and Bridge-Domain configurations - connecting over memif virtual interfaces VPPs running in Docker - containers, with service chain topologies orchestrated by Kubernetes. - Chained, horizontal and standalone linked topologies added; + - Added tests with VPP in L2 Cross-Connect and Bridge-Domain + configurations containers, with service chain topologies orchestrated by + Kubernetes. Added following forwarding topologies: i) "Parallel" with + packets flowing from NIC via VPP to container and back to VPP and NIC; + ii) "Chained" a.k.a. "Snake" with packets flowing via VPP to container, + back to VPP, to next container, back to VPP and so on until the last + container in chain, then back to VPP and NIC; iii) "Horizontal" with + packets flowing via VPP to container, then via "horizontal" memif to + next container, and so on until the last container, then back to VPP and + NIC;. - **VPP TCP/IP stack** - - Added tests with VPP builtin TCP based HTTP server. WRK traffic generator - is used. + - Added tests for VPP TCP/IP stack using VPP built-in HTTP server. + WRK traffic generator is used as a client-side; - **SRv6 tests** - - [placeholder] + - Initial SRv6 (Segment Routing IPv6) tests verifying performance of + IPv6 and SRH (Segment Routing Header) encapsulation, decapsulation, + lookups and rewrites based on configured End and End.DX6 SRv6 egress + functions; - **IPSecSW tests** - SW computed IPSec encryption with AES-GCM, CBC-SHA1 ciphers, in - combination with IPv4 routed-forwarding. + combination with IPv4 routed-forwarding; #. Presentation and Analytics Layer - - Added multi-core scale-up analysis into Presentation and Analytics Layer - (PAL) for automated CSIT test results analysis; - + - Added throughput speedup analysis for multi-core and multi-thread + VPP tests into Presentation and Analytics Layer (PAL) for automated + CSIT test results analysis; #. Other improvements - **Framework optimizations** - - Ability to run CSIT framework on ARM architecture. + - Ability to run CSIT framework on ARM architecture; - - Overall stability improvements. + - Overall stability improvements; -Performance Improvements ------------------------- +Performance Changes +------------------- -Substantial improvements in measured packet throughput have been observed in a -number of CSIT |release| tests listed below, with relative increase of -double-digit percentage points. Relative improvements for this release are -calculated against the test results listed in CSIT |release-1| report. The +Substantial changes in measured packet throughput have been observed in a +number of CSIT |release| tests listed below. Relative changes for this release +are calculated against the test results listed in CSIT |release-1| report. The comparison is calculated between the mean values based on collected and archived test results' samples for involved VPP releases. Standard deviation -has been also listed for CSIT |release|. Performance numbers since release -VPP-16.09 are provided for reference. - -NDR Throughput -~~~~~~~~~~~~~~ +has been also listed for CSIT |release|. -Non-Drop Rate Throughput discovery tests: +NDR Throughput: Best 20 Changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. only:: html .. csv-table:: :align: center - :file: performance_improvements/performance_improvements_ndr_top.csv + :file: ../../../_build/_static/vpp/performance-changes-ndr-1t1c-top.csv .. only:: latex @@ -70,7 +75,7 @@ Non-Drop Rate Throughput discovery tests: \makeatletter \csvset{ - perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{ m{1.5cm} m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, + perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, } \makeatother @@ -81,20 +86,17 @@ Non-Drop Rate Throughput discovery tests: perfimprovements column width=1cm, late after line={\\\hline}, late after last line={\end{longtable}} - ]{../_tmp/src/vpp_performance_tests/performance_improvements/performance_improvements_ndr_top.csv} + ]{../_build/_static/vpp/performance-changes-ndr-1t1c-top.csv} } - -PDR Throughput -~~~~~~~~~~~~~~ - -Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%: +NDR Throughput: Worst 20 Changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. only:: html .. csv-table:: :align: center - :file: performance_improvements/performance_improvements_pdr_top.csv + :file: ../../../_build/_static/vpp/performance-changes-ndr-1t1c-bottom.csv .. only:: latex @@ -102,7 +104,7 @@ Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%: \makeatletter \csvset{ - perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{ m{1.5cm} m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, + perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, } \makeatother @@ -113,32 +115,32 @@ Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%: perfimprovements column width=1cm, late after line={\\\hline}, late after last line={\end{longtable}} - ]{../_tmp/src/vpp_performance_tests/performance_improvements/performance_improvements_pdr_top.csv} + ]{../../_build/_static/vpp/performance-changes-ndr-1t1c-bottom.csv} } +.. only:: html -Measured improvements are in line with VPP code optimizations listed in -`VPP-17.10 release notes -`_. - -Other Performance Changes -------------------------- + NDR Throughput: All Changes + ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Other changes in measured packet throughput, with either minor relative increase -or decrease, have been observed in a number of CSIT |release| tests listed -below. Relative changes are calculated against the test results listed in CSIT -|release-1| report. + Complete results for all NDR tests are available in a CSV and pretty + ASCII formats: -NDR Throughput -~~~~~~~~~~~~~~ + - `csv format for 1t1c <../_static/vpp/performance-changes-ndr-1t1c-full.csv>`_, + - `csv format for 2t2c <../_static/vpp/performance-changes-ndr-2t2c-full.csv>`_, + - `csv format for 4t4c <../_static/vpp/performance-changes-ndr-4t4c-full.csv>`_, + - `pretty ASCII format for 1t1c <../_static/vpp/performance-changes-ndr-1t1c-full.txt>`_, + - `pretty ASCII format for 2t2c <../_static/vpp/performance-changes-ndr-2t2c-full.txt>`_, + - `pretty ASCII format for 4t4c <../_static/vpp/performance-changes-ndr-4t4c-full.txt>`_. -Non-Drop Rate Throughput discovery tests: +PDR Throughput: Best 20 Changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. only:: html .. csv-table:: :align: center - :file: performance_improvements/performance_improvements_ndr_low.csv + :file: ../../../_build/_static/vpp/performance-changes-pdr-1t1c-top.csv .. only:: latex @@ -146,7 +148,7 @@ Non-Drop Rate Throughput discovery tests: \makeatletter \csvset{ - perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{ m{1.5cm} m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, + perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, } \makeatother @@ -157,20 +159,17 @@ Non-Drop Rate Throughput discovery tests: perfimprovements column width=1cm, late after line={\\\hline}, late after last line={\end{longtable}} - ]{../_tmp/src/vpp_performance_tests/performance_improvements/performance_improvements_ndr_low.csv} + ]{../../../_build/_static/vpp/performance-changes-pdr-1t1c-top.csv} } - -PDR Throughput -~~~~~~~~~~~~~~ - -Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%: +PDR Throughput: Worst 20 Changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. only:: html .. csv-table:: :align: center - :file: performance_improvements/performance_improvements_pdr_low.csv + :file: ../../../_build/_static/vpp/performance-changes-pdr-1t1c-bottom.csv .. only:: latex @@ -178,7 +177,7 @@ Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%: \makeatletter \csvset{ - perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{ m{1.5cm} m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, + perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead}, } \makeatother @@ -189,9 +188,27 @@ Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%: perfimprovements column width=1cm, late after line={\\\hline}, late after last line={\end{longtable}} - ]{../_tmp/src/vpp_performance_tests/performance_improvements/performance_improvements_pdr_low.csv} + ]{../../../../_build/_static/vpp/performance-changes-pdr-1t1c-bottom.csv} } +.. only:: html + + PDR Throughput: All Changes + ~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Complete results for all PDR tests are available in a CSV and pretty + ASCII formats: + + - `csv format for 1t1c <../_static/vpp/performance-changes-pdr-1t1c-full.csv>`_, + - `csv format for 2t2c <../_static/vpp/performance-changes-pdr-2t2c-full.csv>`_, + - `csv format for 4t4c <../_static/vpp/performance-changes-pdr-4t4c-full.csv>`_, + - `pretty ASCII format for 1t1c <../_static/vpp/performance-changes-pdr-1t1c-full.txt>`_, + - `pretty ASCII format for 2t2c <../_static/vpp/performance-changes-pdr-2t2c-full.txt>`_, + - `pretty ASCII format for 4t4c <../_static/vpp/performance-changes-pdr-4t4c-full.txt>`_. + +Measured improvements are in line with VPP code optimizations listed in +`VPP-17.10 release notes +`_. Known Issues ------------ @@ -214,4 +231,3 @@ Here is the list of known issues in CSIT |release| for VPP performance tests: | 4 | Lower than expected NDR throughput with | CSIT-569 | Suspected NIC firmware or DPDK driver issue affecting NDR and | | | xl710 and x710 NICs, compared to x520 NICs. | | PDR throughput. Applies to XL710 and X710 NICs. | +---+-------------------------------------------------+------------+-----------------------------------------------------------------+ -