Сетевой агент — справка по компоненту
Назначение
Сетевой агент — служба, которая сканирует IP-диапазоны и опрашивает принтеры и МФУ по SNMP. Передаёт данные в Мониторинг.
Когда используется
- Всегда — устанавливается автоматически с Мониторингом
- Дополнительные агенты — для сегментов сети, недоступных с основного сервера
Ключевые параметры конфигурации
Файл: /opt/printum-agent/config.env
| Параметр | По умолчанию | Описание | | --------------------- | ------------ | -------------------------------------------- | | DEFAULT_SCAN_INTERVAL | 3600 сек | Интервал сканирования сети | | DEFAULT_POLL_INTERVAL | 300 сек | Интервал опроса устройств | | 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> |
| Версия агента не обновляется в панели | Агент не перезапустился после обновления | Проверить статус сервиса агента |