Перейти к основному содержимому
Версия: 8.3

Сигналы

В данном разделе документации содержится информация о Сигналах и способах работы с ними.

Сигнал - это динамический сигнал тревоги, имеющий время начала и время завершения. Сигнализирует о выходе какого-либо параметра из штатного состояния и в основном предназначен для дедупликации первичных событий. Так как сигнал имеет начало и конец своего существования, поэтому нельзя открыть сигнал повторно после его закрытия, необходимо открывать новый сигнал.

Сигнал обладает следующими свойствами:

  • ID - общесистемный идентификатор сигнала
  • Время начала - время создания сигнала
  • Время завершения - время закрытия сигнала
  • Критичность (приоритет) - уровень важности сигнала (неизменяемое свойство сигнала).
  • Связанные КЕ - связанные с сигналом конфигурационные единицы
  • Связанные первичные события - связанные с сигналом события из внешних источников (события открытия, подтверждения или закрытия сигнала)
  • Метки - специальные поля, расширяющие возможности классификации и фильтрации сигналов
  • Пользовательские тэги - дополнительные поля для категоризации сигналов
  • Владелец - рабочая группа, которой принадлежит сигнал

Управление сигналами, а именно создание сигнала, связь сигнала с КЕ, обогащение метками и тэгами, а также закрытие сигналов осуществляется в сценариях автоматизации.

Дополнительно, в интерфейсе управления сигналами существует возможность ручного управления сигналом:

  • Закрытие открытого сигнала
  • Привязка к сигналу конфигурационных единиц
  • Добавление или удаление тэгов

Экран управления сигналами

Для работы с новой сущностью Сигналы реализована новая вкладка Сигналы в интерфейсе работы с картами ресурсно-сервисной модели Monq.

Изображение

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

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

Таблица сигналов

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

Пользователям доступна возможность изменять состав и порядок столбцов в таблице, используя форму настройки представления ("шестеренка" в правом верхнем углу).

Изображение

При клике средней кнопкой мыши по сигналу в таблице - будет открыта новая вкладка с детальной информацией о сигнале.

Критичность сигнала

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

Модель критичности представлена 6-ю степенями в разной цветовой дифференциации:

  • 1 Fatal
  • 2 Critical
  • 3 Major
  • 4 Warning
  • 5 Info
  • 6 Unknown (устанавливается в случаях, если при создании сигнала атрибут критичности не входит в интервал от 1 до 5)

Статус сигнала

  • Статус является обязательным атрибутом сигнала
  • Модель статуса состоит из значений Open и Closed
  • Открытый сигнал можно принудительно закрыть через API или вручную в интерфейсе
  • Закрытый сигнал повторно открыть нельзя

Название сигнала

  • Название - обязательное свойство сигнала
  • Не является уникальным
  • Назначается при создании сигнала и остается неизменным

Описание сигнала

  • Название - необязательное свойство сигнала
  • Не является уникальным
  • Назначается при создании сигнала и остается неизменным

Дата создания

  • Дата создания устанавливается при создании сигнала автоматически

Дата закрытия

  • Дата закрытия устанавливается при закрытии сигнала автоматически

Длительность

Длительность - время жизни сигнала от даты создания до даты закрытия, если сигнал уже закрыт или до текущего времени, если сигнал еще открыт

РГ владелец сигнала

Владелец сигнала - обязательный атрибут, назначаемый при создании сигнала и остается неизменным

Связанные КЕ

  • Связанные КЕ - необязательный атрибут сигнала
  • К сигналу может быть привязано неограниченное количество конфигурационных единиц
  • Конфигурационные единицы можно привязать при создании сигнала или на протяжении всего времени существования сигнала
  • Конфигурационные единицы можно привязать только в том случае, если владельцем КЕ и владельцем сигнала является одна Рабочая группа

Связанные события

  • Связанные события - необязательный атрибут сигнала
  • В таблице сигналов отображается информация о количестве привязанных событий, типе и времени последнего события
  • Просмотреть привязанные события можно в карточке сигнала
  • Событие может быть привязано как на этапе создания сигнала, так и во время жизни данного сигнала
  • События можно привязать только используя API сигналов
  • Модель связанного события состоит из:
    • Тело события
    • Дата привязки события
    • Источник события (маршрутный узел)
    • Тип события (Opening, Confirming, Closing)
  • Отвязать событие от сигнала нельзя

