Apache HTTP Server Version 1.3
Is this the version you want? For more recent
versions, check our documentation
index.
Module mod_log_common
This module is contained in the mod_log_common.c
file, and is compiled in by default. It provides for logging of
the requests made to the server using the Common Logfile
Format. This module has been replaced by mod_log_config in
Apache 1.2
Log file format
The log file contains a separate line for each request. A line
is composed of several tokens separated by spaces:
host ident authuser date request status bytes
If a token does not have a value then it is represented by a
hyphen (-). The meanings and values of these tokens are as
follows:
- host
- The fully-qualified domain name of the client, or its IP
number if the name is not available.
- ident
- If IdentityCheck is
enabled and the client machine runs identd, then this is the
identity information reported by the client.
- authuser
- If the request was for a password protected document,
then this is the userid used in the request.
- date
-
The date and time of the request, in the following format:
-
date = [day/month/year:hour:minute:second
zone]
day = 2*digit
month = 3*letter
year = 4*digit
hour = 2*digit
minute = 2*digit
second = 2*digit
zone = (`+' | `-') 4*digit
- request
- The request line from the client, enclosed in double
quotes (
"
).
- status
- The three digit status code returned to the client.
- bytes
- The number of bytes in the object returned to the client,
not including any headers.
Directives
Syntax: TransferLog
file-pipe
Default: TransferLog
logs/transfer_log
Context: server config, virtual
host
Status: Base
Module: mod_log_common
The TransferLog directive sets the name of the file to which
the server will log the incoming requests. File-pipe
is one of
- A filename
- A filename relative to the ServerRoot.
- `|' followed by a command
- A program to receive the agent log information on its
standard input. Note the a new program will not be started
for a VirtualHost if it inherits the TransferLog from the
main server. See, just as an example, cronolog.
Security: if a program is used, then it will
be run under the user who started httpd. This will be root if
the server was started by root; be sure that the program is
secure.
Security: See the security tips document
for details on why your security could be compromised if the
directory where logfiles are stored is writable by anyone other
than the user that starts the server.
Apache HTTP Server Version 1.3