comparison xml/en/docs/http/ngx_http_log_module.xml @ 826:ddd22f571529

Variables $pipe, $request_length, $time_iso8601, and $time_local.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 01 Feb 2013 17:34:08 +0400
parents 41363f013cc9
children 9dab69f2b71d
comparison
equal deleted inserted replaced
825:ae15915990ad 826:ddd22f571529
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="7"> 13 rev="8">
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
193 <list type="tag"> 193 <list type="tag">
194 194
195 <tag-name><var>$bytes_sent</var></tag-name> 195 <tag-name><var>$bytes_sent</var></tag-name>
196 <tag-desc> 196 <tag-desc>
197 the number of bytes sent to a client 197 the number of bytes sent to a client
198 <note>
199 Since versions 1.3.8 and 1.2.5 there is a common variable with the
200 <link doc="ngx_http_core_module.xml" id="var_bytes_sent">same name</link>.
201 </note>
202 </tag-desc> 198 </tag-desc>
203 199
204 <tag-name><var>$connection</var></tag-name> 200 <tag-name><var>$connection</var></tag-name>
205 <tag-desc> 201 <tag-desc>
206 connection serial number 202 connection serial number
207 <note>
208 Since versions 1.3.8 and 1.2.5 there is a common variable with the
209 <link doc="ngx_http_core_module.xml" id="var_connection">same name</link>.
210 </note>
211 </tag-desc> 203 </tag-desc>
212 204
213 <tag-name><var>$connection_requests</var></tag-name> 205 <tag-name><var>$connection_requests</var></tag-name>
214 <tag-desc> 206 <tag-desc>
215 the current number of requests made through a connection (1.1.18) 207 the current number of requests made through a connection (1.1.18)
216 <note>
217 Since versions 1.3.8 and 1.2.5 there is a common variable with the
218 <link doc="ngx_http_core_module.xml" id="var_connection_requests">same
219 name</link>.
220 </note>
221 </tag-desc> 208 </tag-desc>
222 209
223 <tag-name><var>$msec</var></tag-name> 210 <tag-name><var>$msec</var></tag-name>
224 <tag-desc> 211 <tag-desc>
225 time in seconds with a milliseconds resolution at the time of log write 212 time in seconds with a milliseconds resolution at the time of log write
226 <note>
227 Since versions 1.3.9 and 1.2.6 there is a common variable with the
228 <link doc="ngx_http_core_module.xml" id="var_msec">same name</link>.
229 </note>
230 </tag-desc> 213 </tag-desc>
231 214
232 <tag-name><var>$pipe</var></tag-name> 215 <tag-name><var>$pipe</var></tag-name>
233 <tag-desc> 216 <tag-desc>
234 “<literal>p</literal>” if request was pipelined, “<literal>.</literal>” 217 “<literal>p</literal>” if request was pipelined, “<literal>.</literal>”
243 <tag-name><var>$request_time</var></tag-name> 226 <tag-name><var>$request_time</var></tag-name>
244 <tag-desc> 227 <tag-desc>
245 request processing time in seconds with a milliseconds resolution; 228 request processing time in seconds with a milliseconds resolution;
246 time elapsed between the first bytes were read from the client and 229 time elapsed between the first bytes were read from the client and
247 the log write after the last bytes were sent to the client 230 the log write after the last bytes were sent to the client
231 </tag-desc>
232
233 <tag-name><var>$status</var></tag-name>
234 <tag-desc>
235 response status
236 </tag-desc>
237
238 <tag-name><var>$time_iso8601</var></tag-name>
239 <tag-desc>
240 local time in the ISO 8601 standard format
241 </tag-desc>
242
243 <tag-name><var>$time_local</var></tag-name>
244 <tag-desc>
245 local time in the Common Log Format
246 </tag-desc>
247
248 </list>
249
248 <note> 250 <note>
249 Since versions 1.3.9 and 1.2.6 there is a common variable with the 251 In modern versions of nginx variables
250 <link doc="ngx_http_core_module.xml" id="var_request_time">same name</link>. 252 <link doc="ngx_http_core_module.xml" id="var_status">$status</link>
253 (1.3.2, 1.2.2),
254 <link doc="ngx_http_core_module.xml" id="var_bytes_sent">$bytes_sent</link>
255 (1.3.8, 1.2.5),
256 <link doc="ngx_http_core_module.xml" id="var_connection">$connection</link>
257 (1.3.8, 1.2.5),
258 <link doc="ngx_http_core_module.xml" id="var_connection_requests">$connection_requests</link>
259 (1.3.8, 1.2.5),
260 <link doc="ngx_http_core_module.xml" id="var_msec">$msec</link>
261 (1.3.9, 1.2.6),
262 <link doc="ngx_http_core_module.xml" id="var_request_time">$request_time</link>
263 (1.3.9, 1.2.6),
264 <link doc="ngx_http_core_module.xml" id="var_pipe">$pipe</link>
265 (1.3.12),
266 <link doc="ngx_http_core_module.xml" id="var_request_length">$request_length</link>
267 (1.3.12),
268 <link doc="ngx_http_core_module.xml" id="var_time_iso8601">$time_iso8601</link>
269 (1.3.12),
270 and
271 <link doc="ngx_http_core_module.xml" id="var_time_local">$time_local</link>
272 (1.3.12)
273 are also available as common variables.
251 </note> 274 </note>
252 </tag-desc> 275
253
254 <tag-name><var>$status</var></tag-name>
255 <tag-desc>
256 response status
257 <note>
258 Since versions 1.3.2 and 1.2.2 there is a common variable with the
259 <link doc="ngx_http_core_module.xml" id="var_status">same name</link>.
260 </note>
261 </tag-desc>
262
263 <tag-name><var>$time_iso8601</var></tag-name>
264 <tag-desc>
265 local time in the ISO 8601 standard format
266 </tag-desc>
267
268 <tag-name><var>$time_local</var></tag-name>
269 <tag-desc>
270 local time in the Common Log Format
271 </tag-desc>
272
273 </list>
274 </para> 276 </para>
275 277
276 <para> 278 <para>
277 Header lines sent to a client have the prefix 279 Header lines sent to a client have the prefix
278 “<literal>sent_http_</literal>”, for example, 280 “<literal>sent_http_</literal>”, for example,