diff options
author | Jenkins <jenkins@review.openstack.org> | 2016-09-16 10:57:05 +0000 |
---|---|---|
committer | Gerrit Code Review <review@openstack.org> | 2016-09-16 10:57:05 +0000 |
commit | 922657e58c1c75c9c1fdefb8052cc0a651e6825d (patch) | |
tree | dd0497ece6ff5e3442de2728059ce9f2a089cd9f | |
parent | 2f6118f52b110f86427dc387bc66610d96be4468 (diff) | |
parent | 7a40bf4d58431f08968bf185b9a76ccc3aca763e (diff) | |
download | ceilometer-922657e58c1c75c9c1fdefb8052cc0a651e6825d.tar.gz |
Merge "add note regarding pipeline_processing_queues option"
-rw-r--r-- | ceilometer/notification.py | 3 | ||||
-rw-r--r-- | doc/source/configuration.rst | 25 |
2 files changed, 27 insertions, 1 deletions
diff --git a/ceilometer/notification.py b/ceilometer/notification.py index 960bca7f..0bc42a11 100644 --- a/ceilometer/notification.py +++ b/ceilometer/notification.py @@ -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', diff --git a/doc/source/configuration.rst b/doc/source/configuration.rst index 64774835..dd73d613 100644 --- a/doc/source/configuration.rst +++ b/doc/source/configuration.rst @@ -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 ++++++++++ |