Счётчики не обновляются после обновления Мониторинга
Симптомы
- После обновления Мониторинга счётчики принтеров заморожены на дате обновления.
- В Личном Кабинете → "Отчёты по устройствам" - дата последнего опроса не меняется.
- Агент мониторинга работает, ошибок в админке Мониторинга нет.
Причина
Две наиболее частые:
- Агент не перезапустился корректно после обновления — продолжает работать старая версия или агент завис.
- Ошибка чтения данных в ClickHouse — при крупном обновлении (например, 4.1 → 4.3) формат хранения данных изменился, агент получает ошибку при записи или чтении.
Диагностика
Проверить статус контейнера агента:
sudo systemctl status printum-agent.service
Проверить логи агента в интерактивном режиме:
cd /opt/printum-agent/
tail agent.log -f
Признак проблемы 1 (агент завис):
# Ошибки по запуску периодических задач на опрос и сканирование:
level=error msg="get /agent/poll_tasks failed
level=error msg="get /agent/scan_tasks failed
Проверить работу периодической задачи по обработке регистров принтеров (periodic_update_register_of_printers_in_snmp):
cd /opt/printum/
sudo docker-compose logs -f --tail=5 worker-low
Признак проблемы 2 (ClickHouse):
[<date_time>: ERROR/ForkPoolWorker-26] Task apps.printer.tasks.periodic_update_register_of_printers_in_snmp[<UUID>] raised unexpected: ServerException('DB::Exception: Unknown codec family code: 0...
Решение
Агент не перезапустился
sudo systemctl restart printum-agent.service
Подождать 2–3 минуты, проверить счётчики в ЛК.
Ошибка ClickHouse
Не устраняется самостоятельно. Требует вмешательства на уровне БД.
Передать в ТП:
- Логи агента системы Мониторинга.
- Версию Мониторинга до и после обновления.
- Вывод
sudo docker-compose ps.
Как проверить результат
- В ЛК → Отчёты по устройствам: дата последнего опроса обновилась.
- Отправить тестовое задание на печать — счётчик вырос.
Когда эскалировать
- В логах ошибка ClickHouse (
Unknown codec family codeилиServerException). - Агент запускается, но данные не поступают более 30 минут.