Модуль "Мониторинг агентов"
Контроль агентов в 1С-Битрикс без ручной рутины

Контроль агентов в 1С-Битрикс без ручной рутины
Модуль помогает быстро проверить состояние агентов, вовремя заметить ошибки выполнения и держать под контролем фоновые задачи проекта.
Ключевые возможности
Диагностика и проверка уведомлений
Отдельная вкладка диагностики показывает последний запуск проверки, источник запуска, состояние уведомлений, статистику по отслеживаемым агентам и готовую команду для cron. Email и Telegram-уведомления можно проверить тестовой отправкой прямо из настроек модуля.
Раннее обнаружение проблемных агентов
Модуль отслеживает просроченные агенты и помогает заметить сбой до того, как он повлияет на важные фоновые процессы сайта: обмены, рассылки, интеграции, очистку кеша и другие регулярные задачи.
Понятные статусы и история состояния
Для каждого проблемного агента фиксируется состояние: NEW — проблема обнаружена, NOTIFIED — уведомление уже отправлено, RESOLVED — агент восстановился. Если восстановленный агент снова зависает, модуль заново отмечает проблему.
Регулярный контроль через cron
роверку можно запускать не только агентом Битрикс, но и отдельным CLI-скриптом через cron. В диагностике выводится готовая команда для настройки, а lock-файл защищает от одновременного запуска нескольких проверок.
Установка и быстрый старт
Установка и базовая инициализация
- Установите модуль
kokhanenko.agentwatchиз Маркетплейса. - При установке модуль
- создаёт в БД таблицы
kokhanenko_agentwatch_watchиkokhanenko_agentwatch_agent_state, - регистрирует почтовое событие
KOKHANENKO_AGENTWATCH_REPORT, - добавляет агент
\Kokhanenko\AgentWatch\Monitor::run();(интервал 300 сек).
- создаёт в БД таблицы
- После установки откройте:
Kokhanenko → Agent Watch → Настройки.
Выбор агентов для контроля (вкладка «Агенты»)
- В таблице агентов включите чекбокс
Отслеживатьтолько для нужных агентов. - Для каждого отслеживаемого агента задайте человекочитаемое
Название (TITLE), чтобы в мониторинге и уведомлениях было понятно, что именно упало. - При необходимости используйте фильтр
Показывать только отслеживаемых агентов. - Сохраните настройки.
Настройка логики срабатывания и уведомлений
- Во вкладке
Настройкизадайте:- порог просрочки в минутах
(threshold_minutes)— после него агент считается проблемным; - интервал повторных уведомлений
(report_interval_minutes)— чтобы не спамить.
- порог просрочки в минутах
- Во вкладке
Уведомлениявключите нужные каналы:Email(и список получателей),Telegram(bot token + chat_id),- уведомления в админке.
- После настройки
EmailилиTelegramиспользуйте тестовую отправку, чтобы сразу проверить корректность получателей, токена и chat_id. - Если уведомление успешно отправлено, старая ошибка отправки больше не будет отображаться как актуальная.
Лог (/bitrix/logs/kokhanenko.agentwatch.log).Работа в мониторинге и регулярный контроль
- Откройте
Kokhanenko → Agent Watch → Мониторинг(/bitrix/admin/kokhanenko_agentwatch.php). - Нажмите
Запустить проверкудля ручной проверки. - Отслеживайте статусы:
NEW— впервые обнаружена просрочка,NOTIFIED— по агенту уже отправлено уведомление,RESOLVED— агент восстановился.
- Откройте вкладку
Диагностика, чтобы проверить дату последнего запуска, источник проверки, количество проблемных агентов и состояние каналов уведомлений. - Для стабильного регулярного контроля используйте CLI-команду из диагностики и добавьте её в
cron.



