# Мониторинг USB-устройств с помощью локального агента

## Описание

В стандартной конфигурации Принтум собирает статистику через Сетевой агент, который опрашивает устройства по SNMP. Однако в инфраструктурах с USB-устройствами или нестандартными устройствами сетевой опрос недоступен.
Для таких случаев используется локальный агент – небольшая программа, устанавливаемая на рабочие станции, к которым подключены USB-устройства. Агент отслеживает очередь печати на этой станции и передаёт в Мониторинг сведения о заданиях, пользователях и устройствах.
Также агент позволяет вести учёт печати заданий в разрезе пользователей и отделов при отсутствии ПринтМенеджера.
Даже при наличии ПринтМенеджера локальный агент может быть полезен, если компания хочет анализировать задания, отправленные мимо сервера (например, на личные или временные устройства).

## Как работает Локальный агент

Агент подписывается на события локальной очереди печати. Когда пользователь отправляет задание, агент фиксирует:
- пользователя (по учётной записи операционной системы);
- имя МФУ и тип подключения;
- количество страниц, цветность, формат;
- атрибуты задания (двусторонняя печать, размеры и др.).

Эти данные отправляются на сервер Мониторинга по протоколу HTTP\HTTPS и порту 8000\8001. В базе появляется запись о задании, которая в дальнейшем используется для отчётов.

## Ограничения и точность данных

#### Ограниченный набор параметров
В отличие от SNMP-опроса через cетевой агент, локальный агент не может получить счётчики устройства или состояние расходников. Он видит только атрибуты конкретного задания и базовую информацию о целевом USB-устройстве.
#### Ошибки драйвера
Оценка цветности и других атрибутов зависит от драйвера устройства. Иногда драйвер считает документ цветным, даже если он черно-белый, потому что пользователь отправил его без изменения настроек. Принтум корректирует очевидные несоответствия (например, исключает цвет для монохромных МФУ), но полностью исключить погрешности невозможно.
#### Нет контроля очередей
Локальный агент относится только к мониторингу. Он не способен удерживать задания или применять правила печати. Для полного контроля требуется ПринтМенеджер.

## Рекомендации по развёртыванию

1. Устанавливайте локальный агент только там, где действительно нужны данные о печати: на рабочих станциях с USB-устройствами или на отдельных АРМ с высокими требованиями к учёту.
2. Настраивайте агент в режиме «мониторинг только USB-устройств» (фильтрация по типу подключения), если вас интересует только статистика по USB-устройств. Периодически сверяйте собранную статистику со счётчиками устройств, чтобы корректировать возможные ошибки в определении цветности или страниц.