summaryrefslogtreecommitdiffstats
path: root/doc/troubleshoot.html
diff options
context:
space:
mode:
authorRainer Gerhards <rgerhards@adiscon.com>2009-05-11 22:00:48 +0200
committerRainer Gerhards <rgerhards@adiscon.com>2009-05-11 22:00:48 +0200
commitd1985c4a65feb5caaea855517431ed564a13ed4c (patch)
treeda90b5e2e32344bef32a036e3597a6b1e3dfe533 /doc/troubleshoot.html
parent8e430258fdc9b0577ea8e54dae21cc5942f90104 (diff)
downloadrsyslog-d1985c4a65feb5caaea855517431ed564a13ed4c.tar.gz
rsyslog-d1985c4a65feb5caaea855517431ed564a13ed4c.tar.xz
rsyslog-d1985c4a65feb5caaea855517431ed564a13ed4c.zip
doc: given some concrete advise on the common %hostname% content problem
Diffstat (limited to 'doc/troubleshoot.html')
-rw-r--r--doc/troubleshoot.html9
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/troubleshoot.html b/doc/troubleshoot.html
index cb4367f6..a8855fd4 100644
--- a/doc/troubleshoot.html
+++ b/doc/troubleshoot.html
@@ -18,7 +18,14 @@ is a rsyslog-doc package, that often needs to be installed separately.
<p><b>Malformed Messages and Message Properties</b>
<p>A common trouble source are <a href="syslog_parsing.html">ill-formed syslog messages</a>, which
lead to to all sorts of interesting problems, including malformed hostnames and dates.
-Read the quoted guide to find relief.
+Read the quoted guide to find relief. A common symptom is that the %HOSTNAME% property is
+used for generating dynafile names, but some glibberish shows up. This is caused by the
+malformed syslog messages, so be sure to read the
+<a href="syslog_parsing.html">guide</a> if you face that problem. Just let me add that the
+common work-around is to use %FROMHOST% or %FROMHOST-IP% instead. These do not take the
+hostname from the message, but rather use the host that sent the message (taken from
+the socket layer). Of course, this does not work over NAT or relay chains, where the
+only cure is to make sure senders emit well-formed messages.
<p><b>Configuration Problems</b>
<p>Rsyslog 3.21.1 and above has been enhanced to support extended configuration checking.
It offers a special command line switch (-N1) that puts it into "config verfication mode".