Сбор данных по файлам

Файловая инвентаризация собирает все обычные файлы данных на устройстве, то есть файлы, не являющиеся символическими ссылками, устройствами, сокетами, FIFO и т. п. В выводе команды ls -l такие файлы обозначаются символом - в начале строки прав доступа.

Сбор включает как исполняемые файлы, так и неисполняемые. При этом для каждого файла передается признак исполняемости.

Для настройки сбора данных по файлам на устройстве в меню навигации выберите Настройки > Инвентаризация устройств > Сбор данных программного обеспечения > Сбор данных по файлам.

Включение и отключение сбора данных по файлам

По умолчанию файловая инвентаризация отключена.

Чтобы включить ее, на странице настроек сбора данных по файлам установите флажок Собирать данные.

После этого становятся доступны для изменения настройки расписания сбора данных, а также настройки состава собираемых данных.

Изменение расписания сбора данных по файлам

Для настройки расписания сбора данных по файлам на странице «Сбор данных по файлам» раскройте вкладку Расписание и задайте следующие параметры:

  • расписание полной инвентаризации:

    • Запускать каждые — периодичность выполнения инвентаризации (значение по умолчанию: 7);

    • Период — единица измерения времени; возможные значения: секунды, минуты, часы, дни (значение по умолчанию: дни);

    • Случайный разброс, секунд — интервал случайной задержки (в секундах) перед запуском задачи на агенте; используется для равномерного распределения нагрузки при одновременном запуске на множестве устройств (значение по умолчанию: 3600);

    • Указать интервал запуска — установить ограничение времени выполнения инвентаризации в рамках суток (например, только с 02:00 до 05:00); если ограничение отсутствует, инвентаризация может запускаться в любое время (значение по умолчанию: не задано);

  • расписание частичной инвентаризации:

    • Запускать каждые — периодичность выполнения инвентаризации (значение по умолчанию: 1);

    • Период — единица измерения времени; возможные значения: секунды, минуты, часы, дни (значение по умолчанию: дни);

    • Случайный разброс, секунд — интервал случайной задержки (в секундах) перед запуском задачи на агенте; используется для равномерного распределения нагрузки при одновременном запуске на множестве устройств (значение по умолчанию: 600);

    • Указать интервал запуска — установить ограничение времени выполнения инвентаризации в рамках суток (например, только с 02:00 до 05:00); если ограничение отсутствует, инвентаризация может запускаться в любое время (значение по умолчанию: не задано);

    • Запуск при старте устройства — выполнять частичную инвентаризацию при старте устройства.

Для сохранения изменений нажмите Сохранить.

Пример настройки расписания полной и частичной инвентаризации:

file inventory schedule

Изменение настроек (режима) сбора данных по файлам

Для настройки состава собираемых данных по файлам на странице «Сбор данных по файлам» раскройте вкладку Собираемые данные и задайте следующие параметры:

  • в разделе Белый список укажите путь к директории, в которой должно выполняться сканирование; для добавления нескольких путей нажмите + Добавить и введите дополнительный путь;

    Для корректной работы сбора данных обязательно должен быть указан хотя бы один путь в белом списке.
  • в разделе Черный список укажите путь к директории, которая должна быть исключена из сканирования; для добавления нескольких путей нажмите + Добавить и введите дополнительный путь.

    Черный список имеет приоритет над белым: даже если директория указана в белом списке, она будет исключена, если также присутствует в черном.

Для сохранения изменений нажмите Сохранить.

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

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

  • белый и черный списки работают совместно: файлы сканируются только в директориях, указанных в белом списке, но исключаются, если они попадают в черный список;

  • приоритет имеет черный список: исключения перекрывают разрешения;

  • списки поддерживают абсолютные пути (например, /etc, /var/tmp), но не поддерживают шаблоны или регулярные выражения.

Пример настройки черных и белых списков для сбора данных по файлам:

file inventory black white lists

Задержка при отображении результатов инвентаризации

После выполнения инвентаризации информация о файлах на странице «Инвентаризация ПО и файлов» отображается с некоторой задержкой. Это связано с настройкой расписания синхронизации данных (параметр osmax.inventory.software.files.sync-cache-data-cron в таблице app_config в БД модуля osmax-core; по умолчанию — 1 раз в 60 минут).

Особенности работы частичной и полной инвентаризации

При выполнении полной инвентаризации на устройстве создается кэш-файл с полным списком всех обнаруженных файлов. Этот кэш используется для последующих частичных инвентаризаций — они сравнивают текущее состояние системы с кэшем и передают в «Осмакс» только изменения (добавленные, удаленные или измененные файлы).

Время актуальности кэша вычисляется на основе параметров расписания полной инвентаризации: значение интервала выполнения (в часах, днях или минутах) преобразуется в секунды и суммируется со значением параметра Случайный разброс, секунд. Полученное итоговое значение в секундах определяет момент, когда результаты локальной инвентаризации считаются устаревшими (неактуальными).

При запуске частичной инвентаризации система проверяет наличие результатов полной инвентаризации на устройстве и сравнивает текущее время с рассчитанным временем актуальности кэша:

  • если кэш отсутствует или просрочен, выполняется полная инвентаризация для восстановления актуального состояния;

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

При расчете периода актуальности кэша временные ограничения из расписания (например, интервал «с 01:00 до 04:00») не учитываются.

Обновлено: