Локальный агент

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

Назначение

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

Когда используется

Ключевые параметры конфигурации (Windows)

Файл: Printum.JobTracking.WindowsService.exe.config

Параметр Описание
PrintumURL Адрес Мониторинга, например http://10.0.0.1:8000/localprinter/
PrintumClientKey Ключ из Панели администратора Мониторинга → Локальные принтеры → Клиентские ключи
OnlyUSB true — только USB-принтеры, false — все очереди

Что важно для диагностики

Просмотр событий → Источник ServicePrintum

systemctl status printum-jtm

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

Связанные компоненты

Где настраивается

Типовые проблемы

Проблема Причина Решение
Локальные принтеры меняют название после печати Неактуальные задания в спулере рабочей станции Остановить спулер: net stop spooler; удалить файлы *.shd и *.spl из C:\Windows\System32\spool\PRINTERS; запустить: net start spooler
Статистика не отображается в ЛК Неверный PrintumURL или PrintumClientKey Проверить конфигурационный файл агента

Что проверить перед эскалацией

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

Как Локальный агент отслеживает задания печати

Назначение

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

Кратко

Локальный агент (внутреннее техническое название службы — Job Tracking Monitor, PrintumJTMS) — Windows-служба, устанавливаемая на компьютер пользователя или сервер печати. Её задача — отслеживать локальную очередь печати и отправлять информацию о заданиях на бэкенд Принтум.

Основная задача

Локальный агент:

Как работает мониторинг очереди

Служба работает в фоне и постоянно опрашивает очередь печати Windows с интервалом 60 мс. Отслеживаемые статусы заданий:

Как отправляются данные

Данные отправляются на бэкенд по TCP. Доставка сообщений не гарантирована: при проблемах со связью часть событий может быть потеряна без возможности восстановления.

Потенциальные проблемы

Потеря событий при нестабильном соединении

Если в момент отправки данных связь с бэкендом прервалась, событие теряется. Механизма повторной отправки нет.

Быстрое удаление задания из очереди

Если задание исчезает из очереди быстрее, чем Локальный агент успевает его опросить (между итерациями по 60 мс), нужный статус может не зафиксироваться.

Логи

Логи Локального агента записываются в стандартный журнал событий Windows:

Просмотр событий → Журналы Windows → Приложение

Код события: 101

Открыть быстро:

eventvwr

Установка

Варианты установки:

Основные команды установки

msiexec /i printum_installer.msi /qn
Printum.JobTracking.WindowsService.exe --install
net start PrintumJTMS

Основные команды удаления

net stop PrintumJTMS
Printum.JobTracking.WindowsService.exe --uninstall
msiexec /x printum_installer.msi /qn

Что важно помнить

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

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

В стандартной конфигурации Принтум собирает статистику через Сетевой агент, который опрашивает устройства по SNMP. Однако в инфраструктурах с USB-МФУ или нестандартными устройствами сетевой опрос недоступен. Для таких случаев используется Локальный агент – небольшая программа, установленная на рабочих станциях. Когда нужен Локальный агент USB-МФУ. Если МФУ подключён напрямую к компьютеру, Мониторинг не может собирать данные по SNMP. Локальный агент отслеживает очередь печати на этой станции и передаёт в систему сведения о заданиях и пользователях. Отсутствие ПринтМенеджера. В компаниях, где не требуется централизованное управление заданиями (нет ПринтМенеджера), Локальный агент позволяет всё-таки вести учёт печати в разрезе пользователей и отделов. Это полезно для ориентировочного распределения затрат. Мониторинг локальных очередей. Даже при наличии ПринтМенеджера Локальный агент может быть полезен, если компания хочет анализировать задания, отправленные мимо сервера (например, на личные или временные МФУ). Как работает Локальный агент Агент подписывается на события локальной очереди печати. Когда пользователь отправляет задание, агент фиксирует: пользователя (по учётной записи операционной системы); имя МФУ и тип подключения; количество страниц, цветность, формат; атрибуты задания (двусторонняя печать, размеры и др.). Эти данные отправляются на сервер Мониторинга. В базе появляется запись о задании, которая может использоваться для отчётов. При необходимости использовать правила (квоты, политики) или делать удержание заданий для авторизации нужно подключать ПринтМенеджер. Ограничения и точность данных Ограниченный набор параметров. В отличие от SNMP-опроса через Сетевой агент, Локальный агент не может получить счётчики устройства или состояние расходников. Он видит только атрибуты конкретного задания. Ошибки драйвера. Оценка цветности и других атрибутов зависит от драйвера МФУ. Иногда драйвер считает документ цветным, даже если он черно-белый, потому что пользователь отправил его без изменения настроек. Принтум корректирует очевидные несоответствия (например, исключает цвет для монохромных МФУ), но полностью исключить погрешности невозможно. Нет контроля очередей. Локальный агент — это только мониторинг. Он не способен удерживать задания или применять правила. Для полного контроля требуется ПринтМенеджер. Рекомендации по развёртыванию Устанавливайте Локальный агент только там, где действительно нужны данные о печати: на рабочих станциях с USB-МФУ или на отдельных АРМ с высокими требованиями к учёту. Настраивайте агент в режиме «мониторинг USB-устройств» (фильтрация по типу подключения), если вас интересует только статистика по USB-МФУ. Периодически сверяйте собранную статистику со счётчиками устройств, чтобы корректировать возможные ошибки в определении цветности или страниц. Заключение Локальный агент – полезное расширение Принтум для мониторинга печати на USB-МФУ и там, где нет ПринтМенеджера. Он не заменяет сетевой мониторинг и ПринтМенеджер, но позволяет собрать нужную статистику, повысить прозрачность затрат и подготовить базу для внедрения полноценного управления печатью.