Skip to main content

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

Назначение

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

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

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

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

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

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

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

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

Windows

    Путь к файлу конфигурации на АРМ с Windows: 
    C:\Program Files (Windows)

    Файл: 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

      • КонфигурационныйПуть файлк вфайлу Windowsконфигурации на АРМ с Linux:
      /opt/printum-jtm/settings.yml
      • Для подключения по HTTPS: CA-сертификат из/home/printum/certs/current/ca.crt добавляется в доверенные корневые центры сертификации АРМ.
      • Параметры PrintumURL и PrintumClientKey для отправки данных в Мониторинг:
      
Параметр
Описание
      monitoring_base_url Адрес Мониторинга, например C:\Programhttp://10.0.0.1:8000/localprinter/ Files (x86)\Printumio\PrintumService\Printum.JobTracking.WindowsService.exe.config client_key
        Конфигурационный файл в Linux
          Для подключения по HTTPS: CA-сертификатКлюч из/home/printum/certs/current/ca.crt добавляетсяПанели доверенныеадминистратора корневыеМониторинга центры→ сертификацииЛокальные АРМ.принтеры Параметры→ monitoring_base_urlКлиентские иключи. client_key дляотправкиserial_number данных в Мониторинг, опциональныйОпциональный параметр 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).
          • Наличие задания в ЛК после тестовой печати.

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

          Back to top