csit rls1701 report edits:

[csit.git] / docs / report / testpmd_performance_tests / packet_latency_graphs / l2.rst

diff --git a/docs/report/testpmd_performance_tests/packet_latency_graphs/l2.rst b/docs/report/testpmd_performance_tests/packet_latency_graphs/l2.rst
new file mode 100644 (file)
index 0000000..a323761
--- /dev/null
+++ b/docs/report/testpmd_performance_tests/packet_latency_graphs/l2.rst
@@ -0,0 +1,78 @@
+L2 Ethernet Switching\r
+=====================\r
+\r
+This section provides a summary of Testpmd Phy-to-Phy L2 Ethernet looping\r
+performance illustrating packet latency measured at 50% of discovered NDR\r
+throughput rate. Latency is reported for Testpmd running in multiple\r
+configurations of Testpmd worker thread(s), a.k.a. Testpmd data plane thread\r
+(s), and their physical CPU core(s) placement.\r
+\r
+Title of each graph is a regex (regular expression) matching all plotted\r
+test case throughput measurements.\r
+\r
+.. note::\r
+\r
+    Data sources for reported test results: i) FD.io test executor jobs\r
+    `csit-dpdk-perf-1701-all <https://jenkins.fd.io/view/csit/job/csit-dpdk-perf-1701-all/>`_\r
+    and\r
+    `csit-dpdk-perf-1701-long <https://jenkins.fd.io/view/csit/job/csit-dpdk-perf-1701-long/>`_\r
+    , ii) archived FD.io jobs test result output files\r
+    `csit-dpdk-perf-1701-all#job-number <https://nexus.fd.io/link>`_.\r
+\r
+Testpmd packet latency - running in configuration of **one worker thread (1t) on one\r
+physical core (1c)** - is presented in the figure below.\r
+\r
+.. raw:: html\r
+\r
+    <iframe width="700" height="700" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-1t1c-l2-ndrdisc-lat50.html"></iframe>\r
+\r
+*Figure 1. Testpmd 1thread 1core - packet latency for Phy-to-Phy L2 Ethernet Looping.*\r
+\r
+CSIT test cases used to generate results presented above can be found in CSIT\r
+git repository by filtering with specified regex as follows:\r
+\r
+.. code-block:: bash\r
+\r
+    $ csit/tests/perf\r
+    $ grep -E "64B-1t1c-(eth|dot1q|dot1ad)-(l2xcbase|l2bdbasemaclrn)-ndrdisc" *\r
+\r
+    10ge2p1x520-eth-l2xcbase-ndrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-ndrdisc\r
+\r
+Testpmd packet latency - running in configuration of **two worker threads (2t)\r
+on two physical cores (2c)** - is presented in the figure below.\r
+\r
+.. raw:: html\r
+\r
+    <iframe width="700" height="700" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-2t2c-l2-ndrdisc-lat50.html"></iframe>\r
+\r
+*Figure 2. Testpmd 2thread 2core - packet latency for Phy-to-Phy L2 Ethernet Looping.*\r
+\r
+CSIT test cases used to generate results presented above can be found in CSIT\r
+git repository by filtering with specified regex as follows:\r
+\r
+.. code-block:: bash\r
+\r
+    $ csit/tests/perf\r
+    $ grep -E "64B-2t2c-(eth|dot1q|dot1ad)-(l2xcbase|l2bdbasemaclrn)-ndrdisc" *\r
+\r
+    10ge2p1x520-eth-l2xcbase-ndrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-ndrdisc\r
+\r
+Testpmd packet latency - running in configuration of **four worker threads (4t)\r
+on four physical cores (4c)** - is presented in the figure below.\r
+\r
+.. raw:: html\r
+\r
+    <iframe width="700" height="700" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-4t4c-l2-ndrdisc-lat50.html"></iframe>\r
+\r
+*Figure 3. Testpmd 4thread 4core - packet latency for Phy-to-Phy L2 Ethernet Looping.*\r
+\r
+CSIT test cases used to generate results presented above can be found in CSIT\r
+git repository by filtering with specified regex as follows:\r
+\r
+.. code-block:: bash\r
+\r
+    $ csit/tests/perf\r
+    $ grep -E "64B-4t4c-(eth|dot1q|dot1ad)-(l2xcbase|l2bdbasemaclrn)-ndrdisc" *\r
+\r
+    10ge2p1x520-eth-l2xcbase-ndrdisc.robot:| tc13-64B-4t4c-eth-l2xcbase-ndrdisc\r
+\r