Администрирование процессов ОС

Обновлено 18.11.2026
Процессы ОС для администратора: маскирование командной строки, профиль для зон PCI DSS и ИСПДн, права доступа, лицензия, сроки хранения и настройки платформы, требования к ресурсам, несколько реплик приёма.

На этой странице:

Включение и отключение сбора процессов на агенте описано на странице Процессы ОС.

Маскирование командной строки

Командная строка процесса может содержать пароли и токены. Агент маскирует аргументы до отправки, платформа хранит и показывает уже замаскированную строку.

  • Ключ process_config.scrub_args по умолчанию true: значение после чувствительного аргумента заменяется на ********, например --password=********.
  • Встроенный словарь чувствительных слов: *password*, *passwd*, *mysql_pwd*, *access_token*, *auth_token*, *api_key*, *apikey*, *secret*, *credentials*, stripetoken; на Windows к нему добавлены /p и /rp.
  • Свои слова добавляются ключом process_config.custom_sensitive_words (список) или переменной окружения POBP_CUSTOM_SENSITIVE_WORDS (JSON или список через запятую). Они дополняют встроенный словарь.
process_config:
  scrub_args: true
  custom_sensitive_words:
    - "*token*"
    - "--db-pass"

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

Регулярные выражения правил групп процессов и поле «Командная строка содержит» поиска по парку сравниваются с уже замаскированной строкой.

Переменные окружения процессов агент не собирает.

Профиль для зон PCI DSS и ИСПДн

Для хостов платёжного контура и информационных систем персональных данных рекомендуется не передавать аргументы процессов вовсе и исключить процессы, работающие с картами и персональными данными:

process_config:
  process_collection:
    enabled: true
  strip_proc_arguments: true
  blacklist_patterns:
    - "^/opt/payment/"
    - "card-processor"
  • strip_proc_arguments: true — от командной строки остаётся только исполняемый файл. В Helm-чарте агента то же задаёт protoobp.processAgent.stripProcessArguments: true.
  • blacklist_patterns — список регулярных выражений; процессы, совпавшие с ними, агент не присылает совсем. Подставьте выражения под процессы своего контура.

С таким профилем группы процессов по имени исполняемого файла, графики и алерт «не запущена» работают; условия правил по регулярному выражению командной строки видят только имя исполняемого файла.

Права доступа

Процессы ОС регулируются типом ресурса processes в ролевой модели:

ДействиеЧто открывает
просмотр (view)вкладки «Процессы» в карточке хоста и на странице списка хостов, просмотр правил групп процессов
редактирование (edit)создание, изменение, удаление и порядок правил групп процессов
  • Роль с правом просмотра всех ресурсов получает просмотр processes автоматически. Отдельного права на командную строку нет.
  • Какие хосты видны, определяют гранты host и host_group: процессы хоста видны, если роли доступен сам хост или группа хостов, в которую он входит. Состав группы раскрывается платформой.
  • Гранты service и service_group процессы не открывают. Роль, в которой есть ограничения, но нет грантов host и host_group, процессов не видит.
  • Все процессы видит только роль без ограничений по данным.
  • Хост вне доступа роли выглядит как неизвестный: «Хост неизвестен или вне вашей области доступа».
  • Правило группы процессов можно изменить, только если его область до и после изменения входит в доступ роли через host_group. Область «Все хосты» создаёт и правит только роль без ограничений.
  • Ряды групп процессов в хранилище метрик несут метку host, к ним применяется обычный фильтр по доступу роли (дашборды, браузер метрик, PromQL).

Лицензия

Процессы ОС входят в модуль лицензии «Инфраструктура» (INFRA).

  • Без модуля приём процессов на бэкенде отвечает агенту отказом, API процессов недоступно, вкладки «Процессы» и раздел Группы процессов в интерфейсе скрыты.
  • Своего учёта хостов у процессов нет: действуют те же правила, что для инфраструктурных метрик. Списки процессов и ряды групп от хостов сверх лимита хостов модуля «Инфраструктура» отбрасываются так же, как метрики этих хостов.
  • При истёкшей лицензии приём останавливается целиком, как для остальных данных.

Подробнее о лицензии — Лицензирование.

Сроки хранения

ДанныеГде хранятсяСрок по умолчаниюПеременнаяМинимум
Живой список процессовproto-database24 часаPOBP_DATA_RETENTION_DB_OS_PROCESS_LIVE_HOURS1
Инвентарь процессовproto-database30 дней от последнего появления процессаPOBP_DATA_RETENTION_DB_OS_PROCESS_INVENTORY_DAYS2
Короткоживущие процессы ОС (виден меньше 60 с) в инвентареproto-database7 днейPOBP_DATA_RETENTION_DB_OS_PROCESS_SHORT_LIVED_DAYS2; не больше срока инвентаря
Ряды групп процессовproto-metric-storageобщий срок метрик (2w)POBP_DATA_RETENTION_METRICS—
  • Долгоживущий процесс не выпадает из инвентаря: раз в сутки платформа обновляет время последнего появления у всех работающих процессов.
  • Сроки применяются к таблицам при каждом запуске proto-trace-processor. Значение меньше минимума поднимается до минимума. Срок короткоживущих, заданный больше срока инвентаря, уменьшается до срока инвентаря, в журнал пишется предупреждение.
  • Переменная POBP_DATA_RETENTION_DB_PROCESS_DAYS относится к бизнес-процессам, а не к процессам ОС.

