Сетевой агент — справка по компоненту
Назначение
Сетевой агент — служба, которая сканирует IP-диапазоны и опрашивает принтерыМФУ и МФУ по SNMP. Передаёт данные в Мониторинг.
Когда используется
Всегда — устанавливается автоматически с Мониторингом Дополнительные агенты — для сегментов сети, недоступных с основного сервера
Ключевые параметры конфигурации
Файл: /opt/printum-agent/config.env
Параметр
Параметр
По умолчанию Описание
DEFAULT_SCAN_INTERVAL
DEFAULT_SCAN_INTERVAL
3600 сек Интервал сканирования сети
DEFAULT_POLL_INTERVAL
DEFAULT_POLL_INTERVAL
300 сек
Интервал опроса устройств LOG_LEVEL WARNING LOG_LEVEL
WARNING
Уровень логирования. DEBUG
— для диагностики
Что важно для диагностики
Текущий лог:
/opt/printum-agent/agent.log
Перезапуск:
systemctl restart printum-agent.service
Что проверить перед эскалацией
IP-адрес устройства в настройках локации Доступность SNMP:
snmpwalk -v 2c -c public <ip> Логи агента в режиме DEBUG
Основные функции
Обнаружение сетевых
принтеровМФУ и МФУ по IP-диапазонам, заданным в локациях. Опрос устройств по протоколу SNMP: состояние, счётчики, расходные материалы. Передача данных на сервер Мониторинга. Один агент может обслуживать несколько локаций.
Связанные компоненты
Мониторинг — сервер, к которому подключается агент (IP + TOKEN). МФУ и
ПринтерМФУ — устройства, которые агент опрашивает по SNMP.
Где настраивается
Токен агента создаётся в ЛК Мониторинга: Настройки → Интеграции → Сетевые агенты. Привязка агента к локациям: Настройки → Общие настройки → Модули → Сетевой агент. Linux: параметры IP_ADDRESS и TOKEN передаются при установке через
install.sh . Windows: файл config.env (BACKEND, TOKEN) в директории агента.
Типовые проблемы
Проблема Причина Решение Проблема
Причина
Решение
Не все устройства обнаружены Неверный IP в локации, SNMP отключён, агент не опрашивает локацию Проверить IP в настройках локации; убедиться, что локация отмечена для агента; проверить SNMP:
snmpwalk -v 2c -c public <printer-ip>
Версия агента не обновляется в панели Агент не перезапустился после обновления Проверить статус сервиса агента
Связанные страницы
Мониторинг — справка по компоненту Установка Сетевого агента на Linux ПринтерМФУ не обнаружен при сетевом сканировании