X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Freport%2Fvpp_performance_tests%2Fcsit_release_notes.rst;h=fce6e1c7033d95d3a9358a0755949c0f462959b3;hb=dbd371e940a5136fcaf68a1181b55943259c67c1;hp=da25ef6bd5ec332065629c2aaeafc4b5c6663e54;hpb=c5bb42a7c4fb7c7fd8a62947250d91f8e81668f7;p=csit.git diff --git a/docs/report/vpp_performance_tests/csit_release_notes.rst b/docs/report/vpp_performance_tests/csit_release_notes.rst index da25ef6bd5..fce6e1c703 100644 --- a/docs/report/vpp_performance_tests/csit_release_notes.rst +++ b/docs/report/vpp_performance_tests/csit_release_notes.rst @@ -1,224 +1,164 @@ +.. _vpp_performance_tests_release_notes: + Release Notes ============= Changes in |csit-release| ------------------------- -#. **VPP performance tests** - - - *MRR tests* - Maximum Receive Rate tests measure the packet forwarding rate - under the maximum load offered by traffic generator over a set trial - duration, regardless of packet loss. MRR tests are used for continuous - performance trending and for comparison between releases. - - - *MLR tests* - NDR and PDR tests measure the packet forwarding rate using - MLRsearch library by traffic generator. All tests that previously used - binary search were converted to MLRsearch. - - - *L2patch tests* - Tests measure performance of L2patch, cross linking - RX and TX of two physical interfaces. - - - *2-node tests* - Baseline set of 2-node tests covering base ip4, ip4, - l2patch, l2bd, l2xc. - - - *Generated tests* - Simplified and unified test structure, - semi-autogenerated by generator script. Test generator is currently able - to create test combinations with various frame size and cores combinations. - All existing test cases were converted to new format. - - - *Simultaneous multithreading* - SMT-aware automatic detection and - resource configuration including thread affinity, number of rx queues and - DPDK I/O mbufs. Tests are automatically tagged during execution indicating - configuration. - - - *Intel Skylake* - Topologies consisting of 2-node and 3-node using - SuperMirco servers each equipped with two Intel Xeon Skylake Platinum - processors. - -#. **Presentation and Analytics Layer** - - - *Performance trending* - Added continuous performance trending and - analysis. New Performance Trending and Performance Analysis jobs - executed regular throughput tests, with results being subsequently - analysed and trend and anomalies summarized and presented in VPP - Performance Dashboard and trendline graphs. - -#. **Test Framework Optimizations** - - - *Performance tests efficiency* - Qemu build/install optimizations, - warmup phase handling, vpp restart handling. Resulted in improved - stability and reduced total execution time by 30% for single pkt - size e.g. 64B/78B. - - - *General code housekeeping* - ongoing RF keywords optimizations, - removal of redundant RF keywords. - -Performance Changes -------------------- - -Relative performance changes in measured packet throughput in |csit-release| -are calculated against the results from |csit-release-1| -report. 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 a -CSV and pretty ASCII formats: - - - `csv format for 1t1c <../_static/vpp/performance-changes-1t1c-ndr.csv>`_, - - `csv format for 2t2c <../_static/vpp/performance-changes-2t2c-ndr.csv>`_, - - `pretty ASCII format for 1t1c <../_static/vpp/performance-changes-1t1c-ndr.txt>`_, - - `pretty ASCII format for 2t2c <../_static/vpp/performance-changes-2t2c-ndr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor vpp performance job 3n-hsw`_, - with Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -PDR Changes -~~~~~~~~~~~ - -PDR throughput changes between releases are available in a -CSV and pretty ASCII formats: - - - `csv format for 1t1c <../_static/vpp/performance-changes-1t1c-pdr.csv>`_, - - `csv format for 2t2c <../_static/vpp/performance-changes-2t2c-pdr.csv>`_, - - `pretty ASCII format for 1t1c <../_static/vpp/performance-changes-1t1c-pdr.txt>`_, - - `pretty ASCII format for 2t2c <../_static/vpp/performance-changes-2t2c-pdr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor vpp performance job 3n-hsw`_, - with Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -MRR Changes -~~~~~~~~~~~ - -MRR small packet throughput changes between releases are available in a -CSV and pretty ASCII formats: - - - `csv format for 1t1c <../_static/vpp/performance-changes-1t1c-mrr.csv>`_, - - `csv format for 2t2c <../_static/vpp/performance-changes-2t2c-mrr.csv>`_, - - `csv format for 4t4c <../_static/vpp/performance-changes-4t4c-mrr.csv>`_, - - `pretty ASCII format for 1t1c <../_static/vpp/performance-changes-1t1c-mrr.txt>`_, - - `pretty ASCII format for 2t2c <../_static/vpp/performance-changes-2t2c-mrr.txt>`_, - - `pretty ASCII format for 4t4c <../_static/vpp/performance-changes-4t4c-mrr.txt>`_. - -.. note:: - - Test results have been generated by - `FD.io test executor vpp performance job 3n-hsw`_, - with Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -Comparison Across Testbeds --------------------------- - -Relative performance changes in measured packet throughputon 3-Node Skx testbed -are calculated against the results measured on 3-Node Hsw testbed. - -NDR Changes -~~~~~~~~~~~ - -NDR changes between testbeds are available in a -CSV and pretty ASCII formats: - - - `csv format for ndr <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-ndr.csv>`_, - - `pretty ASCII format for ndr <../_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 Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. - -PDR Changes -~~~~~~~~~~~ - -PDR throughput changes between testbeds are available in a -CSV and pretty ASCII formats: +#. VPP PERFORMANCE TESTS - - `csv format for pdr <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-pdr.csv>`_, - - `pretty ASCII format for pdr <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-pdr.txt>`_. + - **Enhanced and added VPP hoststack tests** to daily and weekly + trending including: Quic VPP Echo, UDP+TCP LD_PRELOAD iPerf3, + LD_PRELOAD NGINX. -.. note:: + - **Added Nvidia/Mellanox DPDK tests** to daily and weekly trending + and report, in addition to RDMA_CORE ones that were already + there. - 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 Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. + - **Jumbo frames tests** got fixed and re-added number of to report + coverage tests. -MRR Changes -~~~~~~~~~~~ + - **Intel Xeon SKX performance testbeds** got decommissioned and + removed from FD.io performance lab. -MRR throughput changes between testbeds are available in a -CSV and pretty ASCII formats: +#. TEST FRAMEWORK - - `csv format for mrr <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-mrr.csv>`_, - - `pretty ASCII format for mrr <../_static/vpp/performance-compare-testbeds-3n-hsw-3n-skx-mrr.txt>`_. + - **CSIT test environment** version has not changed from ver. 11 used + in previous release, see :ref:`test_environment_versioning`. -.. note:: + - **CSIT PAPI optimizations for scale** got applied improving PAPI + programming speed especially for large scale tests. VAT has been + now completely deprecated from CSIT. - 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 Robot Framework result - files csit-vpp-perf-|srelease|-\*.zip - `archived here <../_static/archive/>`_. + - **General Code Housekeeping**: Ongoing code optimizations and bug + fixes. -Throughput Trending -------------------- +#. PRESENTATION AND ANALYTICS LAYER -In addition to reporting throughput changes between VPP releases, CSIT -provides continuous performance trending for VPP master branch: + - `Performance dashboard `_ got updated with + addition of VPP telemetry trending across all VPP tests. A number + of code and AWS resource usage optimizations got applied to the + data processing pipeline and UI frontend and backend. -#. `VPP Performance Dashboard `_ - - per VPP test case throughput trend, trend compliance and summary of - detected anomalies. +.. raw:: latex -#. `Trending Methodology `_ - - throughput test metrics, trend calculations and anomaly - classification (progression, regression, outlier). + \clearpage -#. `Trendline Graphs `_ - - per VPP build MRR throughput measurements against the trendline - with anomaly highlights, with associated CSIT test jobs. +.. _vpp_known_issues: Known Issues ------------ -List of known issues in |csit-release| for VPP performance tests: - -+---+-------------------------------------------------+------------+-----------------------------------------------------------------+ -| # | Issue | Jira ID | Description | -+===+=================================================+============+=================================================================+ -| 1 | Sporadic (1 in 200) NDR discovery test failures | CSIT-570 | DPDK reporting rx-errors, indicating L1 issue. Suspected issue | -| | on x520. | | with HW combination of X710-X520 in LF testbeds. Not observed | -| | | | outside of LF testbeds. | -+---+-------------------------------------------------+------------+-----------------------------------------------------------------+ -| 2 | High failure rate of api call | VPP-1361 | Failure rate: 30-40% of tests failing due to interfaces not | -| | sw_interface_set_flags [admin-up|link-up] | | in link-up state after API call sw_interface_set_flags. | -+---+-------------------------------------------------+------------+-----------------------------------------------------------------+ -| 3 | Scale IPSecHW Interface mode throughput | CSIT-1234 | IPSec throughput regression: NDR -28%..-31%, PDR -28%..-31%, | -| | regression. | | MRR -40%. Affects IPSec HW Scale 1000tnl tests with Int mode. | -+---+-------------------------------------------------+------------+-----------------------------------------------------------------+ +Editing Note: below listed known issues need to be updated to reflect the current state as tracked on `CSIT TestFailuresTracking wiki `_. + +New +___ + ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| # | JiraID | Issue Description | ++====+=========================================+===========================================================================================================+ +| 1 | `CSIT-1890 | 3n-alt: Tests failing until 40Ge Interface comes up. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ + +Previous +________ + +Issues reported in previous releases which still affect the current results. + ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| # | JiraID | Issue Description | ++====+=========================================+===========================================================================================================+ +| 1 | `CSIT-1782 | Multicore AVF tests are failing when trying to create interface. | +| | `_ | Frequency is reduced by CSIT workaround, but occasional failures do still happen. | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 2 | `CSIT-1785 | NAT44ED tests failing to establish all TCP sessions. | +| | `_ | At least for max scale, in allotted time (limited by session 500s timeout) due to worse | +| +-----------------------------------------+ slow path performance than previously measured and calibrated for. | +| | `VPP-1972 | CSIT removed the max scale NAT tests to avoid this issue. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 3 | `CSIT-1799 | All NAT44-ED 16M sessions CPS scale tests fail while setting NAT44 address range. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 4 | `CSIT-1800 | All Geneve L3 mode scale tests (1024 tunnels) are failing. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 5 | `CSIT-1801 | 9000B payload frames not forwarded over tunnels due to violating supported Max Frame Size (VxLAN, LISP, | +| | `_ | SRv6). | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 6 | `CSIT-1802 | all testbeds: AF-XDP - NDR tests failing from time to time. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 7 | `CSIT-1804 | All testbeds: NDR tests failing from time to time. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 8 | `CSIT-1808 | All tests with 9000B payload frames not forwarded over memif interfaces. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 9 | `CSIT-1827 | 3n-icx, 3n-skx: all AVF crypto tests sporadically fail. 1518B with no traffic, IMIX with excessive | +| | `_ | packet loss. | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 10 | `CSIT-1835 | 3n-icx: QUIC vppecho BPS tests failing on timeout when checking hoststack finished. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 11 | `CSIT-1849 | 2n-skx, 2n-clx, 2n-icx: UDP 16m TPUT tests fail to create all sessions. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 12 | `CSIT-1864 | 2n-clx: half of the packets lost on PDR tests. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 13 | `CSIT-1877 | 3n-tsh: all VM tests failing to boot VM. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 14 | `CSIT-1883 | 3n-snr: All hwasync wireguard tests failing when trying to verify device. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 15 | `CSIT-1884 | 2n-clx, 2n-icx: All NAT44DET NDR PDR IMIX over 1M sessions BIDIR tests failing to create enough sessions. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 16 | `CSIT-1885 | 3n-icx: 9000b ip4 ip6 l2 NDRPDR AVF tests are failing to forward traffic. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 17 | `CSIT-1886 | 3n-icx: Wireguard tests with 100 and more tunnels are failing PDR criteria. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ + +Fixed +_____ + +Issues reported in previous releases which were fixed in this release: + ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| # | JiraID | Issue Description | ++====+=========================================+===========================================================================================================+ +| 1 | `CSIT-1868 | 2n-clx: ALL ldpreload-nginx tests fails when trying to start nginx. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ +| 2 | `CSIT-1871 | 3n-snr: 25GE interface between SUT and TG/TRex goes down randomly. | +| | `_ | | ++----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+ + +.. _vpp_rca: + +Root Cause Analysis for Performance Changes +------------------------------------------- + +List of RCAs in |csit-release| for VPP performance changes: + ++----+-----------------------------------------+--------------------------------------------------------------------+ +| # | JiraID | Issue Description | ++====+=========================================+====================================================================+ +| 1 | `CSIT-1887 | rls2210 RCA: ASTF tests | +| | `_ | TRex upgrade decreased TRex performance. NAT results not affected, | +| | | except on Denverton due to interference from VPP-2010. | ++----+-----------------------------------------+--------------------------------------------------------------------+ +| 2 | `CSIT-1888 | rls2210 RCA: testbed differences, especially for ipsec | +| | `_ | Not caused by VPP code nor CSIT code. | +| | | Most probable cause is clang-14 behavior. | ++----+-----------------------------------------+--------------------------------------------------------------------+ +| 3 | `CSIT-1889 | rls2210 RCA: policy-outbound-nocrypto | +| | `_ | When VPP added spd fast path matching (Gerrit 36097), | +| | | it decreased MRR of the corresponding tests, at least on 3-alt. | ++----+-----------------------------------------+--------------------------------------------------------------------+