changeset 942:ba3d6ade3513

Elaborate on upstream server failures. Documented that {proxy,fastcgi,memcached}_next_upstream directives define what is considered an unsuccessful attempt of communication with a server.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 05 Jul 2013 10:40:38 +0400
parents 7d1d53d4d293
children 888b1074b39f
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/en/docs/http/ngx_http_memcached_module.xml xml/en/docs/http/ngx_http_proxy_module.xml xml/en/docs/http/ngx_http_upstream_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_memcached_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_upstream_module.xml
diffstat 8 files changed, 83 insertions(+), 15 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="8">
+        rev="9">
 
 <section id="summary">
 
@@ -695,6 +695,19 @@
 transferring a response, fixing this is impossible.
 </para>
 
+<para>
+The directive also defines what is considered an unsuccessful attempt
+of communication with a
+<link doc="ngx_http_upstream_module.xml" id="server"/>.
+The cases of <literal>error</literal>, <literal>timeout</literal> and
+<literal>invalid_header</literal> are always considered unsuccessful attempts,
+even if they are not specified in the directive.
+The cases of <literal>http_500</literal> and <literal>http_503</literal> are
+considered unsuccessful attempts only if they are specified in the directive.
+The cases of <literal>http_403</literal> and <literal>http_404</literal>
+are never considered unsuccessful attempts.
+</para>
+
 </directive>
 
 
--- a/xml/en/docs/http/ngx_http_memcached_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/en/docs/http/ngx_http_memcached_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_memcached_module"
         link="/en/docs/http/ngx_http_memcached_module.html"
         lang="en"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -162,6 +162,17 @@
 transferring a response, fixing this is impossible.
 </para>
 
+<para>
+The directive also defines what is considered an unsuccessful attempt
+of communication with a
+<link doc="ngx_http_upstream_module.xml" id="server"/>.
+The cases of <literal>error</literal>, <literal>timeout</literal> and
+<literal>invalid_header</literal> are always considered unsuccessful attempts,
+even if they are not specified in the directive.
+The case of <literal>not_found</literal>
+is never considered an unsuccessful attempt.
+</para>
+
 </directive>
 
 
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -883,6 +883,20 @@
 transferring a response, fixing this is impossible.
 </para>
 
+<para>
+The directive also defines what is considered an unsuccessful attempt
+of communication with a
+<link doc="ngx_http_upstream_module.xml" id="server"/>.
+The cases of <literal>error</literal>, <literal>timeout</literal> and
+<literal>invalid_header</literal> are always considered unsuccessful attempts,
+even if they are not specified in the directive.
+The cases of <literal>http_500</literal>, <literal>http_502</literal>,
+<literal>http_503</literal> and <literal>http_504</literal> are
+considered unsuccessful attempts only if they are specified in the directive.
+The cases of <literal>http_403</literal> and <literal>http_404</literal>
+are never considered unsuccessful attempts.
+</para>
+
 </directive>
 
 
--- a/xml/en/docs/http/ngx_http_upstream_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/en/docs/http/ngx_http_upstream_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_upstream_module"
         link="/en/docs/http/ngx_http_upstream_module.html"
         lang="en"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -123,14 +123,11 @@
 by the <literal>fail_timeout</literal> parameter.
 By default, the number of unsuccessful attempts is set to 1.
 A value of zero disables accounting of attempts.
-What is considered to be an unsuccessful attempt is configured by the
+What is considered an unsuccessful attempt is defined by the
 <link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/>, and
 <link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/>
 directives.
-The <literal>http_403</literal>, <literal>http_404</literal>,
-and <literal>not_found</literal> states are not considered as
-unsuccessful attempts.
 </tag-desc>
 
 <tag-name><literal>fail_timeout</literal>=<value>time</value></tag-name>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="8">
+        rev="9">
 
 <section id="summary">
 
@@ -692,6 +692,18 @@
 то исправить это уже невозможно.
 </para>
 
+<para>
+Директива также определяет, что считается неудачной попыткой работы с
+<link doc="ngx_http_upstream_module.xml" id="server">сервером</link>.
+Случаи <literal>error</literal>, <literal>timeout</literal> и
+<literal>invalid_header</literal>
+всегда считаются неудачными попытками, даже если они не указаны в директиве.
+Случаи <literal>http_500</literal> и <literal>http_503</literal>
+считаются неудачными попытками, только если они указаны в директиве.
+Случаи <literal>http_403</literal> и <literal>http_404</literal>
+никогда не считаются неудачными попытками.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_memcached_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/ru/docs/http/ngx_http_memcached_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_memcached_module"
         link="/ru/docs/http/ngx_http_memcached_module.html"
         lang="ru"
-        rev="5">
+        rev="6">
 
 <section id="summary">
 
@@ -161,6 +161,16 @@
 то исправить это уже невозможно.
 </para>
 
+<para>
+Директива также определяет, что считается неудачной попыткой работы с
+<link doc="ngx_http_upstream_module.xml" id="server">сервером</link>.
+Случаи <literal>error</literal>, <literal>timeout</literal> и
+<literal>invalid_response</literal>
+всегда считаются неудачными попытками, даже если они не указаны в директиве.
+Случай <literal>not_found</literal>
+никогда не считается неудачной попыткой.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -880,6 +880,19 @@
 то исправить это уже невозможно.
 </para>
 
+<para>
+Директива также определяет, что считается неудачной попыткой работы с
+<link doc="ngx_http_upstream_module.xml" id="server">сервером</link>.
+Случаи <literal>error</literal>, <literal>timeout</literal> и
+<literal>invalid_header</literal>
+всегда считаются неудачными попытками, даже если они не указаны в директиве.
+Случаи <literal>http_500</literal>, <literal>http_502</literal>,
+<literal>http_503</literal> и <literal>http_504</literal>
+считаются неудачными попытками, только если они указаны в директиве.
+Случаи <literal>http_403</literal> и <literal>http_404</literal>
+никогда не считаются неудачными попытками.
+</para>
+
 </directive>
 
 
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml	Fri Jul 05 08:11:37 2013 +0400
+++ b/xml/ru/docs/http/ngx_http_upstream_module.xml	Fri Jul 05 10:40:38 2013 +0400
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_upstream_module"
         link="/ru/docs/http/ngx_http_upstream_module.html"
         lang="ru"
-        rev="3">
+        rev="4">
 
 <section id="summary">
 
@@ -125,12 +125,10 @@
 заданного параметром <literal>fail_timeout</literal>.
 По умолчанию число попыток устанавливается равным 1.
 Нулевое значение запрещает учёт попыток.
-Что считается неудачной попыткой, задаётся директивами
+Что считается неудачной попыткой, определяется директивами
 <link doc="ngx_http_proxy_module.xml" id="proxy_next_upstream"/>,
 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_next_upstream"/> и
 <link doc="ngx_http_memcached_module.xml" id="memcached_next_upstream"/>.
-Состояния <literal>http_403</literal>, <literal>http_404</literal>
-и <literal>not_found</literal> не считаются неудачными попытками.
 </tag-desc>
 
 <tag-name><literal>fail_timeout</literal>=<value>время</value></tag-name>