<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Operational logging using syslog</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PowerDNS manual"
HREF="index.html"><LINK
REL="UP"
TITLE="Logging & Monitoring Authoritative Server performance"
HREF="monitoring.html"><LINK
REL="PREVIOUS"
TITLE="Via init.d commands"
HREF="init-d-commands.html"><LINK
REL="NEXT"
TITLE="Security settings & considerations"
HREF="security.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PowerDNS manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="init-d-commands.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 6. Logging & Monitoring Authoritative Server performance</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="security.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="SYSLOG"
>6.3. Operational logging using syslog</A
></H1
><P
>(<B
CLASS="COMMAND"
>logging-facility</B
> is available from 1.99.10 and onwards)</P
><P
> This chapter assumes familiarity with syslog, the unix logging device. PDNS logs messages with different levels. The more urgent the
message, the lower the 'priority'. By default, PDNS will only log messages with an urgency of 3 or lower, but this can be changed
using the <B
CLASS="COMMAND"
>loglevel</B
> setting in the configuration file. Setting it to 0 will eliminate all logging, 9 will log
everything.
</P
><P
> By default, logging is performed under the 'DAEMON' facility which is shared with lots of other programs. If you regard nameserving
as important, you may want to have it under a dedicated facility so PDNS can log to its own files, and not clutter generic files.
</P
><P
> For this purpose, syslog knows about 'local' facilities, numbered from LOCAL0 to LOCAL7. To move PDNS logging to LOCAL0, add
<B
CLASS="COMMAND"
>logging-facility=0</B
> to your configuration.
</P
><P
> Furthermore, you may want to have separate files for the differing prioties - preventing lower priority messages from obscuring
important ones.
</P
><P
> A sample syslog.conf might be:
<PRE
CLASS="PROGRAMLISTING"
>local0.info -/var/log/pdns.info
local0.warn -/var/log/pdns.warn
local0.err /var/log/pdns.err
</PRE
>
</P
><P
> Where local0.err would store the really important messages. For performance and diskspace reasons, it is advised
to audit your syslog.conf for statements also logging PDNS activities. Many syslog.confs have a '*.*' statement to
/var/log/syslog, which you may want to remove.
</P
><P
> For performance reasons, be especially certain that no large amounts of synchronous logging take place. Under Linux, this
is indicated by filenames not starting with a '-' - indicating a synchronous log, which hurts performance.
</P
><P
> Be aware that syslog by default logs messages at the configured priority and higher! To log only info messages, use
<B
CLASS="COMMAND"
>local0.=info</B
>.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="init-d-commands.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="security.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Via init.d commands</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="monitoring.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Security settings & considerations</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
