Mercurial > hg > nginx-site
changeset 731:f62328124e5b
Documented $upstream_cache_status and $upstream_response_length variables.
author | Vladimir Homutov <vl@nginx.com> |
---|---|
date | Tue, 16 Oct 2012 07:36:26 +0000 |
parents | 76e876c58dc0 |
children | cea4732f6843 |
files | xml/en/docs/http/ngx_http_upstream_module.xml xml/ru/docs/http/ngx_http_upstream_module.xml |
diffstat | 2 files changed, 57 insertions(+), 11 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_upstream_module.xml Mon Oct 15 09:20:33 2012 +0000 +++ b/xml/en/docs/http/ngx_http_upstream_module.xml Tue Oct 16 07:36:26 2012 +0000 @@ -10,7 +10,7 @@ <module name="Module ngx_http_upstream_module" link="/en/docs/http/ngx_http_upstream_module.html" lang="en" - rev="1"> + rev="2"> <section id="summary"> @@ -391,16 +391,36 @@ “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80</literal>”. </tag-desc> +<tag-name><var>$upstream_cache_status</var></tag-name> +<tag-desc> +keeps status of accessing a response cache (0.8.3). +The status can be one of “<literal>MISS</literal>”, +“<literal>BYPASS</literal>”, “<literal>EXPIRED</literal>”, +“<literal>STALE</literal>”, “<literal>UPDATING</literal>” or +“<literal>HIT</literal>”. +</tag-desc> + +<tag-name><var>$upstream_response_length</var></tag-name> +<tag-desc> +keeps lengths of responses obtained from upstream servers (0.7.27); +lengths are kept in bytes. +Several responses are separated by commas and colons +like in the <var>$upstream_addr</var> variable. +</tag-desc> + <tag-name><var>$upstream_response_time</var></tag-name> <tag-desc> -keeps servers response times in seconds with a milliseconds resolution. -Several responses are also separated by commas and colons. +keeps times of responses obtained from upstream servers; +times are kept in seconds with a milliseconds resolution. +Several responses are separated by commas and colons +like in the <var>$upstream_addr</var> variable. </tag-desc> <tag-name><var>$upstream_status</var></tag-name> <tag-desc> -keeps servers response codes. -Several responses are also separated by commas and colons. +keeps codes of responses obtained from upstream servers. +Several responses are separated by commas and colons +like in the <var>$upstream_addr</var> variable. </tag-desc> <tag-name><var>$upstream_http_...</var></tag-name> @@ -408,7 +428,10 @@ keep server response header fields. For example, the <header>Server</header> response header field is made available through the <var>$upstream_http_server</var> variable. -Note that only the last server’s response header fields are saved. +The rules of converting header field names to variable names are the same +as for variables starting with the +“<link doc="ngx_http_core_module.xml" id="variables">$http_</link>” prefix. +Only the last server’s response header fields are saved. </tag-desc> </list>
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml Mon Oct 15 09:20:33 2012 +0000 +++ b/xml/ru/docs/http/ngx_http_upstream_module.xml Tue Oct 16 07:36:26 2012 +0000 @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_upstream_module" link="/ru/docs/http/ngx_http_upstream_module.html" lang="ru" - rev="1"> + rev="2"> <section id="summary"> @@ -392,16 +392,36 @@ “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80</literal>”. </tag-desc> +<tag-name><var>$upstream_cache_status</var></tag-name> +<tag-desc> +хранит статус доступа к кэшу ответов (0.8.3). +Статус может быть одним из “<literal>MISS</literal>”, +“<literal>BYPASS</literal>”, “<literal>EXPIRED</literal>”, +“<literal>STALE</literal>”, “<literal>UPDATING</literal>” или +“<literal>HIT</literal>”. +</tag-desc> + +<tag-name><var>$upstream_response_length</var></tag-name> +<tag-desc> +хранит длины ответов, полученных от серверов группы (0.7.27); +длины хранятся в байтах. +Несколько ответов разделяются запятыми и двоеточиями, +подобно переменной <var>$upstream_addr</var>. +</tag-desc> + <tag-name><var>$upstream_response_time</var></tag-name> <tag-desc> -хранит времена ответов серверов в секундах с точностью до миллисекунд. -Несколько ответов также разделяются запятыми и двоеточиями. +хранит времена ответов, полученных от серверов группы; +времена хранятся в секундах с точностью до миллисекунд. +Несколько ответов разделяются запятыми и двоеточиями, +подобно переменной <var>$upstream_addr</var>. </tag-desc> <tag-name><var>$upstream_status</var></tag-name> <tag-desc> -хранит коды ответов серверов. -Несколько ответов также разделяются запятыми и двоеточиями. +хранит коды ответов, полученных от серверов группы. +Несколько ответов разделяются запятыми и двоеточиями, +подобно переменной <var>$upstream_addr</var>. </tag-desc> <tag-name><var>$upstream_http_...</var></tag-name> @@ -409,6 +429,9 @@ хранят поля заголовка ответа сервера. Например, поле заголовка ответа <header>Server</header> доступно в переменной <var>$upstream_http_server</var>. +Правила преобразования имён полей заголовка ответа в имена переменных +такие же, как для переменных с префиксом +“<link doc="ngx_http_core_module.xml" id="variables">$http_</link>”. Необходимо иметь в виду, что запоминаются только поля заголовка ответа последнего сервера. </tag-desc>