h1. Контролёры

{{>toc}}

Контролёры - это приложения, занимающиеся постоянным мониторингом определенных параметров телефонного трафика.
В случае, если на протяжении сконфигурированного интервала времени данные параметры выходят за сконфигурированные пороги, трафик может блокироваться.
В момент блокировки может происходить отправка предупреждающего письма на e-mail блокируемого партнера, также возможна отправка копии данного письма на ваш e-mail.
Блокировка может длиться сконфигурированное кол-во времени.
По истечению данного времени, телефонный трафик может разблокироваться и процесс повторится опять.

Вы можете включить контролёр в 2 режимах:

* *пир*.  
Система сравнивает с пороговыми значениями показатели трафика для пира в целом и блокирует весь пир целиком.

* *код направления*. 
Система сравнивает с пороговыми значениями показатели трафика для каждого подконтрольного кода направления и блокирует каждый код независимо. 
Перечень контролируемых кодов вы можете задавать в виде [[Regex шаблоны|Regex шаблонов]]. 
Для наиболее типичного примера - "контролировать все коды направлений" - следует указать шаблон кода ".*".

h2. Блокировка

Для выполнения контроля используется приложение, которое запускается с определенным интервалом.
Каждый запуск приложения называется _итерацией_.
По умолчанию интервал запуска - 5 минут, следовательно 1 _итерация_ длится 5 минут.
Настроить другой интервал можно в _Общие->Задачи_.
При каждом запуске контролёр сравнивает с пороговыми значениями показатели трафика на пирах, на которых он задействован.
Как только был обнаружен выход за пороговое значение на определенном пире (или, в зависимости от режима, коде направления), этот пир (код направления) помечается как нуждающийся в дальнейшей проверке.

Всего этот пир (код направления) проверяется кол-во итераций (1 итерация = 1 запуск), равное _итерации проверки (кол-во)_.
Например:
_итерации проверки (кол-во)_ = 10
_интервал запуска контролёра (минут)_ = 5
Если все 10 запусков контролёра (то есть в течение 50 минут) показатели трафика выходят за пороговые значения - данный пир (код направления) блокируется и в дальнейшем на него не принимается/отправляется трафик.
Если выставить _итерации проверки (кол-во)_ = 1, то при первой же неудовлетворительной проверке код направления будет заблокирован.

Теперь возникает задача разблокировки кода направления, чтобы снова направить туда трафик.
Это можно сделать либо вручную, удалив код направления из [[Заблокированные коды|Заблокированных кодов]], либо автоматически.

h2. Автоматическая разблокировка

Для автоматической разблокировки служит параметр _итерации блокировки (кол-во)_.
Он определяет сколько итераций данный пир (код направления) будет заблокирован, после чего он автоматически разблокируется.
Например:
_итерации блокировки (кол-во)_ = 72
_интервал запуска контролёра (минут)_ = 5
Код направления будет разблокирован через 5 * 72 = 360 минут (6 часов)
Если указать _итерации блокировки (кол-во)_ = 0, пир (код направления) не будет блокироваться.
Если указать _итерации блокировки (кол-во)_ = 1, пир (код направления) автоматически разблокируется через 5 минут после блокировки.

h2. Симуляция блокировки

Также возможна *симуляция блокировки*.
В этом случае система будет принимать/посылать трафик на заблокированный пир (код направления), при этом остальной функционал (отображение в [[Заблокированные коды|Заблокированных кодах]] и отправление предупреждающего письма) будет работать так, как будто произошла блокировка.

h2. Отправление предупреждающего письма.

Возможно отправление предупреждающего письма в момент, когда происходит блокировка.
При отправке предупреждающего письма используется сконфигурированный [[Шаблоны писем|Шаблон письма]].
В шаблон передаются следующие переменные:

*COMPANY* - название компании, на которой был обнаружен выход за пороговые значения
*PEER* - название пира, на котором был обнаружен выход за пороговые значения
*PERIOD* - период, за который выполнялась проверка

*DETAILS* - детали касательно нарушения порогового значения.
*DETAILS_HTML* - те же детали, но в формате HTML таблицы, пригодные для использования в HTML шаблоне письма.
Описание деталей описано в разделе Реализации в соотвествующем разделе для каждого типа Контролёра.

h2. Реализации

Ниже описаны различные реализации вышеописанной логики.

* [[Контроль терминации]]
* [[Контроль оригинации]]
* [[Контроль ретрансляции]]

[[Controllers|English translation]]