CSIT rls1704 report - update to handcraftec sections:
[csit.git] / docs / report / testpmd_performance_tests / packet_latency_graphs / l2.rst
1 L2 Ethernet Switching\r
2 =====================\r
3 \r
4 This section provides a summary of Testpmd Phy-to-Phy L2 Ethernet looping\r
5 performance illustrating packet latency measured at 50% of discovered NDR\r
6 throughput rate. Latency is reported for Testpmd running in multiple\r
7 configurations of Testpmd worker thread(s), a.k.a. Testpmd data plane thread\r
8 (s), and their physical CPU core(s) placement.\r
9 \r
10 *Title of each graph* is a regex (regular expression) matching all plotted\r
11 latency test cases, *X-axis labels* are indeces of csit-dpdk-perf-1704 jobs\r
12 that created result output files used as data sources for the graph,\r
13 *Y-axis labels* are measured packet Latency [uSec] values, and the *graph\r
14 legend* identifes the plotted test suites.\r
15 \r
16 .. note::\r
17 \r
18     Data sources for reported test results: i) FD.io test executor jobs\r
19     `csit-dpdk-perf-1704-all <https://jenkins.fd.io/view/csit/job/csit-dpdk-perf-1704-all/>`_ ,\r
20     ii) archived FD.io jobs test result output files\r
21     `csit-dpdk-perf-1704-all#job-number <https://nexus.fd.io/link>`_.\r
22 \r
23 Testpmd packet latency - running in configuration of **one worker thread (1t) on one\r
24 physical core (1c)** - is presented in the figure below.\r
25 \r
26 .. raw:: html\r
27 \r
28     <iframe width="700" height="700" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-1t1c-l2-ndrdisc-lat50.html"></iframe>\r
29 \r
30 *Figure 1. Testpmd 1thread 1core - packet latency for Phy-to-Phy L2 Ethernet Looping.*\r
31 \r
32 CSIT test cases used to generate results presented above can be found in CSIT\r
33 git repository by filtering with specified regex as follows:\r
34 \r
35 .. code-block:: bash\r
36 \r
37     $ csit/tests/perf\r
38     $ grep -E "64B-1t1c-(eth|dot1q|dot1ad)-(l2xcbase|l2bdbasemaclrn)-ndrdisc" *\r
39 \r
40     10ge2p1x520-eth-l2xcbase-ndrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-ndrdisc\r
41 \r
42 Testpmd packet latency - running in configuration of **two worker threads (2t)\r
43 on two physical cores (2c)** - is presented in the figure below.\r
44 \r
45 .. raw:: html\r
46 \r
47     <iframe width="700" height="700" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-2t2c-l2-ndrdisc-lat50.html"></iframe>\r
48 \r
49 *Figure 2. Testpmd 2thread 2core - packet latency for Phy-to-Phy L2 Ethernet Looping.*\r
50 \r
51 CSIT test cases used to generate results presented above can be found in CSIT\r
52 git repository by filtering with specified regex as follows:\r
53 \r
54 .. code-block:: bash\r
55 \r
56     $ csit/tests/perf\r
57     $ grep -E "64B-2t2c-(eth|dot1q|dot1ad)-(l2xcbase|l2bdbasemaclrn)-ndrdisc" *\r
58 \r
59     10ge2p1x520-eth-l2xcbase-ndrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-ndrdisc\r
60 \r