<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Logging & Monitoring Authoritative Server performance</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PowerDNS manual"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Dynamic resolution using the PipeBackend"
HREF="pipebackend-dynamic-resolution.html"><LINK
REL="NEXT"
TITLE="Via init.d commands"
HREF="init-d-commands.html"></HEAD
><BODY
CLASS="CHAPTER"
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="pipebackend-dynamic-resolution.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="init-d-commands.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="MONITORING"
></A
>Chapter 6. Logging & Monitoring Authoritative Server performance</H1
><P
> In a production environment, you will want to be able to monitor PDNS performance. For this purpose, currently
two methods are available, the webserver and the init.d
<B
CLASS="COMMAND"
>dump</B
>, <B
CLASS="COMMAND"
>show</B
> and
<B
CLASS="COMMAND"
>mrtg</B
>, commands. Furthermore, PDNS can perform a configurable amount of operational logging. This chapter
also explains how to configure syslog for best results.
</P
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="WEBSERVER"
>6.1. Webserver</A
></H1
><P
> To launch the internal webserver, add a <B
CLASS="COMMAND"
>webserver</B
> statement to the pdns.conf. This
will instruct the PDNS daemon to start a webserver on localhost at port 8081, without password protection.
Only local users (on the same host) will be able to access the webserver by default.
The webserver lists a lot of information about the PDNS process, including frequent queries, frequently failing queries,
lists of remote hosts sending queries, hosts sending corrupt queries etc. The webserver does not allow
remote management of the daemon.
The following nameserver related configuration items are available:
<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>webserver</DT
><DD
><P
> If set to anything but 'no', a webserver is launched.
</P
></DD
><DT
>webserver-address</DT
><DD
><P
> Address to bind the webserver to. Defaults to 127.0.0.1, which implies that only the local computer
is able to connect to the nameserver! To allow remote hosts to connect, change to 0.0.0.0 or the
physical IP address of your nameserver.
</P
></DD
><DT
>webserver-password</DT
><DD
><P
> If set, viewers will have to enter this plaintext password in order to gain access to the statistics.
</P
></DD
><DT
>webserver-port</DT
><DD
><P
> Port to bind the webserver to. Defaults to 8081.
</P
></DD
></DL
></DIV
>
</P
></DIV
></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="pipebackend-dynamic-resolution.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="init-d-commands.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Dynamic resolution using the PipeBackend</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
> </TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Via init.d commands</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
