comparison xml/ru/docs/stream/ngx_stream_log_module.xml @ 2540:b686736680e3

Documented escaping rules in log_format.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 12 May 2020 22:06:12 +0100
parents dab82d534f0f
children eeed494bba51
comparison
equal deleted inserted replaced
2539:5a5a791b3166 2540:b686736680e3
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_stream_log_module" 9 <module name="Модуль ngx_stream_log_module"
10 link="/ru/docs/stream/ngx_stream_log_module.html" 10 link="/ru/docs/stream/ngx_stream_log_module.html"
11 lang="ru" 11 lang="ru"
12 rev="6"> 12 rev="7">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_stream_log_module</literal> (1.11.4) записывает логи сессий 17 Модуль <literal>ngx_stream_log_module</literal> (1.11.4) записывает логи сессий
176 в переменных, по умолчанию используется <literal>default</literal>. 176 в переменных, по умолчанию используется <literal>default</literal>.
177 Параметр <literal>none</literal> (1.13.10) отключает 177 Параметр <literal>none</literal> (1.13.10) отключает
178 экранирование символов. 178 экранирование символов.
179 </para> 179 </para>
180 180
181 <para id="log_format_escape_default">
182 При использовании <literal>default</literal>
183 символы “<literal>"</literal>”, “<literal>\</literal>”,
184 a также символы со значениями меньше 32 или больше 126
185 экранируются как “<literal>\xXX</literal>”.
186 Если значение переменной не найдено,
187 то в качестве значения в лог будет записываться дефис (“<literal>-</literal>”).
188 </para>
189
190 <para id="log_format_escape_json">
191 При использовании <literal>json</literal>
192 экранируются все символы, недопустимые
193 в JSON <link url="https://tools.ietf.org/html/rfc8259#section-7">строках</link>:
194 символы “<literal>"</literal>” и
195 “<literal>\</literal>” экранируются как
196 “<literal>\"</literal>” и “<literal>\\</literal>”,
197 символы со значениями меньше 32 экранируются как
198 “<literal>\n</literal>”,
199 “<literal>\r</literal>”,
200 “<literal>\t</literal>”,
201 “<literal>\b</literal>”,
202 “<literal>\f</literal>” или
203 “<literal>\u00XX</literal>”.
204 </para>
205
181 </directive> 206 </directive>
182 207
183 208
184 <directive name="open_log_file_cache"> 209 <directive name="open_log_file_cache">
185 210