Helena McGough 606902c455 DevStack enablement of the collectd-ceilometer custom units feature

- Added deployment code for custom units enablement
      - Updated the DevStack documentation to provide instructions on
        how to enable this feature
      - Editted the collectd-ceilometer-plugin.conf file to enable the
        feature
      - Added a reno for this change

Change-Id: Ia93da4abdf066ba677dcb3ee0e44388c06d97ff5

2017-01-11 10:18:08 +00:00

2.4 KiB

Raw Blame History

Installing Collectd-ceilometer-plugin with Devstack

This guide outlines how to install the collectd-ceilometer-plugin using a devstack deployment.

Pre-requisites

Access to the internet

Installation of Devstack

Follow the instructions provided in the following document to set up your own Devstack deployment.

http://docs.openstack.org/developer/devstack/guides/single-machine.html

Once Devstack is ready to be deployed, follow the configuration steps in the next section to allow the installation of the plugin during deployment.

Configuration of Devstack

These configuration instructions only allow for the minimal installation of collectd, ceilometer and the plugin. The sample local.conf provided must be edited to enable additional services.

To configure Devstack for to install the plugin, download the sample local.conf from the collectd-ceilometer-plugin repo into your devstack directory.

cd devstack
wget https://github.com/openstack/collectd-ceilometer-plugin/blob/master/collectd_ceilometer/doc/source/examples/local.conf.minimal

Edit the "HOST_IP" varible to appropriately match your environment.

If you wish to enable any extra features please follow the instructions in the "Additional Features" section below before moving on to the next step.

Finally, build your devstack environment.

./stack.sh

Verfication of Collectd-ceilometer-plugin

Confirm that the collectd service is up and running.

sudo systemctl status collectd.service

By default collectd enables the "cpu.cpu" meter. Check that the statistics for this meter are being sent to ceilometer, thus confirming that collectd is working with ceilometer.

ceilometer sample-list --meter cpu.cpu

Addtional Features

Custom Units Feature

This feature enables users to define new units for existing meter values. To enable this feature execute the following instructions:

To include your new units, add the following line with your chosen units to your local.conf file.

COLLECTD_CEILOMETER_UNITS="<meter> <unit>"

If you would like to add more than one new unit include them in the same line and seperate each meter and its unit with a comma, as shown below.

COLLECTD_CEILOMETER_UNITS="<meter> <unit>,<meter> <unit>"

2.4 KiB Raw Blame History