Процедура контроля

5 марта 2025 г.Около 3 минCoreprocedurecron

Общее описание

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

Порядок настройки типовой КП:

Создать контрольную процедуру.
Создать условия проверки параметра, связанные с этой КП.

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

Все условия имеют порядковый номер, поэтому при назначении КП параметру, все значения, поступающие от этого параметра, проходят проверку условий, согласно их порядковым номерам от 1 и выше.

Атрибуты сущности "Условие"

«УСЛОВИЕ» – логическое выражение для контроля значения параметра;
«СТАТУС ПАРАМЕТРА» – идентификатор состояния, в которое должен перейти параметр при выполнении условия; выбирается из списка «Нет контроля», «Недостоверно», «Норма», «Отклонение», «Критическое»;
«ПОРЯДКОВЫЙ НОМЕР» – порядковый номер условия в рамках одной КП; если условий несколько, то их проверка выполняется по порядку указанных номеров, начиная с 1;
«ВРЕМЯ ЗАДЕРЖКИ (МИН)» – интервал времени (в минутах), по истечении которого, если условие непрерывно выполняется, должно быть инициировано событие;
«ВРЕМЕННЫЕ ОГРАНИЧЕНИЯ» – интервал применимости условия в cron-формате;
«ШАБЛОН РАСПИСАНИЯ» – интервал применимости условия, заданный в шаблоне расписания;
«СОБЫТИЕ» – название события из «Справочника событий», инициируемого при выполнении условия.

Пояснения

При записи условия типовой контролируемый параметр обозначается оператором "V"
При задании условий используются только логические выражения.
Если в условии необходимо задать интервал, то следует использовать символ "&&"
Если задано cron-расписания и шаблон расписание, то приоритет имеет шаблон расписания.

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

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

Индивидуальные процедуры контроля

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

физический параметр объекта: P<id параметра> ;
вычисляемый параметр объекта: L<id параметра> .
параметр ИКП: V .
Например,
условие ИКП, в котором участвуют несколько параметров объекта : (P1>P2) || (P2>L1). Значение ID параметров выводится в ЛК платформы.
условие ИКП, в котором участвует только параметр, для которого создается ИКП: (V >0) && (V < 10)

Формат cron

Синтаксис cron

Команда в cron-формате представляет собой ряд из 5 чисел или групп чисел, разделенных пробелами и означающих

минута час день месяца месяц день недели

Задачи, запланированные в файле crontab, выглядят следующим образом:

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

Специальные символы cron-формата

Символ	Описание
*	Символ «звездочка» представляет любые значения. Например, задача, запланированная в форме * * * * * ... , будет запускаться каждую минуту, каждый час, каждый день каждого месяца.
,	Запятые разбивают значения расписания для получения списка. Например, если необходимо запускать задачу в начале и середине каждого часа, то вместо двух отдельных команд *0 * * * ... и 30 * * * * ... , можно составить одну: 0,30 * * * * ...**
-	Дефис представляет диапазон значений в поле расписания. С помощью дефиса для команды, которую, например, необходимо запускать первые 30 минут каждого часа, вместо создания 30 отдельных задач: *0 * * * ... , 1 * * * * ... , 2 * * * * ... и т.д. можно запланировать одну задачу: 0-29 * * * * ...**
/	Слэш (косая черта) используется для обозначения величины шага. С помощью слэша в комбинации со звездочкой (/) для команды, которую, например, необходимо запускать каждые три часа, вместо написания восьми отдельных задач: 0 0 * * ... , 0 3 * * * ... , 0 6 * * * ... и т.д. можно запланировать одну задачу: 0 /3 * * ...**
	Примечание: для значений шага допускается использование только целых чисел, которые равномерно делят диапазон поля. Например, в поле «часы» после косой черты можно указать только такие числа, на которые 24 часа делятся без остатка: 1, 2, 3, 4, 6, 8 или 12.

Примеры расписаний в cron-формате

Пример	Описание
* * * * *	Запускать команду каждую минуту.
13 * * * *	Запускать команду 13 минут в начале каждого часа.
0,15,30,45 * * * *	Запускать команду каждые 15 минут.
/15 * * *	Запускать команду каждые 15 минут.
0 5 * * *	Запускать команду каждый день в 5:00.
0 4 * * 2-4	Запускать команду каждый вторник, среду и четверг в 4:00.
10,45 /8 7-12 *	Запускать команду на 10-й и 45-й минутах каждого 8-го часа каждый день последних 6 месяцев года.