Подавление

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

В редакторе задачи блок Подавление находится на вкладке Главное в секции Расписание.

Выбор правила

Включите переключатель Подавление и выберите вид правила:

Вид правила	Когда использовать
Автоматическое подавление	Чтобы ограничить частоту действий для событий с одинаковыми значениями выбранных полей
Точечное подавление	Чтобы запретить действия для событий с заданными значениями полей на определенный срок или бессрочно
Исключение	Чтобы разрешить действия для выбранных событий, даже если они попадают под подавление

Первым можно добавить автоматическое или точечное подавление. Затем кнопка Добавить правило позволяет создавать другие правила, в том числе исключения. В задаче может быть только одно автоматическое правило. Точечное подавление можно использовать без автоматического.

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

Автоматическое подавление

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

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

Чтобы настроить правило:

1. Выберите Автоматическое подавление
2. Укажите Окно подавления: целое число больше нуля и единицу времени (секунды, минуты, часы или дни)
3. Добавьте названия полей, по которым нужно определять повторы. Значения этих полей указывать не требуется
4. Сохраните задачу

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

Например, выбрано поле host.name, окно подавления составляет один час. Точечных правил и исключений нет. Первое событие с host.name = web-01 проходит проверку подавления и создает автоматическую запись. Повторные события этого хоста подавляются, пока запись действует. Событие с host.name = web-02 имеет другое значение и проходит проверку независимо от первого хоста.

Если добавить поле event.code, отдельно учитывается каждое сочетание host.name и event.code.

Сброс накопленного подавления

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

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

Сброс применяется сразу

После подтверждения операция выполняется без нажатия Сохранить. Для SP-задачи сброс затрагивает всех ее клиентов.

Точечное подавление

Точечное правило запрещает запуск действий для событий с указанными значениями полей, пока действует правило. Например, на время обслуживания сервера можно подавить события с host.name = web-01 на два часа.

Чтобы добавить правило:

1. Выберите Точечное подавление. Если правила уже есть, используйте кнопку Добавить правило
2. Введите название в поле Поле и нужное значение в поле Значение
3. При необходимости добавьте другие условия кнопкой Поле со значком плюса
4. Укажите Срок: На период или Бессрочно. Для периода задайте целое число больше нуля и выберите минуты, часы или дни
5. Сохраните задачу

Правило применяется, когда совпадают все его условия. Например, условия host.name = web-01 и event.code = 4625 подавляют только события этого хоста с указанным кодом.

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

Исключения

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

Нажмите Добавить правило, выберите Исключение и задайте пары Поле и Значение, а также Срок. Условия и срок заполняются так же, как в точечном правиле. Затем сохраните задачу.

Например, автоматическое правило ограничивает повторы по host.name до одного срабатывания в час. Исключение с условием host.name = dc-01 разрешает действия для каждого события этого хоста.

Приоритет правил

Ссылка Как это работает в блоке Подавление раскрывает пояснение порядка проверки:

1. Если событие совпало со всеми условиями хотя бы одного исключения, оно передается активным действиям. Остальные правила не проверяются, автоматическая запись для этого события не создается
2. Если исключение не подошло, но событие попало под точечное подавление, оно не передается активным действиям
3. Если есть автоматическое правило и для сочетания значений существует действующая автоматическая запись, повторное событие не передается активным действиям
4. В остальных случаях событие передается активным действиям. Если настроено автоматическое правило, перед запуском действий для нового сочетания значений создается запись. Она действует в течение окна подавления

Правила с истекшим сроком не учитываются.

Пример приоритета правил

В задаче настроены три действующих правила:

• автоматическое подавление по host.name с окном один час
• точечное подавление для event.code = 4625
• исключение для host.name = dc-01

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

Время	host.name	event.code	Результат
10:00	dc-01	4625	Событие передается активным действиям по исключению. Автоматическая запись не создается
10:01	web-01	4625	Событие подавляется точечным правилом
10:02	web-01	4624	Событие проходит проверку подавления и передается активным действиям. Для web-01 создается автоматическая запись на один час
10:05	web-01	4624	Событие подавляется: для web-01 еще действует автоматическая запись, созданная в 10:02

Последующие события с host.name = dc-01 также передаются активным действиям, пока действует исключение, независимо от кода события и повторов.

Особенности SP-задач

В режиме Service Provider SP-задача выполняется для подключенных клиентов через дочерние задания.

Точечные подавления и исключения, добавленные в блоке Подавление SP-задачи, действуют для всех ее клиентов.

Автоматические записи подавления учитываются отдельно для каждого дочернего задания. Например, запись для host.name = web-01 у одного клиента не подавляет события с тем же значением у другого клиента. Для второго клиента проверяются его собственные автоматические записи.

Сброс автоматического подавления из SP-задачи затрагивает всех ее клиентов. Точечные правила и исключения при этом сохраняются.

Изменение срока и удаление правил

Период точечного подавления или исключения отсчитывается с момента сохранения. У сохраненного правила отображается дата окончания или Бессрочно.

Для изменения срока раскройте карточку и нажмите Изменить срок. Кнопка Оставить прежний срок позволяет отменить изменение срока в форме. Если срок не менять, сохранение задачи сохраняет прежнюю дату окончания.

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

Выключение подавления

Выключите переключатель Подавление и сохраните задачу, чтобы прекратить применение всех правил. Карточки скроются, но правила сохранятся.

Сроки точечных правил и исключений продолжают идти при выключенном подавлении. Повторное включение не начинает их отсчет заново.

Просмотр без права записи

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

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

Ограничения работы подавления

При настройке правил учитывайте следующие ограничения:

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

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

Количество подавленных документов можно посмотреть в статистике запусков.