Условия перехода состояний

Условия перехода состояний

Условия перехода состояний ​

В этой секции настраиваются условия перехода состояния для сущностей.

conditions ui

В этой секции есть следующие элементы управления:

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

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

Список объектов, к которым не будут применены изменения отображается в следующем окне:

  • Кнопка Унаследовать от класса применяет к текущему объекту условия по умолчанию, указанные для данного класса.
  • Кнопкой , расположенной в правой части заголовка секции, графический конструктор условий можно переключить на текстовый режим:

Настройка условий ​

Секция Условия перехода состояний содержит набор записей. Каждая запись состоит из:

  1. Условия:
  • тип (сравнение/прогноз/всплеск/экспирация данных);
  • источник данных - имя метрики из Данных текущего или внешнего объекта;
  • оператор сравнения из списка, например, = или совпадает с;
  • значение, с которым выполняется сравнение.
  1. Действия - переход состояния в указанное при выполнении условия.

NOTE

Типы Прогноз и Всплеск доступны только при включенном модуле аналитики. Условие типа Экспирация данных выполняется, если данные не поступили в систему в течение периода проверки; по умолчанию в таком случае объект переходит в состояние NO DATA. Остальные поля у такого условия отсутствуют. Математические операторы сравнения используются для числовых значений; текстовые - для числовых и текстовых, без учёта регистра букв. Операторы = и ≠ также могут использоваться с текстовыми значениями, регистр букв учитывается. При выборе текстового оператора сравнения, например, совпадает с, в качестве значения можно использовать регулярное выражение.

Построение условий ​

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

image

NOTE

Алгоритм выбора данных для условий можно найти в разделе Алгоритм выбора данных для нескольких условий .

Кнопки и справа от значения добавляют условие в систему и удаляют условие из системы соответственно.

NOTE

Условие может быть пустым, такое условие выполняется всегда.

Кнопки и справа от действия добавляют и удаляют систему условий целиком соответственно.

Кнопка активирует ручной ввод источника данных. Ручной ввод позволяет:

image

Смена состояний при ошибках ​

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

  • если у объекта не настроены условия перехода состояний или ни одно из них не удовлетворяет условию по метрике Ошибка сенсора, то объект переходит в состояние ALARM;
  • если выполняется условие, настроенное по метрике Ошибка сенсора, то объект переходит в состояние данного условия.

image

Если условия перехода состояний составлены с ошибкой, то объект при поступлении данных переходит в состояние ALARM. В истории состояний будет указана причина Ошибка в условии перехода состояния:

image

Дополнительные операторы ​

По кнопке справа от значения доступны дополнительные операторы:

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

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

На изображении ниже демонстрируются условия смены состояний для устройства, которое отправляет SNMP-Trap о смене состояния интерфейса. Если устройство пришлёт последовательность "Down - Up (или любое другое, отличное от Down) - Down - Up (или любое другое, отличное от Down) - Down" за 10 секунд, то сработает первое условие, и объект перейдёт в состояние OVERLOADED.

Если устройство пришлёт строку "Down", и она продержится 10 секунд, то сработает второе условие, и объект перейдёт в состояние ALARM.

Если устройство пришлёт строку "Up", и она продержится 10 секунд, то сработает последнее условие, и объект перейдёт в состояние WORKING.

NOTE

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

Действия при отсутствии данных ​

По умолчанию, в случае отсутствия данных в системе по истечении периода проверки, объект переходит в состояние NO DATA.

Если отсутствие данных у выполненной проверки не является причиной для аварии, и объект в этом случае не нужно переводить в состояние NO DATA, необходимо использовать условие с типом Экспирация данных.

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

Например, если объект собирает данные об ошибках (когда ошибок нет, данные не поступают), при отсутствии данных переводить объект в состояние WORKING:

Использование метрик из внешних объектов ​

При настройке условий перехода состояний возможно использование метрик из других объектов.

NOTE

Для использования метрик из внешних объектов нужно иметь доступ к этим объектам.

Для использования метрик из внешних объектов, укажите ID объекта и имя используемой метрики через двоеточие с помощью функции ручного ввода метрики (кнопка ).

Например, для использования метрики packetsTransmitted из объекта с ID = 634020c368413b26524a3424 необходимо ввести следующую строку:

text
634020c368413b26524a3424:packetsTransmitted

external metric

В текстовом режиме внешние метрики записываются так:

