comparison xml/en/docs/http/ngx_http_log_module.xml @ 2593:eeed494bba51

Unified phrases about configuration levels and inheritance.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 21 Sep 2020 15:45:07 +0300
parents b686736680e3
children 4add6ae1296f
comparison
equal deleted inserted replaced
2592:fca42223b9fc 2593:eeed494bba51
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="20"> 13 rev="21">
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
62 <context>if in location</context> 62 <context>if in location</context>
63 <context>limit_except</context> 63 <context>limit_except</context>
64 64
65 <para> 65 <para>
66 Sets the path, format, and configuration for a buffered log write. 66 Sets the path, format, and configuration for a buffered log write.
67 Several logs can be specified on the same level. 67 Several logs can be specified on the same configuration level.
68 Logging to <link doc="../syslog.xml">syslog</link> 68 Logging to <link doc="../syslog.xml">syslog</link>
69 can be configured by specifying 69 can be configured by specifying
70 the “<literal>syslog:</literal>” prefix in the first parameter. 70 the “<literal>syslog:</literal>” prefix in the first parameter.
71 The special value <literal>off</literal> cancels all 71 The special value <literal>off</literal> cancels all
72 <literal>access_log</literal> directives on the current level. 72 <literal>access_log</literal> directives on the current level.
158 <link doc="ngx_http_core_module.xml" id="root">root directory</link> 158 <link doc="ngx_http_core_module.xml" id="root">root directory</link>
159 is checked, and if it does not exist the log is not 159 is checked, and if it does not exist the log is not
160 created. 160 created.
161 It is thus a good idea to specify both 161 It is thus a good idea to specify both
162 <link doc="ngx_http_core_module.xml" id="root"/> 162 <link doc="ngx_http_core_module.xml" id="root"/>
163 and <literal>access_log</literal> on the same level: 163 and <literal>access_log</literal> on the same configuration level:
164 <example> 164 <example>
165 server { 165 server {
166 root /spool/vhost/data/$host; 166 root /spool/vhost/data/$host;
167 access_log /spool/vhost/logs/$host; 167 access_log /spool/vhost/logs/$host;
168 ... 168 ...