CSIT-891: Add data sources for 1801 report
[csit.git] / docs / report / vpp_performance_tests / csit_release_notes.rst
index c21a12e..85cbd7b 100644 (file)
@@ -4,200 +4,211 @@ CSIT Release Notes
 Changes in CSIT |release|\r
 -------------------------\r
 \r
-#. VPP performance test environment changes\r
+#. Added VPP performance tests\r
 \r
-    - Further optimizations of VM and vhost-user test environment - Qemu virtio\r
-      queue size increased from default value of 256 to 1024.\r
-    - Addition of HW cryptodev devices - Intel QAT 8950 50G - in all three\r
-      LF FD.io physical testbeds.\r
+   - **Container Topologies Orchestrated by K8s with VPP memif tests**\r
 \r
-#. VPP performance test framework changes\r
+   - Added tests with VPP in L2 Cross-Connect and Bridge-Domain\r
+     configurations containers, with service chain topologies orchestrated by\r
+     Kubernetes. Added following forwarding topologies: i) "Parallel" with\r
+     packets flowing from NIC via VPP to container and back to VPP and NIC;\r
+     ii) "Chained" a.k.a. "Snake" with packets flowing via VPP to container,\r
+     back to VPP, to next container, back to VPP and so on until the last\r
+     container in chain, then back to VPP and NIC; iii) "Horizontal" with\r
+     packets flowing via VPP to container, then via "horizontal" memif to\r
+     next container, and so on until the last container, then back to VPP and\r
+     NIC;.\r
 \r
-    - Added VAT command history collection for every test case as part of teardown.\r
+   - **VPP TCP/IP stack**\r
 \r
-#. Added VPP performance tests\r
+     - Added tests for VPP TCP/IP stack using VPP built-in HTTP server.\r
+       WRK traffic generator is used as a client-side;\r
 \r
-    - **CGNAT**\r
-\r
-      - Carrier Grade Network Address Translation tests with varying number\r
-        of users and ports per user: 1u-15p, 10u-15p, 100u-15p, 1000u-15p,\r
-        2000u-15p, 4000u-15p - with Intel x520 NIC.\r
-\r
-    - **vhost-user tests with one VM**\r
-\r
-      - L2 Bridge Domain switched-forwarding with Intel x710 NIC, Intel x520 NIC,\r
-        Intel xl710 NIC.\r
-      - VXLAN and L2 Bridge Domain switched-forwarding with Intel x520 NIC.\r
-\r
-    - **vhost-user tests with two VMs service chain**\r
-\r
-      - L2 cross-connect switched-forwarding with Intel x520 NIC, Intel xl710 NIC.\r
-      - L2 Bridge Domain switched-forwarding with Intel x520 NIC, Intel xl710 NIC.\r
-      - IPv4 routed-forwarding with Intel x520 NIC, Intel xl710 NIC.\r
-\r
-    - **IPSec encryption with**\r
-\r
-      - AES-GCM, CBC-SHA1 ciphers, in combination with IPv4 routed-forwarding\r
-        with Intel xl710 NIC.\r
-      - CBC-SHA1 ciphers, in combination with LISP-GPE overlay tunneling for\r
-        IPv4-over-IPv4 with Intel xl710 NIC.\r
-\r
-Performance Improvements\r
-------------------------\r
-\r
-Substantial improvements in measured packet throughput have been\r
-observed in a number of CSIT |release| tests listed below, with relative\r
-increase  of double-digit percentage points. Relative improvements are\r
-calculated against the test results listed in CSIT rls1701 report.\r
-VPP-16.09 numbers are provided for reference.\r
-\r
-NDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Non-Drop Rate Throughput discovery tests:\r
-\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name                                                       | VPP-16.09  | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
-|                   |                                                                 | [Mpps]     | [Mpps]    | [Mpps]    | Relative Change |\r
-+===================+=================================================================+============+===========+===========+=================+\r
-| L2XC-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-eth-2vhost-1vm-ndrdisc       | 0.5        | 2.8       | 3.4       | 21%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| L2BD-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-eth-2vhost-1vm-ndrdisc | 0.4        | 2.7       | 3.1       | 15%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 vhost        | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-eth-2vhost-1vm-ndrdisc     | 0.3        | 2.6       | 3.0       | 15%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 LISP         | 10ge2p1x520: 64B-1t1c-ethip4lispip4-ip4base-ndrdisc             | 4.4        | 4.8       | 5.5       | 15%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv6              | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-ndrdisc                    | 3.0        | 7.3       | 8.1       | 11%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv6 COP          | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-copwhtlistbase-ndrdisc     | 6.1        | 6.1       | 6.9       | 13%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv6 iAcl         | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-iacldstbase-ndrdisc        | 6.5        | 6.1       | 6.9       | 13%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv6 FIB 2M       | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale2m-ndrdisc                 | 5.3        | 4.2       | 4.6       | 10%             |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-\r
-PDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%:\r
-\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name                                                       | VPP-16.09 | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
-|                   |                                                                 | [Mpps]    | [Mpps]    | [Mpps]    | Relative Change |\r
-+===================+=================================================================+===========+===========+===========+=================+\r
-| L2XC-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-eth-2vhost-1vm-pdrdisc       | 2.6       | 3.2       | 3.7       | 15%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| L2BD-vhost-VM     | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-eth-2vhost-1vm-pdrdisc | 2.1       | 2.9       | 3.3       | 14%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 vhost        | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-eth-2vhost-1vm-pdrdisc     | 2.0       | 2.7       | 3.0       | 11%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 LISP         | 10ge2p1x520: 64B-1t1c-ethip4lispip4-ip4base-pdrdisc             | 4.6       | 4.8       | 5.5       | 15%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv6              | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-pdrdisc                    | 7.7       | 7.3       | 8.1       | 11%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv6 COP          | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-copwhtlistbase-pdrdisc     | 6.1       | 6.1       | 6.9       | 13%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv6 iAcl         | 10ge2p1x520: 78B-1t1c-ethip6-ip6base-iacldstbase-pdrdisc        | 6.5       | 6.1       | 6.9       | 13%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 2M       | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale2m-pdrdisc                 | 5.3       | 4.2       | 4.6       | 10%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
+   - **SRv6 tests**\r
 \r