json
[
  {
    "condition": {
      "634020c368413b26524a3424:packetsTransmitted": {
        "_eq": "4"
      }
    },
    "state": 3,
    "description": "",
    "externalRefs": [
      {
        "id": "634020c368413b26524a3424",
        "metric": "packetsTransmitted"
      }
    ]
  }
]

Данный функционал также можно использовать и в редакторе формул.

Например, для сложения внешних метрик packetsTransmitted и packetsReceived из объектов с ID 634020c368413b26524a3424 и 634020d668413b26524a342b соответственно нужно записать следующую строчку:

text
{{634020c368413b26524a3424:packetsTransmitted}} - {{634020d668413b26524a342b:packetsReceived}}

В текстовом режиме формулы с внешними метриками записываются так:

json
[
  {
    "condition": {
      "_formula": {
        "definition": "{{634020c368413b26524a3424:packetsTransmitted}} - {{634020d668413b26524a342b:packetsReceived}}",
        "value": {
          "_eq": "0"
        }
      }
    },
    "state": 3,
    "description": "",
    "externalRefs": [
      {
        "id": "634020c368413b26524a3424",
        "metric": "packetsTransmitted"
      },
      {
        "id": "634020d668413b26524a342b",
        "metric": "packetsReceived"
      }
    ]
  },
  {
    "condition": {},
    "state": 5,
    "description": ""
  }
]

Математические операции ​

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

Ввод формул ​

Для ввода формулы необходимо:

  1. Перейти в режим ручного ввода .
  2. В поле Источник данных ввести название метрики или выбрать её в отфильтрованном списке вариантов. Название каждой метрики должно быть записано в двойных фигурных скобках: {{имя_метрики}}.
  3. При помощи математических символов, констант и скобок ввести формулу.

Например, разность максимального времени приёма-передачи и минимального времени приёма-передачи: {{roundTripMaximum}} - {{roundTripMinimal}}.

Над введённой математической операцией автоматически отобразится результат вычислений.

Доступные операции, операторы и функции ​

Операции ​

ОперацияОписание
!Факториал
^Возведение в степень
*****Умножение
/Деление
%Остаток от деления
+Сложение
-Вычитание
||Конкатенация
==Равно
!=Не равно
>=Больше или равно
<=Меньше или равно
>Больше
<Меньше
andЛогическое И
orЛогическое ИЛИ
notЛогическое НЕ

Операторы ​

ОператорОписание
x!Факториал (x * (x-1) * (x-2) * …​ * 2 * 1).gamma(x + 1) для нецелых чисел
abs xМодуль x
ceil xОкругление до следующего целого
floor xОкругление до предыдущего целого
length xДлина строки x
round xОкругление до ближайшего целого
sqrt xКвадратный корень из x
trunc xОтбрасывает дробную часть x
exp xЭкспонента (e^x - показательная функция с основанием e)
ln x или log xНатуральный логарифм x
log10 xДесятичный логарифм x
acos xАрккосинус x (в радианах)
acosh xГиперболический арккосинус x (в радианах)
asin xАрксинус x (в радианах)
asinh xГиперболический арксинус x (в радианах)
atan xАрктангенс x (в радианах)
atanh xГиперболический арктангенс x (в радианах)
cos xКосинус x (в радианах)
cosh xГиперболический косинус x (в радианах)
sin xСинус x (в радианах)
sinh xГиперболический синус x (в радианах)
tan xТангенс x (в радианах)
tanh xГиперболический тангенс x (в радианах)
x ? y : zОператор условия (если x, то y, иначе z)

Функции ​

ФункцияОписание
random(n)Случайное число в диапазоне [0, n). Если n равно 0 или не задано, значение приравнивается к 1.
min(a,b,…)Минимальное значение из списка.
max(a,b,…)Максимальное значение из списка.
hypot(a,b) или pyt(a, b)Гипотенуза, т.е. квадратный корень суммы квадратов двух аргументов (sqrt(a^2+b^2)).
pow(x, y)Эквивалент возведения в степень (x^y).
atan2(y, x)Арктангенс x/y, т.е. угол между (0, 0) и (x, y) в радианах.
if(x, y, z)Эквивалент оператора условия (если x, то y, иначе z).
delta(x)Разница между текущим и предыдущим значением x.
deltaRoll(x)Только неотрицательная разница между текущим и предыдущим значением x. Отрицательное значение разницы заменяется на последний неотрицательный результат.
timestamp()Метка времени каждой метрики из возвращаемого ряда значений в формате 13-значного числа (с миллисекундами).