Improve documentation on Ceilosca not needing Gnocchi

There was a recent question in IRC about how to configure Ceilosca.
These edits should make it clearer that Gnocchi is not needed
in a Ceilosca deployment, and how to disable it.

Change-Id: I25b894e1ad222e3b55c6787c0625c03b9ebdcbf1
This commit is contained in:
Joseph Davis 2019-10-07 11:15:28 -07:00
parent 15697d9d3a
commit 187bda1447
3 changed files with 33 additions and 8 deletions

View File

@ -33,6 +33,26 @@ DevStack.
1. Run devstack to get openstack installed, including Monasca and
Ceilometer plugins.
a. Not all Ceilometer components are required. The following may be
disabled in ``local.conf`` if using an older Ceilometer release.
::
disable_service ceilometer-alarm-notifier
disable_service ceilometer-alarm-evaluator
disable_service ceilometer-collector
b. Panko and Aodh from the Telemetry project are not required,
as Monasca will be providing these types of services.
c. Gnocchi is also not required, as Monasca uses a configured
Time-Series Database for measurement storage.
Gnocchi installation in DevStack may be skipped by setting the
following in ``local.conf``.
::
CEILOMETER_BACKEND=none
2. Install python-monascaclient.
::

View File

@ -3,21 +3,22 @@
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.
- 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
- 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.
- 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 tweaked before execution, particularly the lines below
should be set to match the environment.
- `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
@ -39,6 +40,7 @@ export OS_USERNAME=mini-mon
- 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.
Here are a few examples.
- 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
@ -53,5 +55,5 @@ export OS_USERNAME=mini-mon
- openstack security group rule create --proto tcp --dst-port 22 <security group id>
- openstack server create --flavor <flavor id> --image <image id> --security-group <security group id> mytest
- Check the progress with `openstack server list`
- Look for additional metrics with `datasource: ceilometer` in `monasca metric-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.

View File

@ -27,6 +27,9 @@ MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-influxdb}
# MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-cassandra}
# MONASCA_METRICS_DB=${MONASCA_METRICS_DB:-vertica}
# Disable Gnocchi (Ceilometer default backend), as it is not needed for Ceilometer
CEILOMETER_BACKEND=none
# Monasca services to enable
enable_service monasca
enable_service monasca-influxdb