Skip to main content

Как Локальный агент отслеживает задания печати

Назначение

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


Кратко

Локальный агент (внутреннее техническое название службы — Job Tracking Monitor, PrintumJTMS) — Windows-служба, устанавливаемая на компьютерАРМ пользователя или сервер печати. Её задача — отслеживать локальную очередь печати и отправлять информацию о заданиях на бэкенд Принтум.

Основная задача

Локальный агент:

    отслеживает задания печати в очереди Windows; определяет момент завершения печати; отправляет события с данными задания на бэкенд.

    Как работает мониторинг очереди

    Мониторинг.

    Служба работает в фоне и постоянно опрашивает очередь печати Windowsна сналичие интервалом 60 мс.заданий. Отслеживаемые статусы заданий:

    • Printed — задание напечатано;
    • Retained — задание удержано в очереди;
    • Completed — задание завершено.

    Как отправляются данные

    Данные отправляются нав бэкендМониторинг по TCP., по протоколам HTTP или HTTPS и портам 8000 или 8001 соответственно. Доставка сообщений не гарантирована: при проблемах со связью часть событий может быть потеряна без возможности восстановления.

    Потенциальные проблемы

    Потеря событий при нестабильном соединении

    Если в момент отправки данных связь с бэкендомМониторингом прервалась, событие теряется. Механизма повторной отправки нет.

    Быстрое удаление задания из очереди

    Если задание исчезает из очереди быстрее, чем Локальный агент успевает его опросить (между итерациями по 60 мс),опросить, нужный статус может не зафиксироваться.

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

    Windows

      Логи Локального агента записываются в стандартный журнал событийсобытий: Windows:
      
      Просмотр событий → Журналы Windows → Приложение → Источник _ServicePrintum_
      

      Код события: 101

      Открыть быстро:

      eventvwr

      Установка

      Варианты установки:

      Linux

      • MSI-установщикСтатус +работы XML-файлслужбы конфигурации;
      и скриптылоги install.bat / uninstall.bat.работы:

      Основные

      sudo командыsystemctl установки
      status
      msiexecprintum-jtm.service
      /ivar/log/printum-jtm
      printum_installer.msi /qn
      Printum.JobTracking.WindowsService.exe --install
      net start PrintumJTMS

      Основные команды удаления

      net stop PrintumJTMS
      Printum.JobTracking.WindowsService.exe --uninstall
      msiexec /x printum_installer.msi /qn

      Что важно помнить

        Локальный агент работает как Windows-служба (PrintumJTMS). Доставка TCP-сообщений не гарантируется. Слишком быстрое удаление заданий из очереди может приводить к пропуску событий. Логи пишутся в стандартный журнал Windows (событие 101).

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