Mercurial > hg > nginx-site
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>