8b0fb6d048
As of Queens the Ceilometer V2 API has been removed. Storage driver related code in monasca-ceilometer can thus be removed. Backport some refactoring that came up in creating https://review.openstack.org/#/c/562400/ Realized some class names could be clearer and fit better with Ceilometer. Update test-requirements.txt with Rocky release of python-monascaclient. Also include more license info. Specify py35 instead of py34 in tox.ini (gates already using py35). Include updates to devstack configuration to keep up with master ceilometer. These include adding values for the [monasca] section in ceilometer.conf and refreshing setup.cfg as well as updating how the connection url to Monasca API is configured. Also include some testing notes in devstack/README.md Change-Id: I9291dfc06d67f18109a0ff66184bd418c6361977 |
||
---|---|---|
.. | ||
README.md | ||
Vagrantfile | ||
ceilosca.sh | ||
plugin.sh | ||
sample-local.conf | ||
settings | ||
setup.cfg |
README.md
Installing Ceilosca using automated methods
There are a few options for configuring Ceilosca on top of a Ceilometer and Monasca deployment.
Choose one:
-
DevStack can be instructed through the local.conf to "enable ceilosca". Reference the included devstack/sample-local.conf for one example configuration.
-
Use the included Vagrantfile to create and provision a VM. This will provision a new Ubuntu 16.04 VM and run the ceilosca.sh.
-
Under certain conditions the monasca_test_setup.py may be used to set up Ceilosca for testing. This .py may also be useful reference if you choose to write your own integration scripts.
-
The devstack/ceilosca.sh script will copy Ceilosca components on top of Ceilometer.
- ceilosca.sh has been updated to the Newton release.
- ceilosca.sh is also used by the Vagrant deployment option.
- The script should be tweaked before execution, particularly the lines.
- export SERVICE_HOST=192.168.10.6
- export HOST_IP_IFACE=eth0
- The script should be run by a sudoers user with no password required. Such as is described in https://docs.openstack.org/devstack/latest/
- And note ceilosca.sh does not configure Horizon
Testing notes
Once Ceilosca is installed the gathered metrics will appear in Monasca. The monasca
cli can be used to verify
functionality.
- Source a valid rc file to set the OS_ environment variables needed for the cli. For example:
export OS_PROJECT_NAME=mini-mon
export OS_IDENTITY_API_VERSION=3
export OS_PASSWORD=<the password>
export OS_AUTH_URL=http://<Your Keystone IP>/identity/v3/
export OS_USERNAME=mini-mon
- Run
monasca metric-list
- Devstack includes a cirros 3.5 image by default. This will be represented in an
image.size
metric in monasca with a datasource ofceilometer
.
- Devstack includes a cirros 3.5 image by default. This will be represented in an
- Cause further metrics to be created by doing more OpenStack operations.
- Create another image
- wget -c http://download.cirros-cloud.net/0.4.0/cirros-0.4.0-x86_64-disk.img -o cirros-0.4.0-x86_64-disk.img
- openstack image create --disk-format qcow2 --container-format bare cirros-0.4.0 < cirros-0.4.0-x86_64-disk.img
- Create a simple vm
- openstack image list
- Choose one of the images listed, note its id
- openstack flavor list
- Choose one of the flavors, note its id
- openstack project list
- openstack security group list
- Pick the group that matches the
admin
project, note its id - openstack security group rule create --proto tcp --dst-port 22
- openstack server create --flavor --image --security-group mytest
- Check the progress with
openstack server list
- Look for additional metrics with
datasource: ceilometer
inmonasca metric-list
- Create another image
- Explore the samples (aka. measurements) in
monasca measurement-list image.size -120
and similar commands.