Сетевой агент — справка по компоненту

Назначение

Сетевой агент — служба, которая сканирует IP-диапазоны и опрашивает принтеры и МФУ по SNMP. Передаёт данные в Мониторинг.

Когда используется

Всегда — устанавливается автоматически с Мониторингом
Дополнительные агенты — для сегментов сети, недоступных с основного сервера

Ключевые параметры конфигурации

Файл: /opt/printum-agent/config.env

Параметр | По умолчанию |Описание ~~Описание~~ | |~~---------------------~~|DEFAULT_SCAN_INTERVAL ~~------------ | -------------------------------------------- | | DEFAULT_SCAN_INTERVAL |~~ 3600 сек | Интервал сканирования сети | | DEFAULT_POLL_INTERVAL | 300 сек | Интервал опроса устройств | | LOG_LEVEL |WARNING ~~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.~~sh.
Windows: файл config.env (BACKEND, TOKEN) в директории агента.

Типовые проблемы

Проблема Причина Решение Не все устройства обнаружены Неверный IP в локации, SNMP отключён, агент не опрашивает локацию Проверить IP в настройках локации; убедиться, что локация отмечена для агента; проверить SNMP: snmpwalk -v 2c -c public <printer-ip> Версия агента не обновляется в панели Агент не перезапустился после обновления Проверить статус сервиса агента