События

События - это сущности контекста, которые позволяют всем заинтересованным сторонам узнать о том, что с контекстом или представленным им ресурсом/системой произошло некоторое событие. Каждый тип события определяет параметры экземпляров события, создаваемых каждый раз при возникновении события данного типа.

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

С каждым экземпляром события связана таблица данных события:

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

  • Если вам необходимо сгенерировать событие, потребуется сформировать таблицу данных в правильном формате, соответствующем его определению.

Определение события

Каждое событие определяется в своем контекста при помощи Определения события. Определение содержит несколько опций:

  • Имя события. Уникальное имя в контексте, где определяется событие. Является строкой, которая может включать в себя только английские буквы, цифры и символ нижнего подчеркивания ("_").

  • Формат события. Формат таблицы данных, представляющей данные о событии.

  • Описание. Удобное для чтения описание события.

  • Помощь. Подробное описание события (опционально).

  • Срок хранения. Определяет время, в течение которого сохраняемое событие хранится в истории.

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

  • Группа. Указывает на то, что событие принадлежит к группе событий. Группа помогает объединить схожие экземпляры событий во время выполнения различных операций.

Примеры

Контекст Тревога имеет событие alert ("Тревога"), которое активируется при возникновении тревоги.

Корневой контекст AggreGate Server имеет событие login ("Вход пользователя в систему"), которое активируется при входе пользователя на сервер.

Для каждого контекста устройства MQTT драйвер устройства MQTT создает событие сообщения («Message») каждый раз, когда от брокера поступает сообщение. Таблица данных события также представляет собой таблицу с одной записью, содержащую имя темы, полезную нагрузку сообщения и другие параметры, специфичные для протокола.

Экземпляры событий

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

Полезные руководства:

Was this page helpful?