diff options
24 files changed, 805 insertions, 168 deletions
diff --git a/docs/configguide/featureconfig.rst b/docs/configguide/feature.configuration.rst index e7c8d5ce..e7c8d5ce 100644 --- a/docs/configguide/featureconfig.rst +++ b/docs/configguide/feature.configuration.rst diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst index d5b161f6..b336d2d5 100644 --- a/docs/configguide/index.rst +++ b/docs/configguide/index.rst @@ -2,12 +2,12 @@ .. http://creativecommons.org/licenses/by/4.0 .. Copyright (c) 2016 Open Platform for NFV Project, Inc. and its contributors -================================== -Barometer Guides and Installation -================================== +*************************************** +Barometer configuration Guide in OPNFV +*************************************** .. toctree:: :numbered: :maxdepth: 3 - featureconfig.rst + feature.configuration.rst diff --git a/docs/index.rst b/docs/index.rst index 00e13366..9b1c6137 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -2,12 +2,14 @@ .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV, Intel Corporation and others. -********** +========= Barometer -********** +========= :Project: Barometer, https://wiki.opnfv.org/display/fastpath/Barometer+Home + :Authors: Maryam Tahhan <maryam.tahhan@intel.com> + :History: ========== ===================================================== @@ -16,15 +18,15 @@ Barometer 16.12.2014 Project creation ========== ===================================================== - -Table of Contents: -================== - .. toctree:: - :maxdepth: 4 + :maxdepth: 3 :numbered: - requirements/index.rst - configguide/index.rst - userguide/index.rst - release/index.rst + ./requirements/index.rst + ./userguide/index.rst + ./configguide/index.rst + ./release/index.rst + +Indices +======= +* :ref:`search` diff --git a/docs/release/index.rst b/docs/release/index.rst index 706efe7f..30b2524c 100644 --- a/docs/release/index.rst +++ b/docs/release/index.rst @@ -2,8 +2,11 @@ .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV, Intel Corporation and others. +************************ +Barometer Release Notes +************************ .. toctree:: - :maxdepth: 4 + :maxdepth: 3 :numbered: 01-release.rst diff --git a/docs/requirements/02-collectd.rst b/docs/requirements/02-collectd.rst new file mode 100755 index 00000000..2303fadc --- /dev/null +++ b/docs/requirements/02-collectd.rst @@ -0,0 +1,103 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV, Intel Corporation and others. + +collectd +~~~~~~~~ +collectd is a daemon which collects system performance statistics periodically +and provides a variety of mechanisms to publish the collected metrics. It +supports more than 90 different input and output plugins. Input plugins retrieve +metrics and publish them to the collectd deamon, while output plugins publish +the data they receive to an end point. collectd also has infrastructure to +support thresholding and notification. + +collectd statistics and Notifications +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Within collectd notifications and performance data are dispatched in the same +way. There are producer plugins (plugins that create notifications/metrics), +and consumer plugins (plugins that receive notifications/metrics and do +something with them). + +Statistics in collectd consist of a value list. A value list includes: + +* Values, can be one of: + + * Derive: used for values where a change in the value since it's last been + read is of interest. Can be used to calculate and store a rate. + + * Counter: similar to derive values, but take the possibility of a counter + wrap around into consideration. + + * Gauge: used for values that are stored as is. + + * Absolute: used for counters that are reset after reading. + +* Value length: the number of values in the data set. + +* Time: timestamp at which the value was collected. + +* Interval: interval at which to expect a new value. + +* Host: used to identify the host. + +* Plugin: used to identify the plugin. + +* Plugin instance (optional): used to group a set of values together. For e.g. + values belonging to a DPDK interface. + +* Type: unit used to measure a value. In other words used to refer to a data + set. + +* Type instance (optional): used to distinguish between values that have an + identical type. + +* meta data: an opaque data structure that enables the passing of additional + information about a value list. "Meta data in the global cache can be used to + store arbitrary information about an identifier" [7]. + +Host, plugin, plugin instance, type and type instance uniquely identify a +collectd value. + +Values lists are often accompanied by data sets that describe the values in more +detail. Data sets consist of: + +* A type: a name which uniquely identifies a data set. + +* One or more data sources (entries in a data set) which include: + + * The name of the data source. If there is only a single data source this is + set to "value". + + * The type of the data source, one of: counter, gauge, absolute or derive. + + * A min and a max value. + +Types in collectd are defined in types.db. Examples of types in types.db: + +.. code-block:: console + + bitrate value:GAUGE:0:4294967295 + counter value:COUNTER:U:U + if_octets rx:COUNTER:0:4294967295, tx:COUNTER:0:4294967295 + +In the example above if_octets has two data sources: tx and rx. + +Notifications in collectd are generic messages containing: + +* An associated severity, which can be one of OKAY, WARNING, and FAILURE. + +* A time. + +* A Message + +* A host. + +* A plugin. + +* A plugin instance (optional). + +* A type. + +* A types instance (optional). + +* Meta-data. diff --git a/docs/userguide/keepalive.userguide.rst b/docs/requirements/03-dpdk.rst index 4b6e990d..ad7c8c78 100644 --- a/docs/userguide/keepalive.userguide.rst +++ b/docs/requirements/03-dpdk.rst @@ -2,8 +2,50 @@ .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV, Intel Corporation and others. +DPDK Enhancements +================== +This section will discuss the Barometer features that were integrated with DPDK. + +Measuring Telco Traffic and Performance KPIs +-------------------------------------------- +This section will discuss the Barometer features that enable Measuring Telco Traffic +and Performance KPIs. + +.. Figure:: stats_and_timestamps.png + + Measuring Telco Traffic and Performance KPIs + +* The very first thing Barometer enabled was a call-back API in DPDK and an + associated application that used the API to demonstrate how to timestamp + packets and measure packet latency in DPDK (the sample app is called + rxtx_callbacks). This was upstreamed to DPDK 2.0 and is represented by + the interfaces 1 and 2 in Figure 1.2. + +* The second thing Barometer implemented in DPDK is the extended NIC statistics API, + which exposes NIC stats including error stats to the DPDK user by reading the + registers on the NIC. This is represented by interface 3 in Figure 1.2. + + * For DPDK 2.1 this API was only implemented for the ixgbe (10Gb) NIC driver, + in association with a sample application that runs as a DPDK secondary + process and retrieves the extended NIC stats. + + * For DPDK 2.2 the API was implemented for igb, i40e and all the Virtual + Functions (VFs) for all drivers. + + * For DPDK 16.07 the API migrated from using string value pairs to using id + value pairs, improving the overall performance of the API. + +Monitoring DPDK interfaces +-------------------------- +With the features Barometer enabled in DPDK to enable measuring Telco traffic and +performance KPIs, we can now retrieve NIC statistics including error stats and +relay them to a DPDK user. The next step is to enable monitoring of the DPDK +interfaces based on the stats that we are retrieving from the NICs, by relaying +the information to a higher level Fault Management entity. To enable this Barometer +has been enabling a number of plugins for collectd. + DPDK Keep Alive description -=========================== +--------------------------- SFQM aims to enable fault detection within DPDK, the very first feature to meet this goal is the DPDK Keep Alive Sample app that is part of DPDK 2.2. @@ -29,7 +71,7 @@ detection and notification. heartbeat mechanism. DPDK Keep Alive Sample App Internals ------------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This section provides some explanation of the The Keep-Alive/'Liveliness' conceptual scheme as well as the DPDK Keep Alive App. The initialization and run-time paths are very similar to those of the L2 forwarding application (see @@ -51,7 +93,7 @@ The Keep-Alive/'Liveliness' conceptual scheme is: to monitor the Keep Alive Monitor Agent Core. DPDK Keep Alive Sample App Code Internals ------------------------------------------ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following section provides some explanation of the code aspects that are specific to the Keep Alive sample application. diff --git a/docs/userguide/dpdk_ka.png b/docs/requirements/dpdk_ka.png Binary files differindex 4a45e10c..4a45e10c 100644 --- a/docs/userguide/dpdk_ka.png +++ b/docs/requirements/dpdk_ka.png diff --git a/docs/requirements/index.rst b/docs/requirements/index.rst index a9be153d..e5d04896 100644 --- a/docs/requirements/index.rst +++ b/docs/requirements/index.rst @@ -2,8 +2,13 @@ .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV, Intel Corporation and others. +********************** +Barometer Requirements +********************** .. toctree:: - :maxdepth: 4 + :maxdepth: 3 :numbered: 01-intro.rst + 02-collectd.rst + 03-dpdk.rst diff --git a/docs/userguide/stats_and_timestamps.png b/docs/requirements/stats_and_timestamps.png Binary files differindex 84aef726..84aef726 100644 --- a/docs/userguide/stats_and_timestamps.png +++ b/docs/requirements/stats_and_timestamps.png diff --git a/docs/userguide/collectd.userguide.rst b/docs/userguide/collectd.userguide.rst index 5151befc..2dcb3593 100644 --- a/docs/userguide/collectd.userguide.rst +++ b/docs/userguide/collectd.userguide.rst @@ -2,193 +2,339 @@ .. http://creativecommons.org/licenses/by/4.0 .. (c) OPNFV, Intel Corporation and others. -collectd plugins description -============================ -The SFQM collectd plugins enable the ability to monitor DPDK interfaces by -exposing stats and the relevant events to higher level telemetry and fault -management applications. The following sections will discuss the SFQM features -in detail. +collectd plugins +================= +Barometer has enabled the following collectd plugins: -Measuring Telco Traffic and Performance KPIs --------------------------------------------- -This section will discuss the SFQM features that enable Measuring Telco Traffic -and Performance KPIs. +* dpdkstat plugin: A read plugin that retrieve stats from the DPDK extended + NIC stats API. -.. Figure:: stats_and_timestamps.png +* `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. - Measuring Telco Traffic and Performance KPIs +* 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 + hugepages per socket. -* The very first thing SFQM enabled was a call-back API in DPDK and an - associated application that used the API to demonstrate how to timestamp - packets and measure packet latency in DPDK (the sample app is called - rxtx_callbacks). This was upstreamed to DPDK 2.0 and is represented by - the interfaces 1 and 2 in Figure 1.2. +* RDT plugin: A read plugin that provides the last level cache utilitzation and + memory bandwidth utilization -* The second thing SFQM implemented in DPDK is the extended NIC statistics API, - which exposes NIC stats including error stats to the DPDK user by reading the - registers on the NIC. This is represented by interface 3 in Figure 1.2. +* Open vSwitch events Plugin: A read plugin that retrieves events from OVS. - * For DPDK 2.1 this API was only implemented for the ixgbe (10Gb) NIC driver, - in association with a sample application that runs as a DPDK secondary - process and retrieves the extended NIC stats. +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. - * For DPDK 2.2 the API was implemented for igb, i40e and all the Virtual - Functions (VFs) for all drivers. +Other plugins under development or existing as a pull request into collectd master: - * For DPDK 16.07 the API migrated from using string value pairs to using id - value pairs, improving the overall performance of the API. +* dpdkevents: A read plugin that retrieves DPDK link status and DPDK + forwarding cores liveliness status (DPDK Keep Alive). -Monitoring DPDK interfaces --------------------------- -With the features SFQM enabled in DPDK to enable measuring Telco traffic and -performance KPIs, we can now retrieve NIC statistics including error stats and -relay them to a DPDK user. The next step is to enable monitoring of the DPDK -interfaces based on the stats that we are retrieving from the NICs, by relaying -the information to a higher level Fault Management entity. To enable this SFQM -has been enabling a number of plugins for collectd. +* Open vSwitch stats Plugin: A read plugin that retrieve flow and interface + stats from OVS. -collectd -~~~~~~~~ -collectd is a daemon which collects system performance statistics periodically -and provides a variety of mechanisms to publish the collected metrics. It -supports more than 90 different input and output plugins. Input plugins retrieve -metrics and publish them to the collectd deamon, while output plugins publish -the data they receive to an end point. collectd also has infrastructure to -support thresholding and notification. +* mcelog plugin: A read plugin that uses mcelog client protocol to check for + memory Machine Check Exceptions and sends the stats for reported exceptions. -collectd statistics and Notifications -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Within collectd notifications and performance data are dispatched in the same -way. There are producer plugins (plugins that create notifications/metrics), -and consumer plugins (plugins that receive notifications/metrics and do -something with them). +* SNMP write: A write plugin that will act as a SNMP subagent and will map + collectd metrics to relavent OIDs. Will only support SNMP: get, getnext and + walk. -Statistics in collectd consist of a value list. A value list includes: +* Legacy/IPMI: A read plugin that will report platform thermals, voltages, + fanspeed.... -* Values, can be one of: +Building collectd with the Barometer plugins and installing the dependencies +============================================================================= - * Derive: used for values where a change in the value since it's last been - read is of interest. Can be used to calculate and store a rate. +All plugins +----------- +The plugins that have been merged to the baromter master branch can all be +built and configured through the barometer repository. - * Counter: similar to derive values, but take the possibility of a counter - wrap around into consideration. +**Note**: sudo permissions are required to install collectd. - * Gauge: used for values that are stored as is. +**Note**: These are instructions for Ubuntu 16.04. - * Absolute: used for counters that are reset after reading. +To build and install these dependencies, clone the barometer repo: -* Value length: the number of values in the data set. +.. code:: c -* Time: timestamp at which the value was collected. + $ git clone https://gerrit.opnfv.org/gerrit/barometer -* Interval: interval at which to expect a new value. +Install the build dependencies -* Host: used to identify the host. +.. code:: bash -* Plugin: used to identify the plugin. + $ ./src/install_build_deps.sh -* Plugin instance (optional): used to group a set of values together. For e.g. - values belonging to a DPDK interface. +To install collectd as a service and install all it's dependencies: -* Type: unit used to measure a value. In other words used to refer to a data - set. +.. code:: bash -* Type instance (optional): used to distinguish between values that have an - identical type. + $ cd barometer/src && sudo make && sudo make install -* meta data: an opaque data structure that enables the passing of additional - information about a value list. "Meta data in the global cache can be used to - store arbitrary information about an identifier" [7]. +This will install collectd as a service and the base install directory +is /opt/collectd. -Host, plugin, plugin instance, type and type instance uniquely identify a -collectd value. +Sample configuration files can be found in '/opt/collectd/etc/collectd.conf.d' -Values lists are often accompanied by data sets that describe the values in more -detail. Data sets consist of: +Please note if you are using any Open vSwitch plugins you need to run: -* A type: a name which uniquely identifies a data set. +.. code:: bash -* One or more data sources (entries in a data set) which include: + $ sudo ovs-vsctl set-manager ptcp:6640 - * The name of the data source. If there is only a single data source this is - set to "value". +DPDK statistics plugin +----------------------- +Repo: https://github.com/collectd/collectd - * The type of the data source, one of: counter, gauge, absolute or derive. +Branch: master - * A min and a max value. +Dependencies: DPDK (http://dpdk.org/) -Types in collectd are defined in types.db. Examples of types in types.db: +To build and install DPDK to /usr please see: +https://github.com/collectd/collectd/blob/master/docs/BUILD.dpdkstat.md -.. code-block:: console +Building and installing collectd: - bitrate value:GAUGE:0:4294967295 - counter value:COUNTER:U:U - if_octets rx:COUNTER:0:4294967295, tx:COUNTER:0:4294967295 +.. code:: bash -In the example above if_octets has two data sources: tx and rx. + $ git clone https://github.com/collectd/collectd.git + $ cd collectd + $ ./build.sh + $ ./configure --enable-syslog --enable-logfile --enable-debug + $ make + $ sudo make install -Notifications in collectd are generic messages containing: -* An associated severity, which can be one of OKAY, WARNING, and FAILURE. +This will install collectd to /opt/collectd +The collectd configuration file can be found at /opt/collectd/etc +To configure the hugepages plugin you need to modify the configuration file to +include: -* A time. +.. code:: bash -* A Message + LoadPlugin dpdkstat + <Plugin dpdkstat> + Coremask "0xf" + ProcessType "secondary" + FilePrefix "rte" + EnabledPortMask 0xffff + </Plugin> -* A host. +For more information on the plugin parameters, please see: +https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod -* A plugin. +Please note if you are configuring collectd with the **static DPDK library** +you must compile the DPDK library with the -fPIC flag: -* A plugin instance (optional). +.. code:: bash -* A type. + $ make EXTRA_CFLAGS=-fPIC -* A types instance (optional). +You must also modify the configuration step when building collectd: -* Meta-data. +.. code:: bash -collectd plugins ----------------- -Barometer has enabled the following collectd plugins: + $ ./configure CFLAGS=" -lpthread -Wl,--whole-archive -Wl,-ldpdk -Wl,-lm -Wl,-lrt -Wl,-lpcap -Wl,-ldl -Wl,--no-whole-archive" -* dpdkstat plugin: A read plugin that retrieve stats from the DPDK extended - NIC stats API. +Please also note that if you are not building and installing DPDK system-wide +you will need to specify the specific paths to the header files and libraries +using LIBDPDK_CPPFLAGS and LIBDPDK_LDFLAGS. You will also need to add the DPDK +library symbols to the shared library path using ldconfig. Note that this +update to the shared library path is not persistant (i.e. it will not survive a +reboot). Pending a merge of https://github.com/collectd/collectd/pull/2073. -* `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. +.. code:: bash -* 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 - hugepages per socket. + $ ./configure LIBDPDK_CPPFLAGS="path to DPDK header files" LIBDPDK_LDFLAGS="path to DPDK libraries" -* RDT plugin: A read plugin that provides the last level cache utilitzation 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. +Hugepages Plugin +----------------- +Repo: https://github.com/collectd/collectd -Other plugins in progress: +Branch: master -* dpdkevents: A read plugin that retrieves DPDK link status and DPDK - forwarding cores liveliness status (DPDK Keep Alive). +Dependencies: None, but assumes hugepages are configured. -* Open vSwitch stats Plugin: A read plugin that retrieve flow and interface - stats from OVS. +To configure some hugepages: -* Open vSwitch events Plugin: A read plugin that retrieves events from OVS. +.. code:: bash -* mcelog plugin: A read plugin that uses mcelog client protocol to check for - memory Machine Check Exceptions and sends the stats for reported exceptions. + sudo mkdir -p /mnt/huge + sudo mount -t hugetlbfs nodev /mnt/huge + sudo echo 14336 > /sys/devices/system/node/node0/hugepages/hugepages-2048kB/nr_hugepages -* SNMP write: A write plugin that will act as a SNMP subagent and will map - collectd metrics to relavent OIDs. Will only support SNMP: get, getnext and - walk. +Building and installing collectd: -* Legacy/IPMI: A read plugin that will report platform thermals, voltages, - fanspeed.... +.. code:: bash + + $ git clone https://github.com/collectd/collectd.git + $ cd collectd + $ ./build.sh + $ ./configure --enable-syslog --enable-logfile --enable-hugepages --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 hugepages plugin you need to modify the configuration file to +include: + +.. code:: bash + + LoadPlugin hugepages + <Plugin hugepages> + ReportPerNodeHP true + ReportRootHP true + ValuesPages true + ValuesBytes false + ValuesPercentage false + </Plugin> + +For more information on the plugin parameters, please see: +https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod + +Intel RDT Plugin +----------------- +Repo: https://github.com/collectd/collectd + +Branch: master + +Dependencies: + + * PQoS/Intel RDT library https://github.com/01org/intel-cmt-cat.git + * msr kernel module + +Building and installing PQoS/Intel RDT library: + +.. code:: bash + + $ git clone https://github.com/01org/intel-cmt-cat.git + $ cd intel-cmt-cat.git + $ make + $ make install PREFIX=/usr + +Building and installing collectd: + +.. code:: bash + + $ git clone https://github.com/collectd/collectd.git + $ cd collectd + $ ./build.sh + $ ./configure --enable-syslog --enable-logfile --with-libpqos=/usr/ --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 RDT plugin you need to modify the configuration file to +include: + +.. code:: bash + + <LoadPlugin intel_rdt> + Interval 1 + </LoadPlugin> + <Plugin "intel_rdt"> + Cores "" + </Plugin> + +For more information on the plugin parameters, please see: +https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod + +Installing collectd as a service +-------------------------------- +Collectd service scripts are available in the collectd/contrib directory. +To install collectd as a service: + +.. code:: bash + + $ sudo cp contrib/systemd.collectd.service /etc/systemd/system/ + $ cd /etc/systemd/system/ + $ sudo mv systemd.collectd.service collectd.service + $ sudo chmod +x collectd.service + +Modify collectd.service + +.. code:: bash + + [Service] + ExecStart=/opt/collectd/sbin/collectd + EnvironmentFile=-/opt/collectd/etc/ + EnvironmentFile=-/opt/collectd/etc/ + CapabilityBoundingSet=CAP_SETUID CAP_SETGID + +Reload + +.. code:: bash + + $ sudo systemctl daemon-reload + $ sudo systemctl start collectd.service + $ sudo systemctl status collectd.service should show success + +Additional useful plugins +-------------------------- + +Exec Plugin +~~~~~~~~~~~ + +Can be used to show you when notifications are being generated by calling a +bash script that dumps notifications to file. (handy for debug). Modify +/opt/collectd/etc/collectd.conf: + +.. code:: bash + + LoadPlugin exec + <Plugin exec> + # Exec "user:group" "/path/to/exec" + NotificationExec "user" "<path to barometer>/barometer/src/collectd/collectd_sample_configs/write_notification.sh" + </Plugin> + +write_notification.sh (just writes the notification passed from exec through +STDIN to a file (/tmp/notifications)): + +.. code:: bash + + #!/bin/bash + rm -f /tmp/notifications + while read x y + do + echo $x$y >> /tmp/notifications + done + +output to /tmp/notifications should look like: + +.. code:: bash + + Severity:WARNING + Time:1479991318.806 + Host:localhost + Plugin:ovs_events + PluginInstance:br-ex + Type:gauge + TypeInstance:link_status + uuid:f2aafeec-fa98-4e76-aec5-18ae9fc74589 + + linkstate of "br-ex" interface has been changed to "DOWN" + +logfile plugin +~~~~~~~~~~~~~~~ +Can be used to log collectd activity. Modify /opt/collectd/etc/collectd.conf to +include: + +.. code:: bash + + LoadPlugin logfile + <Plugin logfile> + LogLevel info + File "/var/log/collectd.log" + Timestamp true + PrintSeverity false + </Plugin> Monitoring Interfaces and Openstack Support ------------------------------------------- @@ -201,7 +347,7 @@ 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. -To see this demo in action please checkout: `SFQM OPNFV Summit demo`_ +To see this demo in action please checkout: `Barometer OPNFV Summit demo`_ References ---------- @@ -213,5 +359,5 @@ References [6] https://collectd.org/wiki/index.php/Data_source [7] https://collectd.org/wiki/index.php/Meta_Data_Interface -.. _SFQM OPNFV Summit demo: https://prezi.com/kjv6o8ixs6se/software-fastpath-service-quality-metrics-demo/ +.. _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 diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst index ae459d0a..bf62a43d 100644 --- a/docs/userguide/index.rst +++ b/docs/userguide/index.rst @@ -1,10 +1,10 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. - .. http://creativecommons.org/licenses/by/4.0 - .. (c) <optionally add copywriters name> +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Intel Corporation and OPNFV -==================== +******************** Barometer user guide -==================== +******************** .. The feature user guide should provide an OPNFV user with enough information to .. use the features provided by the feature project in the supported scenarios. @@ -16,4 +16,3 @@ Barometer user guide :maxdepth: 3 collectd.userguide.rst - keepalive.userguide.rst diff --git a/src/Makefile b/src/Makefile index 73e3508a..48d79e9a 100644 --- a/src/Makefile +++ b/src/Makefile @@ -35,6 +35,7 @@ export WITH_DPDK include mk/master.mk SUBDIRS = SUBDIRS += dpdk +SUBDIRS += libpqos SUBDIRS += collectd SUBDIRS += collectd-ceilometer-plugin diff --git a/src/collectd/Makefile b/src/collectd/Makefile index 1cff9364..6fdd4638 100644 --- a/src/collectd/Makefile +++ b/src/collectd/Makefile @@ -29,40 +29,51 @@ BUILD_CMD = ./build.sh CONFIG_CMD = CONFIG_CMD += ./configure -# DPDK_DIR is the directory where DPDK shared lib is installed -DPDK_DIR = $(shell echo $$DPDK_DIR) -ifeq ($(DPDK_DIR),) -DPDK_DIR = /usr +LIBPQOS_DIR = $(shell echo $$LIBPQOS_DIR) +ifeq ($(LIBPQOS_DIR),) +LIBPQOS_DIR = /usr endif + CONFIG_CMD += --enable-syslog CONFIG_CMD += --enable-logfile -CONFIG_CMD += --with-libdpdk=$(DPDK_DIR) +CONFIG_CMD += --with-libpqos=$(LIBPQOS_DIR) +CONFIG_CMD += --with-hugepages +CONFIG_CMD += --enable-exec +CONFIG_CMD += --enable-python +CONFIG_CMD += --enable-threshold .PHONY: install force_install config force_make # install depends on make -force_install: force_make +#force_install: force_make all: force_make - @echo "Finished making $(WORK_DIR) " + @echo "Finished making $(WORK_DIR)" config $(WORK_DIR)/Makefile: $(WORK_DIR)/configure $(AT)cd $(WORK_DIR); $(CONFIG_CMD) @echo "Configure done" -INSTALL_TARGET = force_install force_make - force_make: $(WORK_DIR)/Makefile $(AT)cd $(WORK_DIR) && git pull $(COLLECTD_URL) $(COLLECTD_TAG) @echo "git pull done" - $(AT)$(MAKE) -C $(WORK_DIR) $(MORE_MAKE_FLAGS) + $(AT) $(MAKE) -C $(WORK_DIR) $(MORE_MAKE_FLAGS) @echo "Make done" force_install: - $(AT)sudo $(MAKE) -C $(WORK_DIR) install + $(AT)$(MAKE) -C $(WORK_DIR) install + $(AT)cp $(WORK_DIR)/contrib/systemd.collectd.service /etc/systemd/system/ + $(AT)mv /etc/systemd/system/systemd.collectd.service /etc/systemd/system/collectd.service + $(AT)chmod +x /etc/systemd/system/collectd.service + $(AT)sed -i -e 's/ExecStart=\/usr\/sbin\/collectd/ExecStart=\/opt\/collectd\/sbin\/collectd/g' /etc/systemd/system/collectd.service + $(AT)sed -i -e 's/CapabilityBoundingSet=/CapabilityBoundingSet=CAP_SETUID CAP_SETGID/g' /etc/systemd/system/collectd.service + $(AT)systemctl daemon-reload + $(AT)sudo ./include_config.sh + @echo "Make install done" + +install: force_install -install: $(INSTALL_TARGET) # hard way to clean and clobber clean: @@ -94,7 +105,7 @@ $(WORK_DIR): $(AT)git clone $(COLLECTD_URL) $(TAG_DONE_FLAG): $(WORK_DIR) - $(AT)cd $(WORK_DIR); git checkout $(COLLECTD_TAG) + $(AT)cd collectd; git checkout $(COLLECTD_TAG) ifneq ($(PATCH_FILE),) $(AT)cd $(WORK_DIR); patch -p1 < ../$(PATCH_FILE) endif diff --git a/src/collectd/collectd_sample_configs/csv.conf b/src/collectd/collectd_sample_configs/csv.conf new file mode 100644 index 00000000..e2350039 --- /dev/null +++ b/src/collectd/collectd_sample_configs/csv.conf @@ -0,0 +1,19 @@ +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +LoadPlugin csv +<Plugin csv> + DataDir "/tmp/collectd/csv" + StoreRates false +</Plugin> diff --git a/src/collectd/collectd_sample_configs/dpdkstat.conf b/src/collectd/collectd_sample_configs/dpdkstat.conf new file mode 100644 index 00000000..201f9d37 --- /dev/null +++ b/src/collectd/collectd_sample_configs/dpdkstat.conf @@ -0,0 +1,24 @@ +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +LoadPlugin dpdkstat + +<Plugin dpdkstat> +# Coremask "0xf" +# ProcessType "secondary" +# FilePrefix "rte" + EnabledPortMask 0xffff +# PortName "interface1" +# PortName "interface2" +</Plugin> + diff --git a/src/collectd/collectd_sample_configs/exec.conf b/src/collectd/collectd_sample_configs/exec.conf new file mode 100644 index 00000000..5b11fd94 --- /dev/null +++ b/src/collectd/collectd_sample_configs/exec.conf @@ -0,0 +1,20 @@ +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + + +LoadPlugin exec +<Plugin exec> +# Exec "user:group" "/path/to/exec" + NotificationExec "" "write_notification.sh" +</Plugin> diff --git a/src/collectd/collectd_sample_configs/hugepages.conf b/src/collectd/collectd_sample_configs/hugepages.conf new file mode 100644 index 00000000..4e4d9152 --- /dev/null +++ b/src/collectd/collectd_sample_configs/hugepages.conf @@ -0,0 +1,23 @@ +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +LoadPlugin hugepages + +<Plugin hugepages> + ReportPerNodeHP true + ReportRootHP true + ValuesPages true + ValuesBytes false + ValuesPercentage false +</Plugin> + diff --git a/src/collectd/collectd_sample_configs/ovs_events.conf b/src/collectd/collectd_sample_configs/ovs_events.conf new file mode 100644 index 00000000..a52842ca --- /dev/null +++ b/src/collectd/collectd_sample_configs/ovs_events.conf @@ -0,0 +1,25 @@ +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +<LoadPlugin ovs_events> + Interval 1 +</LoadPlugin> + +<Plugin ovs_events> +# Port "6640" +# Address "127.0.0.1" +# Socket "/var/run/openvswitch/db.sock" +# Interfaces "br0" "veth0" + SendNotification true +</Plugin> diff --git a/src/collectd/collectd_sample_configs/rdt.conf b/src/collectd/collectd_sample_configs/rdt.conf new file mode 100644 index 00000000..4ff0a77a --- /dev/null +++ b/src/collectd/collectd_sample_configs/rdt.conf @@ -0,0 +1,20 @@ +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +<LoadPlugin intel_rdt> + Interval 1 +</LoadPlugin> + +<Plugin "intel_rdt"> + Cores "" +</Plugin> diff --git a/src/collectd/collectd_sample_configs/write_notification.sh b/src/collectd/collectd_sample_configs/write_notification.sh new file mode 100755 index 00000000..28198f9d --- /dev/null +++ b/src/collectd/collectd_sample_configs/write_notification.sh @@ -0,0 +1,19 @@ +#!/bin/bash +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +rm -f /tmp/notifications +while read x y +do + echo $x$y >> /tmp/notifications +done diff --git a/src/collectd/include_config.sh b/src/collectd/include_config.sh new file mode 100755 index 00000000..1996e96b --- /dev/null +++ b/src/collectd/include_config.sh @@ -0,0 +1,21 @@ +#!/bin/bash +COLLECTD_CONF_FILE=/opt/collectd/etc/collectd.conf +COLLECTD_CONF_DIR=/opt/collectd/etc/collectd.conf.d +INCLUDE_CONF="<Include \"/opt/collectd/etc/collectd.conf.d\">" +CURR_DIR=`pwd` +SAMPLE_CONF_DIR=$CURR_DIR/collectd_sample_configs/* + +function write_include { + echo $INCLUDE_CONF | sudo tee -a $COLLECTD_CONF_FILE; + echo " Filter \"*.conf\"" | sudo tee -a $COLLECTD_CONF_FILE; + echo -e "</Include>" | sudo tee -a /opt/collectd/etc/collectd.conf +} + +grep -qe '<Include "/opt/collectd/etc/collectd.conf.d">' $COLLECTD_CONF_FILE; [ $? -ne 0 ] && write_include + +`mkdir -p $COLLECTD_CONF_DIR` + +for F in $SAMPLE_CONF_DIR; do + FILE=$(basename $F) + [ -f $COLLECTD_CONF_DIR/$FILE ] && echo "File $COLLECTD_CONF_DIR/$FILE exists" || cp $F $COLLECTD_CONF_DIR +done diff --git a/src/install_build_deps.sh b/src/install_build_deps.sh new file mode 100755 index 00000000..7c6a89a2 --- /dev/null +++ b/src/install_build_deps.sh @@ -0,0 +1,74 @@ +#!/bin/bash +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +set -eux +sudo apt-get -y install build-essential dh-autoreconf fakeroot devscripts dpkg-dev git wget + +sudo apt-get -y install \ + debhelper dpkg-dev po-debconf dh-systemd dh-strip-nondeterminism \ + bison flex autotools-dev libltdl-dev pkg-config \ + iptables-dev \ + javahelper \ + libatasmart-dev \ + libcap-dev \ + libcurl4-gnutls-dev \ + libdbi0-dev \ + libesmtp-dev \ + libganglia1-dev \ + libgcrypt11-dev \ + libglib2.0-dev \ + libgps-dev \ + libhiredis-dev \ + libi2c-dev \ + libldap2-dev \ + liblua5.3-dev \ + liblvm2-dev \ + libmemcached-dev \ + libmodbus-dev \ + libmnl-dev \ + libmosquitto-dev \ + libmysqlclient-dev \ + libnotify-dev \ + libopenipmi-dev \ + liboping-dev \ + libow-dev \ + libpcap0.8-dev \ + libpcap-dev\ + libperl-dev \ + libpq-dev \ + libprotobuf-c-dev \ + libriemann-client-dev \ + librdkafka-dev \ + librabbitmq-dev \ + librrd-dev \ + libsensors4-dev \ + libsigrok-dev \ + libsnmp-dev \ + libsnmp9-dev \ + perl \ + libtokyocabinet-dev \ + libtokyotyrant-dev \ + libudev-dev \ + libupsclient-dev \ + libvarnishapi-dev \ + libvirt-dev \ + libxen-dev \ + libxml2-dev \ + libyajl-dev \ + linux-libc-dev \ + default-jdk \ + protobuf-c-compiler \ + python-dev \ + openvswitch-switch + diff --git a/src/libpqos/Makefile b/src/libpqos/Makefile new file mode 100644 index 00000000..14bb7882 --- /dev/null +++ b/src/libpqos/Makefile @@ -0,0 +1,77 @@ +# makefile to manage collectd package +# + +# Copyright 2016 OPNFV +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# +# Contributors: +# Aihua Li, Huawei Technologies. +# Maryam Tahhan, Intel Corporation. + +include ../mk/master.mk +include ../package-list.mk + +WORK_DIR = intel-cmt-cat +TAG_DONE_FLAG = $(WORK_DIR)/.$(LIBPQOS_TAG).done +BUILD_CMD = + +.PHONY: install force_install force_make + +# install depends on make +force_install: force_make + +all: force_make + @echo "Finished making $(WORK_DIR) " + +INSTALL_TARGET = force_install force_make + +force_make: $(WORK_DIR) + $(AT)cd $(WORK_DIR) && git pull $(LIBPQOS_URL) $(LIBPQOS_TAG) + @echo "git pull done" + $(AT)$(MAKE) -C $(WORK_DIR) $(MORE_MAKE_FLAGS) + @echo "Make done" + +force_install: + $(AT)sudo $(MAKE) -C $(WORK_DIR) install PREFIX=/usr + $(AT)sudo modprobe msr + +install: $(INSTALL_TARGET) + +# hard way to clean and clobber +clean: + $(AT)cd $(WORK_DIR) && git clean -xfd *.o +clobber: + $(AT)rm -rf $(WORK_DIR) + +# distclean is for developer who would like to keep the +# clone git repo, saving time to fetch again from url +distclean: + $(AT)cd $(WORK_DIR) && git clean -xfd && git checkout -f + +test: + @echo "Make test in $(WORK_DIR) (stub) " + +sanity: + @echo "Make sanity in $(WORK_DIR) (stub) " + +$(WORK_DIR): + $(AT)git clone $(LIBPQOS_URL) + +$(TAG_DONE_FLAG): $(WORK_DIR) + $(AT)cd $(WORK_DIR); git checkout $(LIBPQOS_TAG) +ifneq ($(PATCH_FILE),) + $(AT)cd $(WORK_DIR); patch -p1 < ../$(PATCH_FILE) +endif + $(AT)touch $@ diff --git a/src/package-list.mk b/src/package-list.mk index a64489da..3ec60210 100644 --- a/src/package-list.mk +++ b/src/package-list.mk @@ -6,7 +6,10 @@ # dpdk section # DPDK_URL ?= git://dpdk.org/dpdk DPDK_URL ?= http://dpdk.org/git/dpdk -DPDK_TAG ?= v16.04 +DPDK_TAG ?= v16.07 + +LIBPQOS_URL ?= https://github.com/01org/intel-cmt-cat.git +LIBPQOS_TAG ?= master # collectd section COLLECTD_URL ?= https://github.com/collectd/collectd |