-Measured improvements are in line with VPP code optimizations listed in\r
-`VPP-17.04 release notes\r
-<https://docs.fd.io/vpp/17.04/release_notes_1704.html>`_.\r
+     - Initial SRv6 (Segment Routing IPv6) tests verifying performance of\r
+       IPv6 and SRH (Segment Routing Header) encapsulation, decapsulation,\r
+       lookups and rewrites based on configured End and End.DX6 SRv6 egress\r
+       functions;\r
 \r
-Additionally, vhost-VM performance improvements are due to both VPP code\r
-optimizations as well as due to the FD.io CSIT Linux KVM test environment\r
-optimizations for vhost-VM tests - see section "2.1.7. Methodology: KVM VM\r
-vhost".\r
+   - **IPSecSW tests**\r
 \r
+     - SW computed IPSec encryption with AES-GCM, CBC-SHA1 ciphers, in\r
+       combination with IPv4 routed-forwarding;\r
 \r
-Other Performance Changes\r
--------------------------\r
+#. Presentation and Analytics Layer\r
+\r
+     - Added throughput speedup analysis for multi-core and multi-thread\r
+       VPP tests into Presentation and Analytics Layer (PAL) for automated\r
+       CSIT test results analysis;\r
+\r
+#. Other improvements\r
+\r
+     - **Framework optimizations**\r
+\r
+       - Ability to run CSIT framework on ARM architecture;\r
+\r
+       - Overall stability improvements;\r
+\r
+Performance Changes\r
+-------------------\r
+\r
+Substantial changes in measured packet throughput have been observed in a\r
+number of CSIT |release| tests listed below. Relative changes for this release\r
+are calculated against the test results listed in CSIT |release-1| report. The\r
+comparison is calculated between the mean values based on collected and\r
+archived test results' samples for involved VPP releases. Standard deviation\r
+has been also listed for CSIT |release|.\r
+\r
+NDR Throughput: Best 20 Changes\r
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+\r
+.. only:: html\r
+\r
+   .. csv-table::\r
+      :align: center\r
+      :file: ../../../../_build/_static/vpp/performance-changes-ndr-1t1c-top.csv\r
+\r
+.. only:: latex\r
+\r
+   .. raw:: latex\r
+\r
+      \makeatletter\r
+      \csvset{\r
+        perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead},\r
+      }\r
+      \makeatother\r
+\r
+      {\tiny\r
+      \csvautobooklongtable[separator=comma,\r
+        respect all,\r
+        no check column count,\r
+        perfimprovements column width=1cm,\r
+        late after line={\\\hline},\r
+        late after last line={\end{longtable}}\r
+        ]{../_build/_static/vpp/performance-changes-ndr-1t1c-top.csv}\r
+      }\r
+\r
+NDR Throughput: Worst 20 Changes\r
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+\r
+.. only:: html\r
+\r
+   .. csv-table::\r
+      :align: center\r
+      :file: ../../../../_build/_static/vpp/performance-changes-ndr-1t1c-bottom.csv\r
+\r
+.. only:: latex\r
+\r
+   .. raw:: latex\r
 \r
