openstack/ceilometer
Code Issues Proposed changes

Clarify the doc about multiple notification_topics usage

Browse Source 
Make clear that the multiple notification topic usage in ceilometer.conf
in case of mistakenly configured that cause duplicate samples.

DocImpact
Closes-Bug: #1496777
Change-Id: I7af36f8e7615ccc31ffad94169b4e5ce1f9df84f
This commit is contained in:
xialinjuan 2015-11-17 17:53:19 +08:00
parent d909342cfc
commit b55ffaa1f8
1 changed files with 36 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
doc/source/install/manual.rst
View File

@ -535,7 +535,7 @@ Notifications queues
========================
.. index::
double: installing; notifications queues
double: installing; notifications queues; multiple topics
By default, Ceilometer consumes notifications on the messaging bus sent to
**notification_topics** by using a queue/pool name that is identical to the
@ -544,6 +544,41 @@ this queue. If you want to also consume the topic notifications with a system
other than Ceilometer, you should configure a separate queue that listens for
the same messages.
Ceilometer allows multiple topics to be configured so that polling agent can
send the same messages of notifications to other queues. Notification agents
also use **notification_topics** to configure which queue to listen for. If
you use multiple topics, you should configure notification agent and polling
agent seperately, otherwise Ceilometer collects duplicate samples.
By default, the ceilometer.conf file is as follows::
[DEFAULT]
notification_topics = notifications
To use multiple topics, you should give ceilometer-agent-notification and
ceilometer-polling services different ceilometer.conf files. The Ceilometer
configuration file ceilometer.conf is normally locate in the /etc/ceilometer
directory. Make changes according to your requirments which may look like
the following::
For notification agent using ceilometer-notification.conf, settings like::
[DEFAULT]
notification_topics = notifications,xxx
For polling agent using ceilometer-polling.conf, settings like::
[DEFAULT]
notification_topics = notifications,foo
.. note::
notification_topics in ceilometer-notification.conf should only have one same
topic in ceilometer-polling.conf
Doing this, it's easy to listen/receive data from multiple internal and external services.
Using multiple dispatchers
================================