Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_log_module.xml @ 2540:b686736680e3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented escaping rules in log_format.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 12 May 2020 22:06:12 +0100
parents 64004f50b9dd
children eeed494bba51
comparison
equal deleted inserted replaced
2539:5a5a791b3166 2540:b686736680e3
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_log_module" 10 <module name="Модуль ngx_http_log_module"
11 link="/ru/docs/http/ngx_http_log_module.html" 11 link="/ru/docs/http/ngx_http_log_module.html"
12 lang="ru" 12 lang="ru"
13 rev="19"> 13 rev="20">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_log_module</literal> записывает логи запросов 18 Модуль <literal>ngx_http_log_module</literal> записывает логи запросов
205 Параметр <literal>escape</literal> (1.11.8) позволяет задать 205 Параметр <literal>escape</literal> (1.11.8) позволяет задать
206 экранирование символов <literal>json</literal> или <literal>default</literal> 206 экранирование символов <literal>json</literal> или <literal>default</literal>
207 в переменных, по умолчанию используется <literal>default</literal>. 207 в переменных, по умолчанию используется <literal>default</literal>.
208 Значение <literal>none</literal> (1.13.10) отключает 208 Значение <literal>none</literal> (1.13.10) отключает
209 экранирование символов. 209 экранирование символов.
210 </para>
211
212 <para id="log_format_escape_default">
213 При использовании <literal>default</literal>
214 символы “<literal>"</literal>”, “<literal>\</literal>”,
215 a также символы со значениями меньше 32 (0.7.0) или больше 126 (1.1.6)
216 экранируются как “<literal>\xXX</literal>”.
217 Если значение переменной не найдено,
218 то в качестве значения в лог будет записываться дефис (“<literal>-</literal>”).
219 </para>
220
221 <para id="log_format_escape_json">
222 При использовании <literal>json</literal>
223 экранируются все символы, недопустимые
224 в JSON <link url="https://tools.ietf.org/html/rfc8259#section-7">строках</link>:
225 символы “<literal>"</literal>” и
226 “<literal>\</literal>” экранируются как
227 “<literal>\"</literal>” и “<literal>\\</literal>”,
228 символы со значениями меньше 32 экранируются как
229 “<literal>\n</literal>”,
230 “<literal>\r</literal>”,
231 “<literal>\t</literal>”,
232 “<literal>\b</literal>”,
233 “<literal>\f</literal>” или
234 “<literal>\u00XX</literal>”.
210 </para> 235 </para>
211 236
212 <para> 237 <para>
213 Кроме общих переменных в формате можно использовать переменные, 238 Кроме общих переменных в формате можно использовать переменные,
214 существующие только на момент записи в лог: 239 существующие только на момент записи в лог: