CSIT rls1704 report - update to handcrafted sections:
[csit.git] / docs / report / vpp_performance_tests / packet_latency_graphs / l2.rst
1 L2 Ethernet Switching
2 =====================
3
4 This section includes summary graphs of VPP Phy-to-Phy packet latency
5 with L2 Ethernet switching measured at 50% of discovered NDR throughput
6 rate. Latency is reported for VPP running in multiple configurations of
7 VPP worker thread(s), a.k.a. VPP data plane thread(s), and their
8 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-vpp-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-vpp-perf-1704-all
28     <https://jenkins.fd.io/view/csit/job/csit-vpp-perf-1704-all/>`_,
29     with Robot Framework result files csit-vpp-perf-1704-all-<id>.zip
30     `archived here <../../_static/archive/>`_
31
32 VPP packet latency in 1t1c setup (1thread, 1core) is presented in the graph below.
33
34 .. raw:: html
35
36     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/vpp/64B-1t1c-l2-ndrdisc-lat50.html"></iframe>
37
38 *Figure 1. VPP 1thread 1core - packet latency for Phy-to-Phy L2 Ethernet Switching.*
39
40 CSIT source code for the test cases used for above plots can be found in CSIT
41 git repository:
42
43 .. code-block:: bash
44
45     $ cd $CSIT/tests/perf
46     $ grep -E "64B-1t1c-(eth|dot1q|dot1ad)-(l2xcbase|l2bdbasemaclrn)-ndrdisc" *
47
48     10ge2p1vic1227-eth-l2bdbasemaclrn-ndrdisc.robot:| tc01-64B-1t1c-eth-l2bdbasemaclrn-ndrdisc
49     10ge2p1x520-dot1ad-l2xcbase-ndrdisc.robot:| tc01-64B-1t1c-dot1ad-l2xcbase-ndrdisc
50     10ge2p1x520-dot1q-l2xcbase-ndrdisc.robot:| tc01-64B-1t1c-dot1q-l2xcbase-ndrdisc
51     10ge2p1x520-eth-l2bdbasemaclrn-ndrdisc.robot:| tc01-64B-1t1c-eth-l2bdbasemaclrn-ndrdisc
52     10ge2p1x520-eth-l2xcbase-ndrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-ndrdisc
53     10ge2p1x710-eth-l2bdbasemaclrn-ndrdisc.robot:| tc01-64B-1t1c-eth-l2bdbasemaclrn-ndrdisc
54     40ge2p1vic1385-eth-l2bdbasemaclrn-ndrdisc.robot:| tc01-64B-1t1c-eth-l2bdbasemaclrn-ndrdisc
55     40ge2p1xl710-eth-l2bdbasemaclrn-ndrdisc.robot:| tc01-64B-1t1c-eth-l2bdbasemaclrn-ndrdisc
56     40ge2p1xl710-eth-l2xcbase-ndrdisc.robot:| tc01-64B-1t1c-eth-l2xcbase-ndrdisc
57
58 VPP packet latency in 2t2c setup (2thread, 2core) is presented in the graph below.
59
60 .. raw:: html
61
62     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/vpp/64B-2t2c-l2-ndrdisc-lat50.html"></iframe>
63
64 *Figure 2. VPP 2threads 2cores - packet latency for Phy-to-Phy L2 Ethernet Switching.*
65
66 CSIT source code for the test cases used for above plots can be found in CSIT
67 git repository:
68
69 .. code-block:: bash
70
71     $ cd $CSIT/tests/perf
72     $ grep -E "64B-2t2c-(eth|dot1q|dot1ad)-(l2xcbase|l2bdbasemaclrn)-ndrdisc" *
73
74     10ge2p1vic1227-eth-l2bdbasemaclrn-ndrdisc.robot:| tc07-64B-2t2c-eth-l2bdbasemaclrn-ndrdisc
75     10ge2p1x520-dot1ad-l2xcbase-ndrdisc.robot:| tc07-64B-2t2c-dot1ad-l2xcbase-ndrdisc
76     10ge2p1x520-dot1q-l2xcbase-ndrdisc.robot:| tc07-64B-2t2c-dot1q-l2xcbase-ndrdisc
77     10ge2p1x520-eth-l2bdbasemaclrn-ndrdisc.robot:| tc07-64B-2t2c-eth-l2bdbasemaclrn-ndrdisc
78     10ge2p1x520-eth-l2xcbase-ndrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-ndrdisc
79     10ge2p1x710-eth-l2bdbasemaclrn-ndrdisc.robot:| tc07-64B-2t2c-eth-l2bdbasemaclrn-ndrdisc
80     40ge2p1vic1385-eth-l2bdbasemaclrn-ndrdisc.robot:| tc07-64B-2t2c-eth-l2bdbasemaclrn-ndrdisc
81     40ge2p1xl710-eth-l2bdbasemaclrn-ndrdisc.robot:| tc07-64B-2t2c-eth-l2bdbasemaclrn-ndrdisc
82     40ge2p1xl710-eth-l2xcbase-ndrdisc.robot:| tc07-64B-2t2c-eth-l2xcbase-ndrdisc
83