Изображение

Связанные метки

  • Метки - необязательный атрибут сигнала
  • Метки сигналов устанавливаются через методы API Сигналов
  • Управление метками через интерфейс пользователя не предусматривается
  • В табличном представлении сигналов метки несут только информационных характер

Связанные тэги

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

Связанные бизнес-процессы

Если был создан Сигнал и по нему были запущены какие-либо "Бизнес-процессы" автоматически создается связь экземпляра запуска БП и Сигнала.

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

По цветовой градации можно понять статус завершения запущенного "Бизнес-процесса".

Фильтрация и поиск сигналов

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

Изображение

  • Фильтрация по КЕ
  • Фильтрация по статусу сигнала
  • Фильтрация по критичности сигнала
  • Фильтрация сигналов по времени последних изменений
  • Фильтрация по длительности сигнала
  • Фильтрация по владельцу сигнала
  • Фильтрация по тэгам
  • Отображение сигналов непривязанных к КЕ
  • Поиск сигналов по имени, описанию и идентификатору сигнала

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

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

Например, создание сигнала осуществляется при помощи функции CreateSignalExpanded:

Изображение

Обязательными параметрами при создании сигнала являются:

  • Название сигнала (string)
  • Владелец сигнала (string)

Необязательными параметрами сигнала при создании могут быть:

  • Критичность (integer)

  • Описание (string)

  • Метки (object)

  • Связанные КЕ (массив ID КЕ) (к Сигналу можно привязать только активные КЕ)

  • Компоненты КЕ (если компонент не указан, Сигнал будет привязан к общему компоненту - Common)

  • Теги (массив моделей тэгов)

  • Связанные события (массив моделей событий)

Чтобы закрыть открытый сигнал необходимо воспользоваться функцией фильтрации сигналов FilterSignalExpanded, чтобы найти необходимый сигнал и получить его идентификатор. Для непосредственно закрытия сигнала используется соответствующая функция CloseSignal, в которую передается параметр - идентификатор сигнала.

Полное описание существующих функций по работе с сигналами доступно в разделе документации Автоматизация - Функции

Ручное создание сигнала

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

Заполните значения формы создания:

Изображение

И нажмите кнопку Создать Сигнал.

После создания Сигнала выберите необходимую конфигурационную единицу в списке КЕ. Если Сигнал создан без привязки к КЕ - настройте соответствующим образом фильтр отображения Сигналов без КЕ.

Массовое закрытие сигналов

Чтобы выполнить закрытие нескольких сигналов, необходимо выделить нужные сигналы и в контекстном меню массовых операций выбрать пункт "Закрыть (кол-во сигналов)".

Изображение

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

Детальная информация о сигнале

При выборе какого-либо сигнала в таблице, отображается нижняя панель с детальной информацией о сигнале:

Изображение

В панели отображается расширенная информация о сигнале:

  • Идентификатор сигнала
  • Наименование сигнала
  • Описание сигнала
  • Текущий статус
  • Уровень критичности
  • Продолжительность
  • Связанные конфигурационные единицы
    • Название
    • Текущий статус
    • Информация о здоровье
  • Связанные первичные события
    • Тип события (Opening, Confirmed, Closing)
    • Время события
    • Содержимое события
  • Метки сигнала - в JSON-формате
  • Связанные и выполненные "Бизнес-процессы" с возможностью перейти к конкретному экземпляру запуска
  • Информация о вложениях (скриншоты провалившихся сборок автотестов)
  • Ссылки на внешние или внутренние ресурсы
  • Тэги сигнала
  • Информация об инициаторе создания сигнала (сценарий автоматизации/пользователь)

Действия над сигналом

В панели детальной информации о сигнале, пользователям доступны функции управления сигналами:

  • Управления связанными с сигналом конфигурационными единицами и компонентами

    Изображение

  • Закрытие сигнала

    Закрыть можно только открытый сигнал. Повторно открыть закрытый сигнал нельзя.

    Изображение

  • Возможность поделиться сигналом (скопировать ссылку на сигнал)

    Изображение

  • Добавление ссылок к сигналу (например в "Базу знаний")

    Изображение

  • Управление тэгами для дополнительной классификации

  • Запуск бизнес-процессов относительно сигналов

    Изображение