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

Назначение

Сетевой агент — служба, которая сканирует 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>`
Версия агента не обновляется в панели	Агент не перезапустился после обновления	Проверить статус сервиса агента

Связанные страницы

Back to top