DEPRECATED, Integration between Monasca and Ceilometer
Go to file
Nguyen Hung Phuong e81be04ef7 Add stestr to .gitignore file
Change-Id: I0deb591643706ac928f412579e7435077295233b
2018-02-01 10:36:50 +07:00
ceilosca Remove oslo config global conf dependency 2018-01-21 14:40:54 -08:00
devstack Update the documentation link for doc migration 2017-07-21 10:59:43 +08:00
etc/ceilometer Fix ceilosca.sh vagrant env setup 2017-06-29 08:41:40 -07:00
tools Remove white space between print () in ceilosca-message-simulator.py 2016-11-16 06:32:10 +00:00
.gitignore Add stestr to .gitignore file 2018-02-01 10:36:50 +07:00
.gitreview Update .gitreview for new namespace 2015-10-17 22:30:39 +00:00
.testr.conf Improve unit tests 2015-07-23 17:15:50 +00:00
LICENSE Add LICENSE file 2017-01-17 13:08:37 +07:00
README.md Optimize the link address 2017-04-11 14:08:27 +05:30
mkdocs.yml Change repositories from stackforge to openstack 2015-10-20 15:07:44 +05:30
monasca_test_setup.py Remove oslo config global conf dependency 2018-01-21 14:40:54 -08:00
pep8-test-requirements.txt Migrate monasca-ceilometer to be liberty compatible 2015-11-18 16:52:53 +00:00
setup.cfg Create a package for monasca-ceilometer 2017-07-21 07:53:07 +00:00
setup.py Remove oslo config global conf dependency 2018-01-21 14:40:54 -08:00
test-requirements.txt Remove oslo config global conf dependency 2018-01-21 14:40:54 -08:00
tox.ini Remove oslo config global conf dependency 2018-01-21 14:40:54 -08:00

README.md

Team and repository tags

Team and repository tags

monasca-ceilometer

Python plugin and storage driver for Ceilometer to send samples to monasca-api

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.

  1. Run devstack to get openstack installed.

  2. Install python-monascaclient

    pip install python-monascaclient

  3. Clone monasca-ceilometer from github.com.

    Copy the following files from ceilosca/ceilometer to devstack's ceilometer location typically at /opt/stack/ceilometer

    monasca_client.py
    storage/impl_monasca.py
    tests/* (skipping the init.py files)
    publisher/monasca_data_filter.py
    publisher/monclient.py
    ceilosca_mapping/*
    
  4. Edit entry_points.txt

    Under [ceilometer.publisher] section add the following line:

    monasca = ceilometer.publisher.monclient:MonascaPublisher
    

    Under [ceilometer.metering.storage] section add the following line:

    monasca = ceilometer.storage.impl_monasca:Connection
    
  5. Edit setup.cfg (used at the time of installation)

    Under 'ceilometer.publisher =' section add the following line:

    monasca = ceilometer.publisher.monclient:MonascaPublisher

    Under 'ceilometer.metering.storage =' section add the following line

    monasca = ceilometer.storage.impl_monasca:Connection

  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 API. Use the included monasca-ceilometer/etc/ceilometer/ceilometer.conf file as an example.

  8. Copy the included monasca_field_definitions.yml and monasca_pipeline.yaml files 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 info

Since we don't have 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/liberty 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

License

Copyright (c) 2015-2017 Hewlett-Packard Development Company, L.P.

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.