Mercurial > hg > nginx-site
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 +++ b/xml/en/docs/http/ngx_http_limit_req_module.xml @@ -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 @@ request processing is delayed such as th 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 @@ limit_req zone=one burst=5 nodelay; <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 @@ delays are logged with the <literal>info <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 @@ limit_req_zone $binary_remote_addr zone= <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 +++ 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>