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

## Назначение

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

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

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

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

Файл: **Printum.JobTracking.WindowsService.exe.config**

<table border="1" id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-pr" style="border-collapse: collapse; width: 100%; height: 155.938px;"><colgroup><col style="width: 50.0477%;"></col><col style="width: 50.0477%;"></col></colgroup><thead><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px;">Параметр</td><td class="align-center" style="height: 29.6px;">Описание</td></tr></thead><tbody><tr style="height: 47.7125px;"><td style="height: 47.7125px;">PrintumURL</td><td style="height: 47.7125px;"><span class="">Адрес Мониторинга, например </span>`http://10.0.0.1:8000/localprinter/`</td></tr><tr style="height: 49.025px;"><td style="height: 49.025px;">PrintumClientKey</td><td style="height: 49.025px;"><span class="">Ключ из Панели администратора `Мониторинга → Локальные принтеры → Клиентские ключи`</span></td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">OnlyUSB</td><td style="height: 29.6px;">`true`<span class=""> — только USB-принтеры, </span>`false`<span class=""> — все очереди</span></td></tr></tbody></table>

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

- 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` добавляется в доверенные на ПК.

---

## Типовые проблемы

<table id="bkmrk-%D0%9F%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%D0%B0%D0%9F%D1%80%D0%B8%D1%87%D0%B8%D0%BD%D0%B0%D0%A0%D0%B5%D1%88%D0%B5%D0%BD"><thead><tr><th>Проблема</th><th>Причина</th><th>Решение</th></tr></thead><tbody><tr><td>Локальные принтеры меняют название после печати</td><td>Неактуальные задания в спулере рабочей станции</td><td>Остановить спулер: `net stop spooler`; удалить файлы \*.shd и \*.spl из C:\\Windows\\System32\\spool\\PRINTERS; запустить: `net start spooler`</td></tr><tr><td>Статистика не отображается в ЛК</td><td>Неверный PrintumURL или PrintumClientKey</td><td>Проверить конфигурационный файл агента</td></tr></tbody></table>

---

## Что проверить перед эскалацией

- Статус службы агента (Windows: `services.msc` → Printum JobTracking)
- Содержимое конфигурационного файла (PrintumURL, PrintumClientKey)
- Сетевую доступность сервера Мониторинга (порт 8000 или 8001)
- Наличие задания в ЛК после тестовой печати

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

- [Мониторинг — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/monitoring-spravka-po-komponentu)
- [Установка Локального агента на Windows](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-lokalnogo-agenta-na-windows)
- [Установка Локального агента на Linux](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-lokalnogo-agenta-na-linux)

---