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

README.rst

@@ -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.
 
    ::

devstack/README.md

@@ -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 can be instructed through the `local.conf` to "enable ceilosca".  Reference the included
-  devstack/sample-local.conf for one example configuration.
+  `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.
+  - The script should be tweaked before execution, particularly the lines below
-    - export SERVICE_HOST=192.168.10.6
+    should be set to match the environment.
-    - export HOST_IP_IFACE=eth0
+    - `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.

devstack/sample-local.conf

@@ -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