Часто задаваемые вопросы

Активность учитывается по всем устройствам и объединяется в единую временную шкалу.

Для корректного учета активности сотрудника в гибридной среде (локальные ПК, терминалы, VDI) необходимо:

• Установить агент мониторинга на каждое устройство или сервер, с которого сотрудник выполняет работу
• Убедиться, что сотрудник однозначно идентифицируется в системе по логину, ID, адресу электронной почты и т. д.

После этого система:

• Агрегирует активность со всех устройств
• Объединяет действия в единую временную шкалу по индивидуальному ID сотрудника
• Учитывает переключение между устройствами и аккаунтами при настройке соответствующих правил

Таким образом формируется полная картина рабочей активности, независимо от точки доступа.

Да, агент мониторинга можно устанавливать на терминальные серверы (RDS), где выполняются пользовательские сессии.

Особенности работы агента в терминальной среде:

• Агент запускается отдельно в каждой активной сессии пользователя, что обеспечивает корректный сбор данных по каждому сотруднику
• Полностью исключить процесс агента из сессии нельзя, но можно отключить сбор данных через настройки мониторинга для конкретного пользователя
• Нагрузка на сервер пропорциональна количеству одновременных сессий — учитывайте это при расчете технических требований
• Агент хранит данные (включая архивы активности) в каталоге %AppData%\ProcesetAgent\. При использовании технологий Citrix PVS или аналогов убедитесь, что профиль пользователя (включая %APPDATA%) сохраняется между переподключениями

Да, для этого используются белый и черный списки в фильтрах мониторинга.

Вы можете выбрать, какие приложения и сайты учитывать, а какие — игнорировать. Для этого предусмотрены три режима фильтрации приложений:

• Белый список — фиксируется активность только в указанных приложениях и на сайтах
• Черный список — собирается информация по всем приложениям и сайтам, кроме перечисленных
• Фильтрация выключена — данные собираются по всем приложениям

Необходимо приобрести и назначить расширенную лицензию.

Расширенный мониторинг недоступен по умолчанию — для его активации необходимо:

• Приобрести лицензии типа Мониторинг расширенный
• Назначить лицензию конкретному пользователю или группе сотрудников через веб-интерфейс

Лицензию можно назначить двумя способами:

• Через массовое назначение
• Через профиль конкретного пользователя

Да, можно отключить отдельные функции.

Настройки агента позволяют регулировать интенсивность сбора информации, с помощью отключения таких функций, как сбор скриншотов.

Это помогает адаптировать работу агента под производительность конкретного ПК, минимизируя его влияние на систему.

После установки агента сбор активности начинается автоматически. Дополнительные настройки, например, сбор скриншотов выполняются через систему.

Нет. Агент мониторинга не фиксирует вводимые пользователем символы и не сохраняет текст, набранный с клавиатуры.

Фиксируется:

• Факт редактирования полей (без значения)
• Факт использования клавиатуры
• Комбинации горячих клавиш (Ctrl+C, Ctrl+V и т.п.)

Содержимое вводимого текста, включая пароли, не собирается и не передается.

Агент мониторинга фиксирует только факт операций копирования и вставки.

Особенности обработки:

• Значение буфера обмена всегда хэшируется (односторонний хэш, crc32)
• Хранение и передача данных в открытом виде невозможны
• Восстановление исходного значения технически невозможно

Хэш используется исключительно для технической корреляции событий.

Агент мониторинга фиксирует факт редактирования документа, а не его содержимое.

При этом:

• Текст не сохраняется
• Значения редактируемых полей хэшируются
• Событие фиксируется после потери фокуса (переключения на другой элемент)

Агент мониторинга:

• Не фиксирует значения password-полей
• Не передает пароли
• Игнорирует любые попытки передачи подобных параметров

С помощью шаблонного отчета Диагностика по агентам мониторинга можно увидеть статус агента, версию, количество активности и ошибки.

