diff xml/ru/docs/http/ngx_http_limit_req_module.xml @ 529:d477ae38c0bd

Clarified on what this module actually limits.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 06 Jun 2012 14:17:28 +0000
parents bef9e1a2e3c8
children ebcb351d9eb3
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_limit_req_module.xml
+++ b/xml/ru/docs/http/ngx_http_limit_req_module.xml
@@ -10,9 +10,10 @@
 
 <para>
 Модуль <literal>ngx_http_limit_req_module</literal> (0.7.21) позволяет
-ограничить число запросов
-по заданному ключу или, как частный случай, число запросов с одного IP-адреса.
-Ограничение делается с помощью метода “leaky bucket”.
+ограничить скорость обработки запросов по заданному ключу или,
+как частный случай, скорость обработки запросов, поступающих
+с одного IP-адреса.
+Ограничение обеспечивается с помощью метода “leaky bucket”.
 </para>
 
 </section>
@@ -54,12 +55,12 @@ http {
 
 <para>
 Задаёт зону (zone) и максимально возможные всплески запросов (burst).
-Если скорость запросов превышает описанную в зоне,
+Если скорость поступления запросов превышает описанную в зоне,
 то их обработка задерживается так, чтобы запросы обрабатывались
 с заданной скоростью.
 Избыточные запросы задерживаются до тех пор, пока их число
 не превысит заданное число всплесков.
-В этом случае запрос завершается с ошибкой
+При превышении запрос завершается с ошибкой
 <http-status code="503" text="Service Temporarily Unavailable"/>.
 По умолчанию число всплесков равно нулю.
 Например, директивы
@@ -99,9 +100,10 @@ limit_req zone=one burst=5 nodelay;
 <appeared-in>0.8.18</appeared-in>
 
 <para>
-Задаёт желаемый уровень записи в лог случаев ограничения
-числа запросов и задержек при обработке запроса.
-Задержки записываются в лог с уровнем на единицу меньшим, чем ограничения,
+Задаёт желаемый уровень записи в лог
+случаев отказа в обработке запросов при превышении скорости
+и случаев задержек при обработке запроса.
+Задержки записываются в лог с уровнем на единицу меньшим, чем отказы,
 например, если указано “<literal>limit_req_log_level notice</literal>”,
 то задержки будут записываться в лог на уровне <literal>info</literal>.
 </para>
@@ -120,7 +122,7 @@ limit_req zone=one burst=5 nodelay;
 <para>
 Задаёт параметры зоны,
 которая хранит состояние для разных значений ключа.
-Состояние в частности хранит текущее число запросов.
+Состояние в частности хранит текущее число избыточных запросов.
 Ключом является любое непустое значение заданной переменной
 (пустые значения не учитываются).
 Пример использования:
@@ -131,7 +133,7 @@ limit_req_zone $binary_remote_addr zone=
 
 <para>
 В данном случае состояния хранятся в зоне “one” размером 10 мегабайт,
-и средняя скорость запросов для этой зоны не может превышать
+и средняя скорость обработки запросов для этой зоны не может превышать
 1 запроса в секунду.
 </para>