2020-10-26 10:29:30 +00:00
---
2022-08-26 17:37:11 +00:00
slug: /ru/operations/quotas
2022-04-09 13:29:05 +00:00
sidebar_position: 51
sidebar_label: "Квоты"
2020-10-26 10:29:30 +00:00
---
2018-12-21 19:23:55 +00:00
# Квоты {#quotas}
2017-10-25 05:27:09 +00:00
Квоты позволяют ограничить использование ресурсов за некоторый интервал времени, или просто подсчитывать использование ресурсов.
Квоты настраиваются в конфиге пользователей. Обычно это users.xml.
2020-03-20 18:20:59 +00:00
В
2017-10-25 05:27:09 +00:00
В
2020-04-09 20:51:01 +00:00
- ограничивают не один запрос, а
- при распределённой обработке запроса, учитывают ресурсы, потраченные на всех удалённых серверах.
2017-10-25 05:27:09 +00:00
Рассмотрим фрагмент файла users.xml, описывающего квоты.
2020-03-20 18:20:59 +00:00
``` xml
2017-10-25 05:27:09 +00:00
<!-- Квоты. -->
< quotas >
<!-- Имя квоты. -->
< default >
<!-- Ограничения за интервал времени. Можно задать много интервалов с -->
< interval >
<!-- Длина интервала. -->
< duration > 3600< / duration >
<!-- Без ограничений. Просто считать соответствующие данные за указанный интервал. -->
< queries > 0< / queries >
2021-03-10 18:46:14 +00:00
< query_selects > 0< / query_selects >
< query_inserts > 0< / query_inserts >
2017-10-25 05:27:09 +00:00
< errors > 0< / errors >
< result_rows > 0< / result_rows >
< read_rows > 0< / read_rows >
< execution_time > 0< / execution_time >
< / interval >
< / default >
```
Видно, что квота по умолчанию просто считает использование ресурсов за каждый час, но не ограничивает их.
Подсчитанное использование ресурсов за каждый интервал, выводится в лог сервера после каждого запроса.
2020-03-20 18:20:59 +00:00
``` xml
2017-10-25 05:27:09 +00:00
< statbox >
<!-- Ограничения за интервал времени. Можно задать много интервалов с -->
< interval >
<!-- Длина интервала. -->
< duration > 3600< / duration >
< queries > 1000< / queries >
2021-03-10 18:46:14 +00:00
< query_selects > 100< / query_selects >
< query_inserts > 100< / query_inserts >
2017-10-25 05:27:09 +00:00
< errors > 100< / errors >
< result_rows > 1000000000< / result_rows >
< read_rows > 100000000000< / read_rows >
< execution_time > 900< / execution_time >
< / interval >
< interval >
< duration > 86400< / duration >
< queries > 10000< / queries >
2021-03-10 18:46:14 +00:00
< query_selects > 10000< / query_selects >
< query_inserts > 10000< / query_inserts >
2017-10-25 05:27:09 +00:00
< errors > 1000< / errors >
< result_rows > 5000000000< / result_rows >
< read_rows > 500000000000< / read_rows >
< execution_time > 7200< / execution_time >
< / interval >
< / statbox >
```
Для квоты с Т о
Когда интервал заканчивается, все накопленные значения сбрасываются. Т о
Рассмотрим величины, которые можно ограничить:
`queries` - общее количество запросов;
2021-03-10 18:46:14 +00:00
`query_selects` – `SELECT` .
2021-03-18 06:30:19 +00:00
`query_inserts` – `INSERT` .
2021-03-10 18:46:14 +00:00
2017-10-25 05:27:09 +00:00
`errors` - количество запросов, при выполнении которых было выкинуто исключение;
`result_rows` - суммарное количество строк, отданных в виде результата;
`read_rows` - суммарное количество исходных строк, прочитанных из таблиц, для выполнения запроса, на всех удалённых серверах;
`execution_time` - суммарное время выполнения запросов, в секундах (wall time);
Если за хотя бы один интервал, ограничение превышено, то кидается исключение с о
2020-03-20 18:20:59 +00:00
Для квоты может быть включена возможность указывать «ключ квоты», чтобы производить учёт ресурсов для многих ключей независимо. Рассмотрим это на примере:
2017-10-25 05:27:09 +00:00
2020-03-20 18:20:59 +00:00
``` xml
2017-10-25 05:27:09 +00:00
<!-- Для глобального конструктора отчётов. -->
< web_global >
<!-- keyed - значит в параметре запроса передаётся "ключ" quota_key,
и квота считается по отдельности для каждого значения ключа.
Например, в качестве ключа может передаваться логин пользователя в Метрике,
и тогда квота будет считаться для каждого логина по отдельности.
Имеет смысл использовать только если quota_key передаётся не пользователем, а
Также можно написать < keyed_by_ip / > - тогда в качестве ключа квоты используется IP-адрес.
(но стоит учесть, что пользователь может достаточно легко менять IPv6-адрес)
-->
< keyed / >
```
2020-03-20 18:20:59 +00:00
Квота прописывается для пользователей в секции users конфига. Смотрите раздел «Права доступа».
2017-10-25 05:27:09 +00:00
2020-03-20 18:20:59 +00:00
При распределённой обработке запроса, накопленные величины хранятся на сервере-инициаторе запроса. Т о
2017-10-25 05:27:09 +00:00
При перезапуске сервера, квоты сбрасываются.
