Applied. Moved to docs directory. On Sun, May 6, 2012 at 11:23 AM, Matt Simerson <m...@tnpi.net> wrote:
> added FAQ with 3 answers. > > --- > FAQ.pod | 47 +++++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 47 insertions(+) > create mode 100644 FAQ.pod > > diff --git a/FAQ.pod b/FAQ.pod > new file mode 100644 > index 0000000..68e8806 > --- /dev/null > +++ b/FAQ.pod > @@ -0,0 +1,47 @@ > +# best read with perldoc: perldoc FAQ.pod > + > +=head1 FAQ > + > +=head2 Q: Do I need to enable a logging plugin? > + > +=head2 A: No. > + > +When zero logging plugins are configured, logs are directed to STDERR. > This > +is the 'default' logging and logs are piped to multilog and stored in > +log/main/current. > + > +When more than zero logging plugins are enabled, builtin logging is > disabled > +and logs are sent to every logging plugin configured in config/plugins. > + > + > +=head2 Q: How do I watch the logs? > + > +=head2 A: Here's a few examples: > + > +The default log files can be watched in real time lik this: > + > + tail -F ~smtpd/log/main/current > + > +To convert the tai timestamps to human readable date time: > + > + tail -F ~smtpd/log/main/current | tai64nlocal > + > +To exclude the dates entirely, use this command: > + > + tail -F ~smtpd/smtpd/log/main/current | cut -d' ' -f2-3 > + > + > +=head2 Q: How do I get alerts when qpsmtpd has a problem? > + > +=head2 A: Send logs with levels below LOGERROR to syslog. > + > +This can be done by adding the following lines to config/plugins: > + > + logging/syslog loglevel LOGERROR > + logging/warn LOGINFO > + > +The warn logging plugin replicates the builtin logging, directing log > messages to STDERR. The syslog plugin directs errors to syslog where > standard monitoring tools can pick them up and act on them. > + > +With these settings, errors will still get sent to STDERR as well. > + > +=cut > -- > 1.7.9.6 > >