Skip to main content

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

Назначение

Локальный агент — служба на рабочей станции. Отслеживает локальную очередь печати и передаёт данные о заданиях и 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

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

  • Отслеживание локальной очереди печати в режиме реального времени.
  • Сбор статистики по 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)
  • Наличие задания в ЛК после тестовой печати

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