Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_log_module.xml @ 840:9dab69f2b71d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented nginx 1.2.7 changes. - variables support in the "auth_basic" directive; - new generic variables $pipe, $request_length, $time_iso8601, and $time_local; - IPv6 support in ngx_http_geo_module and ngx_http_geoip_module; - "gzip" and "flush" parameters of the "access_log" directive.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 12 Feb 2013 16:45:45 +0400
parents ddd22f571529
children 2a9e42106d6f
comparison
equal deleted inserted replaced
839:1a917e32c1da 840:9dab69f2b71d
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_log_module" 10 <module name="Module ngx_http_log_module"
11 link="/en/docs/http/ngx_http_log_module.html" 11 link="/en/docs/http/ngx_http_log_module.html"
12 lang="en" 12 lang="en"
13 rev="8"> 13 rev="9">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_log_module</literal> module writes request logs 18 The <literal>ngx_http_log_module</literal> module writes request logs
74 If format is not specified then the predefined format 74 If format is not specified then the predefined format
75 “<literal>combined</literal>” is used. 75 “<literal>combined</literal>” is used.
76 </para> 76 </para>
77 77
78 <para> 78 <para>
79 If either the <literal>buffer</literal> or <literal>gzip</literal> (1.3.10) 79 If either the <literal>buffer</literal> or <literal>gzip</literal>
80 (1.3.10, 1.2.7)
80 parameter is used, writes to log will be buffered. 81 parameter is used, writes to log will be buffered.
81 <note> 82 <note>
82 The buffer size must not exceed the size of the atomic write to a disk file. 83 The buffer size must not exceed the size of the atomic write to a disk file.
83 For FreeBSD this size is unlimited. 84 For FreeBSD this size is unlimited.
84 </note> 85 </note>
92 if the next log line does not fit into the buffer; 93 if the next log line does not fit into the buffer;
93 </listitem> 94 </listitem>
94 95
95 <listitem> 96 <listitem>
96 if the buffered data is older than specified by the <literal>flush</literal> 97 if the buffered data is older than specified by the <literal>flush</literal>
97 parameter (1.3.10); 98 parameter (1.3.10, 1.2.7);
98 </listitem> 99 </listitem>
99 100
100 <listitem> 101 <listitem>
101 when a worker process is <link doc="../control.xml">re-opening</link> log 102 when a worker process is <link doc="../control.xml">re-opening</link> log
102 files or is shutting down. 103 files or is shutting down.
260 <link doc="ngx_http_core_module.xml" id="var_msec">$msec</link> 261 <link doc="ngx_http_core_module.xml" id="var_msec">$msec</link>
261 (1.3.9, 1.2.6), 262 (1.3.9, 1.2.6),
262 <link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link> 263 <link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link>
263 (1.3.9, 1.2.6), 264 (1.3.9, 1.2.6),
264 <link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link> 265 <link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link>
265 (1.3.12), 266 (1.3.12, 1.2.7),
266 <link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link> 267 <link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link>
267 (1.3.12), 268 (1.3.12, 1.2.7),
268 <link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link> 269 <link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link>
269 (1.3.12), 270 (1.3.12, 1.2.7),
270 and 271 and
271 <link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link> 272 <link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link>
272 (1.3.12) 273 (1.3.12, 1.2.7)
273 are also available as common variables. 274 are also available as common variables.
274 </note> 275 </note>
275 276
276 </para> 277 </para>
277 278