Ограничение количества срабатываний правила корреляции

Если правило корреляции должно срабатывать ограниченное количество раз за определенный период, количество его срабатываний можно хранить в активном листе и использовать это значение при обработке правила. Например, нужно ограничить количество срабатываний правила корреляции десятью в сутки. Для этого в активном листе хранится счетчик срабатываний и для каждого правила и каждой даты используется отдельная запись. При срабатывании правила значение счетчика увеличивается на единицу, а после достижения значения 10 правило не должно срабатывать до начала следующего дня.

Настройка ограничения количества срабатываний правила корреляции состоит из следующих этапов:

Создание активного листа

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

1. В веб-интерфейсе перейдите в раздел Ресурсы → Активные листы.
2. Нажмите на кнопку Создать.
3. Укажите параметры активного листа:
   1. В поле Название укажите, например, correlation_limits.
   2. В раскрывающемся списке Тенант выберите нужный тенант.
   3. В поле Срок жизни укажите срок хранения записи активного листа.
4. При необходимости заполните поля Теги и Описание.
5. Нажмите на кнопку Сохранить.

Активный лист будет добавлен.

В качестве поля для хранения количества срабатываний используйте _count. Для записи активного листа задайте ключ, состоящий из названия правила корреляции и даты события (например LimitRule_Example_2026-09-06). Такой ключ позволяет хранить отдельный счетчик для каждого правила корреляции за каждый день.

Настройка правила корреляции

1. Создайте или откройте параметры существующего правила корреляции типа standard.
2. На вкладке Общие укажите основные параметры правила, включая Название, Тенант и Тип.
3. На вкладке Селекторы настройте условия, по которым правило должно отбирать события.
4. Перейдите на вкладку Действия.
5. В блоке Обновление активных листов нажмите + Добавить действие с активным листом и укажите следующие параметры:
   1. В поле Название выберите созданный ранее активный лист.
   2. В поле Операция выберите операцию, необходимую для работы со счетчиком:
      • Получить – получить текущее значение _count.
      • Установить – создать или обновить запись.
      • Сложить – увеличить значение счетчика.
6. Для обращения к одной записи активного листа используйте Ключевые поля. В них должны входить поля события, из которых формируется ключ записи: название правила корреляции и дата события.
7. В блоке параметров Сопоставление настройте соответствие поля _count и поля события, если оно нужно для выбранной операции.
8. Настройте обработку полученного значения _count:
   • Если записи за текущую дату нет, счетчик должен быть установлен в 1.
   • Если значение _count меньше 10, счетчик должен быть увеличен на 1, а правило должно сработать.
   • Если _count равен 10, правило не должно срабатывать.
9. Сохраните правило корреляции.

Привязка активного листа и правила корреляции

Привяжите активный лист к правилу корреляции, а правило корреляции – к коррелятору.

1. Откройте созданное правило корреляции.
2. Перейдите на вкладку Сервисы.
3. Нажмите Привязать к сервису → Привязать к коррелятору.
4. В открывшемся окне выберите один или несколько корреляторов.
5. Нажмите на кнопку ОК.

После привязки правило корреляции будет добавлено в очередь выполнения выбранного коррелятора. При необходимости его позицию в очереди можно изменить в разделе Ресурсы → Корреляторы → [нужный коррелятор] → Корреляция, используя кнопки Поднять и Опустить.

Убедитесь, что активный лист доступен для коррелятора, к которому привязано правило корреляции.

Проверка результата

Отправьте примеры событий, соответствующих условиям селектора правила корреляции, чтобы проверить количество срабатываний и значение _count в активном листе.

1. Отправьте первое событие.

   Убедитесь, что правило сработало, а в активном листе создана запись для текущей даты со значением _count = 1.

2. Последовательно отправьте еще восемь событий.

   Убедитесь, что правило продолжает срабатывать, а значение _count увеличивается до 9.

3. Отправьте десятое событие.

   Убедитесь, что правило сработало, а значение _count стало равно 10.

4. Отправьте еще одно событие, соответствующее условиям селектора.

   Убедитесь, что правило не сработало и значение _count осталось равным 10.

5. После наступления следующего дня отправьте событие, соответствующее условиям селектора.

   Убедитесь, что для новой даты используется отдельная запись активного листа и правило снова может сработать.

Чтобы просмотреть записи активного листа, перейдите в Ресурсы → Активные листы и выберите нужный активный лист. В открывшейся таблице отображаются Ключ, Значение, Срок действия, Последнее обновление и другие параметры записи.