openstack/ceilometer
Code Issues Proposed changes

add note regarding pipeline_processing_queues option

Browse Source 
Change-Id: I81fde04a671a39f73a315f3c600e288aa25885d9
This commit is contained in:
gord chung 2016-09-02 17:21:20 +00:00 committed by Julien Danjou
parent 01d9efba94
commit 7a40bf4d58
2 changed files with 27 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
ceilometer/notification.py
View File

@ -42,7 +42,8 @@ OPTS = [
min=1,
help='Number of queues to parallelize workload across. This '
'value should be larger than the number of active '
'notification agents for optimal results.'),
'notification agents for optimal results. WARNING: '
'Once set, lowering this value may result in lost data.'),
cfg.BoolOpt('ack_on_event_error',
default=True,
deprecated_group='collector',

25
doc/source/configuration.rst
View File

@ -176,6 +176,31 @@ The default configuration can be found in `pipeline.yaml`_.
.. _pipeline.yaml: https://git.openstack.org/cgit/openstack/ceilometer/tree/etc/ceilometer/pipeline.yaml
Pipeline Processing
-------------------
On large workloads, multiple notification agents can be deployed to handle the
flood of incoming messages from monitored services. If transformations are
enabled in the pipeline, the notification agents must be coordinated to ensure
related messages are routed to the same agent. To enable coordination, set the
``workload_partitioning`` value in ``notification`` section.
To distribute messages across agents, ``pipeline_processing_queues`` option
should be set. This value defines how many pipeline queues to create which will
then be distributed to the active notification agents. It is recommended that
the number of processing queues, at the very least, match the number of agents.
.. note::
Increasing the number of processing queues will improve the distribution
of messages across the agents.
.. warning::
Decreasing the number of processing queues may result in lost data as any
previously created queues may no longer be assigned to active agents. It
is only recommended that you **increase** processing queues.
Publishers
++++++++++