Агенты и панель

Уведомления

Панель сама пишет о важном в Telegram или на webhook. Почты нет. Без каналов о сбоях вы узнаете, только открыв ЛК.

Каналы — «Настройки» → «Уведомления»: «+ Telegram» или «+ Webhook». Каналов до 10, у каждого свой набор событий.

Создайте бота у @BotFather: команда /newbot — он выдаст токен.
Нажмите «+ Telegram» и вставьте токен.
Напишите боту что угодно или добавьте его в группу и нажмите «Найти чат», затем выберите чат. ID чата или @канал можно ввести и вручную.
«Добавить и проверить» — в чат придёт пробное сообщение.

Webhook

Панель шлёт POST с JSON на ваш адрес: события, текст и ссылку в ЛК. Подходит n8n, Make или свой сервис. Ответ 2xx — доставлено.

С ключом подписи панель добавляет заголовок X-Arcula-Signature: sha256=… — HMAC-SHA256 тела. По нему приёмник проверяет, что сообщение от вашей панели.

События

Событие в ЛК	Когда
«Бэкап не сохранён»	Копия не легла в хранилище или бэкап неполный — компонент не попал
«Бэкап сохранён»	Каждый бэкап в каждое хранилище — для тех, кто хочет видеть всё
«Запуск пропущен»	Агент на связи, а бэкапы по расписанию не начинаются
«Стало «критично»»	Сервер или хранилище — «Критично»
«Стало «предупреждение»»	Сервер или хранилище — «Есть замечания»
«Снова в норме»	После «критично» или «предупреждения»
«Новое без защиты»	Обнаружение нашло том или каталог, о котором вы ещё не решали
«Очистка не прошла»	Старые бэкапы в хранилище не удалились
«Восстановление»	Итог `arcula restore`: прошло или нет

Новый канал получает всё, кроме «Бэкап сохранён» и «Стало «предупреждение»». Галочки у канала меняют набор. Ни одно событие не выбрано — канал молчит.

Как пишет панель

Раз в минуту и коротко: всё новое — одним сообщением на канал, по строке на событие, со ссылкой в ЛК. В Telegram — до 40 строк, дальше «… и ещё N — в ЛК».
Время в сообщениях — в поясе панели.
«Критично» и «предупреждение» приходят, если состояние держится 2 минуты: короткие всплески не будят. Пока проблема держится — напоминание раз в сутки.
«Снова в норме» приходит, когда проблема прошла.
Канал не принял сообщение — панель повторит на следующей минуте, но не дольше часа.
События, которые случились до первого канала, не рассылаются.

Итог последней отправки виден у канала: «Доставлено …» или «Не доставлено …: причина».

Пробное сообщение

«Проверить» у канала шлёт пробное сообщение сразу, даже в выключенный канал. Так видно, что токен, чат или адрес верные.

Токен бота, адрес webhook и ключ подписи панель хранит зашифрованными и обратно не показывает. Чтобы поменять — «Изменить» и новое значение; пустое поле оставляет прежнее.

Чего уведомления не скажут

Если не работает сама панель, она не может об этом сообщить. Для этого подключите к любому внешнему мониторингу адрес:

https://<адрес панели>/api/web/v1/health

Он отвечает без входа и сообщает об ошибке, если у панели нет связи с базой. Перестал отвечать — панель лежит.

Та же статья — в панели, в разделе «Справка».