Skip to main content

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

Назначение

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

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

  • Мониторинг принтеров, подключённых по USB
  • Статистика печати по пользователям без ПринтМенеджера

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

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

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

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

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

Windows

  • Путь к файлу конфигурации на АРМ с Windows:
C:\Program Files (x86)\Printumio\PrintumService\Printum.JobTracking.WindowsService.exe.config
  • Для подключения по HTTPS: CA-сертификат из/home/printum/certs/current/ca.crt добавляется в доверенные корневые центры сертификации АРМ.
Параметр Описание
PrintumURL Адрес Мониторинга, например http://10.0.0.1:8000/localprinter/
PrintumClientKey Ключ из панели администратора Мониторинга → Локальные принтеры → Клиентские ключи.
OnlyUSB true — только USB-принтеры, false — все устройства, подключенные к АРМ.
SerialNumber Опциональный параметр для указания серийного номера USB-устройства.

Linux

  • Путь к файлу конфигурации на АРМ с Linux:
/opt/printum-jtm/settings.yml
  • Для подключения по HTTPS: CA-сертификат из/home/printum/certs/current/ca.crt добавляется в доверенные корневые центры сертификации АРМ.
Параметр Описание
monitoring_base_url Адрес Мониторинга, например http://10.0.0.1:8000/localprinter/
client_key Ключ из Панели администратора Мониторинга → Локальные принтеры → Клиентские ключи.
serial_number Опциональный параметр для указания серийного номера USB-устройства.

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

  • 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).
  • Наличие задания в ЛК после тестовой печати.

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

Back to top