Аварии
Авария – нештатная ситуация выявленная на объекте или связи в результате мониторинга.
Все зафиксированные аварийные ситуации на наблюдаемых объектах мониторинга отображаются в списке аварий. Также, список аварий можно переключить в режим отображения исторических аварий. Страница аварий открывается кнопкой на панели режимов отображения.
Уровни аварий можно настроить на экране Аварии системной конфигурации.
Для перевода аварии в историю, её следует погасить вручную или автоматически.
Генерация аварий
В системе есть два способа генерации аварий – переход сущности в аварийное состояние или выполнение условия генерации аварии.
Переход в аварийное состояние
Система генерирует аварии при переходе сущностей в состояние, которому задана критичность.
В этом случае, у одного объекта может быть только одна активная авария.
Настроить переход состояний для сущности можно с помощью Условий перехода состояний.
NOTE
Критичность аварии для состояний задаётся в окне конфигурации системы в разделе Состояния .
По умолчанию следующим состояниям задана критичность аварий:
- ALARM → ALARM
- OVERLOADED → WARNING
- NO DATA → MAJOR
- DOWN → MAJOR
Условием погашения аварии – CLEARED – является смена состояния объекта на любое состояние, для которого не выбрана критичность аварии.
NOTE
При наследовании аварийного состояния от дочерних объектов авария для объектов-родителей не создаётся.
Условия генерации аварий
Система может генерировать аварии для сущностей при выполнении заданных условий генерации аварий.
В этом случае, для одного объекта может быть создано несколько активных аварий.
Функционал генерации аварий опционален и выключен по умолчанию. Для его активации необходимо добавить или изменить следующие параметры:
"conditional_incidents_enabled": true
enableConditionalIncidents: true
NOTE
Если у объекта есть настроенные условия генерации аварий, то генерация аварий при переходе в аварийное состояние для этого объекта будет отключена.
Условием погашения аварии является отсутствие выполненных условий генерации аварий в списке и выполненные условия очистки (при наличии).
Модель аварии
| Поле | Тип | Описание |
|---|---|---|
| id | String | Идентификатор аварии. |
| entityId | String | Идентификатор сущности, для которой была создана авария. |
| data | String | Данные сущности. |
| acknowledgedBy | String | Идентификатор пользователя, который подтвердил аварию. |
| acknowledgementTimestamp | Integer | Временная метка подтверждения аварии. |
| clearTimestamp | Integer | Временная метка завершения аварии. |
| comment | String | Последний комментарий к аварии. |
| commentedBy | String | Идентификатор пользователя, который оставил последний комментарий. |
| commentTimestamp | Integer | Временная метка добавления последнего комментария. |
| count | Integer | Количество раз возникновения аварии. |
| entityType | Integer | Тип сущности. 1 - объект, 2 - связь. |
| localTimestamp | Integer | Временная метка возникновения аварии. |
| parentChainId | String | Условие генерации аварии с типом 2. |
| state | String | Идентификатор текущего Уровня аварии. |
| lastState | String | Идентификатор Уровня аварии, в котором находилась авария перед её завершением. |
| text | String | Описание аварии. |
| timestamp | Integer | Временная метка регистрация аварии системой. |
| type | Integer | |
| Тип аварии. Возможные значения: |
1 – сущность поменяла состояние;
2 – выполнилось условие генерации аварий;
3 – авария была сгенерирована через REST API запросом Создать аварию.
| | branchId | String | Идентификатор ветки условия для аварий, сгенерированных по пользовательским Условиям генерации аварий. | | reason | Object | Причина генерации аварии. Подробная информация о модели доступна в статье Reason. | | reason.code | Integer | Идентификатор причины генерации аварии. Подробная информация о модели доступна в статье Reason Codes. | | reason.data | Object | Дополнительная информация об Условиях перехода состояний. | | reason.rootCause | String | Информация о первопричине возникновения аварии. Подробная информация о модели доступна в статье Root cause. | | reason.branch | Object | Условие, по которому была сгенерирована авария. Подробная информация доступна в разделе Branch. | | removed | Object | Информация об удалении аварии с помощью запроса Погасить и удалить аварию. | | removed.userId | Object | Идентификатор пользователя, который удалил аварию. | | removed.timestamp | Object | Временная метка удаление аварии. | | owner | Объект/Связь | Информация о сущности, по которой сгенерирована авария. | | properties | Array<Key-Value Pair> | Список свойства аварии. |