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

Назначение

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

Отслеживание локальной очереди печати в режиме реального времени.
Сбор статистики по USB-устройствам и сетевым устройствам, на которые отправляются задания с данного ПК.
Агент Windows отправляет данные немедленно, агент Linux — в течение 5 минут (настраивается).
Фильтрация по USB или по всем устройствам — в зависимости от задачи.

Мониторинг — сервер, на который агент отправляет данные по заданиям печати и USB-устройству (порт 8000 HTTP / 8001 HTTPS).
АРМ на Windows или Linux - рабочая станция, к которой подключены USB-устройства и установлен локальный агент.

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

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

Конфигурационный файл в Windows
- Для подключения по HTTPS: CA-сертификат из/home/printum/certs/current/ca.crt добавляется в доверенные корневые центры сертификации АРМ.
- Параметры PrintumURL и PrintumClientKey для отправки данных в Мониторинг:

C:\Program Files (x86)\Printumio\PrintumService\Printum.JobTracking.WindowsService.exe.config

Конфигурационный файл в Linux
- Для подключения по HTTPS: CA-сертификат из/home/printum/certs/current/ca.crt добавляется доверенные корневые центры сертификации АРМ.
- Параметры monitoring_base_url и client_key для отправки данных в Мониторинг, опциональный параметр serial_number для указания серийного номера USB-принтера:

/opt/printum-jtm/settings.yml

Windows
- Логи работы: Просмотр событий → Журналы Windows → Приложение → Источник ServicePrintum
Linux
- Статус работы службы и логи работы:

sudo systemctl status printum-jtm.service
/var/log/printum-jtm

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

Статус службы агента:
- Windows: services.msc → Журналы Windows → Приложение → Источник ServicePrintum.
- Linux: sudo systemctl status printum-jtm.service
Содержимое конфигурационного файла (адрес сервера Мониторинга, клиентский ключ).
Сетевую доступность c АРМ до сервера Мониторинга (порты 8000 или 8001).
Наличие задания в ЛК после тестовой печати.