Skip to main content

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

Назначение

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

КогдаОсновные используетсязадачи

Мониторинг USB-устройств

Сбор статистики по локально подключённым (по USB) принтерам и МФУ, недоступным для сетевого мониторинга по SNMP.

Поскольку Локальный агент не взаимодействует с устройством, он не получает напрямую от устройства:

  • Мониторингсерийный принтеров,номер подключённых по USBустройства;
  • Статистикапоказания счётчиков;
состояние расходных материалов.

Учёт объёмов печати выполняется на основании данных о заданиях печати, полученных из локальной очереди операционной системы.

Для локальных устройств администратор может указать начальное значение счётчика отпечатков.

По мере выполнения заданий печати система автоматически увеличивает значение счётчика на основании данных, полученных от Локального агента.

При необходимости администратор может вручную скорректировать текущее значение счётчика в процессе эксплуатации.

Мониторинг заданий печати

Сбор статистики печати по пользователям и подразделениям без ПринтМенеджераиспользования ПринтМенеджера.

Что собирает Локальный агент

Локальный агент не получает данные напрямую от принтера или МФУ. Источником данных является локальная очередь печати операционной системы. Из очереди печати агент получает информацию о заданиях, включая:

    пользователя; устройство печати; количество страниц; цветность; статус задания; другие параметры, доступные драйверу печати.

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

    • ОтслеживаниеЛокальный агент отслеживает изменение статусов заданий печати. После получения статуса успешного завершения задание полностью записывается в статистику системы. Система учитывает задания целиком. Определение количества фактически напечатанных страниц внутри задания (например, 5 страниц из 7) не выполняется, поскольку такая информация отсутствует в локальной очереди печати воперационной режиме реального времени.системы.
    • СборОпределение статистики по 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