Access-log
From Resin 3.0
(Difference between revisions)
(renamed tag to directive) |
(migration) |
||
| Line 1: | Line 1: | ||
| − | [[Category: | + | [[Category:Directives]] |
| − | The | + | The '''access-log''' directive controls the information Resin prints with each |
| + | request. It can appear in any [[environment]] (i.e. within a [[server]], | ||
| + | [[host]], or [[web-app]]). | ||
| + | An access log receives output describing each request received by | ||
| + | the server. It is commonly used in conjunction with analyzing tools to | ||
| + | determine statistics and patterns of use for a website. | ||
| − | + | == directives == | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
{| | {| | ||
| − | ! | + | !directive||meaning||default |
| + | |- | ||
| + | ||[[auto-flush]]||flush after each log entry||false | ||
| + | |- | ||
| + | ||[[path]] | ||
| + | ||output path for the stream | ||
| + | ||either <tt>path-format</tt> or <tt>path</tt> is required | ||
| + | |- | ||
| + | ||[[path-format]] | ||
| + | ||the name of a file to write the log to, [[date format]] escape sequences are replaced with the current date and time | ||
| + | ||either <tt>path</tt> or <tt>path-format</tt> is required | ||
| + | |- | ||
| + | ||[[rollover-period]] | ||
| + | ||how often to rollover the log. Specify a [[period]] in days (15D), weeks (2W), months (1M), or hours (1h) | ||
| + | ||none | ||
|- | |- | ||
| − | || | + | ||[[rollover-size]] |
| + | ||maximum size of the file before a rollover occurs. Specify a [[size]] in bytes (50000), kb (128kb), or megabytes (10mb) | ||
| + | ||1mb | ||
|- | |- | ||
| − | || | + | ||[[archive-format]] |
| + | ||the format for the archive filename when a rollover occurs | ||
| + | || ''path'' + ".%Y%m%d" or ''path'' + ".%Y%m%d.%H" if <tt>rollover-period</tt> < 1 day | ||
|} | |} | ||
| − | == | + | == format == |
{| | {| | ||
| − | + | !code||meaning | |
|- | |- | ||
||%b||content length | ||%b||content length | ||
Revision as of 23:20, 27 February 2006
The access-log directive controls the information Resin prints with each
request. It can appear in any environment (i.e. within a server,
host, or web-app).
An access log receives output describing each request received by the server. It is commonly used in conjunction with analyzing tools to determine statistics and patterns of use for a website.
directives
| directive | meaning | default |
|---|---|---|
| auto-flush | flush after each log entry | false |
| path | output path for the stream | either path-format or path is required |
| path-format | the name of a file to write the log to, date format escape sequences are replaced with the current date and time | either path or path-format is required |
| rollover-period | how often to rollover the log. Specify a period in days (15D), weeks (2W), months (1M), or hours (1h) | none |
| rollover-size | maximum size of the file before a rollover occurs. Specify a size in bytes (50000), kb (128kb), or megabytes (10mb) | 1mb |
| archive-format | the format for the archive filename when a rollover occurs | path + ".%Y%m%d" or path + ".%Y%m%d.%H" if rollover-period < 1 day |
format
| code | meaning |
|---|---|
| %b | content length |
| %h | remote IP address |
| %\{xxx}i | request header xxx |
| %\{xxx}o | response header xxx |
| %\{xxx}c | cookie value xxx |
| %n | request attribute |
| %r | request URL |
| %s | status code |
| %\{xxx}t | date with optional time format |
| %T | time of request in seconds |
| %D | time of request in microseconds (3.0.15) |
| %u | remote user |
| %U | request URL |
