From d4a27420b54a69be4200ecb400f4f910375cc826 Mon Sep 17 00:00:00 2001 From: "Mytnyk, VolodymyrX" Date: Wed, 19 Apr 2017 15:45:49 +0100 Subject: dpdk stats: add known issues/limitations Change-Id: I8dbd43002f50e65df40cc8bfb516c40f995b9679 Signed-off-by: Mytnyk, Volodymyr --- docs/release/userguide/feature.userguide.rst | 29 ++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/release/userguide/feature.userguide.rst b/docs/release/userguide/feature.userguide.rst index 2ecc4376..ef366326 100644 --- a/docs/release/userguide/feature.userguide.rst +++ b/docs/release/userguide/feature.userguide.rst @@ -230,6 +230,17 @@ include: +.. note:: Currently, the DPDK library doesn’t support API to de-initialize + the DPDK resources allocated on the initialization. It means, the collectd + plugin will not be able to release the allocated DPDK resources + (locks/memory/pci bindings etc.) correctly on collectd shutdown or reinitialize + the DPDK library if primary DPDK process is restarted. The only way to release + those resources is to terminate the process itself. For this reason, the plugin + forks off a separate collectd process. This child process becomes a secondary + DPDK process which can be run on specific CPU cores configured by user through + collectd configuration file (“Coremask” EAL configuration option, the + hexadecimal bitmask of the cores to run on). + For more information on the plugin parameters, please see: https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod @@ -262,6 +273,24 @@ To fully enable ASLR: For more information on multi-process support, please see: http://dpdk.org/doc/guides/prog_guide/multi_proc_support.html +**DPDK stats plugin limitations:** + +1. The DPDK primary process application should use the same version of DPDK + that collectd DPDK plugin is using; + +2. L2 statistics are only supported; + +3. The plugin has been tested on Intel NIC’s only. + +**DPDK stats known issues:** + +* DPDK port visibility + + When network port controlled by Linux is bound to DPDK driver, the port + will not be available in the OS. It affects the SNMP write plugin as those + ports will not be present in standard IF-MIB. Thus addition work is + required to be done to support DPDK ports and statistics. + Hugepages Plugin ^^^^^^^^^^^^^^^^^ Repo: https://github.com/collectd/collectd -- cgit 1.2.3-korg