changeset 1728:f93a5aadad2c

Translated the stream upstream module into Russian.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 11 Jun 2015 19:06:06 +0300
parents 1a16dce51bce
children 8da2ab346a71
files xml/ru/GNUmakefile xml/ru/docs/index.xml xml/ru/docs/stream/ngx_stream_upstream_module.xml
diffstat 3 files changed, 261 insertions(+), 257 deletions(-) [+]
line wrap: on
line diff
--- a/xml/ru/GNUmakefile
+++ b/xml/ru/GNUmakefile
@@ -88,6 +88,7 @@ REFS =									\
 		stream/ngx_stream_limit_conn_module			\
 		stream/ngx_stream_proxy_module				\
 		stream/ngx_stream_ssl_module				\
+		stream/ngx_stream_upstream_module			\
 
 TOP =									\
 		download						\
--- a/xml/ru/docs/index.xml
+++ b/xml/ru/docs/index.xml
@@ -511,8 +511,8 @@ ngx_stream_ssl_module</link>
 </listitem>
 
 <listitem>
-<link doc="../../en/docs/stream/ngx_stream_upstream_module.xml">
-ngx_stream_upstream_module</link> [en]
+<link doc="stream/ngx_stream_upstream_module.xml">
+ngx_stream_upstream_module</link>
 </listitem>
 
 </list>
copy from xml/en/docs/stream/ngx_stream_upstream_module.xml
copy to xml/ru/docs/stream/ngx_stream_upstream_module.xml
--- a/xml/en/docs/stream/ngx_stream_upstream_module.xml
+++ b/xml/ru/docs/stream/ngx_stream_upstream_module.xml
@@ -6,24 +6,24 @@
 
 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
 
-<module name="Module ngx_stream_upstream_module"
-        link="/en/docs/stream/ngx_stream_upstream_module.html"
-        lang="en"
+<module name="Модуль ngx_stream_upstream_module"
+        link="/ru/docs/stream/ngx_stream_upstream_module.html"
+        lang="ru"
         rev="13">
 
 <section id="summary">
 
 <para>
-The <literal>ngx_stream_upstream_module</literal> module (1.9.0)
-is used to define groups of servers that can be referenced
-by the <link doc="ngx_stream_proxy_module.xml" id="proxy_pass"/>
-directive.
+Модуль <literal>ngx_stream_upstream_module</literal> (1.9.0)
+позволяет описывать группы серверов,
+которые могут использоваться в директиве
+<link doc="ngx_stream_proxy_module.xml" id="proxy_pass"/>.
 </para>
 
 </section>
 
 
-<section id="example" name="Example Configuration">
+<section id="example" name="Пример конфигурации">
 
 <para>
 <example>
@@ -46,9 +46,9 @@ server {
 </para>
 
 <para>
-Dynamically configurable group,
-available as part of our
-<commercial_version>commercial subscription</commercial_version>:
+Динамически настраиваемая группа,
+доступна как часть
+<commercial_version>коммерческой подписки</commercial_version>:
 <example>
 resolver 10.0.0.1;
 
@@ -76,22 +76,22 @@ server {
 </section>
 
 
-<section id="directives" name="Directives">
+<section id="directives" name="Директивы">
 
 <directive name="upstream">
-<syntax block="yes"><value>name</value></syntax>
+<syntax block="yes"><value>название</value></syntax>
 <default/>
 <context>stream</context>
 
 <para>
-Defines a group of servers.
-Servers can listen on different ports.
-In addition, servers listening on TCP and UNIX-domain sockets
-can be mixed.
+Описывает группу серверов.
+Серверы могут слушать на разных портах.
+Кроме того, можно одновременно использовать серверы,
+слушающие на TCP- и UNIX-сокетах.
 </para>
 
 <para>
-Example:
+Пример:
 <example>
 upstream backend {
     server backend1.example.com:12345 weight=5;
@@ -105,129 +105,128 @@ upstream backend {
 </para>
 
 <para>
-By default, connections are distributed between the servers using a
-weighted round-robin balancing method.
-In the above example, each 7 connections will be distributed as follows:
-5 connections go to <literal>backend1.example.com:12345</literal>
-and one connection to each of the second and third servers.
-If an error occurs during communication with a server, the connection will
-be passed to the next server, and so on until all of the functioning
-servers will be tried.
-If communication with all servers fails, the connection will be closed.
+По умолчанию соединения распределяются по серверам циклически
+(в режиме round-robin) с учётом весов серверов.
+В вышеприведённом примере каждые 7 соединений будут распределены так:
+5 соединений на <literal>backend1.example.com:12345</literal>
+и по одному соединению на второй и третий серверы.
+Если при попытке работы с сервером происходит ошибка, то соединение
+передаётся следующему серверу, и так далее до тех пор, пока не будут опробованы
+все работающие серверы.
+Если связь с серверами не удалась, соединение будет закрыто.
 </para>
 
 </directive>
 
 
 <directive name="server">
-<syntax><value>address</value> [<value>parameters</value>]</syntax>
+<syntax><value>адрес</value> [<value>параметры</value>]</syntax>
 <default/>
 <context>upstream</context>
 
 <para>
-Defines the <value>address</value> and other <value>parameters</value>
-of a server.
-The address can be specified as a domain name or IP address
-with an obligatory port, or as a UNIX-domain socket path
-specified after the “<literal>unix:</literal>” prefix.
-A domain name that resolves to several IP addresses defines
-multiple servers at once.
+Задаёт <value>адрес</value> и другие <value>параметры</value>
+сервера.
+Адрес может быть указан в виде доменного имени или IP-адреса,
+и обязательного порта, или в виде пути UNIX-сокета, который
+указывается после префикса “<literal>unix:</literal>”.
+Доменное имя, которому соответствует несколько IP-адресов,
+задаёт сразу несколько серверов.
 </para>
 
 <para>
-The following parameters can be defined:
+Могут быть заданы следующие параметры:
 <list type="tag">
 
 <tag-name id="weight">
-<literal>weight</literal>=<value>number</value>
+<literal>weight</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-sets the weight of the server, by default, 1.
+задаёт вес сервера, по умолчанию 1.
 </tag-desc>
 
 <tag-name id="max_fails">
-<literal>max_fails</literal>=<value>number</value>
+<literal>max_fails</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-sets the number of unsuccessful attempts to communicate with the server
-that should happen in the duration set by the <literal>fail_timeout</literal>
-parameter to consider the server unavailable for a duration also set by the
-<literal>fail_timeout</literal> parameter.
-By default, the number of unsuccessful attempts is set to 1.
-The zero value disables the accounting of attempts.
-Here, an unsuccessful attempt is an error or timeout
-while establishing a connection with the server.
+задаёт число неудачных попыток работы с сервером, которые должны произойти
+в течение времени, заданного параметром <literal>fail_timeout</literal>,
+чтобы сервер считался недоступным на период времени, также заданный
+параметром <literal>fail_timeout</literal>.
+По умолчанию число попыток устанавливается равным 1.
+Нулевое значение отключает учёт попыток.
+В данном случае неудачной попыткой считается ошибка или таймаут
+при установке соединения с сервером.
 </tag-desc>
 
 <tag-name id="fail_timeout">
-<literal>fail_timeout</literal>=<value>time</value>
+<literal>fail_timeout</literal>=<value>время</value>
 </tag-name>
 <tag-desc>
-sets
+задаёт
 <list type="bullet">
 
 <listitem>
-the time during which the specified number of unsuccessful attempts to
-communicate with the server should happen to consider the server unavailable;
+время, в течение которого должно произойти заданное число неудачных
+попыток работы с сервером для того, чтобы сервер считался недоступным;
 </listitem>
 
 <listitem>
-and the period of time the server will be considered unavailable.
+и время, в течение которого сервер будет считаться недоступным.
 </listitem>
 
 </list>
-By default, the parameter is set to 10 seconds.
+По умолчанию параметр равен 10 секундам.
 </tag-desc>
 
 <tag-name id="backup">
 <literal>backup</literal>
 </tag-name>
 <tag-desc>
-marks the server as a backup server.
-Connections to the backup server will be passed
-when the primary servers are unavailable.
+помечает сервер как запасной сервер.
+На него будут передаваться соединения в случае,
+если не работают основные серверы.
 </tag-desc>
 
 <tag-name id="down">
 <literal>down</literal>
 </tag-name>
 <tag-desc>
-marks the server as permanently unavailable.
+помечает сервер как постоянно недоступный.
 </tag-desc>
 
 </list>
 </para>
 
 <para>
-Additionally,
-the following parameters are available as part of our
-<commercial_version>commercial subscription</commercial_version>:
+Кроме того,
+следующие параметры доступны как часть
+<commercial_version>коммерческой подписки</commercial_version>:
 <list type="tag">
 
 <tag-name id="max_conns">
-<literal>max_conns</literal>=<value>number</value>
+<literal>max_conns</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-limits the maximum <value>number</value> of simultaneous connections to the
-proxied server.
-Default value is zero, meaning there is no limit.
+ограничивает максимальное <value>число</value> одновременных
+соединений к проксируемому серверу.
+Значение по умолчанию равно 0 и означает, что ограничения нет.
 </tag-desc>
 
 <tag-name id="resolve">
 <literal>resolve</literal>
 </tag-name>
 <tag-desc>
-monitors changes of the IP addresses
-that correspond to a domain name of the server,
-and automatically modifies the upstream configuration
-without the need of restarting nginx.
-The server group must reside in the <link id="zone">shared memory</link>.
+отслеживает изменения IP-адресов, соответствующих доменному имени сервера,
+и автоматически изменяет конфигурацию группы
+без необходимости перезапуска nginx.
+Группа должна находиться в <link id="zone">зоне разделяемой памяти</link>.
 <para>
-In order for this parameter to work,
-the <link doc="ngx_stream_core_module.xml" id="resolver"/> directive
-must be specified in the
-<link doc="ngx_stream_core_module.xml" id="stream"/> block.
-Example:
+Для работы этого параметра
+директива <link doc="ngx_stream_core_module.xml" id="resolver"/>
+должна быть задана в блоке
+<link doc="ngx_stream_core_module.xml" id="stream"/>.
+Пример:
 <example>
 stream {
     resolver 10.0.0.1;
@@ -243,31 +242,32 @@ stream {
 </tag-desc>
 
 <tag-name id="service">
-<literal>service</literal>=<value>name</value>
+<literal>service</literal>=<value>имя</value>
 </tag-name>
 <tag-desc>
-enables resolving of DNS
-<link url="https://tools.ietf.org/html/rfc2782">SRV</link>
-records and sets the service <value>name</value> (1.9.13).
-In order for this parameter to work, it is necessary to specify
-the <link id="resolve"/> parameter for the server
-and specify a hostname without a port number.
+включает преобразование
+<link url="https://tools.ietf.org/html/rfc2782">SRV</link>-записей
+DNS и задаёт <value>имя</value> сервиса (1.9.13).
+Для работы параметра необходимо указать
+параметр <link id="resolve"/> для сервера
+и не указывать порт сервера.
 <para>
-If the service name does not contain a dot (“<literal>.</literal>”), then
-the <link url="https://tools.ietf.org/html/rfc2782">RFC</link>-compliant name
-is constructed
-and the TCP protocol is added to the service prefix.
-For example, to look up the
-<literal>_http._tcp.backend.example.com</literal> SRV record,
-it is necessary to specify the directive:
+Если имя сервиса не содержит точку (“<literal>.</literal>”), то
+имя составляется в соответствии с
+<link url="https://tools.ietf.org/html/rfc2782">RFC</link>
+и в префикс службы добавляется протокол TCP.
+Например, для получения
+SRV-записи <literal>_http._tcp.backend.example.com</literal>
+необходимо указать директиву:
 <example>
 server backend.example.com service=http resolve;
 </example>
-If the service name contains one or more dots, then the name is constructed
-by joining the service prefix and the server name.
-For example, to look up the <literal>_http._tcp.backend.example.com</literal>
-and <literal>server1.backend.example.com</literal> SRV records,
-it is necessary to specify the directives:
+Если имя сервиса содержит одну и более точек, то имя составляется
+при помощи соединения префикса службы и имени сервера.
+Например, для получения SRV-записей
+<literal>_http._tcp.backend.example.com</literal>
+и <literal>server1.backend.example.com</literal>
+необходимо указать директивы:
 <example>
 server backend.example.com service=_http._tcp resolve;
 server example.com service=server1.backend resolve;
@@ -275,26 +275,27 @@ server example.com service=server1.backe
 </para>
 
 <para>
-Highest-priority SRV records
-(records with the same lowest-number priority value)
-are resolved as primary servers,
-the rest of SRV records are resolved as backup servers.
-If the <link id="backup"/> parameter is specified for the server,
-high-priority SRV records are resolved as backup servers,
-the rest of SRV records are ignored.
+SRV-записи с наивысшим приоритетом
+(записи с одинаковым наименьшим значением приоритета)
+преобразуются в основные серверы,
+остальные SRV-записи преобразуются в запасные серверы.
+Если в конфигурации сервера указан параметр <link id="backup"/>,
+высокоприоритетные SRV-записи преобразуются в запасные серверы,
+остальные SRV-записи игнорируются.
 </para>
 </tag-desc>
 
 <tag-name id="slow_start">
-<literal>slow_start</literal>=<value>time</value>
+<literal>slow_start</literal>=<value>время</value>
 </tag-name>
 <tag-desc>
-sets the <value>time</value> during which the server will recover its weight
-from zero to a nominal value, when unhealthy server becomes
-<link id="health_check">healthy</link>,
-or when the server becomes available after a period of time
-it was considered <link id="fail_timeout">unavailable</link>.
-Default value is zero, i.e. slow start is disabled.
+задаёт <value>время</value>, в течение которого вес сервера
+восстановится от нуля до своего номинального значения в ситуации, когда
+неработоспособный (unhealthy) сервер вновь становится работоспособным
+(<link id="health_check">healthy</link>)
+или когда сервер становится доступным по прошествии времени,
+в течение которого он считался <link id="fail_timeout">недоступным</link>.
+Значение по умолчанию равно нулю и означает, что медленный старт выключен.
 </tag-desc>
 
 </list>
@@ -302,9 +303,9 @@ Default value is zero, i.e. slow start i
 
 <para>
 <note>
-If there is only a single server in a group, <literal>max_fails</literal>,
-<literal>fail_timeout</literal> and <literal>slow_start</literal> parameters
-are ignored, and such a server will never be considered unavailable.
+Если в группе только один сервер, параметры <literal>max_fails</literal>,
+<literal>fail_timeout</literal> и <literal>slow_start</literal>
+игнорируются и такой сервер никогда не будет считаться недоступным.
 </note>
 </para>
 
@@ -312,26 +313,26 @@ are ignored, and such a server will neve
 
 
 <directive name="zone">
-<syntax><value>name</value> [<value>size</value>]</syntax>
+<syntax><value>имя</value> [<value>размер</value>]</syntax>
 <default/>
 <context>upstream</context>
 
 <para>
-Defines the <value>name</value> and <value>size</value> of the shared
-memory zone that keeps the group’s configuration and run-time state that are
-shared between worker processes.
-Several groups may share the same zone.
-In this case, it is enough to specify the zone size only once.
+Задаёт <value>имя</value> и <value>размер</value> зоны разделяемой памяти,
+в которой хранятся конфигурация группы и её рабочее состояние,
+разделяемые между рабочими процессами.
+В одной и той же зоне могут быть сразу несколько групп.
+В этом случае достаточно указать <value>размер</value> только один раз.
 </para>
 
 <para>
-Additionally,
-as part of our <commercial_version>commercial subscription</commercial_version>,
-such groups allow changing the group membership
-or modifying the settings of a particular server
-without the need of restarting nginx.
-The configuration is accessible via a special location
-handled by
+Дополнительно, как часть
+<commercial_version>коммерческой подписки</commercial_version>,
+в таких группах для изменения состава группы
+или настроек отдельных серверов
+нет необходимости перезапускать nginx.
+Конфигурация доступна через специальный location,
+в котором указана директива
 <link doc="../http/ngx_http_upstream_conf_module.xml" id="upstream_conf"/>.
 </para>
 
@@ -339,36 +340,36 @@ handled by
 
 
 <directive name="state">
-<syntax><value>file</value></syntax>
+<syntax><value>файл</value></syntax>
 <default/>
 <context>upstream</context>
 <appeared-in>1.9.7</appeared-in>
 
 <para>
-Specifies a <value>file</value> that keeps the state
-of the dynamically configurable group.
-The state is currently limited to the list of servers with their parameters.
-The file is read when parsing the configuration and is updated each time
-the upstream configuration is
-<link doc="ngx_http_upstream_conf_module.xml" id="upstream_conf">changed</link>.
-Changing the file content directly should be avoided.
-The directive cannot be used
-along with the <link id="server"/> directive.
+Задаёт <value>файл</value>, в котором хранится состояние
+динамически настраиваемой группы.
+В данный момент состояние ограничено списком серверов с их параметрами.
+Файл читается при парсинге конфигурации и обновляется каждый раз при
+<link doc="ngx_http_upstream_conf_module.xml" id="upstream_conf">изменении</link>
+конфигурации группы.
+Изменение содержимого файла напрямую не рекомендуется.
+Директиву нельзя использовать
+совместно с директивой <link id="server"/>.
 </para>
 
 <para>
 <note>
-Changes made during
-<link doc="../control.xml" id="reconfiguration">configuration reload</link>
-or <link doc="../control.xml" id="upgrade">binary upgrade</link>
-can be lost.
+Изменения, совершённые в момент
+<link doc="../control.xml" id="reconfiguration">перезагрузки конфигурации</link>
+или <link doc="../control.xml" id="upgrade">обновления бинарного файла</link>,
+могут быть потеряны.
 </note>
 </para>
 
 <para>
 <note>
-This directive is available as part of our
-<commercial_version>commercial subscription</commercial_version>.
+Эта директива доступна как часть
+<commercial_version>коммерческой подписки</commercial_version>.
 </note>
 </para>
 
@@ -376,33 +377,34 @@ This directive is available as part of o
 
 
 <directive name="hash">
-<syntax><value>key</value> [<literal>consistent</literal>]</syntax>
+<syntax><value>ключ</value> [<literal>consistent</literal>]</syntax>
 <default/>
 <context>upstream</context>
 
 <para>
-Specifies a load balancing method for a server group
-where client-server mapping is based on the hashed <value>key</value> value.
-Currently, the only supported value for the <literal>key</literal>
-is the client remote address specified as <literal>$remote_addr</literal>.
-Note that adding or removing a server from the group
-may result in remapping most of the keys to different servers.
-The method is compatible with the
-<link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link>
-Perl library.
+Задаёт метод балансировки нагрузки для группы, при котором
+соответствие клиента серверу определяется при помощи
+хэшированного значения <value>ключа</value>.
+В настоящий момент единственно возможным значением для <literal>ключа</literal>
+является удалённый адрес клиента,
+указываемый как <literal>$remote_addr</literal>.
+Следует отметить, что любое добавление или удаление серверов в группе
+может привести к перераспределению большинства ключей на другие серверы.
+Метод совместим с библиотекой Perl
+<link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached">Cache::Memcached</link>.
 </para>
 
 <para>
-If the <literal>consistent</literal> parameter is specified,
-the <link url="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</link>
-consistent hashing method will be used instead.
-The method ensures that only a few keys
-will be remapped to different servers
-when a server is added to or removed from the group.
-This helps to achieve a higher cache hit ratio for caching servers.
-The method is compatible with the
+Если задан параметр <literal>consistent</literal>, то вместо
+вышеописанного метода будет использоваться метод консистентного хэширования
+<link url="http://www.last.fm/user/RJ/journal/2007/04/10/392555/">ketama</link>.
+Метод гарантирует, что при добавлении сервера в группу или его удалении
+на другие серверы будет перераспределено минимальное число ключей.
+Применение метода для кэширующих серверов обеспечивает
+больший процент попаданий в кэш.
+Метод совместим с библиотекой Perl
 <link url="http://search.cpan.org/perldoc?Cache%3A%3AMemcached%3A%3AFast">Cache::Memcached::Fast</link>
-Perl library with the <value>ketama_points</value> parameter set to 160.
+при значении параметра <value>ketama_points</value> равным 160.
 </para>
 
 </directive>
@@ -414,12 +416,11 @@ Perl library with the <value>ketama_poin
 <context>upstream</context>
 
 <para>
-Specifies that a server group should use a load balancing method
-where a connection
-is passed to the server with the least number of active connections,
-taking into account weights of servers.
-If there are several such servers, they are tried in turn using a
-weighted round-robin balancing method.
+Задаёт для группы метод балансировки нагрузки, при котором соединение
+передаётся серверу с наименьшим числом активных соединений,
+с учётом весов серверов.
+Если подходит сразу несколько серверов, они выбираются циклически
+(в режиме round-robin) с учётом их весов.
 </para>
 
 </directive>
@@ -433,26 +434,26 @@ weighted round-robin balancing method.
 <context>upstream</context>
 
 <para>
-Specifies that a group should use a load balancing method where a connection
-is passed to the server with the least average time and
-least number of active connections, taking into account weights of servers.
-If there are several such servers, they are tried in turn using a
-weighted round-robin balancing method.
+Задаёт для группы метод балансировки нагрузки, при котором соединение
+передаётся серверу с наименьшими средним временем ответа и
+числом активных соединений с учётом весов серверов.
+Если подходит сразу несколько серверов, то они выбираются циклически
+(в режиме round-robin) с учётом их весов.
 </para>
 
 <para>
-If the <literal>connect</literal> parameter is specified,
-time to connect to the upstream server is used.
-If the <literal>first_byte</literal> parameter is specified,
-time to receive the first byte of data is used.
-If the <literal>last_byte</literal> is specified,
-time to receive the last byte of data is used.
+Если указан параметр <literal>connect</literal>,
+то учитывается время соединения с сервером группы.
+Если указан параметр <literal>first_byte</literal>,
+то учитывается время получения первого байта данных.
+Если указан параметр <literal>last_byte</literal>,
+то учитывается время получения ответа.
 </para>
 
 <para>
 <note>
-This directive is available as part of our
-<commercial_version>commercial subscription</commercial_version>.
+Эта директива доступна как часть
+<commercial_version>коммерческой подписки</commercial_version>.
 </note>
 </para>
 
@@ -460,114 +461,113 @@ This directive is available as part of o
 
 
 <directive name="health_check">
-<syntax>[<value>parameters</value>]</syntax>
+<syntax>[<value>параметры</value>]</syntax>
 <default/>
 <context>server</context>
 
 <para>
-Enables periodic health checks of the servers in a
-<link id="upstream">group</link>.
+Активирует периодические проверки работоспособности серверов в
+<link id="upstream">группе</link>.
 </para>
 
 <para>
-The following optional parameters are supported:
+Могут быть заданы следующие необязательные параметры:
 <list type="tag">
 
 <tag-name id="interval">
-<literal>interval</literal>=<value>time</value>
+<literal>interval</literal>=<value>время</value>
 </tag-name>
 <tag-desc>
-sets the interval between two consecutive health checks,
-by default, 5 seconds;
+задаёт интервал между двумя последовательными проверками,
+по умолчанию 5 секунд;
 </tag-desc>
 
 <tag-name id="fails">
-<literal>fails</literal>=<value>number</value>
+<literal>fails</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-sets the number of consecutive failed health checks of a particular server
-after which this server will be considered unhealthy,
-by default, 1;
+задаёт число последовательных неуспешных проверок для определённого сервера,
+после которых сервер будет считаться неработоспособным,
+по умолчанию 1;
 </tag-desc>
 
 <tag-name id="passes">
-<literal>passes</literal>=<value>number</value>
+<literal>passes</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-sets the number of consecutive passed health checks of a particular server
-after which the server will be considered healthy,
-by default, 1;
+задаёт число последовательных успешных проверок для определённого сервера,
+после которых сервер будет считаться работоспособным,
+по умолчанию 1;
 </tag-desc>
 
 <tag-name id="hc_match">
-<literal>match</literal>=<value>name</value>
+<literal>match</literal>=<value>имя</value>
 </tag-name>
 <tag-desc>
-specifies the <literal>match</literal> block configuring the tests that a
-successful connection should pass in order for a health check to pass.
-By default,
-only the ability to establish a TCP connection with the server is checked;
+указывает на блок <literal>match</literal> с условиями, которым должно
+удовлетворять соединение, чтобы результат проверки считался успешным;
+по умолчанию проверяется лишь возможность установки TCP-соединения с сервером;
 </tag-desc>
 
 <tag-name id="health_check_port">
-<literal>port</literal>=<value>number</value>
+<literal>port</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-defines the port used when connecting to a server
-to perform a health check (1.9.7);
-by default, equals the <link id="server"/> port;
+задаёт порт, используемый при подключении к серверу
+для проверки его работоспособности (1.9.7);
+по умолчанию совпадает с портом <link id="server">сервера</link>.
 </tag-desc>
 
 <tag-name id="health_check_udp">
 <literal>udp</literal>
 </tag-name>
 <tag-desc>
-specifies that the <literal>UDP</literal> protocol should be used for
-health checks instead of the default <literal>TCP</literal> protocol (1.9.13);
-requires a <link id="hc_match">match</link> block with the
-<link id="match_send">send</link> and <link id="match_expect">expect</link>
-parameters.
+указывает, что для проверки работоспособности будет использоваться протокол
+<literal>UDP</literal>
+вместо протокола <literal>TCP</literal>, используемого по умолчанию (1.9.13);
+тебует наличия блока <link id="hc_match">match</link> с параметрами
+<link id="match_send">send</link> и <link id="match_expect">expect</link>.
 </tag-desc>
 
 </list>
 </para>
 
 <para>
-For example,
+В примере
 <example>
 server {
     proxy_pass backend;
     health_check;
 }
 </example>
-will check the ability to establish a TCP connection to each server
-in the <literal>backend</literal> group every five seconds.
-When a connection to the server cannot be established,
-the health check will fail, and the server will
-be considered unhealthy.
-Client connections are not passed to unhealthy servers.
+для каждого сервера группы <literal>backend</literal>
+с интервалом в 5 секунд проверяется возможность установки TCP-соединения.
+Если соединение с сервером не может быть установлено,
+проверка считается неуспешной и сервер
+признаётся неработоспособным.
+На неработоспособные серверы клиентские соединения передаваться не будут.
 </para>
 
 <para>
-Health checks can also be configured to test data obtained from the server.
-Tests are configured separately using the <link id="match"/> directive
-and referenced in the <literal>match</literal> parameter.
+Проверки работоспособности могут тестировать данные, полученные от сервера.
+Тесты настраиваются отдельно при помощи директивы <link id="match"/>
+и указываются в параметре <literal>match</literal>.
 </para>
 
 <para>
-The server group must reside in the <link id="zone">shared memory</link>.
+Группа должна находиться в <link id="zone">зоне разделяемой памяти</link>.
 </para>
 
 <para>
-If several health checks are defined for the same group of servers,
-a single failure of any check will make the corresponding server be
-considered unhealthy.
+Если для группы задано несколько проверок,
+то при любой неуспешной проверке соответствующий сервер будет
+считаться неработоспособным.
 </para>
 
 <para>
 <note>
-This directive is available as part of our
-<commercial_version>commercial subscription</commercial_version>.
+Эта директива доступна как часть
+<commercial_version>коммерческой подписки</commercial_version>.
 </note>
 </para>
 
@@ -575,21 +575,21 @@ This directive is available as part of o
 
 
 <directive name="health_check_timeout">
-<syntax><value>timeout</value></syntax>
+<syntax><value>время</value></syntax>
 <default>5s</default>
 <context>stream</context>
 <context>server</context>
 
 <para>
-Overrides the
+Переопределяет значение
 <link doc="ngx_stream_proxy_module.xml" id="proxy_timeout"/>
-value for health checks.
+для проверок работоспособности.
 </para>
 
 <para>
 <note>
-This directive is available as part of our
-<commercial_version>commercial subscription</commercial_version>.
+Эта директива доступна как часть
+<commercial_version>коммерческой подписки</commercial_version>.
 </note>
 </para>
 
@@ -597,70 +597,73 @@ This directive is available as part of o
 
 
 <directive name="match">
-<syntax block="yes"><value>name</value> </syntax>
+<syntax block="yes"><value>имя</value> </syntax>
 <default/>
 <context>stream</context>
 
 <para>
-Defines the named test set used to verify server responses to health checks.
+Задаёт именованный набор тестов для для анализа ответов сервера
+на запросы проверки работоспособности.
 </para>
 
 <para>
-The following parameters can be configured:
+Могут быть заданы следующие параметры:
 <list type="tag">
 
 <tag-name id="match_send">
-<literal>send</literal> <value>string</value>;
+<literal>send</literal> <value>строка</value>;
 </tag-name>
 <tag-desc>
-sends a <value>string</value> to the server;
+отправляет <value>строку</value> на сервер;
 </tag-desc>
 
 <tag-name id="match_expect">
-<literal>expect</literal> <value>string</value> |
+<literal>expect</literal> <value>стока</value> |
 <literal>~</literal> <value>regex</value>;
 </tag-name>
 <tag-desc>
-a literal string (1.9.12) or a regular expression
-that the data obtained from the server should match.
-The regular expression is specified with the preceding
-“<literal>~*</literal>” modifier (for case-insensitive matching), or the
-“<literal>~</literal>” modifier (for case-sensitive matching).
+текстовая строка (1.9.12) или регулярное выражение,
+которым должны соответствовать данные, полученные с сервера.
+Регулярное выражение задаётся либо с модификатором
+“<literal>~*</literal>” (для поиска совпадения без учёта регистра символов),
+либо с модификатором “<literal>~</literal>” (с учётом регистра).
 </tag-desc>
 
 </list>
-Both <literal>send</literal> and <literal>expect</literal> parameters
-can contain hexadecimal literals with the prefix “<literal>\x</literal>”
-followed by two hex digits, for example, “<literal>\x80</literal>” (1.9.12).
+Параметры <literal>send</literal> и <literal>expect</literal>
+могут содержать строки в шестнадцатеричном виде
+с префиксом “<literal>\x</literal>”
+и последующими двумя шестнадцатеричными цифрами,
+например “<literal>\x80</literal>” (1.9.12).
 </para>
 
 <para>
-Health check is passed if:
+Проверка работоспособности считается успешной, если
 <list type="bullet">
 <listitem>
-the TCP connection was successfully established;
+TCP-соединение успешно установлено;
 </listitem>
 
 <listitem>
-the <value>string</value> from the <literal>send</literal> parameter,
-if specified, was sent;
+<value>строка</value> из параметра <literal>send</literal>
+была отправлена (если была задана);
 </listitem>
 
 <listitem>
-the data obtained from the server matched the string or regular expression
-from the <literal>expect</literal> parameter, if specified;
+данные, полученные от сервера, совпали со строкой или регулярным выражением
+из параметра <literal>expect</literal> (если был задан);
 </listitem>
 
 <listitem>
-the time elapsed does not exceed the value specified
-in the <link id="health_check_timeout"/> directive.
+истёкшее время не превышает значение, указанное
+в директиве <link id="health_check_timeout"/>.
 </listitem>
 
 </list>
 </para>
 
 <para>
-Example:
+Пример:
 <example>
 upstream backend {
     zone     upstream_backend 10m;
@@ -682,16 +685,16 @@ server {
 
 <para>
 <note>
-Only the first
-<link doc="ngx_stream_proxy_module.xml" id="proxy_buffer_size"/>
-bytes of data obtained from the server are examined.
+Проверяются лишь первые байты данных
+<link doc="ngx_stream_proxy_module.xml" id="proxy_buffer_size"/>,
+полученные от сервера.
 </note>
 </para>
 
 <para>
 <note>
-This directive is available as part of our
-<commercial_version>commercial subscription</commercial_version>.
+Эта директива доступна как часть
+<commercial_version>коммерческой подписки</commercial_version>.
 </note>
 </para>