mod_accesslog

mod_accesslog logs requests handled by lighttpd to files, pipes or syslog. The format of the logs can be customized using printf-style placeholders.

accesslog.format (option)

defines the log format

accesslog.format format;

Default value: "%h %V %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\""

Some format specifiers take a mandatory key, enclosed in curly braces between percent sign and the actual specifier. CLF means “common log format”, if a value is zero, a ‘-‘ is used instead.

specifier	description
%%	Percent sign itself
%a	Remote IP-address
%A	Local IP-address
%b	Size of response in bytes, excluding HTTP headers (CLF)
%B	Size of response in bytes, excluding HTTP headers
%{foobar}C	(not implemented yet) Contents of cookie `foobar` of the request
%D	Time taken to serve the request in microseconds
%{foobar}e	Contents of the request environment variable `foobar`
%f	Path to physical file
%h	Remote IP-address (same as `%a`)
%{foobar}i	Contents of request header `foobar`
%m	Request method (GET, POST, etc)
%{foobar}o	Contents of response header `foobar`
%p	Local port
%q	Querystring
%r	First line of request (GET /foo.html?bar HTTP/1.1)
%s	Response status code
%t	Time/date the request was received in standard english format
%T	Time taken to serve the request in seconds
%u	Authed user (from mod_auth). Same as `%{REMOTE_USER}e`
%U	Request path (not including querystring)
%v	Server name as set through the `server.name` option or the request hostname of `server.name` is not set
%V	Request hostname
%X	Connection status after response: “X” if aborted before completed, “+” if keepalive, “-“ if no keepalive
%I	Bytes received including HTTP headers and request body
%O	Bytes sent including HTTP headers and response body

Modifiers right after the percent sign like Apache provides them, are not supported. “<” or “>” are ignored, everything else results in a parse error. Specifiers supported by Apache but not lighty: %l, %n, %P

Example

accesslog.format "%h %V %u %t \"%r\" %>s %b";

accesslog (option)

defines the log target

accesslog target;

Default value: logging disabled

Enable logging by setting a log target. Supports the same log targets as log.

Example

setup {
	module_load "mod_accesslog";

	accesslog "/var/log/lighttpd/access.log";
}