Skip to main content

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

Назначение

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

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

  • Мониторинг — справка по компоненту
  • Установка Сетевого агента на Linux
  • Принтер не обнаружен при сетевом сканировании

Основные функции

    Обнаружение сетевых принтеров и МФУ по 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