Администрирование процессов ОС
Версия
Процессы ОС доступны начиная с версии 204.На этой странице:
- Маскирование командной строки
- Профиль для зон PCI DSS и ИСПДн
- Права доступа
- Лицензия
- Сроки хранения
- Настройки платформы
- Требования к ресурсам
- Несколько реплик proto-trace-processor
Включение и отключение сбора процессов на агенте описано на странице Процессы ОС.
Маскирование командной строки
Командная строка процесса может содержать пароли и токены. Агент маскирует аргументы до отправки, платформа хранит и показывает уже замаскированную строку.
- Ключ
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"
Маскирование работает и при полном сборе, и при обнаружении процессов. Аргументы, в которых нет слов из словаря, уходят как есть — учитывайте это, если в командных строках бывают персональные данные.
Ответственность администратора агента
Хост сscrub_args: false присылает командную строку без маскирования. Платформа не может определить, что маскирование выключено, и хранит строку как пришла. Следите за настройкой агентов на хостах, где в командной строке бывают секреты.Регулярные выражения правил групп процессов и поле «Командная строка содержит» поиска по парку сравниваются с уже замаскированной строкой.
Переменные окружения процессов агент не собирает.
Профиль для зон 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-database | 24 часа | POBP_DATA_RETENTION_DB_OS_PROCESS_LIVE_HOURS | 1 |
| Инвентарь процессов | proto-database | 30 дней от последнего появления процесса | POBP_DATA_RETENTION_DB_OS_PROCESS_INVENTORY_DAYS | 2 |
| Короткоживущие процессы ОС (виден меньше 60 с) в инвентаре | proto-database | 7 дней | POBP_DATA_RETENTION_DB_OS_PROCESS_SHORT_LIVED_DAYS | 2; не больше срока инвентаря |
| Ряды групп процессов | 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_PROCESSES | true | — | выключатель приёма процессов. При false агенты получают обычный ответ, данные не разбираются и не сохраняются |
POBP_TRACE_PROCESSOR_OS_PROCESS_LIVE_INTERVAL_SECONDS | 60 | 30 | как часто обновляется живой список хоста; большой установке рекомендуется 120 (вдвое реже перезаписывается живой список в proto-database) |
POBP_TRACE_PROCESSOR_OS_PROCESS_SERIES_INTERVAL_SECONDS | 30 | 10 | интервал рядов групп процессов |
POBP_TRACE_PROCESSOR_OS_PROCESS_AUTO_GROUPS_MAX_PER_HOST | 100 | 1 | сколько автоматических групп учитывается на хосте; остальные процессы идут в _other |
POBP_TRACE_PROCESSOR_OS_PROCESS_STATE_IDLE_MINUTES | 10 | 2 | через сколько минут без данных забывается состояние хоста с полным сбором |
POBP_TRACE_PROCESSOR_OS_PROCESS_DISCOVERY_STATE_IDLE_HOURS | 9 | 5 | то же в часах для хоста только с обнаружением процессов (списки раз в 4 ч) |
POBP_TRACE_PROCESSOR_OS_PROCESS_FLUSH_SECONDS | 2 | 1 | период записи пачек в proto-database, от 1 до 5 |
Состояние хоста — то, с чем сравнивается очередной список процессов, чтобы найти появления и пропажи. Оно хранится в памяти proto-trace-processor. После перезапуска proto-trace-processor или когда состояние забыто, следующий список хоста записывается как появления, пропажи за пропущенное время не записываются.
Требования к ресурсам
Как получены цифры
Цифры ниже — по нагрузочному замеру на 3500 хостах × 500 процессов с полным сбором, пересчитанные на парк 10 000 хостов. Полный поток 10 000 хостов не замерялся.Дополнительно к текущему потреблению установки:
| Компонент | Сверх текущего |
|---|---|
proto-trace-processor | около 2 ядер, 0,5–1 ГБ памяти (состояние хостов около 80 МБ и буфер сборки списков; при одновременном подключении тысяч хостов — кратковременный пик до 0,8 ГБ) |
proto-nginx | около 0,5 ядра |
| Сеть от агентов | около 5300 запросов/с, до 23 МБ/с, около 2 ТБ в сутки |
proto-database | 0,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 часа.
Ограничения версии 204
- Когда одновременно подключаются тысячи новых хостов (например, после перезапуска
proto-trace-processorна большом парке), первые десятки секунд часть списков процессов отбрасывается:proto-databaseне успевает записывать появления. Следующие списки этих хостов принимаются, данные восстанавливаются за один-два интервала сбора. - Поиск по парку по подстроке командной строки за 7 суток на парке 10 000 хостов укладывается в 30 секунд, если под подстроку попадает немного процессов. Если подходят миллионы процессов за период (например, скрипт проверки, который каждые несколько секунд запускается на всех хостах), поиск может не уложиться в 30 секунд и покажет «Сузьте период или группу хостов». Тогда сужайте период или группы хостов либо уточняйте подстроку. Поиск по точному имени процесса за тот же период укладывается в несколько секунд.
Несколько реплик proto-trace-processor
По умолчанию proto-trace-processor работает в одной реплике. Состояние хостов хранится в памяти экземпляра, поэтому при нескольких репликах все списки процессов одного хоста должны приходить в один и тот же экземпляр.
- В Helm-чарте бэкенда при
traceProcessor.replicasбольше 1proto-nginxвключает привязку хоста к реплике: запросы приёма процессов распределяются по хэшу имени хоста, которое агент передаёт в заголовке запроса, между репликами за headless-сервисомproto-trace-processor-headless. Остальные запросы распределяются как раньше. - В Docker Compose привязку включает переменная
POBP_NGINX_PTP_HOST_AFFINITY=trueуproto-nginx. - При изменении числа реплик большая часть хостов переезжает на другие экземпляры. Состояние таких хостов собирается заново со следующего полного списка: этот список записывается как появления, пропажи за время переезда не записываются, счётчики CPU групп начинаются с нуля.
Ограничение версии 204
Остальные частиproto-trace-processor (миграции, фоновые задачи) к работе в нескольких репликах в версии 204 не готовы. Параметр traceProcessor.replicas — задел на будущее; в рабочих установках оставляйте одну реплику.