Лог-файлы агента находятся на клиентской машине в каталогах %AppData%\ProcesetAgent\logs\ для ОС Windows и ~/.ProcesetAgent/logs для ОС Linux. Логи можно экспортировать и отправить в поддержку.

Агент мониторинга состоит из двух компонентов:

• Служба агента мониторига (agent_service.exe) — запускается один раз на компьютере и отвечает за:
  • Обновление настроек мониторинга (раз в 30 минут)
  • Проверку и установку обновлений (раз в час)
  • Отправку аварийных дампов (если процессы завершаются некорректно)
• Инспектор агента (agent_inspector.exe) — запускается отдельно для каждой активной сессии пользователя:
  • Собирает данные об активности (приложения, действия, скриншоты при включенном расширенном мониторинге)
  • Отправляет данные на сервер Proceset, если мониторинг для пользователя включен

Размер одного пакета данных за 10 минут — 1–3 КБ. Мини-дампы при сбоях — ~100 КБ, отправляются раз в час. Требуемая пропускная способность сети — не менее 256 байт/с.

Данные могут не передаваться по следующим причинам:

1. Агент не установлен — убедитесь, что он установлен на всех рабочих станциях сотрудника, включая VDI и терминальные серверы.
2. Служба остановлена — проверьте статус службы агента мониторинга в «Службах» Windows и при необходимости запустите ее.
3. Нет сетевого подключения к серверу:
   • Убедитесь, что порт сервера (обычно 443/TCP) открыт в межсетевых экранах и брандмауэре
   • Попробуйте открыть веб-интерфейс Proceset в браузере на компьютере сотрудника — если не загружается, проблема в сети
4. Неверный адрес сервера или API-ключ:
   • Адрес сервера и API-ключ задаются в файле C:\ProgramData\ProcesetAgent\settings.cfg
   • Несовпадение ключа приведет к отказу сервера принимать данные
5. Не задан параметр FE_URL (начиная с версии 25.3.15):
   • Если FE_URL не указан при развертывании сервера, агент получает localhost и пытается отправлять данные сам себе
   • В логах появляется ошибка: URL using bad/illegal format or missing URL

Для быстрой диагностики используйте утилиту agent_configurator.exe, которая расположена в C:\Program Files\ProcesetAgent\.

Нечитаемые символы в логах агента являются служебными или бинарными данными.

Они формируются в процессе работы системы. Эти данные:

• Не являются пользовательским текстом
• Не используются для аналитики и не интерпретируются как содержимое ввода
• Не свидетельствуют о сборе текста с клавиатуры

При диагностике работы агента обратите внимание на следующие файлы:

Если у вас возникли сложности с самостоятельной диагностикой — обратитесь в техническую поддержку по адресу support@infomaximum.com.

Файл activity.json содержит события активности пользователя, включая:

• Тип события
• Технические параметры активности
• Метаданные приложений и окон

Файл inspector_log.json — внутренний технический лог агента.

Назначение:

• Диагностика работы агента
• Анализ ошибок и нестандартных ситуаций

Этот лог:

• Не используется для бизнес-аналитики
• Не предназначен для анализа пользовательской активности

Уровень логирования настраивается централизованно и может быть снижен до уровня LEVEL_CRITICAL либо полностью отключен (LEVEL_OFF).

Пустые значения параметров допустимы и являются ожидаемой особенностью формирования событий.

Причины появления пустых значений:

• Ограничения API приложений
• Отсутствие соответствующих атрибутов у окна
• Ограничения со стороны ОС или политики безопасности

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

Агент определяет стандартные каталоги ОС для:

• Нормализации путей
• Замены абсолютных путей на переменные окружения

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

Для работы достаточно прав обычного пользователя.

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

Нет, агент мониторинга не поддерживает HTTP-редиректы (коды 301/302).

Если при обращении к адресу сервера Proceset происходит реальный HTTP-редирект, агент не сможет корректно установить соединение. В этом случае при установке или работе агента могут возникать ошибки вида: syntax error at or near position 0

