Сетевой агент — справка по компоненту
Назначение
Сетевой агент — служба, которая сканирует IP-адреса устройств, диапазоны и\или подсети, опрашивает принтеры и МФУ по SNMP. Передаёт данные в Мониторинг.
Когда используется
- Один сетевой агент всегда устанавливается автоматически вместе с Мониторингом.
- Дополнительные агенты — для сегментов сети, недоступных с основного сервера.
Основные функции
- Обнаружение сетевых принтеров и МФУ по IP-адресам, диапазонам и\или подсетям, заданным в локациях.
- Опрос устройств по протоколу SNMP: состояние, счётчики, расходные материалы.
- Передача данных на сервер Мониторинга.
- Один агент может обслуживать несколько локаций и до 200 000 IP-адресов устройств (при дополнительной настройке опроса и сканирования).
Связанные компоненты
- Мониторинг — сервер, к которому подключается агент.
- МФУ и Принтер — устройства, которые агент опрашивает по SNMP.
Ключевые параметры конфигурации
Windows
- Расположение файла конфигурации:
C:\Program Files\printum\agent\config.env
Linux
- Расположение файла конфигурации:
/opt/printum-agent/config.env
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
| DEFAULT_SCAN_INTERVAL | 3600 сек | Интервал сканирования сети |
| DEFAULT_POLL_INTERVAL | 300 сек | Интервал опроса устройств |
| LOG_LEVEL | WARNING | Уровень логирования. Уровень для диагностики - DEBUG |
| TOKEN | home.mist | Токен агента из ЛК → Настройки → Интеграции → Сетевые агенты. |
| BACKEND | http://127.0.0.1/ | Адрес сервера Мониторинга. |
| WORKER_COUNT | 100 | Количество процессов (воркеров) для опроса устройств и сканирования сети. |
| SNMP_RETRIES | 2 | Количество попыток опроса IP-адреса в случае отсутствия ответа. |
| SNMP_TIMEOUT | 10 | Время в секундах, после которого агент фиксирует отсутствие ответа. |
Что важно для диагностики
- Лог работы Windows:
C:\Program Files\printum\agent\agent.log
- Лог работы Linux и статус работы службы:
/opt/printum-agent/agent.log
systemctl status printum-agent.service
Что проверить перед эскалацией
- Доступность IP-адресов устройств из локации по протоколу SNMP:
snmpwalk -v 2c -c public <ip> - Логи работы агента в режиме DEBUG.
Типовые проблемы
| Проблема | Причина | Решение |
|---|---|---|
| Не все устройства обнаружены | Неверный IP в локации, SNMP отключён на устройстве, агент не опрашивает локацию | Проверить IP в настройках локации. Убедиться, что локация отмечена для опроса в настройках агента. Проверить ответ по SNMP: snmpwalk -v 2c -c public <printer-ip> |
| Версия агента не обновляется в панели | Агент не перезапустился после обновления | Проверить статус сервиса агента |