Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_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 | 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 существующие только на момент записи в лог: |