diff options
author | Mytnyk, VolodymyrX <volodymyrx.mytnyk@intel.com> | 2017-04-19 15:45:49 +0100 |
---|---|---|
committer | Mytnyk, VolodymyrX <volodymyrx.mytnyk@intel.com> | 2017-04-19 15:45:49 +0100 |
commit | d4a27420b54a69be4200ecb400f4f910375cc826 (patch) | |
tree | f48da1356dcfea295b9efd7b7dc71c0141e81569 /docs/release/userguide/feature.userguide.rst | |
parent | f9613d4f1195812e51c8a754a9185b7695ef6957 (diff) |
dpdk stats: add known issues/limitations
Change-Id: I8dbd43002f50e65df40cc8bfb516c40f995b9679
Signed-off-by: Mytnyk, Volodymyr <volodymyrx.mytnyk@intel.com>
Diffstat (limited to 'docs/release/userguide/feature.userguide.rst')
-rw-r--r-- | docs/release/userguide/feature.userguide.rst | 29 |
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 |