add note regarding pipeline_processing_queues option
Change-Id: I81fde04a671a39f73a315f3c600e288aa25885d9
This commit is contained in:
parent
01d9efba94
commit
7a40bf4d58
|
@ -42,7 +42,8 @@ OPTS = [
|
||||||
min=1,
|
min=1,
|
||||||
help='Number of queues to parallelize workload across. This '
|
help='Number of queues to parallelize workload across. This '
|
||||||
'value should be larger than the number of active '
|
'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',
|
cfg.BoolOpt('ack_on_event_error',
|
||||||
default=True,
|
default=True,
|
||||||
deprecated_group='collector',
|
deprecated_group='collector',
|
||||||
|
|
|
@ -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.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
|
Publishers
|
||||||
++++++++++
|
++++++++++
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue