Диагностика типовых проблем Monitor

Ниже собран порядок проверки наиболее частых ситуаций без вмешательства в код модуля.

[Скриншот 1: пример ошибки на дашборде]

Агент давно не запускался

1. Проверьте, включён ли Monitor.
2. Проверьте список агентов Битрикс и NEXT_EXEC.
3. Если на проекте агенты переведены на cron, проверьте cron.
4. Запустите сбор вручную.
5. Посмотрите локальный журнал.

Метрики собираются, но не доходят до Aggregator

1. Проверьте URL агрегатора.
2. Проверьте токен и активность агента.
3. Сверьте системное время серверов.
4. Проверьте исходящий HTTPS.
5. Посмотрите ошибку HttpService в журнале.

Команды не приходят

• убедитесь, что pull-команды включены;
• проверьте URL получения команд;
• убедитесь, что команда действительно находится в очереди Aggregator;
• проверьте, что плановый агент выполняется;
• для direct-режима дополнительно проверьте Base URL и whitelist.

[Скриншот 2: журнал с причиной]

Не работают Python-метрики

• проверьте, что Python-сбор включён;
• запустите встроенную диагностику;
• проверьте путь к Python;
• убедитесь, что для этого интерпретатора установлен psutil;
• проверьте доступность proc_open для пользователя веб-сервера.

Проверка бэкапа завершилась ошибкой

• проверьте целостность и доступность файла архива;
• проверьте права на тестовый каталог;
• уменьшите объём smoke-test, если сервер ограничен ресурсами;
• помните, что smoke-test не импортирует БД и не гарантирует полноценное восстановление.

После обновления модуля возникла проблема

1. Не удаляйте резервную папку предыдущей версии до проверки.
2. Посмотрите журнал updater-а.
3. Сверьте структуру ZIP.
4. При необходимости верните предыдущую папку модуля из резервной копии.
5. После восстановления выполните сбор вручную.

Важно: При обращении в поддержку передавайте версию модуля, время ошибки и текст журнала без токенов и других секретов.

Проверка системного времени

При любой ошибке timestamp/signature сверяйте не только часы в браузере, а системное UTC-время сервера. Разница может возникнуть после проблем с NTP, восстановлением виртуальной машины или неверной конфигурацией timezone.

Проверка update-пакета

Если обновление скачалось, но не применяется, проверьте свободное место, права на каталог модуля, возможность создать временную и резервную папку, корень ZIP и SHA-256. Не пытайтесь «починить» это выдачей 777 всему сайту.

Сбор диагностического пакета

Для поддержки полезно фиксировать версию PHP/Битрикс/Monitor, installation UID, домен, время последнего запуска, код последней ошибки и состояние pull. Секретный токен в пакет не включается.

[Скриншот 3: диагностика Python/связи]