summaryrefslogtreecommitdiffstats
path: root/docs/overview/performance
diff options
context:
space:
mode:
authorJohn DeNisco <jdenisco@cisco.com>2018-07-26 12:45:10 -0400
committerDave Barach <openvpp@barachs.net>2018-07-26 18:34:47 +0000
commit06dcd45ff81e06bc8cf40ed487c0b2652d346a5a (patch)
tree71403f9d422c4e532b2871a66ab909bd6066b10b /docs/overview/performance
parent1d65279ffecd0f540288187b94cb1a6b84a7a0c6 (diff)
Initial commit of Sphinx docs
Change-Id: I9fca8fb98502dffc2555f9de7f507b6f006e0e77 Signed-off-by: John DeNisco <jdenisco@cisco.com>
Diffstat (limited to 'docs/overview/performance')
-rw-r--r--docs/overview/performance/current_ipv4_throughput.rst12
-rw-r--r--docs/overview/performance/current_ipv6_throughput.rst16
-rw-r--r--docs/overview/performance/current_l2_throughput.rst12
-rw-r--r--docs/overview/performance/current_ndr_throughput.rst13
-rw-r--r--docs/overview/performance/index.rst63
-rw-r--r--docs/overview/performance/trending_ipv4_throughput.rst14
-rw-r--r--docs/overview/performance/trending_ipv6_throughput.rst16
-rw-r--r--docs/overview/performance/trending_l2_throughput.rst14
8 files changed, 160 insertions, 0 deletions
diff --git a/docs/overview/performance/current_ipv4_throughput.rst b/docs/overview/performance/current_ipv4_throughput.rst
new file mode 100644
index 00000000000..3a34da76ca0
--- /dev/null
+++ b/docs/overview/performance/current_ipv4_throughput.rst
@@ -0,0 +1,12 @@
+.. _current_ipv4_throughput:
+
+.. toctree::
+
+IPv4 Routed-Forwarding Performance Tests
+****************************************
+
+VPP NDR 64B packet throughput in 1t1c setup (1thread, 1core) is presented in the graph below.
+
+.. raw:: html
+
+ <iframe src="https://docs.fd.io/csit/rls1804/report/_static/vpp/64B-1t1c-ethip4-ip4-ndrdisc.html" width="1200" height="1000" frameborder="0">
diff --git a/docs/overview/performance/current_ipv6_throughput.rst b/docs/overview/performance/current_ipv6_throughput.rst
new file mode 100644
index 00000000000..119f28f5665
--- /dev/null
+++ b/docs/overview/performance/current_ipv6_throughput.rst
@@ -0,0 +1,16 @@
+.. _current_ipv6_throughput:
+
+.. toctree::
+
+IPv6 Routed-Forwarding Performance Tests
+****************************************
+
+VPP NDR 78B packet throughput in 1t1c setup (1 thread, 1 core) is presented in the graph below.
+
+.. raw:: html
+
+ <iframe src="https://docs.fd.io/csit/rls1801/report/_static/vpp/78B-1t1c-ethip6-ip6-ndrdisc.html" width="1200" height="1000" frameborder="0">
+
+
+
+
diff --git a/docs/overview/performance/current_l2_throughput.rst b/docs/overview/performance/current_l2_throughput.rst
new file mode 100644
index 00000000000..532e6dc7163
--- /dev/null
+++ b/docs/overview/performance/current_l2_throughput.rst
@@ -0,0 +1,12 @@
+ .. _current_l2_throughput:
+
+.. toctree::
+
+L2 Ethernet Switching Throughput Tests
+***************************************
+
+VPP NDR 64B packet throughput in 1 Core, 1 Thread setup, is presented in the graph below.
+
+.. raw:: html
+
+ <iframe src="https://docs.fd.io/csit/rls1801/report/_static/vpp/64B-1t1c-l2-sel2-ndrdisc.html" width="1200" height="1000" frameborder="0">
diff --git a/docs/overview/performance/current_ndr_throughput.rst b/docs/overview/performance/current_ndr_throughput.rst
new file mode 100644
index 00000000000..c7348314ef6
--- /dev/null
+++ b/docs/overview/performance/current_ndr_throughput.rst
@@ -0,0 +1,13 @@
+.. _current_ndr_throughput:
+
+.. toctree::
+
+NDR Performance Tests
+*********************
+
+This is a VPP NDR 64B packet throughput in 1 Core, 1 Thread setup, live graph of the NDR (No Drop Rate) L2 Performance Tests.
+
+.. raw:: html
+
+ <iframe src="https://docs.fd.io/csit/rls1804/report/_static/vpp/64B-1t1c-l2-sel1-ndrdisc.html" width="800" height="1000" frameborder="0">
+
diff --git a/docs/overview/performance/index.rst b/docs/overview/performance/index.rst
new file mode 100644
index 00000000000..4255d495c38
--- /dev/null
+++ b/docs/overview/performance/index.rst
@@ -0,0 +1,63 @@
+.. _performance:
+
+Performance
+===========
+
+Overview
+^^^^^^^^
+
+One of the benefits of FD.io VPP, is high performance on relatively low-power computing, this performance is based on the following features:
+
+* A high-performance user-space network stack designed for commodity hardware.
+
+ - L2, L3 and L4 features and encapsulations.
+
+* Optimized packet interfaces supporting a multitude of use cases.
+
+ - An integrated vhost-user backend for high speed VM-to-VM connectivity.
+ - An integrated memif container backend for high speed Container-to-Container connectivity.
+ - An integrated vhost based interface to punt packets to the Linux Kernel.
+
+* The same optimized code-paths run execute on the host, and inside VMs and Linux containers.
+* Leverages best-of-breed open source driver technology: `DPDK <https://www.dpdk.org/>`_.
+* Tested at scale; linear core scaling, tested with millions of flows and mac addresses.
+
+These features have been designed to take full advantage of common micro-processor optimization techniques, such as:
+
+* Reducing cache and TLS misses by processing packets in vectors.
+* Realizing `IPC <https://en.wikipedia.org/wiki/Instructions_per_cycle>`_ gains with vector instructions such as: SSE, AVX and NEON.
+* Eliminating mode switching, context switches and blocking, to always be doing useful work.
+* Cache-lined aliged buffers for cache and memory efficiency.
+
+
+Packet Throughput Graphs
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+These are some of the packet throughput graphs for FD.io VPP 18.04 from the CSIT `18.04 benchmarking report <https://docs.fd.io/csit/rls1804/report/>`_.
+
+.. toctree::
+
+ current_l2_throughput.rst
+ current_ndr_throughput.rst
+ current_ipv4_throughput.rst
+ current_ipv6_throughput.rst
+
+Trending Throughput Graphs
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+These are some of the trending packet throughput graphs from the CSIT `trending dashboard <https://docs.fd.io/csit/master/trending/introduction/index.html>`_. **Please note that**, performance in the trending graphs will change on a nightly basis in line with the software development cycle.
+
+.. toctree::
+
+ trending_l2_throughput.rst
+ trending_ipv4_throughput.rst
+ trending_ipv6_throughput.rst
+
+For More information on CSIT
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+These are FD.io Continuous System Integration and Testing (CSIT)'s documentation links.
+
+* `CSIT Code Documentation <https://docs.fd.io/csit/master/doc/overview.html>`_
+* `CSIT Test Overview <https://docs.fd.io/csit/rls1804/report/introduction/overview.html>`_
+* `VPP Performance Dashboard <https://docs.fd.io/csit/master/trending/introduction/index.html>`_
diff --git a/docs/overview/performance/trending_ipv4_throughput.rst b/docs/overview/performance/trending_ipv4_throughput.rst
new file mode 100644
index 00000000000..4ba028b9e59
--- /dev/null
+++ b/docs/overview/performance/trending_ipv4_throughput.rst
@@ -0,0 +1,14 @@
+.. _trending_ipv4_throughput:
+
+.. toctree::
+
+IPv4 Routed-Forwarding Performance Tests
+****************************************
+
+This is a live graph of the IPv4 Routed Forwarding Switching Performance Tests.
+
+.. raw:: html
+
+ <iframe src="https://docs.fd.io/csit/master/trending/_static/vpp/cpta-ip4-1t1c-x520.html" width="1200" height="1000" frameborder="0">
+
+
diff --git a/docs/overview/performance/trending_ipv6_throughput.rst b/docs/overview/performance/trending_ipv6_throughput.rst
new file mode 100644
index 00000000000..8217b41e817
--- /dev/null
+++ b/docs/overview/performance/trending_ipv6_throughput.rst
@@ -0,0 +1,16 @@
+.. _trending_ipv6_throughput:
+
+.. toctree::
+
+IPv6 Routed-Forwarding Performance Tests
+****************************************
+
+VPP NDR 78B packet throughput in 1t1c setup (1 thread, 1 core) is presented in the trending graph below.
+
+.. raw:: html
+
+ <iframe src="https://docs.fd.io/csit/master/trending/_static/vpp/cpta-ip6-1t1c-x520-1.html" width="1200" height="1000" frameborder="0">
+
+
+
+
diff --git a/docs/overview/performance/trending_l2_throughput.rst b/docs/overview/performance/trending_l2_throughput.rst
new file mode 100644
index 00000000000..59bb3bf6f1a
--- /dev/null
+++ b/docs/overview/performance/trending_l2_throughput.rst
@@ -0,0 +1,14 @@
+ .. _trending_l2_throughput:
+
+.. toctree::
+
+L2 Ethernet Switching Performance Tests
+***************************************
+
+This is a live graph of the 1 Core, 1 Thread, L2 Ethernet Switching Performance Tests Test on the x520 NIC.
+
+.. raw:: html
+
+ <iframe src="https://docs.fd.io/csit/master/trending/_static/vpp/cpta-l2-1t1c-x520.html" width="1200" height="1000" frameborder="0">
+
+