Локальный агент — справка по компоненту
Назначение
Локальный агент — служба на рабочей станции. Отслеживает локальную очередь печати и передаёт данные о заданиях и USB-устройствах в Мониторинг.
Когда используется
- Мониторинг принтеров, подключённых по USB
- Статистика печати по пользователям без ПринтМенеджера
Ключевые параметры конфигурации (Windows)
Файл: Printum.JobTracking.WindowsService.exe.config
| Параметр | Описание | | ---------------- | --------------------------------------------------------------------------------- | | PrintumURL | Адрес Мониторинга, например http://10.0.0.1:8000/localprinter/ | | PrintumClientKey | Ключ из Панели администратора Мониторинга → Локальные принтеры → Клиентские ключи | | OnlyUSB | true — только USB-принтеры, false — все очереди |
Что важно для диагностики
- Windows: Просмотр событий → источник ServicePrintum
- Linux: systemctl status printum-jtm
Связанные страницы
- Мониторинг — справка по компоненту
- Установка Локального агента на Windows
- Установка Локального агента на Linux
Основные функции
- Отслеживание локальной очереди печати в режиме реального времени.
- Сбор статистики по USB-устройствам и сетевым устройствам, на которые отправляются задания с данного ПК.
- Агент Windows отправляет данные немедленно, агент Linux — в течение 5 минут (настраивается).
- Фильтрация по USB или по всем устройствам — в зависимости от задачи.
Связанные компоненты
- Мониторинг — сервер, на который агент отправляет данные (порт 8000 HTTP / 8001 HTTPS).
- PrintumClientKey — ключ для аутентификации агента, берётся из настроек Мониторинга.
Где настраивается
- Конфигурационный файл (Windows):
Printum.JobTracking.WindowsService.exe.config— параметры PrintumURL и PrintumClientKey. - Для HTTPS: CA-сертификат из
/home/printum/certs/current/ca.crtдобавляется в доверенные на ПК.
Типовые проблемы
| Проблема | Причина | Решение |
|---|---|---|
| Локальные принтеры меняют название после печати | Неактуальные задания в спулере рабочей станции | Остановить спулер: net stop spooler; удалить файлы *.shd и *.spl из C:\Windows\System32\spool\PRINTERS; запустить: net start spooler |
| Статистика не отображается в ЛК | Неверный PrintumURL или PrintumClientKey | Проверить конфигурационный файл агента |
Что проверить перед эскалацией
- Статус службы агента (Windows: services.msc → Printum JobTracking)
- Содержимое конфигурационного файла (PrintumURL, PrintumClientKey)
- Сетевую доступность сервера Мониторинга (порт 8000 или 8001)
- Наличие задания в ЛК после тестовой печати