This module uses disk_log(3)
to make it possible to log
all incoming requests to an access log file. The de-facto standard
Common Logfile Format is used for this purpose. There are
numerous statistic programs available to analyze Common
Logfile Format log files. The Common Logfile
Format looks as follows:
remotehost rfc931 authuser [date] "request" status bytes
This module furthermore uses disk_log(3)
to support the
use of an error log file to record internal server errors. The
error log format is more ad hoc than Common Logfile
Format, but conforms to the following syntax:
[date] access to path failed for remotehost, reason: reason
Syntax: DiskLogFormat
internal|external
Default: - external -
Module: mod_disk_log(3)
DiskLogFormat
defines the file-format of the
log files see disk_log for more information.
If the internal file-format is used, the logfile
will be repaired after a crash. When a log file is repaired
data might get lost. When the external file-format is used
httpd will not start if the log file is broken.
DiskLogFormat external
Syntax: ErrorDiskLog
filename
Default: - None -
Module: mod_disk_log(3)
ErrorDiskLog
defines the filename
of the
(disk_log(3))
error log file to be used to log server
errors. If the filename
does not begin with a slash
(/
) it is assumed to be relative to the ServerRoot, for example:
ErrorDiskLog logs/error_disk_log_8080
and errors will be logged in the
server
root (UNIX: $SERVER_ROOT/logs/error_disk_log_8080, Windows: %SERVER_ROOT%\logs\error_disk_log_8080
) space.
Syntax: ErrorDiskLogSize
max-bytes max-files
Default: ErrorDiskLogSize 512000 8
Module: mod_disk_log(3)
ErrorDiskLogSize
defines the properties of the
(disk_log(3))
error log file. The disk_log(3)
error
log file is of type wrap log and max-bytes
will
be written to each file and max-files
will be used
before the first file is truncated and reused.
Syntax: SecurityDiskLog
filename
Default: - None -
Module: mod_disk_log(3)
SecurityDiskLog
defines the filename
of the
(disk_log(3))
access log file which logs incoming
security events i.e authenticated requests.
If the filename
does not begin with a slash
(/
) it is assumed to be relative to the ServerRoot, see
TransferDiskLog for more
information.
Syntax: SecurityDiskLogSize
max-bytes max-files
Default: SecurityDiskLogSize 512000 8
Module: mod_disk_log(3)
SecurityDiskLogSize
defines the properties of the
disk_log(3)
access log file. The disk_log(3)
access
log file is of type wrap log and max-bytes
will
be written to each file and max-files
will be used
before the first file is truncated and reused.
Syntax: TransferDiskLog
filename
Default: - None -
Module: mod_disk_log(3)
TransferDiskLog
defines the filename
of the
(disk_log(3))
access log file which logs incoming
requests. If the filename
does not begin with a slash
(/
) it is assumed to be relative to the
ServerRoot, for example:
TransferDiskLog logs/transfer_disk_log_8080
and errors will be logged in the
server
root (UNIX: $SERVER_ROOT/logs/transfer_disk_log_8080, Windows: %SERVER_ROOT%\logs\transfer_disk_log_8080
) space.
Syntax: TransferDiskLogSize
max-bytes max-files
Default: TransferDiskLogSize 512000 8
Module: mod_disk_log(3)
TransferDiskLogSize
defines the properties of the
disk_log(3)
access log file. The disk_log(3)
access
log file is of type wrap log and max-bytes
will
be written to each file and max-files
will be used
before the first file is truncated and reused.
Uses the following EWSAPI interaction data, if available:
{remote_user,RemoteUser}
This module furthermore exports a batch of functions to be used by other EWSAPI modules:
error_log(Socket,SocketType,ConfigDB,Date,Reason) -> ok | no_error_log
Types:
Socket = socket()
SocketType = ip_comm | ssl
ConfigDB = config_db()
Date = Reason = string()
error_log/5
uses disk_log(3)
to log an error
in the error log file. Socket
is a handler to a
socket of type SocketType
and config_db()
is the
server config file in ETS table format as described in
httpd(3). Date
is a RFC
1123 date string as generated by httpd_util:rfc1123_date/0.
security_log(User,Event) -> ok | no_security_log
Types:
User = String()
Event = String
security_log/2
uses disk_log(3)
to log a security event
in the security log file. User
is the users name.