From 182c2cafceef701cfcd79e2a7994faa9fc5d4672 Mon Sep 17 00:00:00 2001 From: Rainer Gerhards Date: Thu, 31 Jan 2008 11:11:49 +0000 Subject: some more queue details --- doc/queues.html | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/doc/queues.html b/doc/queues.html index 3037ee42..58bbfb71 100644 --- a/doc/queues.html +++ b/doc/queues.html @@ -292,7 +292,9 @@ cancelled and the queue is brought down.

parameter can be set to "on". This requires either a disk or disk-assisted queue. If set, rsyslogd ensures that any queue elements are saved to disk before it terminates. This includes data elements there were begun being processed by -workers that needed to be cancelled due to too-long processing.

+workers that needed to be cancelled due to too-long processing. For a large +queue, this operation may be lengthy. No timeout applies to a required shutdown +save.

Where are Queues Used?

 Currently, queues are used for the main message queue and for the actions.

@@ -304,7 +306,20 @@ message queue.

There are multiple action queues, one for each configured action. By default, these queues operate in direct (non-queueing) mode. Action queues are fully configurable and thus can be changed to whatever is best for the given use case.

-

Future versions of rsyslog will utilize queues at other places, too.

+

Future versions of rsyslog will most probably utilize queues at other places, +too.

+

Whereever "<object>"  was used above in the config file +statements, substitute "<object>" with either "MainMsg" or "Action". The +former will set main message queue paremeters, the later parameters for the next +action that will be created. Action queue parameters can not be modified once +the action has been specified. For example, to tell the main message queue to +save its content on shutdown, use $MainMsgQueueSaveOnShutdown on".

+

If the same parameter is specified multiple times before a queue is created, +the last one specified takes precedence. The main message queue is created after +parsing the config file and all of its potential includes. An action queue is +created each time an action selector is specified. Action queue parameters are +reset to default after an action queue has been created (to provide a clean +environment for the next action).

Not all queues necessarily support the full set of queue configuration parameters, because not all are applicable. For example, in current output module design, actions do not support multi-threading. Consequently, the number -- cgit