openstack
/
monasca-ceilometer
Code Issues Proposed changes
monasca-ceilometer/devstack
History
Ian Wienand 589854bd98 Replace openstack.org git:// URLs with https:// 
This is a mechanically generated change to replace openstack.org
git:// URLs with https:// equivalents.

This is in aid of a planned future move of the git hosting
infrastructure to a self-hosted instance of gitea (https://gitea.io),
which does not support the git wire protocol at this stage.

This update should result in no functional change.

For more information see the thread at

 http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003825.html

Change-Id: I37a7c44da90e2067adf7b99154fb21e534e4f504
 		2019-03-24 20:34:14 +00:00
..
README.md Refactor out Ceilometer V2 API related code 2018-08-09 10:11:28 -07:00
Vagrantfile Fix ceilosca.sh vagrant env setup 2017-06-29 08:41:40 -07:00
ceilosca.sh Replace openstack.org git:// URLs with https:// 2019-03-24 20:34:14 +00:00
plugin.sh Refactor out Ceilometer V2 API related code 2018-08-09 10:11:28 -07:00
sample-local.conf Replace openstack.org git:// URLs with https:// 2019-03-24 20:34:14 +00:00
settings Refactor out Ceilometer V2 API related code 2018-08-09 10:11:28 -07:00
setup.cfg Update devel info: mailing list 2018-12-15 15:33:40 +08:00

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 of ceilometer.
  • Cause further metrics to be created by doing more OpenStack operations.
    • Create another image
    • 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 in monasca metric-list
  • Explore the samples (aka. measurements) in monasca measurement-list image.size -120 and similar commands.