8b13dc9e500609cdc62e7d9e0a773e3cb194b560
[csit.git] / docs / report / testpmd_performance_tests / packet_throughput_graphs / l2.rst
1 L2 Ethernet Interface Loop
2 ==========================
3
4 Following sections include summary graphs of DPDK Testpmd Phy-to-Phy performance
5 with L2 Ethernet Interface Loop, including NDR throughput (zero packet loss)
6 and PDR throughput (<0.5% packet loss). Performance is reported for Testpmd
7 running in multiple configurations of Testpmd pmd thread(s), a.k.a. Testpmd
8 data plane thread(s), and their physical CPU core(s) placement.
9
10 Results are generated by multiple executions of the same CSIT
11 performance tests across three physical testbeds within LF FD.io labs.
12 To provide a descriptive summary view, Box-and-Whisker plots are used to
13 display variation in measured throughput values, without making any
14 assumptions of the underlying statistical distribution. For each plotted
15 test case, Box-and-Whisker plots show the quartiles (Min, 1st quartile
16 / 25th percentile, 2nd quartile / 50th percentile / mean, 3rd quartile /
17 75th percentile, Max) across collected data set (data set size stated in
18 the note below). Outliers are plotted as individual points.
19
20 *Title of each graph* is a regex (regular expression) matching all
21 throughput test cases plotted on this graph, *X-axis labels* are indices
22 of individual test suites executed by csit-dpdk-perf-1704-all jobs that
23 created result output files used as data sources for the graph, *Y-axis
24 labels* are measured Packets Per Second [pps] values, and the *Graph
25 legend* lists the plotted test suites and their indices.
26
27 .. note::
28
29     Test results have been generated by FD.io test executor jobs
30     `csit-dpdk-perf-1704-all
31     <https://jenkins.fd.io/view/csit/job/csit-dpdk-perf-1704-all/>`_,
32     with Robot Framework result files csit-dpdk-perf-1704-all-<id>.zip
33     `archived here <../../_static/archive/>`_. Plotted data set size per
34     test case is equal to the number of job executions presented in this
35     report version: **4**.
36
37 NDR Throughput
38 ~~~~~~~~~~~~~~
39
40 Testpmd NDR 64B packet throughput in 1t1c setup (1thread, 1core) is presented
41 in the graph below.
42
43 .. raw:: html
44
45     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-1t1c-l2-ndrdisc.html"></iframe>
46
47 *Figure 1. Testpmd 1thread 1core - NDR Throughput for Phy-to-Phy L2 Ethernet
48 Looping.*
49
50 CSIT source code for the test cases used for above plots can be found in CSIT
51 git repository:
52
53 .. code-block:: bash
54
55     $ $CSIT/dpdk-tests/perf
56     $ grep -E "64B-1t1c-eth-l2xcbase-testpmd-ndrdisc" *
57
58     10ge2p1x520-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-testpmd-ndrdisc
59     10ge2p1x710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-testpmd-ndrdisc
60     40ge2p1xl710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-testpmd-ndrdisc
61
62 Testpmd NDR 64B packet throughput in 2t2c setup (2thread, 2core) is presented
63 in the graph below.
64
65 .. raw:: html
66
67     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-2t2c-l2-ndrdisc.html"></iframe>
68
69 *Figure 2. Testpmd 2threads 2cores - NDR Throughput for Phy-to-Phy L2 Ethernet
70 Looping.*
71
72 CSIT source code for the test cases used for above plots can be found in CSIT
73 git repository:
74
75 .. code-block:: bash
76
77     $ $CSIT/dpdk-tests/perf
78     $ grep -E "64B-2t2c-eth-l2xcbase-testpmd-ndrdisc" *
79
80     10ge2p1x520-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-testpmd-ndrdisc
81     10ge2p1x710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-testpmd-ndrdisc
82     40ge2p1xl710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-testpmd-ndrdisc
83
84 PDR Throughput
85 ~~~~~~~~~~~~~~
86
87 Testpmd PDR 64B packet throughput in 1t1c setup (1thread, 1core) is presented
88 in the graph below. PDR measured for 0.5% packet loss ratio.
89
90 .. raw:: html
91
92     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-1t1c-l2-pdrdisc.html"></iframe>
93
94 *Figure 3. Testpmd 1thread 1core - PDR Throughput for Phy-to-Phy L2 Ethernet
95 Looping.*
96
97 CSIT source code for the test cases used for above plots can be found in CSIT
98 git repository:
99
100 .. code-block:: bash
101
102     $ csit/tests/perf
103     $ grep -E "64B-1t1c-eth-l2xcbase-testpmd-pdrdisc" *
104
105     10ge2p1x520-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc02-64B-1t1c-eth-l2xcbase-testpmd-pdrdisc
106     10ge2p1x710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc02-64B-1t1c-eth-l2xcbase-testpmd-pdrdisc
107     40ge2p1xl710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc02-64B-1t1c-eth-l2xcbase-testpmd-pdrdisc
108
109 Testpmd PDR 64B packet throughput in 2t2c setup (2thread, 2core) is presented
110 in the graph below. PDR measured for 0.5% packet loss ratio.
111
112 .. raw:: html
113
114     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/testpmd/64B-2t2c-l2-pdrdisc.html"></iframe>
115
116 *Figure 4. Testpmd 2thread 2core - PDR Throughput for Phy-to-Phy L2 Ethernet
117 Looping.*
118
119 CSIT source code for the test cases used for above plots can be found in CSIT
120 git repository:
121
122 .. code-block:: bash
123
124     $ csit/tests/perf
125     $ grep -E "64B-2t2c-eth-l2xcbase-testpmd-pdrdisc" *
126
127         10ge2p1x520-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc08-64B-2t2c-eth-l2xcbase-testpmd-pdrdisc
128         10ge2p1x710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc08-64B-2t2c-eth-l2xcbase-testpmd-pdrdisc
129         40ge2p1xl710-eth-l2xcbase-testpmd-ndrpdrdisc.robot:| tc08-64B-2t2c-eth-l2xcbase-testpmd-pdrdisc
130