From 5a35b30763f56e2585773f8b4f69f4531874b32d Mon Sep 17 00:00:00 2001 From: Dantali0n Date: Tue, 21 May 2019 13:27:43 +0200 Subject: [PATCH] Improve DevStack documentation to support metrics Support DevStack setups with datasources configured starting with Gnocchi. Change-Id: Ibcf0909ccce2dbb646c23a179ca763b6c3e62633 --- doc/source/contributor/devstack.rst | 30 +++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/doc/source/contributor/devstack.rst b/doc/source/contributor/devstack.rst index cd8d2a5c1..3e8a65354 100644 --- a/doc/source/contributor/devstack.rst +++ b/doc/source/contributor/devstack.rst @@ -27,6 +27,36 @@ out the `DevStack documentation`_ for more information regarding DevStack. .. _PluginModelDocs: https://docs.openstack.org/devstack/latest/plugins.html .. _DevStack documentation: https://docs.openstack.org/devstack/latest +Quick Devstack Instructions with Datasources +============================================ + +Watcher requires a datasource to collect metrics from compute nodes and +instances in order to execute most strategies. To enable this a +`[[local|localrc]]` to setup DevStack for some of the supported datasources +is provided. These examples specify the minimal configuration parameters to +get both Watcher and the datasource working but can be expanded is desired. + +Gnocchi +------- + +With the Gnocchi datasource most of the metrics for compute nodes and +instances will work with the provided configuration but metrics that +require Ironic such as `host_airflow and` `host_power` will still be +unavailable as well as `instance_l3_cpu_cache`:: + + [[local|localrc]] + enable_plugin watcher https://opendev.org/openstack/watcher + + enable_plugin ceilometer https://opendev.org/openstack/ceilometer.git + CEILOMETER_BACKEND=gnocchi + + enable_plugin aodh https://opendev.org/openstack/aodh + enable_plugin panko https://opendev.org/openstack/panko + + [[post-config|$NOVA_CONF]] + [DEFAULT] + compute_monitors=cpu.virt_driver + Detailed DevStack Instructions ==============================