[${now}] ${ip_remote}: ${request} (${status})
This module implements a flexible mechanism for logging requests made to the server, using a user-specified format.
The format in which the request will be logged is defined by a string. This string is used to log each request to the log. It can contain both literal characters and a set of variables. All the literal characters will be copied to the log. The following variables will be evaluated right before writing each log entry:
| Variable | Example | Description |
|---|---|---|
| ${ip_remote} | 74.125.67.100 | Remote IP-address |
| ${ip_local} | 10.0.0.1 | Local IP-address |
| ${request} | /file.txt | URL path requested |
| ${request_original} | /file.txt | URL path requested before any rewrite |
| ${protocol} | http | Request Protocol |
| ${port_server} | 80 | Port of the server serving the request |
| ${query_string} | ?bar=foo | The query string, if exists |
| ${request_first_line} | GET / HTTP/1.0 | First line of request |
| ${status} | 200 | Status of the request |
| ${now} | 08/Apr/2009:12:02:11 +0200 | Time: in common log format time format |
| ${time_secs} | 1239185281 | Time: seconds since Epoch |
| ${time_msecs} | 18446744071655350332 | Time: milliseconds since Epoch |
| ${user_remote} | guest | Remote user (authentication) |
| ${vserver_name} | default | Virtual Server nick name |
For instance, the following format string:
[${now}] ${ip_remote}: ${request} (${status})
would generate this entry in the log:
[08/Apr/2009:12:02:11 +0200] 74.125.67.100: /file.txt (200)