Как задать переменные:

  • Установка из Docker Compose — в файле .env (шаблон env_template схем 1-server, 2-server, 3-server и 4-server), затем перезапустите сервисы. Общий порядок — Расширенная конфигурация.
  • Установка из Helm-чарта бэкенда — в global.config, например:
global:
  config:
    POBP_DATA_RETENTION_DB_OS_PROCESS_INVENTORY_DAYS: "45"

Настройки платформы

Переменные proto-trace-processor; задаются там же, где сроки хранения (.env или global.config Helm-чарта бэкенда).

ПеременнаяПо умолчаниюМинимумЧто задаёт
POBP_TRACE_PROCESSOR_CONFIG_ENABLE_OS_PROCESSEStrue—выключатель приёма процессов. При false агенты получают обычный ответ, данные не разбираются и не сохраняются
POBP_TRACE_PROCESSOR_OS_PROCESS_LIVE_INTERVAL_SECONDS6030как часто обновляется живой список хоста; большой установке рекомендуется 120 (вдвое реже перезаписывается живой список в proto-database)
POBP_TRACE_PROCESSOR_OS_PROCESS_SERIES_INTERVAL_SECONDS3010интервал рядов групп процессов
POBP_TRACE_PROCESSOR_OS_PROCESS_AUTO_GROUPS_MAX_PER_HOST1001сколько автоматических групп учитывается на хосте; остальные процессы идут в _other
POBP_TRACE_PROCESSOR_OS_PROCESS_STATE_IDLE_MINUTES102через сколько минут без данных забывается состояние хоста с полным сбором
POBP_TRACE_PROCESSOR_OS_PROCESS_DISCOVERY_STATE_IDLE_HOURS95то же в часах для хоста только с обнаружением процессов (списки раз в 4 ч)
POBP_TRACE_PROCESSOR_OS_PROCESS_FLUSH_SECONDS21период записи пачек в proto-database, от 1 до 5

Состояние хоста — то, с чем сравнивается очередной список процессов, чтобы найти появления и пропажи. Оно хранится в памяти proto-trace-processor. После перезапуска proto-trace-processor или когда состояние забыто, следующий список хоста записывается как появления, пропажи за пропущенное время не записываются.

Требования к ресурсам

Дополнительно к текущему потреблению установки:

КомпонентСверх текущего
proto-trace-processorоколо 2 ядер, 0,5–1 ГБ памяти (состояние хостов около 80 МБ и буфер сборки списков; при одновременном подключении тысяч хостов — кратковременный пик до 0,8 ГБ)
proto-nginxоколо 0,5 ядра
Сеть от агентовоколо 5300 запросов/с, до 23 МБ/с, около 2 ТБ в сутки
proto-database0,2–0,5 ядра; живой список до 0,2 ГБ; инвентарь 10–12 ГБ за срок хранения; запись вставок и слияний около 130 ГБ в сутки при интервале живого списка 60 с; при 120 с меньше
proto-metric-storageоколо 0,5 ядра, 1 ГБ памяти на 1 млн рядов, 1–3 ГБ диска в сутки, до 3 млн рядов
  • С версии 204 лимит памяти proto-trace-processor в поставке увеличен на 1 ГБ: в Helm-чарте бэкенда с 3Gi до 4Gi, в схемах 1-server и 2-server с 3g до 4g, в схемах 3-server и 4-server с 8g до 9g. Если лимит переопределён у вас, увеличьте его сами.
  • Для больших установок задайте POBP_TRACE_PROCESSOR_OS_PROCESS_LIVE_INTERVAL_SECONDS=120.
  • Хосты только с обнаружением процессов почти не создают нагрузки: единицы килобайт раз в 4 часа.

Несколько реплик proto-trace-processor

По умолчанию proto-trace-processor работает в одной реплике. Состояние хостов хранится в памяти экземпляра, поэтому при нескольких репликах все списки процессов одного хоста должны приходить в один и тот же экземпляр.

  • В Helm-чарте бэкенда при traceProcessor.replicas больше 1 proto-nginx включает привязку хоста к реплике: запросы приёма процессов распределяются по хэшу имени хоста, которое агент передаёт в заголовке запроса, между репликами за headless-сервисом proto-trace-processor-headless. Остальные запросы распределяются как раньше.
  • В Docker Compose привязку включает переменная POBP_NGINX_PTP_HOST_AFFINITY=true у proto-nginx.
  • При изменении числа реплик большая часть хостов переезжает на другие экземпляры. Состояние таких хостов собирается заново со следующего полного списка: этот список записывается как появления, пропажи за время переезда не записываются, счётчики CPU групп начинаются с нуля.