# Локальный агент — справка по компоненту

## Назначение

Локальный агент — дополнительный компонент для модуля Мониоринга. Представляет из себя службу на рабочей станции, которая отслеживает локальную очередь печати и передаёт данные о заданиях и USB-устройствах на сервер Мониторинга.

## Основные задачи

### Мониторинг USB-устройств

Сбор статистики по локально подключённым (по USB) принтерам и МФУ, недоступным для сетевого мониторинга по SNMP.

Поскольку Локальный агент не взаимодействует с устройством, он не получает напрямую от устройства:
- серийный номер устройства;
- показания счётчиков;
- состояние расходных материалов.

Учёт объёмов печати выполняется на основании данных о заданиях печати, полученных из локальной очереди операционной системы.

Для локальных устройств администратор может указать начальное значение счётчика отпечатков.

По мере выполнения заданий печати система автоматически увеличивает значение счётчика на основании данных, полученных от Локального агента.

При необходимости администратор может вручную скорректировать текущее значение счётчика в процессе эксплуатации.

### Мониторинг заданий печати

Сбор статистики печати по пользователям и подразделениям без использования ПринтМенеджера.

## Что собирает Локальный агент

Локальный агент не получает данные напрямую от принтера или МФУ.
Источником данных является локальная очередь печати операционной системы.
Из очереди печати агент получает информацию о заданиях, включая:
- пользователя;
- устройство печати;
- количество страниц;
- цветность;
- статус задания;
- другие параметры, доступные драйверу печати.

## Особенности
- Локальный агент отслеживает изменение статусов заданий печати. После получения статуса успешного завершения задание полностью записывается в статистику системы. Система учитывает задания целиком. Определение количества фактически напечатанных страниц внутри задания (например, 5 страниц из 7) не выполняется, поскольку такая информация отсутствует в локальной очереди печати операционной системы.
- Определение цветности задания зависит от драйвера печати. В некоторых случаях драйвер может пометить задание как цветное, даже если документ фактически содержит только чёрно-белые страницы. Для монохромных устройств система выполняет дополнительную проверку. Если драйвер сообщает о цветном задании, но устройство не поддерживает цветную печать, задание будет учтено как чёрно-белое. Для полноцветных устройств используется информация, полученная от драйвера. Анализ содержимого документа локальным агентом не выполняется. Проверка фактического содержимого документа доступна только при использовании ПринтМенеджера.
- Для авторизации агента на сервере используется ключ, указанный в настройках Мониторинга. Один ключ используется для всех Локальных агентов в рамках одной организации. Создавать отдельный ключ для каждого установленного агента не требуется.

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

- [Мониторинг — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/monitoring-spravka-po-komponentu)
- [Установка Локального агента на Windows](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-lokalnogo-agenta-na-windows)
- [Установка Локального агента на Linux](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-lokalnogo-agenta-na-linux)
- Мониторинг USB-устройств через локальный агент
- Мониторинг заданий печати через локальный агент