LogOptions Directive

Top - Docs - General - Server - Resource - Access - FAQ - Tutorials

Purpose

The LogOptions directive allows you to switch between the Common Log File (CLF) format with extra information going to separate files, or a somewhat extended CLF format in which the extra information is logged at the end of the normal CLF information. It also allows you to change various other aspects of server logging.

Some Log Analysers won't accept the combined format, so you might want to check first.

Example Combined Log Format

lothlorien.ncsa.uiuc.edu - - [19/Sep/1995:15:08:07 -0500] "GET / HTTP/1.0" 200 2 424 "" "NCSA_Mosaic/2.7b1 (X11;IRIX 5.3 IP22)  libwww/2.12 modified"
lothlorien.ncsa.uiuc.edu - - [19/Sep/1995:15:08:07 -0500] "GET /images/httpd.gif HTTP/1.0" 200 6872 "" "NCSA_Mosaic/2.7b1 (X11;IRIX 5.3 IP22)  libwww/2.12 modified"
lothlorien.ncsa.uiuc.edu - - [19/Sep/1995:15:08:07 -0500] "GET /images/mosaic-httpd3-trans.gif HTTP/1.0" 200 1503 "" "NCSA_Mosaic/2.7b1 (X11;IRIX 5.3 IP22)  libwww/2.12 modified"
lothlorien.ncsa.uiuc.edu - - [19/Sep/1995:15:19:07 -0500] "GET /docs/Overview.html HTTP/1.0" 200 1752 "" "NCSA_Mosaic/2.7b1 (X11;IRIX 5.3 IP22)  libwww/2.12 modified"
lothlorien.ncsa.uiuc.edu - - [19/Sep/1995:15:19:07 -0500] "GET /images/icon.gif HTTP/1.0" 200 1656 "http://hoohoo.ncsa.uiuc.edu/" "NCSA_Mosaic/2.7b1 (X11;IRIX 5.3 IP22)  libwww/2.12 modified"

Note the extra Referer field and the User agent field on the end

Example of CLF with Servername

lothlorien.ncsa.uiuc.edu - - [06/Oct/1995:13:51:23 -0500] "GET /beta-1.5/howto/fixes.html" 200 3296 hoohoo.ncsa.uiuc.edu
lothlorien.ncsa.uiuc.edu - - [06/Oct/1995:13:51:34 -0500] "GET /beta-1.5/patches/ HTTP/1.0" 200 559 hoohoo.ncsa.uiuc.edu
lothlorien.ncsa.uiuc.edu - - [06/Oct/1995:13:51:35 -0500] "GET /icons/blank.xbm TTP/1.0" 200 509 hoohoo.ncsa.uiuc.edu
lothlorien.ncsa.uiuc.edu - - [06/Oct/1995:13:51:35 -0500] "GET /icons/menu.gif HTTP/1.0" 200 115 hoohoo.ncsa.uiuc.edu
lothlorien.ncsa.uiuc.edu - - [06/Oct/1995:13:51:35 -0500] "GET /icons/text.gif HTTP/1.0" 200 130 hoohoo.ncsa.uiuc.edu

Syntax

LogOptions opt1 opt2

Where optn is:

Combined
With this LogOption, the server doesn't open a RefererLog or AgentLog. The information normally logged to those files is now logged in the TransferLog.
Separate
With this LogOption, the logging behavior is reminiscent of NCSA HTTPd 1.4 with separate log files for RefererLog and AgentLog.
Servername
With this LogOption, the name which the server used is logged in the TransferLog. If you are using VirtualHost support, this will be the name of VirtualHost.
Date
With this LogOption, the Date code section of the TransferLog will be prepended to each line of the RefererLog and AgentLog to help with correlating the various files. This is only valid with Separate.

Virtual Host

This directive is valid in virtual host configuration, and suggested if you intend to have a lot of virtual hosts as a way of reducing the number of file descriptors required.

Default

The default is Separate.

Examples

LogOptions Separate

This will have separate log files.

LogOptions Combined ServerName

This will make a single log file with as much information as possible.

Return to Configuration File Overview

NCSA HTTPd Development Team / httpd@ncsa.uiuc.edu / 10-02-95