CSIT rls1704 report - update to handcrafted sections:
[csit.git] / docs / report / testpmd_performance_tests / packet_latency_graphs / l2.rst
1 L2 Ethernet Interface Loop
2 ==========================
3
4 This section includes summary graphs of Testpmd Phy-to-Phy packet
5 latency with L2 Ethernet Interface Loop measured at 50% of discovered
6 NDR throughput rate. Latency is reported for Testpmd running in multiple
7 configurations of Testpmd pmd thread(s), a.k.a. Testpmd data plane
8 thread(s), and their physical CPU core(s) placement.
9
10 Results are generated from a single execution of CSIT NDR discovery
11 test. Box plots are used to show the Minimum, Average and Maximum packet
12 latency per test.
13
14 *Title of each graph* is a regex (regular expression) matching all
15 throughput test cases plotted on this graph, *X-axis labels* are indices
16 of individual test suites executed by csit-dpdk-perf-1704-all job that
17 created result output file used as data source for the graph, *Y-axis
18 labels* are measured packet Latency [uSec] values, and the *Graph
19 legend* lists the plotted test suites and their indices. Latency is
20 reported for concurrent symmetric bi-directional flows, separately for
21 each direction: i) West-to-East: TGint1-to-SUT1-to-SUT2-to-TGint2, and
22 ii) East-to-West: TGint2-to-SUT2-to-SUT1-to-TGint1.
23
24 .. note::
25
26     Test results have been generated by FD.io test executor jobs
27     `csit-dpdk-perf-1704-all
28     <https://jenkins.fd.io/view/csit/job/csit-dpdk-perf-1704-all/>`_,
29     with Robot Framework result files csit-dpdk-perf-1704-all-<id>.zip
30     `archived here <../../_static/archive/>`_
31
32 Testpmd packet latency - running in configuration of **one worker thread (1t) on one
33 physical core (1c)** - is presented in the figure below.
34
35 .. raw:: html
36
37     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-1t1c-l2-ndrdisc-lat50.html"></iframe>
38
39 *Figure 1. Testpmd 1thread 1core - packet latency for Phy-to-Phy L2 Ethernet Looping.*
40
41 CSIT test cases used to generate results presented above can be found in CSIT
42 git repository by filtering with specified regex as follows:
43
44 .. code-block:: bash
45
46     $ $CSIT/dpdk-tests/perf
47     $ grep -E "64B-1t1c-eth-l2xcbase-testpmd-ndrdisc" *
48
49     10ge2p1x520-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-testpmd-ndrdisc
50     10ge2p1x710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-testpmd-ndrdisc
51     40ge2p1xl710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-testpmd-ndrdisc
52
53 Testpmd packet latency - running in configuration of **two worker threads (2t)
54 on two physical cores (2c)** - is presented in the figure below.
55
56 .. raw:: html
57
58     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-2t2c-l2-ndrdisc-lat50.html"></iframe>
59
60 *Figure 2. Testpmd 2thread 2core - packet latency for Phy-to-Phy L2 Ethernet Looping.*
61
62 CSIT test cases used to generate results presented above can be found in CSIT
63 git repository by filtering with specified regex as follows:
64
65 .. code-block:: bash
66
67     $ $CSIT/dpdk-tests/perf
68     $ grep -E "64B-2t2c-eth-l2xcbase-testpmd-ndrdisc" *
69
70     10ge2p1x520-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-testpmd-ndrdisc
71     10ge2p1x710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-testpmd-ndrdisc
72     40ge2p1xl710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-testpmd-ndrdisc
73