comparison xml/ru/docs/http/ngx_http_upstream_module.xml @ 1391:0702cc081c63

Revised descriptions of upstream module variables.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 19 Jan 2015 15:23:46 +0300
parents d796c95f0922
children 82e62822abe8
comparison
equal deleted inserted replaced
1390:d7cb4dcc1c3e 1391:0702cc081c63
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_upstream_module" 10 <module name="Модуль ngx_http_upstream_module"
11 link="/ru/docs/http/ngx_http_upstream_module.html" 11 link="/ru/docs/http/ngx_http_upstream_module.html"
12 lang="ru" 12 lang="ru"
13 rev="30"> 13 rev="31">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_upstream_module</literal> 18 Модуль <literal>ngx_http_upstream_module</literal>
1296 поддерживает следующие встроенные переменные: 1296 поддерживает следующие встроенные переменные:
1297 <list type="tag"> 1297 <list type="tag">
1298 1298
1299 <tag-name id="var_upstream_addr"><var>$upstream_addr</var></tag-name> 1299 <tag-name id="var_upstream_addr"><var>$upstream_addr</var></tag-name>
1300 <tag-desc> 1300 <tag-desc>
1301 хранит IP-адрес и порт сервера или путь к UNIX-сокету. 1301 хранит IP-адрес и порт или путь к UNIX-сокету сервера группы.
1302 Если при обработке запроса были сделаны обращения к нескольким серверам, 1302 Если при обработке запроса были сделаны обращения к нескольким серверам,
1303 то их адреса разделяются запятой, например, 1303 то их адреса разделяются запятой, например,
1304 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock</literal>”. 1304 “<literal>192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock</literal>”.
1305 Если произошло внутреннее перенаправление от одной группы серверов на другую 1305 Если произошло внутреннее перенаправление от одной группы серверов на другую
1306 с помощью 1306 с помощью
1319 “<literal>BYPASS</literal>”, “<literal>EXPIRED</literal>”, 1319 “<literal>BYPASS</literal>”, “<literal>EXPIRED</literal>”,
1320 “<literal>STALE</literal>”, “<literal>UPDATING</literal>”, 1320 “<literal>STALE</literal>”, “<literal>UPDATING</literal>”,
1321 “<literal>REVALIDATED</literal>” или “<literal>HIT</literal>”. 1321 “<literal>REVALIDATED</literal>” или “<literal>HIT</literal>”.
1322 </tag-desc> 1322 </tag-desc>
1323 1323
1324 <tag-name id="var_upstream_cookie_"><var>$upstream_cookie_</var><value>имя</value></tag-name> 1324 <tag-name id="var_upstream_cookie_"><var>$upstream_cookie_</var><value>имя</value>
1325 </tag-name>
1325 <tag-desc> 1326 <tag-desc>
1326 кука с указанным <value>именем</value>, переданная сервером группы 1327 кука с указанным <value>именем</value>, переданная сервером группы
1327 в поле <header>Set-Cookie</header> заголовка ответа (1.7.1). 1328 в поле <header>Set-Cookie</header> заголовка ответа (1.7.1).
1328 Необходимо иметь в виду, что запоминаются поля заголовка только из ответа 1329 Необходимо иметь в виду, что куки запоминаются только из ответа
1329 последнего сервера. 1330 последнего сервера.
1330 </tag-desc> 1331 </tag-desc>
1331 1332
1332 <tag-name id="var_upstream_response_length"><var>$upstream_response_length</var> 1333 <tag-name id="var_upstream_response_length"><var>$upstream_response_length</var>
1333 </tag-name> 1334 </tag-name>
1334 <tag-desc> 1335 <tag-desc>
1335 хранит длины ответов, полученных от серверов группы (0.7.27); 1336 хранит длину ответа, полученного от сервера группы (0.7.27);
1336 длины хранятся в байтах. 1337 длина хранится в байтах.
1337 Длины нескольких ответов разделяются запятыми и двоеточиями 1338 Длины нескольких ответов
1338 подобно адресам в переменной <var>$upstream_addr</var>. 1339 разделяются запятыми и двоеточиями подобно адресам в переменной
1340 <link id="var_upstream_addr">$upstream_addr</link>.
1339 </tag-desc> 1341 </tag-desc>
1340 1342
1341 <tag-name id="var_upstream_response_time"><var>$upstream_response_time</var> 1343 <tag-name id="var_upstream_response_time"><var>$upstream_response_time</var>
1342 </tag-name> 1344 </tag-name>
1343 <tag-desc> 1345 <tag-desc>
1344 хранит времена ответов, полученных от серверов группы; 1346 хранит время, затраченное на получение ответа от сервера группы;
1345 времена хранятся в секундах с точностью до миллисекунд. 1347 время хранится в секундах с точностью до миллисекунд.
1346 Времена нескольких ответов разделяются запятыми и двоеточиями 1348 Времена нескольких ответов
1347 подобно адресам в переменной <var>$upstream_addr</var>. 1349 разделяются запятыми и двоеточиями подобно адресам в переменной
1350 <link id="var_upstream_addr">$upstream_addr</link>.
1348 </tag-desc> 1351 </tag-desc>
1349 1352
1350 <tag-name id="var_upstream_status"><var>$upstream_status</var></tag-name> 1353 <tag-name id="var_upstream_status"><var>$upstream_status</var></tag-name>
1351 <tag-desc> 1354 <tag-desc>
1352 хранит коды ответов, полученных от серверов группы. 1355 хранит статус ответа, полученного от сервера группы.
1353 Коды нескольких ответов разделяются запятыми и двоеточиями 1356 Статусы нескольких ответов
1354 подобно адресам в переменной <var>$upstream_addr</var>. 1357 разделяются запятыми и двоеточиями подобно адресам в переменной
1358 <link id="var_upstream_addr">$upstream_addr</link>.
1355 </tag-desc> 1359 </tag-desc>
1356 1360
1357 <tag-name id="var_upstream_http_"><var>$upstream_http_</var><value>имя</value></tag-name> 1361 <tag-name id="var_upstream_http_"><var>$upstream_http_</var><value>имя</value></tag-name>
1358 <tag-desc> 1362 <tag-desc>
1359 хранят поля заголовка ответа сервера. 1363 хранят поля заголовка ответа сервера.
1360 Например, поле заголовка ответа <header>Server</header> 1364 Например, поле заголовка ответа <header>Server</header>
1361 доступно в переменной <var>$upstream_http_server</var>. 1365 доступно в переменной <var>$upstream_http_server</var>.
1362 Правила преобразования имён полей заголовка ответа в имена переменных 1366 Правила преобразования имён полей заголовка ответа в имена переменных
1363 такие же, как для переменных с префиксом 1367 такие же, как для переменных с префиксом
1364 “<link doc="ngx_http_core_module.xml" id="variables">$http_</link>”. 1368 “<link doc="ngx_http_core_module.xml" id="var_http_">$http_</link>”.
1365 Необходимо иметь в виду, что запоминаются поля заголовка только из ответа 1369 Необходимо иметь в виду, что поля заголовка запоминаются только из ответа
1366 последнего сервера. 1370 последнего сервера.
1367 </tag-desc> 1371 </tag-desc>
1368 1372
1369 </list> 1373 </list>
1370 </para> 1374 </para>