diff options
| -rw-r--r-- | ChangeLog | 2 | ||||
| -rw-r--r-- | action.c | 2 | ||||
| -rw-r--r-- | doc/queues.html | 12 | ||||
| -rw-r--r-- | syslogd.c | 2 |
4 files changed, 11 insertions, 7 deletions
@@ -8,6 +8,8 @@ Version 3.12.4 (rgerhards), 2008-03-?? the patch - bugfix: fixed some minor memory leaks - bugfix: some slightly invalid memory accesses +- changed queue's discard severities default value to 8 (do not discard) + to prevent unintentional message loss --------------------------------------------------------------------------- Version 3.12.3 (rgerhards), 2008-03-18 - added advanced flow control for congestion cases (mode depending on message @@ -63,7 +63,7 @@ static int iActionQueueSize = 1000; /* size of the main message queue above * static int iActionQHighWtrMark = 800; /* high water mark for disk-assisted queues */ static int iActionQLowWtrMark = 200; /* low water mark for disk-assisted queues */ static int iActionQDiscardMark = 9800; /* begin to discard messages */ -static int iActionQDiscardSeverity = 4; /* discard warning and above */ +static int iActionQDiscardSeverity = 8; /* by default, discard nothing to prevent unintentional loss */ static int iActionQueueNumWorkers = 1; /* number of worker threads for the mm queue above */ static uchar *pszActionQFName = NULL; /* prefix for the main message queue file */ static int64 iActionQueMaxFileSize = 1024*1024; diff --git a/doc/queues.html b/doc/queues.html index 41aa9992..2498da1b 100644 --- a/doc/queues.html +++ b/doc/queues.html @@ -2,7 +2,6 @@ <html><head> <meta http-equiv="Content-Language" content="de"> <title>Understanding rsyslog queues</title></head> - <body> <h1>Understanding rsyslog Queues</h1> @@ -17,7 +16,7 @@ rule processor, which then evaluates which actions are to be carried out. In front of each action, there is also a queue, which potentially de-couples the filter processing from the actual action (e.g. writing to file, database or forwarding to another host).</p> -<h1>Queue Modes</h1> +<h1>iQueue Modes</h1> <p>Rsyslog supports different queue modes, some with submodes. Each of them has specific advantages and disadvantages. Selecting the right queue mode is quite important when tuning rsyslogd. The queue mode (aka "type") is set via the "<i>$<object>QueueType</i>" @@ -243,9 +242,12 @@ This directive accepts both the usual textual severity as well as a numerical one. To understand it, you must be aware of the numerical severity values. They are defined in RFC 3164:</p> <pre> Numerical Severity<br> Code<br><br> 0 Emergency: system is unusable<br> 1 Alert: action must be taken immediately<br> 2 Critical: critical conditions<br> 3 Error: error conditions<br> 4 Warning: warning conditions<br> 5 Notice: normal but significant condition<br> 6 Informational: informational messages<br> 7 Debug: debug-level messages</pre> -<p>Anything of the specified severity and (numerically) above it is discarded. -To turn message discarding off, simply specify the discard watermark to be -higher than the queue size.</p> +<p>Anything of the specified severity and (numerically) above it is +discarded. To turn message discarding off, simply specify the discard +watermark to be higher than the queue size. An alternative is to +specify the numerical value 8 as DiscardSeverity. This is also the +default setting to prevent unintentional message loss. So if you would +like to use message discarding, you need to set" <i>$<object>QueueDiscardSeverity</i>" to an actual value.</p> <p>An interesting application is with disk-assisted queues: if the discard watermark is set lower than the high watermark, message discarding will start before the queue becomes disk-assisted. This may be a good thing if you would @@ -335,7 +335,7 @@ static int iMainMsgQueueSize = 10000; /* size of the main message queue above static int iMainMsgQHighWtrMark = 8000; /* high water mark for disk-assisted queues */ static int iMainMsgQLowWtrMark = 2000; /* low water mark for disk-assisted queues */ static int iMainMsgQDiscardMark = 9800; /* begin to discard messages */ -static int iMainMsgQDiscardSeverity = 4; /* discard warning and above */ +static int iMainMsgQDiscardSeverity = 8; /* by default, discard nothing to prevent unintentional loss */ static int iMainMsgQueueNumWorkers = 1; /* number of worker threads for the mm queue above */ static queueType_t MainMsgQueType = QUEUETYPE_FIXED_ARRAY; /* type of the main message queue above */ static uchar *pszMainMsgQFName = NULL; /* prefix for the main message queue file */ |