<!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 >