Подписки на события
Функция доступна с версии 1.26.3
Механизм подписки на события позволяет гибко настраивать получение уведомлений, связанных с роботами, проектами, заданиями и машинами.
Старый механизм подписок сохранен для обратной совместимости. В дальнейшем планируется постепенный переход на новый механизм.
Основные возможности
- Гибкая настройка фильтров — можно подписаться на события, связанные только с конкретными проектами, машинами, заданиями или роботами.
- Выбор событий — поддерживается подписка как на отдельные системные или оркестраторные события, так и на их комбинации.
- Мультиязычность — язык уведомлений (русский или английский) настраивается централизованно через конфигурацию сервисов.
- Управление активностью — подписку можно временно отключить без удаления.
Типы событий
Системные события
| Событие | Описание |
|---|---|
| Агент не доступен | Агент робота перестал отвечать |
| Очередь ожидания проектов растет | Увеличивается количество проектов в очереди |
| Срок действия лицензии истекает | Приближается дата окончания лицензии |
Оркестраторные события
В новом механизме подписок доступны для выбора оркестраторные события. Полный перечень событий с кодами и описаниями приведен в Приложении 3 – События Оркестратора.
Ниже перечислены основные события, наиболее часто используемые для настройки подписок:
| Событие | Описание |
|---|---|
| Агент доступен / не доступен | Изменение статуса подключения агента |
| Задание создано / изменено / удалено / завершено | Операции с заданиями |
| Запуск робота / Ошибка запуска робота | События запуска роботов |
| Ошибка выполнения робота | Ошибка в процессе выполнения |
| Успешное завершение выполнения проекта | Проект выполнен без ошибок |
| Проект создан / изменен / удален | Операции с проектами |
| Робот создан / изменен / удален | Операции с роботами |
| Лицензия истекает | Приближается дата окончания лицензии |
Фильтрация по сущностям
При создании подписки можно уточнить, к каким сущностям она будет применяться, выбрав один или несколько фильтров:
- Проект — уведомления только для выбранных проектов;
- Машина — уведомления только для выбранных машин;
- Задание — уведомления только для выбранных заданий.
Принцип работы фильтров
Подписка сработает, если хотя бы одна сущность из выбранного списка участвует в событии, на которое оформлена подписка.
Настройка языка уведомлений
Язык уведомлений определяется настройками служб States и Notifications. В файлах конфигурации appsettings.json необходимо установить параметр Culture:
| Язык | Значение параметра |
|---|---|
| Русский | "ru-RU" |
| Английский | "en-US" |
Важно: Значение Culture должно быть одинаковым в обеих службах — States
и Notifications.
Создание подписки
-
Перейдите в раздел Настройки - Подписки.
-
Нажмите Добавить подписку.
-
Заполните основные параметры:
- Наименование — название подписки;
- Email — адрес для получения уведомлений;
- Состояние подписки — активна / не активна.
-
Выберите Системные события и/или Оркестраторные события, на которые необходимо подписаться.
-
При необходимости укажите фильтры по сущностям.
-
Нажмите Сохранить.
Важно: Старый механизм подписок (раздел Настройки → Уведомления) сохранен для обратной совместимости. В будущем планируется постепенный отказ от старого механизма.