Mercurial > hg > nginx-site

changeset 1874:33f742032155

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented support for json escaping in log_format.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 20 Dec 2016 18:44:33 +0300
parents 2f851f71ff08
children 4687cbd3c933
files xml/en/docs/http/ngx_http_log_module.xml xml/en/docs/stream/ngx_stream_log_module.xml xml/ru/docs/http/ngx_http_log_module.xml xml/ru/docs/stream/ngx_stream_log_module.xml
diffstat 4 files changed, 34 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_log_module.xml	Wed Dec 21 22:52:16 2016 +0300
+++ b/xml/en/docs/http/ngx_http_log_module.xml	Tue Dec 20 18:44:33 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_log_module"
         link="/en/docs/http/ngx_http_log_module.html"
         lang="en"
-        rev="15">
+        rev="16">
 
 <section id="summary">
 
@@ -194,6 +194,7 @@
 <directive name="log_format">
 <syntax>
     <value>name</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>string</value> ...</syntax>
 <default>combined "..."</default>
 <context>http</context>
@@ -202,6 +203,12 @@
 Specifies log format.
 </para>
 
+<para id="log_format_escape">
+The <literal>escape</literal> parameter (1.11.8) allows setting
+<value>json</value> or <value>default</value> characters escaping in variables,
+by default, <value>default</value> escaping is used.
+</para>
+
 <para>
 The log format can contain common variables, and variables that
 exist only at the time of a log write:
--- a/xml/en/docs/stream/ngx_stream_log_module.xml	Wed Dec 21 22:52:16 2016 +0300
+++ b/xml/en/docs/stream/ngx_stream_log_module.xml	Tue Dec 20 18:44:33 2016 +0300
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_log_module"
         link="/en/docs/stream/ngx_stream_log_module.html"
         lang="en"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -155,6 +155,7 @@
 <directive name="log_format">
 <syntax>
     <value>name</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>string</value> ...</syntax>
 <default></default>
 <context>stream</context>
@@ -169,6 +170,12 @@
 </example>
 </para>
 
+<para id="log_format_escape">
+The <literal>escape</literal> parameter (1.11.8) allows setting
+<value>json</value> or <value>default</value> characters escaping in variables,
+by default, <value>default</value> escaping is used.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_log_module.xml	Wed Dec 21 22:52:16 2016 +0300
+++ b/xml/ru/docs/http/ngx_http_log_module.xml	Tue Dec 20 18:44:33 2016 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_log_module"
         link="/ru/docs/http/ngx_http_log_module.html"
         lang="ru"
-        rev="15">
+        rev="16">
 
 <section id="summary">
 
@@ -192,6 +192,7 @@
 <directive name="log_format">
 <syntax>
     <value>название</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>строка</value> ...</syntax>
 <default>combined "..."</default>
 <context>http</context>
@@ -200,6 +201,13 @@
 Задаёт формат лога.
 </para>
 
+<para id="log_format_escape">
+Параметр <literal>escape</literal> (1.11.8) позволяет задать
+экранирование символов <value>json</value> или <value>default</value>
+в переменных,
+по умолчанию используется <value>default</value>.
+</para>
+
 <para>
 Кроме общих переменных в формате можно использовать переменные,
 существующие только на момент записи в лог:
--- a/xml/ru/docs/stream/ngx_stream_log_module.xml	Wed Dec 21 22:52:16 2016 +0300
+++ b/xml/ru/docs/stream/ngx_stream_log_module.xml	Tue Dec 20 18:44:33 2016 +0300
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_log_module"
         link="/ru/docs/stream/ngx_stream_log_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -155,6 +155,7 @@
 <directive name="log_format">
 <syntax>
     <value>название</value>
+    [<literal>escape</literal>=<value>default</value>|<value>json</value>]
     <value>строка</value> ...</syntax>
 <default></default>
 <context>stream</context>
@@ -169,6 +170,13 @@
 </example>
 </para>
 
+<para id="log_format_escape">
+Параметр <literal>escape</literal> (1.11.8) позволяет задать
+экранирование символов <value>json</value> или <value>default</value>
+в переменных,
+по умолчанию используется <value>default</value>.
+</para>
+
 </directive>