From 6402cb3470bf9e6e790b9afa4b5b61a79717d259 Mon Sep 17 00:00:00 2001 From: Jabir Kanhira Kadavathu Date: Wed, 23 Sep 2020 03:24:46 -0700 Subject: Enabling dpdk_telemetry plugin Enabling dpdk_telemetry plugin with One Click Install. Added the config. templates and the related Documentation. Signed-off-by: Jabir Kanhira Kadavathu Change-Id: Ibecd96d4102cd76a71d31613879ae57950f5108f --- docs/release/userguide/feature.userguide.rst | 19 +++++++++++++++++++ docs/release/userguide/installguide.oneclick.rst | 13 +++++++------ 2 files changed, 26 insertions(+), 6 deletions(-) (limited to 'docs') diff --git a/docs/release/userguide/feature.userguide.rst b/docs/release/userguide/feature.userguide.rst index 59bf0ea1..50d59cf5 100644 --- a/docs/release/userguide/feature.userguide.rst +++ b/docs/release/userguide/feature.userguide.rst @@ -26,6 +26,21 @@ Barometer has enabled the following collectd plugins: * *dpdkevents plugin*: A read plugin that retrieves DPDK link status and DPDK forwarding cores liveliness status (DPDK Keep Alive). +* *dpdk_telemetry plugin*: A read plugin to collect dpdk interface stats and + application or global stats from dpdk telemetry library. Both 'dpdkstat' and + 'dpdk_telemetry' plugins provides dpdk NIC Stats, but only 'dpdk_telemetry' + provides the DPDK Application stats. So in other words, 'dpdk_telemetry' is + an advanced version of dpdkstat. This plugin don't deal with dpdk events. + So not in related with 'dpdkevents' plugin. The mimimum dpdk version required + to use this plugin is 19.08. + +.. note:: + dpdpkstat and dpdk_telemetry should not be used together. Use dpdk_telemetry + if your version of dpdk supports it (i.e. DPDK >= 19.08) and use dpdkstat otherwise. + dpdkstat, dpdkevents and dpdk_telemetry plugins should only be used if your dpdk + application doesn't already have more relevant metrics available(e.g.ovs_stats). + + * `gnocchi plugin`_: A write plugin that pushes the retrieved stats to Gnocchi. It's capable of pushing any stats read through collectd to Gnocchi, not just the DPDK stats. @@ -304,6 +319,10 @@ http://dpdk.org/doc/guides/prog_guide/multi_proc_support.html ports will not be present in standard IF-MIB. Thus, additional work is required to be done to support DPDK ports and statistics. +**DPDK telemetry plugin** + +Please refer https://wiki.opnfv.org/display/fastpath/DPDK+Telemetry+Plugin + Hugepages Plugin ^^^^^^^^^^^^^^^^^ Repo: https://github.com/collectd/collectd diff --git a/docs/release/userguide/installguide.oneclick.rst b/docs/release/userguide/installguide.oneclick.rst index 76a81db9..19ba48a1 100644 --- a/docs/release/userguide/installguide.oneclick.rst +++ b/docs/release/userguide/installguide.oneclick.rst @@ -302,18 +302,19 @@ List of default plugins for collectd container 3.Change the Makefile path from '(WORKDIR)/kernel/linux/kni/Makefile' to (WORKDIR)/lib/librte_eal/linuxapp/kni/Makefile in '(WORK_DIR)/src/dpdk/Makefile'. By default the collectd is started with default configuration which includes -the followin plugins: +the following plugins: * ``csv``, ``contextswitch``, ``cpu``, ``cpufreq``, ``df``, ``disk``, ``ethstat``, ``ipc``, ``irq``, ``load``, ``memory``, ``numa``, ``processes``, ``swap``, ``turbostat``, ``uuid``, ``uptime``, ``exec``, ``hugepages``, ``intel_pmu``, ``ipmi``, ``write_kafka``, ``logfile``, ``mcelog``, ``network``, ``intel_rdt``, ``rrdtool``, ``snmp_agent``, ``syslog``, ``virt``, ``ovs_stats``, ``ovs_events``, ``dpdkevents``, - ``dpdkstat`` + ``dpdkstat``, ``dpdk_telemetry`` -Some of the plugins are loaded depending on specific system requirements and can be omitted if -dependency is not met, this is the case for: - * ``hugepages``, ``ipmi``, ``mcelog``, ``intel_rdt``, ``virt``, ``ovs_stats``, ``ovs_events`` +.. note:: + Some of the plugins are loaded depending on specific system requirements and can be omitted if + dependency is not met, this is the case for: + * ``hugepages``, ``ipmi``, ``mcelog``, ``intel_rdt``, ``virt``, ``ovs_stats``, ``ovs_events`` List and description of tags used in ansible scripts ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -360,5 +361,5 @@ List of available tags: ``turbostat``, ``uptime``, ``exec``, ``hugepages``, ``ipmi``, ``kafka``, ``logfile``, ``mcelogs``, ``n``etwork``,`` ``pmu``, ``rdt``, ``rrdtool``, ``snmp``, ``syslog``, ``virt``, ``ovs_stats``, ``ovs_events``, ``uuid``, - ``dpdkevents``, ``dpdkstat``. + ``dpdkevents``, ``dpdkstat``, ``dpdk_telemetry``. -- cgit 1.2.3-korg