* *dpdkevents plugin*: A read plugin that retrieves DPDK link status and DPDK
forwarding cores liveliness status (DPDK Keep Alive).
-* `ceilometer plugin`_: A write plugin that pushes the retrieved stats to
- Ceilometer. It's capable of pushing any stats read through collectd to
- Ceilometer, not just the DPDK 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.
+
+* `aodh plugin`_: A notification plugin that pushes events to Aodh, and
+ creates/updates alarms appropriately.
* *hugepages plugin*: A read plugin that retrieves the number of available
and free hugepages on a platform as well as what is available in terms of
* *mcelog plugin*: A read plugin that uses mcelog client protocol to check for
memory Machine Check Exceptions and sends the stats for reported exceptions
+* *PMU plugin*: A read plugin that provides performance counters data on
+ Intel CPUs using Linux perf interface.
+
* *RDT plugin*: A read plugin that provides the last level cache utilization and
memory bandwidth utilization
-All the plugins above are available on the collectd master, except for the
-ceilometer plugin as it's a python based plugin and only C plugins are accepted
-by the collectd community. The ceilometer plugin lives in the OpenStack
-repositories.
-
-Other plugins existing as a pull request into collectd master:
+* *virt*: A read plugin that uses virtualization API *libvirt* to gather
+ statistics about virtualized guests on a system directly from the hypervisor,
+ without a need to install collectd instance on the guest.
* *SNMP Agent*: A write plugin that will act as a AgentX subagent that receives
and handles queries from SNMP master agent and returns the data collected
from collectd and translates requested values from collectd's internal format
to SNMP format. Supports SNMP: get, getnext and walk requests.
+All the plugins above are available on the collectd master, except for the
+Gnocchi and Aodh plugins as they are Python-based plugins and only C plugins
+are accepted by the collectd community. The Gnocchi and Aodh plugins live in
+the OpenStack repositories.
+
+Other plugins existing as a pull request into collectd master:
+
* *Legacy/IPMI*: A read plugin that reports platform thermals, voltages,
fanspeed, current, flow, power etc. Also, the plugin monitors Intelligent
Platform Management Interface (IPMI) System Event Log (SEL) and sends the
+ appropriate notifications based on monitored SEL events.
-* *virt*: A read plugin that uses virtualization API *libvirt* to gather
- statistics about virtualized guests on a system directly from the hypervisor,
- without a need to install collectd instance on the guest.
+* *PCIe AER*: A read plugin that monitors PCIe standard and advanced errors and
+ sends notifications about those errors.
+
+
+Third party application in Barometer repository:
+
+* *Open vSwitch PMD stats*: An aplication that retrieves PMD stats from OVS. It is run
+ through exec plugin.
**Plugins included in the Danube release:**
* sudo permissions are required to install collectd.
* These are instructions for Ubuntu 16.04
-To build and install these dependencies, clone the barometer repo:
+To build all the upstream plugins, clone the barometer repo:
.. code:: c
.. code:: bash
- $ cd barometer && ./systems/build_base_machine.sh
+ $ cd barometer/systems && ./build_base_machine.sh
This will install collectd as a service and the base install directory
will be /opt/collectd.
Sample configuration files can be found in '/opt/collectd/etc/collectd.conf.d'
.. note::
- - If you plan on using the Exec plugin, the plugin requires non-root
- user to execute scripts. By default, `collectd_exec` user is used. Barometer
- scripts do *not* create this user. It needs to be manually added or exec plugin
- configuration has to be changed to use other, existing user before starting
- collectd service.
-
- - If you don't want to use one of the Barometer plugins, simply remove the
- sample config file from '/opt/collectd/etc/collectd.conf.d'
+ If you don't want to use one of the Barometer plugins, simply remove the
+ sample config file from '/opt/collectd/etc/collectd.conf.d'
+.. note::
+ If you plan on using the Exec plugin (for OVS_PMD_STATS or for executing scripts
+ on notification generation), the plugin requires a non-root
+ user to execute scripts. By default, `collectd_exec` user is used in the exec.conf
+ provided in the sample configurations directory under src/collectd in the Barometer
+ repo. The scripts *DO NOT* create this user. You need to create this user before you
+ run build_base_machine.sh. Or modify configuration in the sample configurations
+ directory under src/collectd to use another existing non root user before running
+ run build_base_machine.sh.
- - If you are using any Open vSwitch plugins you need to run:
+.. note::
+ If you are using any Open vSwitch plugins you need to run:
.. code:: bash
$ sudo ovs-vsctl set-manager ptcp:6640
+After this, you should be able to start collectd as a service
+
+.. code:: bash
+
+ $ sudo systemctl status collectd
+
+If you want to use granfana to display the metrics you collect, please see:
+`grafana guide`_
+
+For more information on configuring and installing OpenStack plugins for
+collectd, check out the `collectd-ceilometer-plugin GSG`_.
Below is the per plugin installation and configuration guide, if you only want
to install some/particular plugins.
For more information on the plugin parameters, please see:
https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod
+Intel PMU Plugin
+^^^^^^^^^^^^^^^^
+Repo: https://github.com/collectd/collectd
+
+Branch: master
+
+Dependencies:
+
+ * PMU tools (jevents library) https://github.com/andikleen/pmu-tools
+
+To be suitable for use in collectd plugin shared library *libjevents* should be
+compiled as position-independent code. To do this add the following line to
+*pmu-tools/jevents/Makefile*:
+
+.. code:: bash
+
+ CFLAGS += -fPIC
+
+Building and installing *jevents* library:
+
+.. code:: bash
+
+ $ git clone https://github.com/andikleen/pmu-tools.git
+ $ cd pmu-tools/jevents/
+ $ make
+ $ sudo make install
+
+Building and installing collectd:
+
+.. code:: bash
+
+ $ git clone https://github.com/collectd/collectd.git
+ $ cd collectd
+ $ ./build.sh
+ $ ./configure --enable-syslog --enable-logfile --with-libjevents=/usr/local --enable-debug
+ $ make
+ $ sudo make install
+
+This will install collectd to /opt/collectd
+The collectd configuration file can be found at /opt/collectd/etc
+To configure the PMU plugin you need to modify the configuration file to
+include:
+
+.. code:: bash
+
+ <LoadPlugin intel_pmu>
+ Interval 1
+ </LoadPlugin>
+ <Plugin "intel_pmu">
+ ReportHardwareCacheEvents true
+ ReportKernelPMUEvents true
+ ReportSoftwareEvents true
+ </Plugin>
+
+For more information on the plugin parameters, please see:
+https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod
+
+.. note::
+
+ The plugin opens file descriptors whose quantity depends on number of
+ monitored CPUs and number of monitored counters. Depending on configuration,
+ it might be required to increase the limit on the number of open file
+ descriptors allowed. This can be done using 'ulimit -n' command. If collectd
+ is executed as a service 'LimitNOFILE=' directive should be defined in
+ [Service] section of *collectd.service* file.
+
Intel RDT Plugin
^^^^^^^^^^^^^^^^
Repo: https://github.com/collectd/collectd
$ sudo modprobe ipmi_devintf
$ sudo modprobe ipmi_si
-**Note**: If HW supports IPMI, the ``/dev/ipmi0`` character device will be
-created.
+.. note::
+ If HW supports IPMI, the ``/dev/ipmi0`` character device will be
+ created.
Clone and install the collectd IPMI plugin:
SELEnabled true # only feat_ipmi_events branch supports this
</Plugin>
-**Note**: By default, IPMI plugin will read all available analog sensor values,
-dispatch the values to collectd and send SEL notifications.
+.. note::
+ By default, IPMI plugin will read all available analog sensor values,
+ dispatch the values to collectd and send SEL notifications.
For more information on the IPMI plugin parameters and SEL feature configuration,
please see:
Dependencies: mcelog
-Start by installing mcelog. Note: The kernel has to have CONFIG_X86_MCE
-enabled. For 32bit kernels you need at least a 2.6,30 kernel.
+Start by installing mcelog.
+
+.. note::
+ The kernel has to have CONFIG_X86_MCE enabled. For 32bit kernels you
+ need at least a 2.6,30 kernel.
On ubuntu:
This will inject different classes of errors and check that the mcelog triggers
runs. There will be some kernel messages about page offlining attempts. The
test will also lose a few pages of memory in your system (not significant)
-**Note this test will kill any running mcelog, which needs to be restarted
-manually afterwards**.
+.. note::
+ This test will kill any running mcelog, which needs to be restarted
+ manually afterwards.
+
**mce-inject:**
A utility to inject corrected, uncorrected and fatal machine check exceptions
$ ./mce-inject < test/corrected
-**Note: the uncorrected and fatal scripts under test will cause a platform reset.
-Only the fatal script generates the memory errors**. In order to quickly
-emulate uncorrected memory errors and avoid host reboot following test errors
-from mce-test suite can be injected:
+.. note::
+ The uncorrected and fatal scripts under test will cause a platform reset.
+ Only the fatal script generates the memory errors**. In order to quickly
+ emulate uncorrected memory errors and avoid host reboot following test errors
+ from mce-test suite can be injected:
.. code:: bash
For more information on the plugin parameters, please see:
https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod
+OVS PMD stats
+^^^^^^^^^^^^^^
+Repo: https://gerrit.opnfv.org/gerrit/barometer
+
+Prequistes:
+1. Open vSwitch dependencies are installed.
+2. Open vSwitch service is running.
+3. Ovsdb-server manager is configured.
+You can refer `Open vSwitch Plugins`_ section above for each one of them.
+
+OVS PMD stats application is run through the exec plugin.
+
+To configure the OVS PMD stats application you need to modify the exec plugin configuration
+to include:
+
+.. code:: bash
+
+ <LoadPlugin exec>
+ Interval 1
+ </LoadPlugin
+ <Plugin exec>
+ Exec "user:group" "<path to ovs_pmd_stat.sh>"
+ #NotificationExec "nobody" "/usr/lib/collectd/notify.sh"
+ </Plugin>
+
+.. note:: Exec plugin configuration has to be changed to use appropriate user before starting collectd service.
+
+ovs_pmd_stat.sh calls the script for OVS PMD stats application with its argument:
+
+.. code:: bash
+
+ sudo python /usr/local/src/ovs_pmd_stats.py" "--socket-pid-file"
+ "/var/run/openvswitch/ovs-vswitchd.pid"
+
SNMP Agent Plugin
^^^^^^^^^^^^^^^^^
Repo: https://github.com/maryamtahhan/collectd/
The figure above shows the DPDK L2 forwarding application running on a compute
node, sending and receiving traffic. collectd is also running on this compute
node retrieving the stats periodically from DPDK through the dpdkstat plugin
-and publishing the retrieved stats to Ceilometer through the ceilometer plugin.
+and publishing the retrieved stats to OpenStack through the
+collectd-ceilometer-plugin.
To see this demo in action please checkout: `Barometer OPNFV Summit demo`_
+For more information on configuring and installing OpenStack plugins for
+collectd, check out the `collectd-ceilometer-plugin GSG`_.
+
References
^^^^^^^^^^^
.. [1] https://collectd.org/wiki/index.php/Naming_schema
.. [7] https://collectd.org/wiki/index.php/Meta_Data_Interface
.. _Barometer OPNFV Summit demo: https://prezi.com/kjv6o8ixs6se/software-fastpath-service-quality-metrics-demo/
-.. _ceilometer plugin: https://github.com/openstack/collectd-ceilometer-plugin/tree/stable/mitaka
-
+.. _gnocchi plugin: https://github.com/openstack/collectd-ceilometer-plugin/tree/stable/ocata/
+.. _aodh plugin: https://github.com/openstack/collectd-ceilometer-plugin/tree/stable/ocata/
+.. _collectd-ceilometer-plugin GSG: https://github.com/openstack/collectd-ceilometer-plugin/blob/master/doc/source/GSG.rst
+.. _grafana guide: https://wiki.opnfv.org/display/fastpath/Installing+and+configuring+InfluxDB+and+Grafana+to+display+metrics+with+collectd