monasca-ceilometer 1.10.0

Installation instructions for setting up Ceilosca automatically

See devstack/README.md.

Installation Instructions for setting up Ceilosca manually

To set up Ceilosca automatically, read the instructions in devstack/README.md or use the included Vagrantfile

Assumes that an active monasca-api server is running after installing DevStack.

1. Run devstack to get openstack installed, including Monasca and Ceilometer plugins.

2. Install python-monascaclient.

   pip install python-monascaclient

3. Clone monasca-ceilometer from github.com.

4. Copy the following files from ceilosca/ceilometer to devstack’s ceilometer location, typically at /opt/stack/ceilometer.

   monasca_client.py
   monasca_opts.py
   opts.py
   publisher/monasca_data_filter.py
   publisher/monasca.py
   tests/* (skipping the init.py files)

5. Edit setup.cfg (used at the time of installation)

   Under ‘ceilometer.sample.publisher =’ section add the following line:

   monasca = ceilometer.publisher.monasca:MonascaPublisher

6. Configure /etc/ceilometer/pipeline.yaml to send the metrics to the monasca publisher. Use the included monasca-ceilometer/etc/ceilometer/pipeline.yaml file as an example.

7. Configure /etc/ceilometer/ceilometer.conf for setting up storage driver for Ceilometer. Use the included monasca-ceilometer/etc/ceilometer/ceilometer.conf file as an example.

8. Copy the included monasca_field_definitions.yml file from monasca-ceilometer/etc/ceilometer to /etc/ceilometer.

   This monasca_field_definitions.yaml file contains configuration how to treat each field in Ceilometer sample object on per meter basis. The monasca_data_filter.py uses this file and only stores the fields that are specified in this config file.

9. Make sure the user specified under [service_credentials] in ceilometer.conf has monasca_user role added.

Other install info

Since we don’t have a full repo of ceilometer, we setup the ceilometer repo in venv and copy monasca integration files in there, and run the unit tests over that code. At present this is tested against ceilometer stable/pike branch, if you need to test against different branch you can change it in test-requirements.txt

Relevant files are:

• monasca_test_setup.py - determines the ceilometer venv path and copies the relevant files over

• tox.ini - calls the commands for setup and runs the tests

• test-requirements.txt - contains the dependencies required for testing

Defining or changing existing meters

From time to time, Ceilometer introduces new meters. The list of currently supported measurements can be found at https://docs.openstack.org/ceilometer/pike/admin/telemetry-measurements.html (which is generated from https://github.com/openstack/ceilometer/doc/source/admin/telemetry-measurements.rst).

Some meters require additional configuration in Ceilometer. For example, the SDN pollster meters need specialized drivers. For more information about how Ceilometer collects meters through polling or collecting, please reference the Telemetry documentation and measurements.

Using Monasca API meters collected by Ceilosca

Here are a few examples of how a meter gathered by Ceilometer and passed through Ceilosca can be found and used in the Monasca API.

In Ceilometer pipeline YAML file

Note: Monasca Agent can gather many similar metrics directly, such as cpu time for a VM. For simplicity, it is recommended that the Monasca Agent be favored when choosing which metrics to use.