diff xml/en/docs/http/ngx_http_upstream_module.xml @ 2139:f6e578b1b02d

Updated docs for the upcoming NGINX Plus release.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 09 Apr 2018 11:52:48 +0300
parents 4cafd82e5007
children 2c56f91c304a
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_upstream_module.xml	Thu Apr 05 16:14:30 2018 +0000
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml	Mon Apr 09 11:52:48 2018 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="69">
+        rev="70">
 
 <section id="summary">
 
@@ -820,7 +820,8 @@
     <literal>lookup=</literal><value>$variable</value>
     <literal>zone=</literal><value>name</value>:<value>size</value>
     [<literal>timeout=</literal><value>time</value>]
-    [<literal>header</literal>]</syntax>
+    [<literal>header</literal>]
+    [<literal>sync</literal>]</syntax>
 <default/>
 <context>upstream</context>
 <appeared-in>1.5.7</appeared-in>
@@ -1000,7 +1001,7 @@
 <para>
 Sessions are stored in a shared memory zone, whose <value>name</value> and
 <value>size</value> are configured by the <literal>zone</literal> parameter.
-One megabyte zone can store about 8000 sessions on the 64-bit platform.
+One megabyte zone can store about 4000 sessions on the 64-bit platform.
 The sessions that are not accessed during the time specified by the
 <literal>timeout</literal> parameter get removed from the zone.
 By default, <literal>timeout</literal> is set to 10 minutes.
@@ -1011,6 +1012,12 @@
 right after receiving response headers from the upstream server.
 </para>
 
+<para id="sticky_learn_sync">
+The <literal>sync</literal> parameter (1.13.8) enables
+<link doc="../stream/ngx_stream_zone_sync_module.xml" id="zone_sync">synchronization</link>
+of the shared memory zone.
+</para>
+
 </tag-desc>
 </list>
 </para>
@@ -1133,6 +1140,16 @@
 Only the header fields from the response of the last server are saved.
 </tag-desc>
 
+<tag-name id="var_upstream_queue_time"><var>$upstream_queue_time</var></tag-name>
+<tag-desc>
+keeps time the request spent in the upstream <link id="queue">queue</link>
+(1.13.9);
+the time is kept in seconds with millisecond resolution.
+Times of several responses
+are separated by commas and colons like addresses in the
+<link id="var_upstream_addr">$upstream_addr</link> variable.
+</tag-desc>
+
 <tag-name id="var_upstream_response_length"><var>$upstream_response_length</var>
 </tag-name>
 <tag-desc>