Mercurial > hg > nginx-site
diff xml/en/docs/http/ngx_http_log_module.xml @ 966:95c3c3bbf1ce
Text review.
author | Egor Nikitin <yegor.nikitin@gmail.com> |
---|---|
date | Wed, 14 Aug 2013 12:03:41 +0400 |
parents | 488a3f738db0 |
children | 379cb572a7ec |
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_log_module.xml Wed Aug 14 17:21:19 2013 +0400 +++ b/xml/en/docs/http/ngx_http_log_module.xml Wed Aug 14 12:03:41 2013 +0400 @@ -20,8 +20,8 @@ </para> <para> -Requests are logged in a context of a location where processing ends. -This may be different from the original location, if an +Requests are logged in the context of a location where processing ends. +It may be different from the original location, if an <link doc="ngx_http_core_module.xml" id="internal">internal redirect</link> happens during request processing. </para> @@ -70,14 +70,14 @@ <context>limit_except</context> <para> -Sets the path, format, and configuration of the buffered log writes. +Sets the path, format, and configuration for a buffered log write. Several logs can be specified on the same level. Logging to syslog can be configured by specifying the “<literal>syslog:</literal>” prefix in the first parameter. The special value <literal>off</literal> cancels all <literal>access_log</literal> directives on the current level. -If format is not specified then the predefined format -“<literal>combined</literal>” is used. +If the format is not specified then the predefined +“<literal>combined</literal>” format is used. </para> <para> @@ -85,7 +85,7 @@ (1.3.10, 1.2.7) parameter is used, writes to log will be buffered. <note> -The buffer size must not exceed the size of the atomic write to a disk file. +The buffer size must not exceed the size of an atomic write to a disk file. For FreeBSD this size is unlimited. </note> </para> @@ -116,7 +116,7 @@ be compressed before writing to the file. The compression level can be set between 1 (fastest, less compression) and 9 (slowest, best compression). -By default the buffer size is equal to 64K bytes, and the compression level +By default, the buffer size is equal to 64K bytes, and the compression level is set to 1. Since the data is compressed in atomic blocks, the log file can be decompressed or read by “<literal>zcat</literal>” at any time. @@ -152,12 +152,11 @@ </listitem> <listitem> -a file is opened and closed for each log write. +the file is opened and closed for each log write. However, since the descriptors of frequently used files can be stored -in a <link id="open_log_file_cache">cache</link>, writes during the -time specified by the <literal>valid</literal> parameter of the -<link id="open_log_file_cache"/> directive can continue to be made -to the old file. +in a <link id="open_log_file_cache">cache</link>, writing to the old file +can continue during the time specified by the <link id="open_log_file_cache"/> +directive’s <literal>valid</literal> parameter </listitem> <listitem> @@ -260,7 +259,7 @@ <context>http</context> <para> -Specifies format of a log. +Specifies log format. </para> <para> @@ -285,7 +284,7 @@ <tag-name><var>$msec</var></tag-name> <tag-desc> -time in seconds with a milliseconds resolution at the time of log write +time in seconds with a milliseconds resolution at the time of the log write </tag-desc> <tag-name><var>$pipe</var></tag-name> @@ -324,7 +323,7 @@ </list> <note> -In modern versions of nginx variables +In the modern nginx versions variables <link doc="ngx_http_core_module.xml" id="var_status">$status</link> (1.3.2, 1.2.2), <link doc="ngx_http_core_module.xml" id="var_bytes_sent">$bytes_sent</link> @@ -358,8 +357,8 @@ </para> <para> -The configuration always includes the predefined format -“<literal>combined</literal>”: +The configuration always includes the predefined +“<literal>combined</literal>” format: <example> log_format combined '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' @@ -384,36 +383,36 @@ <context>location</context> <para> -Defines a cache that stores file descriptors of frequently used logs +Defines a cache that stores the file descriptors of frequently used logs whose names contain variables. The directive has the following parameters: <list type="tag"> <tag-name><literal>max</literal></tag-name> <tag-desc> -sets a maximum number of descriptors in a cache; -if cache becomes full the least recently used (LRU) +sets the maximum number of descriptors in a cache; +if the cache becomes full the least recently used (LRU) descriptors are closed </tag-desc> <tag-name><literal>inactive</literal></tag-name> <tag-desc> -sets a time after which the cached descriptor is closed +sets the time after which the cached descriptor is closed if there were no access during this time; by default, 10 seconds </tag-desc> <tag-name><literal>min_uses</literal></tag-name> <tag-desc> -sets a minimum number of file uses during the time +sets the minimum number of file uses during the time defined by the <literal>inactive</literal> parameter -after which the descriptor will stay open in a cache; +to let the descriptor stay open in a cache; by default, 1 </tag-desc> <tag-name><literal>valid</literal></tag-name> <tag-desc> -sets a time after which it should be checked that the file +sets the time after which it should be checked that the file still exists with the same name; by default, 60 seconds </tag-desc> @@ -426,7 +425,7 @@ </para> <para> -Example usage: +Usage example: <example> open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2; </example>