Список аварий
Список аварий представляет из себя таблицу, в которой можно просмотреть список активных и исторических аварий. Выбрать отображаемый список можно в выпадающем меню в левом верхнем углу. Эти списки можно настраивать с помощью фильтров. Интерфейс позволяет настраивать отображаемые столбцы таблицы, а также сохранять эти настройки в виде представлений. К авариям можно оставлять комментарии.
Отображаемую таблицу с применёнными фильтрами и представлениями можно экспортировать.
Страница аварий открывается кнопкой на панели режимов отображения.
Список активных аварий
Окно активных аварий показывает список всех проблемных элементов системы:
Через столбец Путь можно перейти к родительским объектам аварийного элемента. Если включен режим мультиродителя на каком-либо из уровней иерархии, имя объекта этого уровня выделяется жирным шрифтом. При щелчке по такому объекту открывается список всех родительских объектов со ссылками на них:
NOTE
Ссылки на объекты ведут к объектам в облегчённом виде по умолчанию .
Чтобы отделить просмотренные аварии от непросмотренных, используется пометка Подтверждено. Для выделения аварий, с которыми пользователь уже ознакомился, необходимо в списке активных аварий нажать правой кнопкой мыши на рассматриваемую аварию и в контекстном меню выбрать Подтвердить. Имя пользователя, дата и время подтверждения будут добавлены автоматически. Похожим способом добавляются комментарии к авариям.
Погашение активных аварий
Аварии могут быть погашены и переведены в список исторических аварий:
- автоматически – при выполнении необходимых условий,
- вручную – при выборе пользователем в контекстном меню пункта Погасить или Погасить и удалить.
Погашение и удаление аварии отображаются в столбце Статус. Если авария погашена, то в этом столбце будет отображаться значение CLEARED. Удаляемые аварии помечаются символом в столбце Статус.
Удаление аварии происходит не сразу. Авария помечается удалённой и при попытке переноса такой аварии в историю аварий она удаляется без возможности восстановления.
NOTE
Погашение и удаление аварии – это два независимых действия. Поэтому, чтобы полностью отменить действие Погасить и удалить , в контекстном меню нужно в любом порядке выполнить два действия – Отменить погашение и Отменить удаление .
При погашении аварии запись перемещается в список История аварий. По умолчанию перемещение происходит через две минуты после погашения аварии. При необходимости это время можно изменить, добавив параметр incident_timeout в раздел Server конфигурационного файла сервера и установив ему значение времени в миллисекундах:
json
...
"server" : {
...
"incident_timeout": 3600000,
...
},
...Погасить все аварии можно в меню действий со списком аварий. Открыть его можно кнопкой в правом верхнем углу.
Пункты меню " Погасить отображаемые аварии" и " Погасить и удалить отображаемые аварии" погашают аварии с учётом фильтров, а пункты меню " Погасить все аварии" и " Погасить и удалить все аварии" погашают все аварии в системе.
Список исторических аварий
Список исторических аварий содержит аварии, которые были погашены и переведены системой в историю после отведённого в конфигурации времени (по умолчанию – 2 минуты).
Из списка исторических аварий записи могут быть удалены без возможности восстановления. Для этого необходимо вызвать контекстное меню аварии щелчком правой кнопки мыши по аварии и выбрать пункт Удалить.
Сортировка может быть выполнена по любому из столбцов таблицы, кроме столбца Путь.
Через столбец Путь можно перейти к родительским объектам аварийного элемента. Если включен режим мультиродителя на каком-либо из уровней иерархии, имя объекта этого уровня выделяется жирным шрифтом. При щелчке по такому объекту открывается список всех родительских объектов со ссылками на них:
NOTE
Ссылки на объекты ведут к объектам в облегчённом виде по умолчанию .
Также, у исторических аварий можно посмотреть список комментариев, но добавлять новые комментарии нельзя.
Столбцы
Список аварий содержит следующие столбцы:
| Столбец | Описание |
|---|---|
| Время регистрации | Временная метка регистрации аварии на сервере. |
| Время возникновения | Временная метка возникновения аварии на устройстве. |
| Время погашения | Время погашения аварии. Поле пустое, если авария не была погашена. |
| Объект/связь | Сущность, в которой была создана авария. |
| Путь | Путь от корневого объекта до сущности, в которой была создана авария. |
| Статус | Текущий статус аварии. Отображает CLEARED, если авария была погашена. |
| Критичность | Критичность аварии. |
| Текст | Описание аварии или сообщение от аварийного устройства. |
| Подтверждено | Информация о подтверждении аварии. Содержит имя пользователя, который подтвердил аварию и временную метку подтверждения. |
| Комментарий | Последний комментарий к аварии. |
| Количество | Количество раз возникновения аварии. При изменении статуса аварии с CLEARED на любое другое значение счётчик увеличивается на 1. |
Отображение столбцов можно настроить, нажав правой кнопкой мыши на заголовок таблицы и выбрав нужные столбцы из выпадающего списка.
Сохранить текущее отображение столбцов можно в представлении.
Фильтры
Фильтр позволяет отобразить список аварий, согласно выбранному критерию. Созданные условия фильтра можно произвольно комбинировать, используя операторы И и ИЛИ.
При применении фильтра система отображает индикатор загрузки, блокирующий изменение фильтра до получения обновлённого списка аварий. Отменить применение фильтра можно кнопкой .
NOTE
При выборке аварий по родителю в списке отобразятся аварии всех вложенных объектов и связей указанного объекта со всех уровней вложенности.
Следующие критерии связаны со своим значением при помощи операторов сравнения:
- свойство;
- текст;
- сравнение полей;
- комментарий.
Математические операторы сравнения используются для числовых значений; текстовые - для числовых и текстовых, без учёта регистра букв.
Операторы = и ≠ также могут использоваться с текстовыми значениями, регистр букв учитывается.
При выборе текстового оператора сравнения, например, совпадает с, в качестве значения можно использовать регулярное выражение.
Для следующих параметров критерием будет являться временной период.
- время регистрации;
- время возникновения;
- время перехода;
- время погашения.
Фильтр можно сохранить для будущего быстрого использования после ввода всех необходимых критериев и имени фильтра, нажав возле имени фильтра.
Общие фильтры
Система различает фильтры для активных и исторических аварий. По умолчанию, фильтры для одного типа аварий нельзя использовать для другого типа аварий.
Для отображения всех фильтров аварий в параметры адресной строки URL страницы нужно добавить параметр commonFilters=on.
text
http://<saymon-server>/incidents.html?commonFilters=onДанный параметр объединяет фильтры активных и исторических аварий в один список, доступный для выбора в любом представлении.
Данный параметр можно использовать с заданным именем фильтра для того чтобы автоматически применять его к данным при изменении пользователем переключателя типа аварий.
text
http://<saymon-server>/incidents.html?commonFilters=on&filterName=Имя-фильтра&cache=offПри сохранении фильтра со включённым параметром commonFilters=on, система добавит новые фильтры в список фильтров для текущего типа аварий, а при изменении существующего фильтра сохранится ранее заданный тип фильтра.
Представления
Представление – индивидуальное наполнение столбцов в окне аварий. Нажатие правой кнопкой мыши по названию любого столбца открывает список, в котором можно выбирать отображаемые и скрываемые столбцы. Методом перетаскивания можно изменить порядок столбцов. После внесения изменений необходимо ввести имя представления и нажать на кнопку возле имени.
Кнопка позволяет просмотреть все ранее созданные представления.
Поля свойств
Выпадающий список Поля свойств включает в себя все имеющиеся свойства всех объектов системы. Значения отмеченных галочками свойств отобразятся в таблице аварий в соответствующих столбцах при их наличии у объектов, по которым возникли аварии.
При желании можно добавлять дополнительные поля из свойств аварий, значения которых будут отражены в списке активных и исторических аварий. Для этого необходимо указать нужные свойства аварий в разделе Incidents конфигурационного файла клиента.
NOTE
Добавить/изменить или удалить свойства аварий можно с помощью REST API.
Экспорт
Списки активных и исторических аварий можно экспортировать в файл.
Кнопки экспорта " Экспорт в Excel" и " Экспорт в CSV" находятся в меню действий со списком аварий. Открыть его можно кнопкой в правом верхнем углу.
NOTE
Список аварий экспортируется с учётом применённых фильтров .
Подробные инструкции по экспорту соответствующих списков можно найти в статьях Экспорт списка активных аварий и Экспорт списка исторических аварий.
NOTE
С помощью Web-интерфейса, список активных аварий можно экспортировать только в формате XLSX , а список исторических аварий – только в формате CSV . С помощью REST API список исторических аварий можно получить в форматах CSV и XLSX с помощью соответствующих запросов.
Комментарии к авариям
Пользователи могут добавлять комментарии к активным авариям.
Чтобы оставить комментарий, необходимо в списке активных аварий нажать правой кнопкой мыши на рассматриваемую аварию и в контекстном меню выбрать "Комментарий".
После этого, откроется список комментариев:
NOTE
Список комментариев поддерживает Markdown. Используемый синтаксис можно посмотреть в справке Showdown На вкладке "Предпросмотр" можно посмотреть как комментарий будет выглядеть в списке комментариев.
Последний комментарий отображается в строке аварии:
