Оповещения — документация 0.4

Оповещение — то, что требует реакции человека: упало задание, робот без связи, очередь не успевает, скоро истекает пароль. Оповещения видны в «Анализ» → «Оповещения» и в колокольчике вверху панели, а по правилам приходят на почту, в Telegram или во внешнюю систему через вебхук.

Открытые оповещения: „Робот без связи“ и „Ошибки процесса“ с важностью и числом повторений

Разбор оповещений #

Фильтры: «Активные», «Закрытые», «Все»; «Вид»; «Важность» — «Информация», «Предупреждение», «Критично».
Щелчок по оповещению — «Почему» и «Числа, по которым сработало» (например, „Нет связи: 2 ч“), правило, повторения.
«Принять» — взять в работу: все увидят, кто разбирается; оповещение остаётся открытым.
«Закрыть» — готово или не важно. Многие оповещения закрываются сами, когда условие исчезло: робот вернулся, просрочка разобрана, пароль заменён.

Повторы одного и того же оповещения считаются в нём, а уведомления о них приходят не чаще паузы правила.

Виды оповещений #

Вид	Когда срабатывает
„Задание упало“	Задание завершилось ошибкой или потеряно
„Всплеск ошибок“	Из последних 10 заданий процесса упали 3 и больше
„Дольше обычного“, „Выполняется слишком долго“	Задание шло или идёт дольше порога обычной длительности
„Долго ждёт робота“	Задание ждёт свободного робота дольше заданного
„Новая ошибка“, „Ошибка вернулась“	Появилась новая группа ошибок; ошибка, отмеченная «Исправлено», случилась снова
„Робот не в сети“	Робот без связи дольше заданного (короткие обрывы не тревожат)
„Просрочены элементы очереди“, „Очередь растёт“	У элементов прошёл срок; остаток очереди растёт несколько часов подряд
„Пропущен запуск по расписанию“	Запуск пропущен — предыдущее задание ещё выполнялось или сервер был выключен
„Истекает пароль“	Скоро истекает пароль учётных данных
„Шаг стал медленнее“	Раз в сутки: p95 шага за 7 дней в 1,5 раза больше, чем раньше
„Состояние сервера“	Мало места на диске, отстаёт приём событий, нет резервной копии, сертификат, лицензия, роботы без лицензии
„Ежедневная сводка“	Каждый день в заданное время — итоги вчерашнего дня
„Рассылка отчёта не удалась“, „Проверка качества данных“	Ошибки рассылок и проверок отчётов

Правила #

Вкладка «Правила». У каждой рабочей области есть встроенные правила (их можно настроить и выключить, но не удалить); свои правила создают разработчики и владелец области: «Создать правило».

«Что отслеживать» — вид оповещения, «Название», «Важность».
«Когда сообщать» — параметры вида: процессы, роботы и теги, очереди, расписания, пороги („Без связи дольше, мин“).
«Куда» — «В панели» (колокольчик, всегда), «E-mail», «Telegram», «Вебхук». Внешние каналы включает администратор.
«Кому» — роли в рабочей области (владельцы, разработчики, операторы), отдельные пользователи, дополнительные адреса e-mail и чаты Telegram (chat_id группы, число с минусом).
«Пауза между уведомлениями, мин» — повторы того же оповещения не чаще этого; 0 — о каждом.
«Сохранить», затем «Отправить тест» — тестовое сообщение получателям по каналам правила.

Каналы #

Каналы настраивает администратор: «Настройки» → «Каналы» (или вкладка «Каналы» раздела «Оповещения»). Пока внешний канал выключен, сервер никуда не обращается.

Канал	Что нужно
«E-mail (SMTP)»	«Сервер SMTP», «Порт», «Защита соединения», «Логин» и «Пароль» (если сервер требует входа), «Отправитель», например `Tulpar <[email protected]>`
«Telegram»	«Токен бота» от `@BotFather`; серверу нужен доступ к `api.telegram.org` напрямую или через «Прокси»
«Вебхук»	«Адрес» (`https://service.company.kg/hooks/tulpar`); каждый запрос подписан заголовком `X-Tulpar-Signature: sha256=<HMAC-SHA256 тела>` по «Секрет подписи», который показывается один раз

У каждого канала — «Проверить»: сообщение уходит по значениям формы, даже несохранённым. Вебхук ждёт ответа 10 с и при ошибке повторяет запрос ещё 3 раза.

Каналы оповещений: e-mail через SMTP, Telegram и вебхук

Сотрудник привязывает свой Telegram сам: «Профиль» → «Привязать Telegram» и сообщение боту. После этого оповещения правил с каналом Telegram приходят ему в личный чат.