openstack/ceilometer
Code Issues Proposed changes
Files
6377f9f60fb89bae09d954349ceb4773e65e22f5
ceilometer/doc/source/install/development.rst
John Herndon c0fdc3c420 Update dev docs to include notification-agent 
I was reading through the developer docs and noticed they had not been
updated for the new ceilometer-agent-notification service. This patch
adds the right command to put into the localrc. The command comes
straight out of devstack/lib/ceilometer.

Change-Id: I23b917b1c48b6474de2b29901fa039d8353f0eb0
2014-01-24 09:14:27 -07:00

2.5 KiB
Raw Blame History

Installing and Running the Development Version

Ceilometer has four daemons. The compute agent runs on the Nova compute node(s) while the central agent and collector run on the cloud's management node(s). In a development environment created by devstack, these two are typically the same server. They do not have to be, though, so some of the instructions below are duplicated. Skip the steps you have already done.

Configuring Devstack

double: installing; devstack

  1. Create a localrc file as input to devstack.

  2. Ceilometer makes extensive use of the messaging bus, but has not yet been tested with ZeroMQ. We recommend using Rabbit or qpid for now.

  3. Nova does not generate the periodic notifications for all known instances by default. To enable these auditing events, set instance_usage_audit to true in the nova configuration file.

  4. Cinder does not generate notifications by default. To enable these auditing events, set the following in the cinder configuration file:

    notification_driver=cinder.openstack.common.notifier.rpc_notifier

  5. The ceilometer services are not enabled by default, so they must be enabled in localrc before running stack.sh.

This example localrc file shows all of the settings required for ceilometer:

# Enable the ceilometer metering services
enable_service ceilometer-acompute ceilometer-acentral ceilometer-anotification ceilometer-collector

# Enable the ceilometer alarming services
enable_service ceilometer-alarm-evaluator,ceilometer-alarm-notifier

# Enable the ceilometer api services
enable_service ceilometer-api