changeset 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 85bbe7a5f393
children d8c7160527ae
files xml/en/docs/http/ngx_http_limit_req_module.xml xml/ru/docs/http/ngx_http_limit_req_module.xml
diffstat 2 files changed, 22 insertions(+), 18 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_limit_req_module.xml	Wed Jun 06 12:54:23 2012 +0000
+++ b/xml/en/docs/http/ngx_http_limit_req_module.xml	Wed Jun 06 14:17:28 2012 +0000
@@ -10,8 +10,8 @@
 
 <para>
 The <literal>ngx_http_limit_req_module</literal> module (0.7.21) allows
-to limit the number
-of requests per defined key, in particular, the number of requests
+to limit the request processing rate per defined key,
+in particular, the processing rate of requests coming
 from a single IP address.
 The limitation is done using the “leaky bucket” method.
 </para>
@@ -60,7 +60,7 @@
 at a defined rate.
 Excessive requests are delayed until their number exceeds the
 defined number of bursts.
-In this case, the request is terminated with an error
+When exceeded, the request is terminated with an error
 <http-status code="503" text="Service Temporarily Unavailable"/>.
 By default, the number of bursts is equal to zero.
 For example, the directives
@@ -100,9 +100,11 @@
 <appeared-in>0.8.18</appeared-in>
 
 <para>
-Sets the desired logging level for cases when the server limits
-the number of requests, or delays request processing.
-Delays are logged with the level one less than limits; for example,
+Sets the desired logging level
+for cases when the server refuses to process requests
+due to rate being exceeded,
+or delays request processing.
+Delays are logged with the level one less than refusals; for example,
 if “<literal>limit_req_log_level notice</literal>” is specified,
 delays are logged with the <literal>info</literal> level.
 </para>
@@ -120,7 +122,7 @@
 
 <para>
 Sets the parameters for a zone that keeps states for various keys.
-This state stores the current number of requests in particular.
+The state stores the current number of excessive requests in particular.
 The key is any non-empty value of the specified variable
 (empty values are not accounted).
 Example usage:
@@ -131,7 +133,7 @@
 
 <para>
 Here, the states are kept in a 10 megabyte zone “one”, and an
-average rate of requests for this zone cannot exceed
+average request processing rate for this zone cannot exceed
 1 request per second.
 </para>
 
--- a/xml/ru/docs/http/ngx_http_limit_req_module.xml	Wed Jun 06 12:54:23 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_limit_req_module.xml	Wed Jun 06 14:17:28 2012 +0000
@@ -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 @@
 
 <para>
 Задаёт зону (zone) и максимально возможные всплески запросов (burst).
-Если скорость запросов превышает описанную в зоне,
+Если скорость поступления запросов превышает описанную в зоне,
 то их обработка задерживается так, чтобы запросы обрабатывались
 с заданной скоростью.
 Избыточные запросы задерживаются до тех пор, пока их число
 не превысит заданное число всплесков.
-В этом случае запрос завершается с ошибкой
+При превышении запрос завершается с ошибкой
 <http-status code="503" text="Service Temporarily Unavailable"/>.
 По умолчанию число всплесков равно нулю.
 Например, директивы
@@ -99,9 +100,10 @@
 <appeared-in>0.8.18</appeared-in>
 
 <para>
-Задаёт желаемый уровень записи в лог случаев ограничения
-числа запросов и задержек при обработке запроса.
-Задержки записываются в лог с уровнем на единицу меньшим, чем ограничения,
+Задаёт желаемый уровень записи в лог
+случаев отказа в обработке запросов при превышении скорости
+и случаев задержек при обработке запроса.
+Задержки записываются в лог с уровнем на единицу меньшим, чем отказы,
 например, если указано “<literal>limit_req_log_level notice</literal>”,
 то задержки будут записываться в лог на уровне <literal>info</literal>.
 </para>
@@ -120,7 +122,7 @@
 <para>
 Задаёт параметры зоны,
 которая хранит состояние для разных значений ключа.
-Состояние в частности хранит текущее число запросов.
+Состояние в частности хранит текущее число избыточных запросов.
 Ключом является любое непустое значение заданной переменной
 (пустые значения не учитываются).
 Пример использования:
@@ -131,7 +133,7 @@
 
 <para>
 В данном случае состояния хранятся в зоне “one” размером 10 мегабайт,
-и средняя скорость запросов для этой зоны не может превышать
+и средняя скорость обработки запросов для этой зоны не может превышать
 1 запроса в секунду.
 </para>