Performance: Add AF_XDP tests
[csit.git] / docs / report / dpdk_performance_tests / packet_throughput_graphs / index.rst
1
2 .. raw:: latex
3
4     \clearpage
5
6 Packet Throughput
7 =================
8
9 Throughput graphs are generated by multiple executions of the same
10 performance tests across physical testbeds hosted LF FD.io labs:
11 2n-skx, 3n-skx, 2n-clx. Box-and-Whisker plots are used to display variations in
12 measured throughput values, without making any assumptions of the
13 underlying statistical distribution.
14
15 For each test case, Box-and-Whisker plots show the quartiles (Min, 1st
16 quartile / 25th percentile, 2nd quartile / 50th percentile / mean, 3rd
17 quartile / 75th percentile, Max) across collected data set. Outliers are
18 plotted as individual points.
19
20 Additional information about graph data:
21
22 #. **Graph Title**: describes tested packet path, testbed topology,
23    processor model, NIC model, packet size, number of cores and
24    threads used by data plane workers and indication of DPDK DUT
25    configuration.
26
27 #. **X-axis Labels**: indices of individual test suites as listed in
28    Graph Legend.
29
30 #. **Y-axis Labels**: measured Packets Per Second [pps] throughput
31    values.
32
33 #. **Graph Legend**: lists X-axis indices with associated CSIT test
34    suites executed to generate graphed test results.
35
36 #. **Hover Information**: lists minimum, first quartile, median,
37    third quartile, and maximum. If either type of outlier is present the
38    whisker on the appropriate side is taken to 1.5×IQR from the quartile
39    (the "inner fence") rather than the max or min, and individual outlying
40    data points are displayed as unfilled circles (for suspected outliers)
41    or filled circles (for outliers). (The "outer fence" is 3×IQR from the
42    quartile.)
43
44 .. note::
45
46     Test results are stored in
47     `build logs from FD.io dpdk performance job 2n-skx`_,
48     `build logs from FD.io dpdk performance job 3n-skx`_,
49     `build logs from FD.io dpdk performance job 2n-clx`_,
50     `build logs from FD.io dpdk performance job 2n-zn2`_,
51     `build logs from FD.io dpdk performance job 3n-tsh`_,
52     `build logs from FD.io dpdk performance job 2n-tx2`_,
53     `build logs from FD.io dpdk performance job 2n-dnv`_ and
54     `build logs from FD.io dpdk performance job 3n-dnv`_ with RF
55     result files csit-dpdk-perf-|srelease|-\*.zip
56     `archived here <../../_static/archive/>`_.
57     Required per test case data set size is **10** and for DPDK tests
58     this is the actual size, as all scheduled test executions completed
59     successfully.
60
61 .. toctree::
62     :maxdepth: 3
63
64     2n-skx-xxv710
65     2n-skx-x710
66     3n-skx-xxv710
67     3n-skx-x710
68     2n-clx-xxv710
69     2n-clx-x710
70     2n-zn2-xxv710
71     2n-zn2-x710
72     3n-tsh-x520
73     2n-tx2-xl710
74
75 ..
76     2n-dnv-x553
77     3n-dnv-x553