-Other changes in measured packet throughput, with either minor relative\r
-increase or decrease, have been observed in a number of CSIT |release|\r
-tests listed below. Relative changes are calculated against the test\r
-results listed in CSIT rls1701 report.\r
-\r
-NDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Non-Drop Rate Throughput discovery tests:\r
-\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name                                                       | VPP-16.09  | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
-|                   |                                                                 | [Mpps]     | [Mpps]    | [Mpps]    | Relative Change |\r
-+===================+=================================================================+============+===========+===========+=================+\r
-| L2XC              | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-ndrdisc                      | 9.4        | 12.7      | 13.1      | 3%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| L2XC              | 10ge2p1xl710: 64B-1t1c-eth-l2xcbase-ndrdisc                     | 9.5        | 12.2      | 12.4      | 2%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| L2XC dot1ad       | 10ge2p1x520: 64B-1t1c-dot1ad-l2xcbase-ndrdisc                   | 7.4        | 8.8       | 9.3       | 6%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| L2XC dot1q        | 10ge2p1x520: 64B-1t1c-dot1q-l2xcbase-ndrdisc                    | 7.5        | 8.8       | 9.2       | 5%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| L2XC VxLAN        | 10ge2p1x520: 64B-1t1c-ethip4vxlan-l2xcbase-ndrdisc              | 5.4        | 6.5       | 6.8       | 5%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| L2BD              | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-ndrdisc                | 7.8        | 10.4      | 10.8      | 4%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4              | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ndrdisc                    | 8.7        | 9.7       | 10.6      | 9%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 COP          | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-copwhtlistbase-ndrdisc     | 7.1        | 8.3       | 9.0       | 8%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 iAcl         | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-iacldstbase-ndrdisc        | 6.9        | 7.6       | 8.3       | 9%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 FIB 200k     | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale200k-ndrdisc               | 8.5        | 9.0       | 9.7       | 8%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 FIB 20k      | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale20k-ndrdisc                | 8.5        | 9.0       | 9.7       | 8%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 FIB 2M       | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale2m-ndrdisc                 | 8.5        | 7.8       | 8.1       | 4%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv4 Policer      | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ipolicemarkbase-ndrdisc    | 6.9        | 7.4       | 8.1       | 9%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv6 FIB 200k     | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale200k-ndrdisc               | 6.5        | 5.3       | 5.3       | 0%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-| IPv6 FIB 20k      | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale20k-ndrdisc                | 6.9        | 6.5       | 6.9       | 6%              |\r
-+-------------------+-----------------------------------------------------------------+------------+-----------+-----------+-----------------+\r
-\r
-PDR Throughput\r
-~~~~~~~~~~~~~~\r
-\r
-Partial Drop Rate thoughput discovery tests with packet Loss Tolerance of 0.5%:\r
-\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| VPP Functionality | Test Name                                                       | VPP-16.09 | VPP-17.01 | VPP-17.04 | 17.01 to 17.04  |\r
-|                   |                                                                 | [Mpps]    | [Mpps]    | [Mpps]    | Relative Change |\r
-+===================+=================================================================+===========+===========+===========+=================+\r
-| L2XC              | 10ge2p1x520: 64B-1t1c-eth-l2xcbase-pdrdisc                      | 9.4       | 12.7      | 13.4      | 6%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| L2XC dot1ad       | 10ge2p1x520: 64B-1t1c-dot1ad-l2xcbase-pdrdisc                   | 7.4       | 8.8       | 9.3       | 6%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| L2XC dot1q        | 10ge2p1x520: 64B-1t1c-dot1q-l2xcbase-pdrdisc                    | 7.5       | 8.8       | 9.2       | 5%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| L2XC VxLAN        | 10ge2p1x520: 64B-1t1c-ethip4vxlan-l2xcbase-pdrdisc              | 5.4       | 6.5       | 6.8       | 5%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| L2BD              | 10ge2p1x520: 64B-1t1c-eth-l2bdbasemaclrn-pdrdisc                | 7.8       | 10.6      | 10.8      | 2%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4              | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-pdrdisc                    | 8.7       | 9.7       | 10.6      | 9%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 COP          | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-copwhtlistbase-pdrdisc     | 7.1       | 8.3       | 9.2       | 11%             |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 iAcl         | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-iacldstbase-pdrdisc        | 7.1       | 7.6       | 8.3       | 9%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 200k     | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale200k-pdrdisc               | 8.5       | 9.0       | 9.7       | 8%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 20k      | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale20k-pdrdisc                | 8.5       | 9.0       | 9.7       | 8%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 FIB 2M       | 10ge2p1x520: 64B-1t1c-ethip4-ip4scale2m-pdrdisc                 | 8.3       | 8.1       | 8.1       | 0%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv4 Policer      | 10ge2p1x520: 64B-1t1c-ethip4-ip4base-ipolicemarkbase-pdrdisc    | 7.1       | 7.4       | 8.1       | 9%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 200k     | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale200k-pdrdisc               | 6.9       | 5.3       | 5.3       | 0%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
-| IPv6 FIB 20k      | 10ge2p1x520: 78B-1t1c-ethip6-ip6scale20k-pdrdisc                | 6.9       | 6.5       | 6.9       | 6%              |\r
-+-------------------+-----------------------------------------------------------------+-----------+-----------+-----------+-----------------+\r
+      \makeatletter\r
+      \csvset{\r
+        perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead},\r
+      }\r
+      \makeatother\r
+\r
+      {\tiny\r
+      \csvautobooklongtable[separator=comma,\r
+        respect all,\r
+        no check column count,\r
+        perfimprovements column width=1cm,\r
+        late after line={\\\hline},\r
+        late after last line={\end{longtable}}\r
+        ]{../_build/_static/vpp/performance-changes-ndr-1t1c-bottom.csv}\r
+      }\r
+\r
+.. only:: html\r
+\r
+      NDR Throughput: All Changes\r
+      ~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+\r
+      Complete results for all NDR tests are available in a CSV and pretty\r
+      ASCII formats:\r
+\r
+        - `csv format for 1t1c <../../_static/vpp/performance-changes-ndr-1t1c-full.csv>`_,\r
+        - `csv format for 2t2c <../../_static/vpp/performance-changes-ndr-2t2c-full.csv>`_,\r
+        - `csv format for 4t4c <../../_static/vpp/performance-changes-ndr-4t4c-full.csv>`_,\r
+        - `pretty ASCII format for 1t1c <../../_static/vpp/performance-changes-ndr-1t1c-full.txt>`_,\r
+        - `pretty ASCII format for 2t2c <../../_static/vpp/performance-changes-ndr-2t2c-full.txt>`_,\r
+        - `pretty ASCII format for 4t4c <../../_static/vpp/performance-changes-ndr-4t4c-full.txt>`_.\r
+\r
+PDR Throughput: Best 20 Changes\r
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+\r
+.. only:: html\r
+\r
+   .. csv-table::\r
+      :align: center\r
+      :file: ../../../../_build/_static/vpp/performance-changes-pdr-1t1c-top.csv\r
+\r
+.. only:: latex\r
+\r
+   .. raw:: latex\r
+\r
+      \makeatletter\r
+      \csvset{\r
+        perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead},\r
+      }\r
+      \makeatother\r
+\r
+      {\tiny\r
+      \csvautobooklongtable[separator=comma,\r
+        respect all,\r
+        no check column count,\r
+        perfimprovements column width=1cm,\r
+        late after line={\\\hline},\r
+        late after last line={\end{longtable}}\r
+        ]{../_build/_static/vpp/performance-changes-pdr-1t1c-top.csv}\r
+      }\r
+\r
+PDR Throughput: Worst 20 Changes\r
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+\r
+.. only:: html\r
+\r
+   .. csv-table::\r
+      :align: center\r
+      :file: ../../../../_build/_static/vpp/performance-changes-pdr-1t1c-bottom.csv\r
+\r
+.. only:: latex\r
+\r
+   .. raw:: latex\r
+\r
+      \makeatletter\r
+      \csvset{\r
+        perfimprovements column width/.style={after head=\csv@pretable\begin{longtable}{m{4cm} m{#1} m{#1} m{#1} m{#1} m{#1}}\csv@tablehead},\r
+      }\r
+      \makeatother\r
+\r
+      {\tiny\r
+      \csvautobooklongtable[separator=comma,\r
+        respect all,\r
+        no check column count,\r
+        perfimprovements column width=1cm,\r
+        late after line={\\\hline},\r
+        late after last line={\end{longtable}}\r
+        ]{../_build/_static/vpp/performance-changes-pdr-1t1c-bottom.csv}\r
+      }\r
+\r
+.. only:: html\r
+\r
+      PDR Throughput: All Changes\r
+      ~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
+\r
+            Complete results for all PDR tests are available in a CSV and pretty\r
+            ASCII formats:\r
+\r
+              - `csv format for 1t1c <../../_static/vpp/performance-changes-pdr-1t1c-full.csv>`_,\r
+              - `csv format for 2t2c <../../_static/vpp/performance-changes-pdr-2t2c-full.csv>`_,\r
+              - `csv format for 4t4c <../../_static/vpp/performance-changes-pdr-4t4c-full.csv>`_,\r
+              - `pretty ASCII format for 1t1c <../../_static/vpp/performance-changes-pdr-1t1c-full.txt>`_,\r
+              - `pretty ASCII format for 2t2c <../../_static/vpp/performance-changes-pdr-2t2c-full.txt>`_,\r
+              - `pretty ASCII format for 4t4c <../../_static/vpp/performance-changes-pdr-4t4c-full.txt>`_.\r
+\r
+Measured improvements are in line with VPP code optimizations listed in\r
+`VPP-17.10 release notes\r
+<https://docs.fd.io/vpp/17.10/release_notes_1710.html>`_.\r
 \r
 Known Issues\r
 ------------\r
@@ -207,26 +218,16 @@ Here is the list of known issues in CSIT |release| for VPP performance tests:
 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
 | # | Issue                                           | Jira ID    | Description                                                     |\r
 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 1 | NDR discovery test failures 1518B frame size    | VPP-663    | VPP reporting errors: dpdk-input Rx ip checksum errors.         |\r
-|   | for ip4scale200k, ip4scale2m scale IPv4 routed- |            | Observed frequency: all test runs.                              |\r
-|   | forwarding tests. ip4scale20k tests are fine.   |            |                                                                 |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 2 | Sporadic VAT API timeouts during ip6scale2m     | VPP-712    | Needs fixing VPP VAT API timeouts for large volume of IPv6      |\r
-|   | scale IPv6  routed-forwarding tests when volume |            | routes.                                                         |\r
-|   | adding IPv6 routes - 2M in this case.           |            |                                                                 |\r
-|   | ip6scale200k works.                             |            |                                                                 |\r
-+---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 3 | Vic1385 and Vic1227 low performance.            | VPP-664    | Low NDR performance.                                            |\r
+| 1 | Vic1385 and Vic1227 low performance.            | VPP-664    | Low NDR performance.                                            |\r
 |   |                                                 |            |                                                                 |\r
 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 4 | Sporadic NDR discovery test failures on x520.   | CSIT-750   | Suspected issue with HW settings (BIOS, FW) in LF               |\r
+| 2 | Sporadic NDR discovery test failures on x520.   | CSIT-750   | Suspected issue with HW combination of X710-X520 in LF          |\r
 |   |                                                 |            | infrastructure. Issue can't be replicated outside LF.           |\r
 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 5 | VPP in 2t2c setups - large variation            | CSIT-568   | Suspected NIC firmware or DPDK driver issue affecting NDR       |\r
+| 3 | VPP in 2t2c setups - large variation            | CSIT-568   | Suspected NIC firmware or DPDK driver issue affecting NDR       |\r
 |   | of discovered NDR throughput values across      |            | throughput. Applies to XL710 and X710 NICs, x520 NICs are fine. |\r
 |   | multiple test runs with xl710 and x710 NICs.    |            |                                                                 |\r
 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-| 6 | Lower than expected NDR and PDR throughput with | CSIT-569   | Suspected NIC firmware or DPDK driver issue affecting NDR and   |\r
+| 4 | Lower than expected NDR throughput with         | CSIT-569   | Suspected NIC firmware or DPDK driver issue affecting NDR and   |\r
 |   | xl710 and x710 NICs, compared to x520 NICs.     |            | PDR throughput. Applies to XL710 and X710 NICs.                 |\r
 +---+-------------------------------------------------+------------+-----------------------------------------------------------------+\r
-\r