Skip to content

Аварии

Алармы настраиваются на объекте (вкладка «Аварии» у объекта: события, приоритет, кейсы, действия — контракт домена описан на странице Логика), а эта страница — про их жизнь после сохранения: активный проект показывает аварии — факты срабатываний, которые приходят из рантайма контроллера и квитируются пользователем.

Записи аварий и статусы ​

Журнал аварий (вкладка «Аварии» проекта/папки) строится на IAlarmsFromRuntime: записи приходят из рантайма по GET /alarm (getAlarms), редактор их не создаёт и не хранит. Редактор читает только поля, на которые опирается таблица: статус, времена, счётчик, приоритет.

ts
/**
 * Аварии активного проекта: статусы и записи приходят из рантайма контроллера
 * (GET /alarm), редактор их не создаёт. Точная семантика полей определяется
 * рантаймом; здесь — только то, на что опирается билдер (таблица аварий,
 * квитирование).
 */
export enum EAlarmStatus {
  /** квитирована пользователем (accidentAlarm, POST /alarm/ack) */
  Acknowledged = "Acknowledged",
  /** условие аварии выполняется сейчас */
  Active = "Active",
  /** авария прошла, но не квитирована */
  unActive = "unActive",
  /** владелец аварии удалён из проекта */
  Invalid = "Invalid",
}

/** Запись об аварии из рантайма (GET /alarm). */
export interface IAlarmsFromRuntime {
  alarmID: string;
  status: EAlarmStatus;
  /** время первого срабатывания, ISO 8601 с зоной */
  alarmTsFirst: string;
  /** время последнего срабатывания, ISO 8601 с зоной */
  alarmTsLast: string;
  /** сколько раз условие срабатывало с первого раза */
  counter: number;
  /** идентификатор инцидента; участвует в квитировании (uid в POST /alarm/ack) */
  uid: string;
  /** id объекта-владельца аларма */
  object: string;
  /** кто квитировал; приходит только для Acknowledged */
  userID?: string;
  description?: string;
  acknowledgeDate?: string;
  priority: EAlarmPriority;
  projectID?: string;
  reason?: string;
}

Квитирование ​

Подтверждение аварии — POST /alarm/ack (accidentAlarm) с alarmID и uid записи; после этого статус становится Acknowledged, у записи появляются пользователь и дата. Массового квитирования нет — по одной записи.

Mentioned In ​

None yet.