nginx-site: xml/en/docs/http/ngx_http_log

annotate xml/en/docs/http/ngx_http_log_module.xml @ 1168:384bb0349a8a

Documented the "if" parameter of the "access_log" directive.

author	Yaroslav Zhuravlev <yar@nginx.com>
date	Thu, 24 Apr 2014 12:25:59 +0400
parents	07402a11fd8d
children	aab8a1667171

rev	line source
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	1 <?xml version="1.0"?>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	2
580 be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 452 diff changeset	3 <!--
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 452 diff changeset	4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 452 diff changeset	5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 452 diff changeset	6 -->
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 452 diff changeset	7
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	9
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	10 <module name="Module ngx_http_log_module"
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	11 link="/en/docs/http/ngx_http_log_module.html"
589 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	12 lang="en"
1168 384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	13 rev="12">
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	14
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	15 <section id="summary">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	16
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	17 <para>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	18 The <literal>ngx_http_log_module</literal> module writes request logs
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	19 in the specified format.
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	20 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	21
430 570b312367bd Documented the context of request logging. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	22 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	23 Requests are logged in the context of a location where processing ends.
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	24 It may be different from the original location, if an
430 570b312367bd Documented the context of request logging. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	25 <link doc="ngx_http_core_module.xml" id="internal">internal
570b312367bd Documented the context of request logging. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	26 redirect</link> happens during request processing.
570b312367bd Documented the context of request logging. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	27 </para>
570b312367bd Documented the context of request logging. Ruslan Ermilov <ru@nginx.com> parents: 364 diff changeset	28
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	29 </section>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	30
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	31
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	32 <section id="example" name="Example Configuration">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	33
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	34 <para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	35 <example>
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	36 log_format compression '$remote_addr - $remote_user [$time_local] '
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	37 '"$request" $status $bytes_sent '
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	38 '"$http_referer" "$http_user_agent" "$gzip_ratio"';
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	39
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	40 access_log /spool/logs/nginx-access.log compression buffer=32k;
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	41 </example>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	42 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	43
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	44 </section>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	45
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	46
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	47 <section id="directives" name="Directives">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	48
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	49 <directive name="access_log">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	50 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	51 <value>path</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	52 [<value>format</value>
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	53 [<literal>buffer</literal>=<value>size</value>
1168 384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	54 [<literal>flush</literal>=<value>time</value>]]
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	55 [<literal>if</literal>=<value>condition</value>]]</syntax>
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	56 <syntax>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	57 <value>path</value>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	58 <value>format</value>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	59 <literal>gzip[=<value>level</value>]</literal>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	60 [<literal>buffer</literal>=<value>size</value>]
1168 384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	61 [<literal>flush</literal>=<value>time</value>]
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	62 [<literal>if</literal>=<value>condition</value>]</syntax>
953 aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	63 <syntax>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	64 <literal>syslog:</literal><literal>server</literal>=<value>address</value>[,<value>parameter</value>=<value>value</value>]
1168 384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	65 [<value>format</value>
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	66 [<literal>if</literal>=<value>condition</value>]]</syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	67 <syntax><literal>off</literal></syntax>
443 1b2264bdd433 Fixed default for the access_log directive. Ruslan Ermilov <ru@nginx.com> parents: 430 diff changeset	68 <default>logs/access.log combined</default>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	69 <context>http</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	70 <context>server</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	71 <context>location</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	72 <context>if in location</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	73 <context>limit_except</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	74
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	75 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	76 Sets the path, format, and configuration for a buffered log write.
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	77 Several logs can be specified on the same level.
953 aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	78 Logging to syslog can be configured by specifying
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	79 the “<literal>syslog:</literal>” prefix in the first parameter.
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	80 The special value <literal>off</literal> cancels all
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	81 <literal>access_log</literal> directives on the current level.
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	82 If the format is not specified then the predefined
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	83 “<literal>combined</literal>” format is used.
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	84 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	85
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	86 <para>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	87 If either the <literal>buffer</literal> or <literal>gzip</literal>
9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	88 (1.3.10, 1.2.7)
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	89 parameter is used, writes to log will be buffered.
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	90 <note>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	91 The buffer size must not exceed the size of an atomic write to a disk file.
657 56fa3cab4ceb Completely dropped FreeBSD version information when talking about Ruslan Ermilov <ru@nginx.com> parents: 656 diff changeset	92 For FreeBSD this size is unlimited.
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	93 </note>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	94 </para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	95
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	96 <para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	97 When buffering is enabled, the data will be written to the file:
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	98 <list type="bullet">
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	99
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	100 <listitem>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	101 if the next log line does not fit into the buffer;
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	102 </listitem>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	103
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	104 <listitem>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	105 if the buffered data is older than specified by the <literal>flush</literal>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	106 parameter (1.3.10, 1.2.7);
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	107 </listitem>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	108
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	109 <listitem>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	110 when a worker process is <link doc="../control.xml">re-opening</link> log
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	111 files or is shutting down.
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	112 </listitem>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	113
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	114 </list>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	115 </para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	116
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	117 <para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	118 If the <literal>gzip</literal> parameter is used, then the buffered data will
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	119 be compressed before writing to the file.
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	120 The compression level can be set between 1 (fastest, less compression)
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	121 and 9 (slowest, best compression).
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	122 By default, the buffer size is equal to 64K bytes, and the compression level
795 41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	123 is set to 1.
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	124 Since the data is compressed in atomic blocks, the log file can be decompressed
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	125 or read by “<literal>zcat</literal>” at any time.
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	126 </para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	127
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	128 <para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	129 Example:
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	130 <example>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	131 access_log /path/to/log.gz combined gzip flush=5m;
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	132 </example>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	133 </para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	134
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	135 <para>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	136 <note>
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	137 For gzip compression to work, nginx must be built with the zlib library.
41363f013cc9 Documented the recently added "gzip" and "flush" parameters of the "access_log" Valentin Bartenev <vbart@nginx.com> parents: 779 diff changeset	138 </note>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	139 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	140
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	141 <para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	142 The file path can contain variables (0.7.6+),
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	143 but such logs have some constraints:
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	144 <list type="bullet">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	145
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	146 <listitem>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	147 the <link doc="../ngx_core_module.xml" id="user"/>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	148 whose credentials are used by worker processes should
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	149 have permissions to create files in a directory with
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	150 such logs;
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	151 </listitem>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	152
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	153 <listitem>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	154 buffered writes do not work;
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	155 </listitem>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	156
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	157 <listitem>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	158 the file is opened and closed for each log write.
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	159 However, since the descriptors of frequently used files can be stored
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	160 in a <link id="open_log_file_cache">cache</link>, writing to the old file
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	161 can continue during the time specified by the <link id="open_log_file_cache"/>
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	162 directive’s <literal>valid</literal> parameter
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	163 </listitem>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	164
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	165 <listitem>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	166 during each log write the existence of the request’s
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	167 <link doc="ngx_http_core_module.xml" id="root">root directory</link>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	168 is checked, and if it does not exist the log is not
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	169 created.
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	170 It is thus a good idea to specify both
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	171 <link doc="ngx_http_core_module.xml" id="root"/>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	172 and <literal>access_log</literal> on the same level:
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	173 <example>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	174 server {
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	175 root /spool/vhost/data/$host;
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	176 access_log /spool/vhost/logs/$host;
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	177 ...
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	178 </example>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	179 </listitem>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	180
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	181 </list>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	182 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	183
953 aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	184 <para>
1168 384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	185 The <literal>if</literal> parameter (1.7.0) enables conditional logging.
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	186 A request will not be logged if the <value>condition</value> evaluates to “0”
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	187 or an empty string.
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	188 In the following example, the requests with response codes 2xx and 3xx
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	189 will not be logged:
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	190 <example>
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	191 map $status $loggable {
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	192 ~^[23] 0;
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	193 default 1;
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	194 }
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	195
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	196 access_log /path/to/access.log combined if=$loggable;
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	197 </example>
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	198 </para>
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	199
384bb0349a8a Documented the "if" parameter of the "access_log" directive. Yaroslav Zhuravlev <yar@nginx.com> parents: 1155 diff changeset	200 <para>
953 aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	201 The following parameters configure logging to syslog:
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	202 <list type="tag">
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	203
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	204 <tag-name><literal>server=</literal><value>address</value></tag-name>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	205 <tag-desc>
956 488a3f738db0 Text revision of commercial modules. Egor Nikitin <yegor.nikitin@gmail.com> parents: 953 diff changeset	206 Defines the address of a syslog server.
488a3f738db0 Text revision of commercial modules. Egor Nikitin <yegor.nikitin@gmail.com> parents: 953 diff changeset	207 The address can be specified as a domain name, IP address, or
488a3f738db0 Text revision of commercial modules. Egor Nikitin <yegor.nikitin@gmail.com> parents: 953 diff changeset	208 a UNIX-domain socket path (specified after the “<literal>unix:</literal>”
488a3f738db0 Text revision of commercial modules. Egor Nikitin <yegor.nikitin@gmail.com> parents: 953 diff changeset	209 prefix).
488a3f738db0 Text revision of commercial modules. Egor Nikitin <yegor.nikitin@gmail.com> parents: 953 diff changeset	210 With a domain name or IP address, the port can be specified.
953 aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	211 If port is not specified, the port 514 is used.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	212 If a domain name resolves to several IP addresses, the first resolved
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	213 address is used.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	214 </tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	215
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	216 <tag-name><literal>facility=</literal><value>string</value></tag-name>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	217 <tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	218 Sets facility of syslog messages, as defined in
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	219 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	220 Facility can be one of “<literal>kern</literal>”, “<literal>user</literal>”,
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	221 “<literal>mail</literal>”, “<literal>daemon</literal>”,
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	222 “<literal>auth</literal>”, “<literal>intern</literal>”,
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	223 “<literal>lpr</literal>”, “<literal>news</literal>”, “<literal>uucp</literal>”,
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	224 “<literal>clock</literal>”, “<literal>authpriv</literal>”,
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	225 “<literal>ftp</literal>”, “<literal>ntp</literal>”, “<literal>audit</literal>”,
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	226 “<literal>alert</literal>”, “<literal>cron</literal>”,
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	227 “<literal>local0</literal>”..“<literal>local7</literal>”.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	228 Default is “<literal>local7</literal>”.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	229 </tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	230
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	231 <tag-name><literal>severity=</literal><value>string</value></tag-name>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	232 <tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	233 Sets severity of syslog messages, as defined in
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	234 <link url="http://tools.ietf.org/html/rfc3164#section-4.1.1">RFC 3164</link>.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	235 Possible values are the same as for the second parameter (level) of the
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	236 <link doc="../ngx_core_module.xml" id="error_log"/> directive.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	237 Default is “<literal>info</literal>”.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	238 </tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	239
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	240 <tag-name><literal>tag=</literal><value>string</value></tag-name>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	241 <tag-desc>
956 488a3f738db0 Text revision of commercial modules. Egor Nikitin <yegor.nikitin@gmail.com> parents: 953 diff changeset	242 Sets the tag of syslog messages.
953 aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	243 Default is “<literal>nginx</literal>”.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	244 </tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	245
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	246 <!--
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	247 <tag-name><literal>bare=</literal><literal>on</literal> \|
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	248 <literal>off</literal></tag-name>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	249 <tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	250 If enabled, messages are sent without syslog headers.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	251 Default is <literal>off</literal>.
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	252 </tag-desc>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	253 -->
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	254
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	255 </list>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	256 Example syslog configuration:
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	257 <example>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	258 access_log syslog:server=192.168.1.1;
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	259 access_log syslog:server=unix:/var/log/nginx.sock;
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	260 access_log syslog:server=[2001:db8::1]:12345,facility=local7,tag=nginx,severity=info combined;
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	261 </example>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	262 </para>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	263
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	264 <para>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	265 <note>
1128 1594ed379f1f De-i18n'ed <commercial_version/>. Ruslan Ermilov <ru@nginx.com> parents: 1088 diff changeset	266 Logging to syslog is available as part of our
1594ed379f1f De-i18n'ed <commercial_version/>. Ruslan Ermilov <ru@nginx.com> parents: 1088 diff changeset	267 <commercial_version>commercial subscription</commercial_version>.
953 aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	268 </note>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	269 </para>
aded7086e84f Commercial version documentation. Ruslan Ermilov <ru@nginx.com> parents: 939 diff changeset	270
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	271 </directive>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	272
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	273
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	274 <directive name="log_format">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	275 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	276 <value>name</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	277 <value>string</value> ...</syntax>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	278 <default>combined "..."</default>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	279 <context>http</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	280
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	281 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	282 Specifies log format.
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	283 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	284
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	285 <para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	286 The log format can contain common variables, and variables that
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	287 exist only at the time of a log write:
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	288 <list type="tag">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	289
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	290 <tag-name id="var_bytes_sent"><var>$bytes_sent</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	291 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	292 the number of bytes sent to a client
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	293 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	294
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	295 <tag-name id="var_connection"><var>$connection</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	296 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	297 connection serial number
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	298 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	299
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	300 <tag-name id="var_connection_requests"><var>$connection_requests</var>
07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	301 </tag-name>
452 e9a2a856d76b Documented the $connection_requests variable. Ruslan Ermilov <ru@nginx.com> parents: 451 diff changeset	302 <tag-desc>
769 d71e56d56ada Documented variables relocations between http log and core modules. Vladimir Homutov <vl@nginx.com> parents: 657 diff changeset	303 the current number of requests made through a connection (1.1.18)
452 e9a2a856d76b Documented the $connection_requests variable. Ruslan Ermilov <ru@nginx.com> parents: 451 diff changeset	304 </tag-desc>
e9a2a856d76b Documented the $connection_requests variable. Ruslan Ermilov <ru@nginx.com> parents: 451 diff changeset	305
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	306 <tag-name id="var_msec"><var>$msec</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	307 <tag-desc>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	308 time in seconds with a milliseconds resolution at the time of the log write
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	309 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	310
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	311 <tag-name id="var_pipe"><var>$pipe</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	312 <tag-desc>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	313 “<literal>p</literal>” if request was pipelined, “<literal>.</literal>”
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	314 otherwise
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	315 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	316
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	317 <tag-name id="var_request_length"><var>$request_length</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	318 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	319 request length (including request line, header, and request body)
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	320 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	321
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	322 <tag-name id="var_request_time"><var>$request_time</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	323 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	324 request processing time in seconds with a milliseconds resolution;
451 6351ab788157 Documented $request_time more precisely. Ruslan Ermilov <ru@nginx.com> parents: 443 diff changeset	325 time elapsed between the first bytes were read from the client and
6351ab788157 Documented $request_time more precisely. Ruslan Ermilov <ru@nginx.com> parents: 443 diff changeset	326 the log write after the last bytes were sent to the client
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	327 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	328
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	329 <tag-name id="var_status"><var>$status</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	330 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	331 response status
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	332 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	333
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	334 <tag-name id="var_time_iso8601"><var>$time_iso8601</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	335 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	336 local time in the ISO 8601 standard format
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	337 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	338
1155 07402a11fd8d Assigned IDs to tags describing variables. Vladimir Homutov <vl@nginx.com> parents: 1128 diff changeset	339 <tag-name id="var_time_local"><var>$time_local</var></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	340 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	341 local time in the Common Log Format
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	342 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	343
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	344 </list>
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	345
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	346 <note>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	347 In the modern nginx versions variables
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	348 <link doc="ngx_http_core_module.xml" id="var_status">$status</link>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	349 (1.3.2, 1.2.2),
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	350 <link doc="ngx_http_core_module.xml" id="var_bytes_sent">$bytes_sent</link>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	351 (1.3.8, 1.2.5),
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	352 <link doc="ngx_http_core_module.xml" id="var_connection">$connection</link>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	353 (1.3.8, 1.2.5),
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	354 <link doc="ngx_http_core_module.xml" id="var_connection_requests">$connection_requests</link>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	355 (1.3.8, 1.2.5),
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	356 <link doc="ngx_http_core_module.xml" id="var_msec">$msec</link>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	357 (1.3.9, 1.2.6),
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	358 <link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	359 (1.3.9, 1.2.6),
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	360 <link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	361 (1.3.12, 1.2.7),
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	362 <link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	363 (1.3.12, 1.2.7),
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	364 <link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	365 (1.3.12, 1.2.7),
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	366 and
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	367 <link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link>
840 9dab69f2b71d Documented nginx 1.2.7 changes. Ruslan Ermilov <ru@nginx.com> parents: 826 diff changeset	368 (1.3.12, 1.2.7)
826 ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	369 are also available as common variables.
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	370 </note>
ddd22f571529 Variables $pipe, $request_length, $time_iso8601, and $time_local. Ruslan Ermilov <ru@nginx.com> parents: 795 diff changeset	371
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	372 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	373
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	374 <para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	375 Header lines sent to a client have the prefix
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	376 “<literal>sent_http_</literal>”, for example,
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	377 <var>$sent_http_content_range</var>.
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	378 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	379
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	380 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	381 The configuration always includes the predefined
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	382 “<literal>combined</literal>” format:
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	383 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	384 log_format combined '$remote_addr - $remote_user [$time_local] '
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	385 '"$request" $status $body_bytes_sent '
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	386 '"$http_referer" "$http_user_agent"';
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	387 </example>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	388 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	389
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	390 </directive>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	391
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	392
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	393 <directive name="open_log_file_cache">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	394
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	395 <syntax>
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	396 <literal>max</literal>=<value>N</value>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	397 [<literal>inactive</literal>=<value>time</value>]
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	398 [<literal>min_uses</literal>=<value>N</value>]
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	399 [<literal>valid</literal>=<value>time</value>]</syntax>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	400 <syntax><literal>off</literal></syntax>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	401 <default>off</default>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	402 <context>http</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	403 <context>server</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	404 <context>location</context>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	405
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	406 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	407 Defines a cache that stores the file descriptors of frequently used logs
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	408 whose names contain variables.
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	409 The directive has the following parameters:
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	410 <list type="tag">
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	411
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	412 <tag-name><literal>max</literal></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	413 <tag-desc>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	414 sets the maximum number of descriptors in a cache;
95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	415 if the cache becomes full the least recently used (LRU)
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	416 descriptors are closed
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	417 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	418
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	419 <tag-name><literal>inactive</literal></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	420 <tag-desc>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	421 sets the time after which the cached descriptor is closed
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	422 if there were no access during this time;
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	423 by default, 10 seconds
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	424 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	425
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	426 <tag-name><literal>min_uses</literal></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	427 <tag-desc>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	428 sets the minimum number of file uses during the time
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	429 defined by the <literal>inactive</literal> parameter
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	430 to let the descriptor stay open in a cache;
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	431 by default, 1
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	432 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	433
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	434 <tag-name><literal>valid</literal></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	435 <tag-desc>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	436 sets the time after which it should be checked that the file
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	437 still exists with the same name; by default, 60 seconds
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	438 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	439
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 270 diff changeset	440 <tag-name><literal>off</literal></tag-name>
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	441 <tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	442 disables caching
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	443 </tag-desc>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	444
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	445 </list>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	446 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	447
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	448 <para>
966 95c3c3bbf1ce Text review. Egor Nikitin <yegor.nikitin@gmail.com> parents: 956 diff changeset	449 Usage example:
224 7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	450 <example>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	451 open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	452 </example>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	453 </para>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	454
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	455 </directive>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	456
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	457 </section>
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	458
7f36795d99a2 Updated ngx_http_log_module documentation including translation into English. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	459 </module>

Mercurial > hg > nginx-site

annotate xml/en/docs/http/ngx_http_log_module.xml @ 1168:384bb0349a8a