Поддерживаются следующие сценарии:

• Реверс-прокси (например, Nginx, Apache), который прозрачно перенаправляет трафик без HTTP-редиректа
• DNS-алиасы (CNAME-записи), указывающие на корректный хост сервера Proceset

Сбор скриншотов настраивается в настройках, в разделе Исследования.

Процесс сбора пользовательской активности включает следующие этапы:

1. Фиксация активности агентом мониторинга
2. Отправка архивов: Раз в сутки агент отправляет собранные данные в виде архивов на сервер Proceset
3. Прием и первичная обработка:
   • Сервер сохраняет архивы во встроенную файловую базу данных
   • Архивы помещаются в очередь на обработку
   • Архивы, не соответствующие требованиям (например, с ошибками в manifest.json, несуществующим пользователем и т. д.), не попадают в ClickHouse и не отражаются в таблицах monitoring_activity и monitoring_agent_inspector_log. Такие архивы помещаются в специальную очередь corrupted и остаются на сервере
4. Синхронизация с ClickHouse:
   • По расписанию, заданному параметром rdb_ch_synchronization в файле com.infomaximum.subsystem.monitoring.json, запускается процесс синхронизации
   • Только корректные архивы из очереди обрабатываются и загружаются в таблицы ClickHouse:
     • main.monitoring_activity — основная активность пользователей
     • main.monitoring_agent_inspector_log — технические логи агентов

Агент мониторинга Proceset Agent использует системные API операционных систем Windows (Microsoft UI Automation и др.) и Linux (AT-SPI и др., если применимо).

Качество, полнота и корректность сбора аналитических данных, а также стабильность работы агента мониторинга целиком зависят от:

• Технологической совместимости клиентских приложений с используемыми API и стандартами доступности
• Особенностей архитектуры и реализации сторонних приложений, включая приложения, использующие проприетарные или устаревшие технологии (legacy-системы)
• Настроек безопасности и политик корпоративной инфраструктуры, блокировки сторонними средствами защиты, ограничений операционной системы и/или антивирусного программного обеспечения
• Корректности разметки и экспонирования свойств интерфейса со стороны мониторируемых приложений
• Правильности активации и поддержки соответствующих технологий доступности, например, Java Access Bridge для Java-приложений

Компания «Инфомаксимум» принимает все разумные меры для максимальной совместимости с прикладным программным обеспечением, однако не несет ответственности за те ограничения, которые предопределены архитектурой сторонних решений, изменениями системных API, либо политиками безопасности инфраструктуры клиента.

Если вы обнаружили, что активность из важного для вас приложения не учитывается — обратитесь в техническую поддержку по адресу support@infomaximum.com. Мы проанализируем ситуацию и, при возможности, предложим пути решения.

Версию сервера Proceset можно посмотреть в настройках системы на странице «О системе».

На странице О системе отображаются версии всех основных компонентов системы, включая сервер Proceset.

Версии установленных агентов мониторинга можно также проверить с помощью отчета Диагностика по агентам мониторинга.

Да, можно, для этого необходимо вставить JS-сниппет в приложение, настроить прием данных и построить дашборды в Proceset.

Выполните следующие шаги:

1. Добавьте сниппет JS-трекера, предоставленный в интерфейсе Proceset, в код всех страниц вашего сайта или веб-приложения. Сниппет загружает скрипт трекера для сбора событий, таких как просмотры страниц, клики, заполнение форм и другие.
2. Настройте прием данных. Убедитесь, что сервер Proceset доступен для приема данных. Если система работает в изолированном контуре, используйте агент Webhook.
3. Создайте скрипт для обработки данных. Трекер собирает события и передает их в Proceset. Для обработки этих событий необходимо создать скрипт с триггером Новое событие.
4. Постройте дашборд. Сохраните обработанные данные в таблицу в модели данных и настройте визуализацию через виджеты. Так вы сможете анализировать поведение пользователей: пути конверсии, узкие места и эффективность рекламных кампаний.