summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMytnyk, VolodymyrX <volodymyrx.mytnyk@intel.com>2017-04-19 15:45:49 +0100
committerMytnyk, VolodymyrX <volodymyrx.mytnyk@intel.com>2017-04-19 15:45:49 +0100
commitd4a27420b54a69be4200ecb400f4f910375cc826 (patch)
treef48da1356dcfea295b9efd7b7dc71c0141e81569
parentf9613d4f1195812e51c8a754a9185b7695ef6957 (diff)
dpdk stats: add known issues/limitations
Change-Id: I8dbd43002f50e65df40cc8bfb516c40f995b9679 Signed-off-by: Mytnyk, Volodymyr <volodymyrx.mytnyk@intel.com>
-rw-r--r--docs/release/userguide/feature.userguide.rst29
1 files changed, 29 insertions, 0 deletions
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:
</Event>
</Plugin>
+.. 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