Версия: 6.2

Активные действия

Общее описание

Активные действия позволяют реагировать на события и инциденты как внутри Smart Monitor, так и во внешних системах: заблокировать учетную запись в Active Directory, запретить IP-адрес на межсетевом экране, создать инцидент или отправить email на почту дежурному.

Одно и то же действие можно запускать в разных местах: по результатам поискового задания Планировщика задач, вручную из карточки инцидента, автоматически при смене статуса инцидента в Рабочем процессе или при достижении порога политики SLA. Логика реагирования пишется один раз, а затем переиспользуется везде, где она нужна.

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

Обратите внимание!

Активные действия Менеджера инцидентов (Менеджер инцидентов - Активные действия) устарели и будут удалены в следующих версиях. Переведите такие действия на активные действия на скриптах.

Из чего состоит пользовательское активное действие

Настройка разделена на три уровня.

Уровень	Что определяет
Настройка скрипта	Что выполнить: код, который выполняет работу, его входные и возвращаемые параметры
Настройка активного действия	Как выглядит и где используется: название, какие параметры видит и меняет пользователь, где действие доступно
Применение в модулях	Как запустить: правила наполнения входных параметров действия в модулях - откуда взять данные

Скрипт

Скрипт — исполняемый файл на Python. У скрипта объявлен контракт: список входных параметров, которые он принимает, и список возвращаемых параметров, которые он отдает по завершении.

Скрипт не знает, кто и откуда его вызвал: аналитик из карточки инцидента или поисковое задание по расписанию. Он получает значения входных параметров и возвращает результат.

Активное действие

Активное действие — это применение скрипта. Действие решает три вещи:

как называется и описывается операция для пользователя
какие входные параметры показываются пользователю, какие из них можно менять, а какие заданы администратором и скрыты
в каких модулях действие предлагается к запуску

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

Блокировка учетной записи AD — для ручного запуска из инцидента: аналитик указывает причину и срок блокировки, домен и приоритет заявки заданы администратором
Автоблокировка по регламенту — для Планировщика задач: все параметры заданы заранее

Место применения

Место применения — это модуль, в котором действие запускается. Для каждого места администратор один раз настраивает, откуда берется значение каждого входного параметра:

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

Скриншот

actions-overview-scheme.png — схема связи уровней: один скрипт, два активных действия на нем и места применения каждого действия (Планировщик задач, тип инцидента, переход рабочего процесса).

Порядок настройки

Чтобы начать использовать активное действие, выполните настройку в следующем порядке:

Создайте скрипт: опишите входные и возвращаемые параметры и напишите код
Создайте на основе скрипта активное действие: задайте название, настройте поля и отметьте области применения
Добавьте действие в место применения и укажите источник данных для каждого входного параметра

Если подходящее встроенное действие уже есть, первый шаг не нужен.

подсказка

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

Скрипты

Скрипты активных действий Smart Monitor: назначение, параметры исполнения, входные и возвращаемые параметры, код скрипта и связанные активные действия.