penlog(1) [debian man page]

PENLOG(1)						      General Commands Manual							 PENLOG(1)

NAME

       penlog - pipe Apache logs to penlogd

SYNOPSIS

       penlog server_ip server_port [my_ip]

EXAMPLE

       penlog lbhost:10000

DESCRIPTION

       Penlog  reads  webserver log entries from stdin and sends them using UDP to penlogd. It is intended for Apache's "reliable piped logs".	To
       use penlog from Apache, add a command like this to the web server's httpd.conf:

       CustomLog "|/usr/local/bin/penlog somehost 10000" common

       The optional third argument is used if the server has several addresses.  Penlogd uses the source address to identify the  server,  and	it
       must be identical to the address configured in the command line to Pen.

SEE ALSO

       pen(1), penlogd(1)

AUTHOR

       Copyright (C) 2002 Ulric Eriksson, <ulric@siag.nu>.

								       LOCAL								 PENLOG(1)

PENLOGD(1)						      General Commands Manual							PENLOGD(1)

NAME

       penlogd - consolidate web server logs

SYNOPSIS

       penlogd [-fd] [-j dir] [-l logfile] [-n N] [-p pidfile] [-u user] port

EXAMPLE

       penlogd -l /var/log/access_log -p /var/run/penlogd.pid 10000

DESCRIPTION

       Penlogd	receives  log  entries from Pen and from each of the web servers. It consolidates the entries by replacing the source addresses in
       each entry with the "real" client address and writes the result to stdout or to the file  given	on  the  command  line.   This	completely
       removes the need for postprocessing with mergelogs, since the logs are already merged.

       Pen must be instructed to send its log to penlogd. See HOWTO and pen man page for details.

       Sending penlogd a HUP signal will make it close and reopen the logfile, unless it is logging to stdout. Rotate the log like this:

       mv access_log access_log.1 kill -HUP `cat <pidfile>`

       where <pidfile> is the file containing pen's process id.

       Sending penlogd a TERM signal will make it close the log file and exit cleanly.

OPTIONS

       -d     Turn  on	debugging.  The  output goes to stderr if we are running in the foreground (see -f) and to syslog (facility user, priority
	      debug) otherwise.

       -f     Stay in foreground.

       -j dir Run in a chroot environment.

       -l logfile
	      Write output into logfile.

       -n N   Number of pen log entries to cache (default 1000).

       -p pidfile
	      Write process id into pidfile.

       -u user
	      Run as a different user.

       port   The UDP port where penlogd receives log entries.

SEE ALSO

       pen(1), penlog(1), webresolve(1)

AUTHOR

       Copyright (C) 2002-2003 Ulric Eriksson, <ulric@siag.nu>.

								       LOCAL								PENLOGD(1)