changeset 2451:721f78cff4ef

Documented resolver statistics for stream and mail.
author Yaroslav Zhuravlev <yar@nginx.com>
date Tue, 29 Oct 2019 19:19:25 +0300
parents a26a42699207
children 4487310de7e7
files xml/en/docs/mail/ngx_mail_core_module.xml xml/en/docs/stream/ngx_stream_core_module.xml xml/ru/docs/mail/ngx_mail_core_module.xml xml/ru/docs/stream/ngx_stream_core_module.xml
diffstat 4 files changed, 60 insertions(+), 10 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/mail/ngx_mail_core_module.xml
+++ b/xml/en/docs/mail/ngx_mail_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_mail_core_module"
         link="/en/docs/mail/ngx_mail_core_module.html"
         lang="en"
-        rev="10">
+        rev="11">
 
 <section id="summary">
 
@@ -283,8 +283,9 @@ parameters <literal>--without-mail_imap_
 
 <directive name="resolver">
 <syntax>
-<value>address</value> ...
-[<literal>valid</literal>=<value>time</value>]</syntax>
+    <value>address</value> ...
+    [<literal>valid</literal>=<value>time</value>]
+    [<literal>status_zone</literal>=<value>zone</value>]</syntax>
 <syntax><literal>off</literal></syntax>
 <default>off</default>
 <context>mail</context>
@@ -321,6 +322,16 @@ and nginx always cached answers for the 
 </note>
 </para>
 
+<para id="resolver_status_zone">
+The optional <literal>status_zone</literal> parameter (1.17.1)
+enables
+<link doc="../http/ngx_http_api_module.xml" id="resolvers_">collection</link>
+of DNS server statistics of requests and responses
+in the specified <value>zone</value>.
+The parameter is available as part of our
+<commercial_version>commercial subscription</commercial_version>.
+</para>
+
 <para>
 The special value <literal>off</literal> disables resolving.
 </para>
--- a/xml/en/docs/stream/ngx_stream_core_module.xml
+++ b/xml/en/docs/stream/ngx_stream_core_module.xml
@@ -9,7 +9,7 @@
 <module name="Module ngx_stream_core_module"
         link="/en/docs/stream/ngx_stream_core_module.html"
         lang="en"
-        rev="27">
+        rev="28">
 
 <section id="summary">
 
@@ -320,7 +320,8 @@ the connection is closed.
 <syntax>
     <value>address</value> ...
     [<literal>valid</literal>=<value>time</value>]
-    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]</syntax>
+    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>status_zone</literal>=<value>zone</value>]</syntax>
 <default/>
 <context>stream</context>
 <context>server</context>
@@ -350,6 +351,19 @@ The optional <literal>valid</literal> pa
 <example>
 resolver 127.0.0.1 [::1]:5353 valid=30s;
 </example>
+</para>
+
+<para id="resolver_status_zone">
+The optional <literal>status_zone</literal> parameter (1.17.1)
+enables
+<link doc="../http/ngx_http_api_module.xml" id="resolvers_">collection</link>
+of DNS server statistics of requests and responses
+in the specified <value>zone</value>.
+The parameter is available as part of our
+<commercial_version>commercial subscription</commercial_version>.
+</para>
+
+<para>
 <note>
 Before version 1.11.3, this directive was available as part of our
 <commercial_version>commercial subscription</commercial_version>.
--- a/xml/ru/docs/mail/ngx_mail_core_module.xml
+++ b/xml/ru/docs/mail/ngx_mail_core_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_mail_core_module"
         link="/ru/docs/mail/ngx_mail_core_module.html"
         lang="ru"
-        rev="10">
+        rev="11">
 
 <section id="summary">
 
@@ -285,8 +285,9 @@ FreeBSD 9.0-STABLE)
 
 <directive name="resolver">
 <syntax>
-<value>адрес</value> ...
-[<literal>valid</literal>=<value>время</value>]</syntax>
+    <value>адрес</value> ...
+    [<literal>valid</literal>=<value>time</value>]
+    [<literal>status_zone</literal>=<value>зона</value>]</syntax>
 <syntax><literal>off</literal></syntax>
 <default>off</default>
 <context>mail</context>
@@ -324,6 +325,16 @@ resolver 127.0.0.1 [::1]:5353 valid=30s;
 </note>
 </para>
 
+<para id="resolver_status_zone">
+Необязательный параметр <literal>status_zone</literal> (1.17.1)
+включает
+<link doc="../http/ngx_http_api_module.xml" id="resolvers_">сбор информации</link>
+о запросах и ответах сервера DNS
+в указанной <value>зоне</value>.
+Параметр доступен как часть
+<commercial_version>коммерческой подписки</commercial_version>.
+</para>
+
 <para>
 Специальное значение <literal>off</literal> запрещает использование DNS.
 </para>
--- a/xml/ru/docs/stream/ngx_stream_core_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_core_module.xml
@@ -9,7 +9,7 @@
 <module name="Модуль ngx_stream_core_module"
         link="/ru/docs/stream/ngx_stream_core_module.html"
         lang="ru"
-        rev="27">
+        rev="28">
 
 <section id="summary">
 
@@ -325,7 +325,8 @@ FreeBSD 9.0-STABLE)
 <syntax>
     <value>адрес</value> ...
     [<literal>valid</literal>=<value>время</value>]
-    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]</syntax>
+    [<literal>ipv6</literal>=<literal>on</literal>|<literal>off</literal>]
+    [<literal>status_zone</literal>=<value>зона</value>]</syntax>
 <default/>
 <context>stream</context>
 <context>server</context>
@@ -357,6 +358,19 @@ resolver 127.0.0.1 [::1]:5353;
 <example>
 resolver 127.0.0.1 [::1]:5353 valid=30s;
 </example>
+</para>
+
+<para id="resolver_status_zone">
+Необязательный параметр <literal>status_zone</literal> (1.17.1)
+включает
+<link doc="../http/ngx_http_api_module.xml" id="resolvers_">сбор информации</link>
+о запросах и ответах сервера DNS
+в указанной <value>зоне</value>.
+Параметр доступен как часть
+<commercial_version>коммерческой подписки</commercial_version>.
+</para>
+
+<para>
 <note>
 До версии 1.11.3 эта директива была доступна как часть
 <commercial_version>коммерческой подписки</commercial_version>.