9b7a0a145c609b8fa6dcbd24ad9e4a64a2571f0a
[csit.git] / docs / report / vpp_performance_tests / csit_release_notes.rst
1 .. _vpp_performance_tests_release_notes:
2
3 Release Notes
4 =============
5
6 Changes in |csit-release|
7 -------------------------
8
9 #. VPP PERFORMANCE TESTS
10
11    - **Regressions with DPDK drivers**: Change from DPDK v21.08 to DPDK
12      v21.11 introduced regression across all tests using dpdk
13      drivers (with dpdk_plugin loaded). Compared to previous VPP
14      release performance drop varies in the range of -15% to -6%,
15      depending on test. It is related to updated MTU checks within
16      DPDK code and associated VPP code changes. See
17      `VPP v2202 release notes <https://s3-docs.fd.io/vpp/22.02/aboutvpp/releasenotes/v22.02.html>`_
18      and :ref:`vpp_known_issues`.
19
20    - **Number of CSIT 9000B frame tests failing**: tests with higher
21      encapsulation overhead are failing due to exceeding default
22      Ethernet Maximum Frame Size value that has been reduced by MTU
23      related VPP code changes. See
24      `VPP v2202 release notes <https://s3-docs.fd.io/vpp/22.02/aboutvpp/releasenotes/v22.02.html>`_
25      and :ref:`vpp_known_issues`.
26
27    - **Intel Xeon Ice Lake**: Performance test data for these platforms
28      is now provided by testbeds newly installed in FD.io CSIT labs.
29      For details about the physical setup see
30      :ref:`physical_testbeds_2n_icx` and
31      :ref:`physical_testbeds_3n_icx`.
32
33    - **Arm Ampere Altra**: Performance test data for these platforms
34      is now provided by testbeds newly installed in FD.io CSIT labs.
35      For details about the physical setup see
36      :ref:`physical_testbeds_3n_alt`.
37
38    - **Reduction of tests**: Removed certain test variations executed
39      iteratively for the report (as well as in daily and weekly
40      trending) due to physical testbeds overload.
41
42    - **RC2 coverage test data is used for 2n-icx test bed**: There is only
43      one 2n-icx test bed and the amount of tests is large (same as 2n-skx with 4
44      test beds), so we decided to use test data already available from RC2
45      testing.
46
47 #. TEST FRAMEWORK
48
49    - **CSIT test environment** version has been updated to ver. 10, see
50      :ref:`test_environment_versioning`.
51
52    - **CSIT PAPI support**: Due to issues with PAPI performance, and
53      deprecation of VAT, VPP CLI is used in CSIT for many VPP scale
54      tests. See :ref:`vpp_known_issues`.
55
56    - **General Code Housekeeping**: Ongoing code optimizations and bug
57      fixes.
58
59 #. PRESENTATION AND ANALYTICS LAYER
60
61    - **Graphs improvements**: Updated Packet Latency graphs,
62      see :ref:`latency_methodology`.
63
64 .. raw:: latex
65
66     \clearpage
67
68 .. _vpp_known_issues:
69
70 Known Issues
71 ------------
72
73 New
74 ___
75
76 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
77 |  # | JiraID                                  | Issue Description                                                                                         |
78 +====+=========================================+===========================================================================================================+
79 |  1 | `CSIT-1799                              | All NAT44-ED 16M scale tests fail while setting NAT44 address range.                                      |
80 |    | <https://jira.fd.io/browse/CSIT-1799>`_ |                                                                                                           |
81 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
82 |  2 | `CSIT-1800                              | All Geneve L3 mode scale tests (1024 tunnels) are failing.                                                |
83 |    | <https://jira.fd.io/browse/CSIT-1800>`_ |                                                                                                           |
84 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
85 |  3 | `CSIT-1801                              | 9000B payload frames not forwarded over tunnels due to violating supported Max Frame Size (VxLAN, LISP,   |
86 |    | <https://jira.fd.io/browse/CSIT-1801>`_ | SRv6).                                                                                                    |
87 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
88 |  4 | `CSIT-1808                              | All tests with 9000B payload frames not forwarded over memif interfaces.                                  |
89 |    | <https://jira.fd.io/browse/CSIT-1808>`_ |                                                                                                           |
90 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
91 |  5 | `CSIT-1809                              | All tests with 9000B payload frames not forwarded over vhostuser interfaces.                              |
92 |    | <https://jira.fd.io/browse/CSIT-1809>`_ |                                                                                                           |
93 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
94 |  6 | `CSIT-1802                              | AF-XDP - NDR tests failing from time to time.                                                             |
95 |    | <https://jira.fd.io/browse/CSIT-1802>`_ |                                                                                                           |
96 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
97 |  7 | `CSIT-1803                              | 3n-icx testbeds (Icelake): all IMIX aes128cbc-hmac512sha tests are failing due to excessive packet loss.  |
98 |    | <https://jira.fd.io/browse/CSIT-1803>`_ |                                                                                                           |
99 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
100 |  8 | `CSIT-1804                              | 3n-tsh testbed (Taishan): NDR tests failing from time to time.                                            |
101 |    | <https://jira.fd.io/browse/CSIT-1804>`_ |                                                                                                           |
102 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
103 |  9 | `CSIT-1805                              | 3n-skx testbeds (Skylake): all hoststack quic vppecho scale tests are failing.                            |
104 |    | <https://jira.fd.io/browse/CSIT-1805>`_ |                                                                                                           |
105 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
106 | 10 | `CSIT-1810                              | DPDK - performance regression with DPDK driver when Max Frame Size is set to less than 2023.              |
107 |    | <https://jira.fd.io/browse/CSIT-1810>`_ |                                                                                                           |
108 |    +-----------------------------------------+                                                                                                           |
109 |    | `VPP-1876                               | Worse performance with DPDK driver when MTU is set to 2022 or less.                                       |
110 |    | <https://jira.fd.io/browse/VPP-1876>`_  |                                                                                                           |
111 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
112 | 11 | `CSIT-1811                              | All 9000B NAT44DET 64k 1m scale tests fail due to bps rate set to high on TRex.                           |
113 |    | <https://jira.fd.io/browse/CSIT-1811>`_ |                                                                                                           |
114 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
115 | 12 | `CSIT-1812                              | All IMIX NAT44DET 4m 16m scale tests fail due to not creating required session count.                     |
116 |    | <https://jira.fd.io/browse/CSIT-1812>`_ |                                                                                                           |
117 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
118
119
120 Previous
121 ________
122
123 Issues reported in previous releases which still affect the current results.
124
125 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
126 |  # | JiraID                                  | Issue Description                                                                                         |
127 +====+=========================================+===========================================================================================================+
128 |  1 | `CSIT-1782                              | Multicore AVF tests are failing when trying to create interface.                                          |
129 |    | <https://jira.fd.io/browse/CSIT-1782>`_ | Frequency is reduced by CSIT workaround, but occasional failures do still happen.                         |
130 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
131 |  2 | `CSIT-1671                              | All CSIT scale tests can not use PAPI due to much slower performance compared to VAT/CLI (it takes much   |
132 |    | <https://jira.fd.io/browse/CSIT-1671>`_ | longer to program VPP). This needs to be addressed on the PAPI side.                                      |
133 |    +-----------------------------------------+ Currently, the time critical code uses VAT running large files with exec statements and CLI commands.     |
134 |    | `VPP-1763                               | Still, we needed to reduce the number of scale tests run to keep overall duration reasonable.             |
135 |    | <https://jira.fd.io/browse/VPP-1763>`_  | More improvements needed to achieve sufficient configuration speed.                                       |
136 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
137 |  3 | `CSIT-1785                              | NAT44ED tests failing to establish all TCP sessions.                                                      |
138 |    | <https://jira.fd.io/browse/CSIT-1785>`_ | At least for max scale, in allotted time (limited by session 500s timeout) due to worse                   |
139 |    +-----------------------------------------+ slow path performance than previously measured and calibrated for.                                        |
140 |    | `VPP-1972                               | CSIT removed the max scale NAT tests to avoid this issue.                                                 |
141 |    | <https://jira.fd.io/browse/VPP-1972>`_  |                                                                                                           |
142 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
143 |  4 | `CSIT-1791                              | Performance regression in RDMA tests, due to CSIT environment changes.                                    |
144 |    | <https://jira.fd.io/browse/CSIT-1791>`_ | Two symptoms: 1. 10-20% regression across most tests. 2. DUT performance cap just below 38 Mpps.          |
145 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
146
147 Fixed
148 _____
149
150 Issues reported in previous releases which were fixed in this release:
151
152 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
153 |  # | JiraID                                  | Issue Description                                                                                         |
154 +====+=========================================+===========================================================================================================+
155 |  1 | `CSIT-1789                              | IPSEC SW async scheduler tests show bad behavior.                                                         |
156 |    | <https://jira.fd.io/browse/CSIT-1789>`_ | VPP code is not behaving correctly when crypto workers are the bottleneck.                                |
157 |    +-----------------------------------------+                                                                                                           |
158 |    | `VPP-1998                               |                                                                                                           |
159 |    | <https://jira.fd.io/browse/VPP-1998>`_  |                                                                                                           |
160 +----+-----------------------------------------+-----------------------------------------------------------------------------------------------------------+
161
162 Root Cause Analysis for Performance Changes
163 -------------------------------------------
164
165 List of RCAs in |csit-release| for VPP performance changes:
166
167 +----+-----------------------------------------+--------------------------------------------------------------+
168 |  # | JiraID                                  | Issue Description                                            |
169 +====+=========================================+==============================================================+
170 |  1 | `CSIT-1814                              | rls2202 regression: NAT44ED CPS larger scales.               |
171 |    | <https://jira.fd.io/browse/CSIT-1814>`_ |                                                              |
172 +----+-----------------------------------------+--------------------------------------------------------------+
173 |  2 | `CSIT-1815                              | rls2202 regression: l2bdbasemaclrn around 2021-11-11.        |
174 |    | <https://jira.fd.io/browse/CSIT-1815>`_ |                                                              |
175 +----+-----------------------------------------+--------------------------------------------------------------+
176 |  3 | `CSIT-1816                              | rls2202 regression: l2-input.                                |
177 |    | <https://jira.fd.io/browse/CSIT-1816>`_ |                                                              |
178 +----+-----------------------------------------+--------------------------------------------------------------+
179 |  4 | `CSIT-1820                              | rls2202 regression: tx2 ip6base at dpdk upgrade.             |
180 |    | <https://jira.fd.io/browse/CSIT-1820>`_ |                                                              |
181 +----+-----------------------------------------+--------------------------------------------------------------+
182 |  5 | `CSIT-1821                              | rls2202 regression: tx2 ip6base before dpdk upgrade.         |
183 |    | <https://jira.fd.io/browse/CSIT-1821>`_ |                                                              |
184 +----+-----------------------------------------+--------------------------------------------------------------+
185 |  6 | `CSIT-1822                              | rls2202 regression: avf-ip4base around 2022-01-06.           |
186 |    | <https://jira.fd.io/browse/CSIT-1822>`_ |                                                              |
187 +----+-----------------------------------------+--------------------------------------------------------------+
188 |  7 | `CSIT-1823                              | rls2202 regression: vxlan-l2xcbase on tsh around 2022-01-07. |
189 |    | <https://jira.fd.io/browse/CSIT-1823>`_ |                                                              |
190 +----+-----------------------------------------+--------------------------------------------------------------+
191 |  8 | `CSIT-1824                              | rls2202 regression: SRv6.                                    |
192 |    | <https://jira.fd.io/browse/CSIT-1824>`_ |                                                              |
193 +----+-----------------------------------------+--------------------------------------------------------------+