Filesystem monitoring

Расширения / Filesystem monitoring

Расширение Filesystem monitoring версии 1.5.7 контролирует файлы, каталоги и точки монтирования на хостах Windows и Linux. Идентификатор: ru.ruscomtech.filesystem.

Возможности

• Подсчёт файлов и каталогов по пути или glob-шаблону.
• Сбор размера файлов и возраста последнего изменения.
• Подсчёт файлов старше или новее заданного возраста.
• Проверка наличия точки монтирования в Unix.
• Работа с локальной файловой системой и файловыми ресурсами Azure File Share.
• Запуск проверок по расписанию, в том числе ежемесячному и ежегодному.
• Выполнение проверок от имени другого пользователя и использование хранилища учётных данных.

Требования и режим работы

• Ключ-АСТРОМ 1.318.0+ и контроллер выполнения расширений (EEC) 1.310.0+.
• ЕдиныйАгент с включённым EEC на каждом контролируемом хосте Windows или Linux.
• Среда Python не ниже 3.9 в составе EEC. Устанавливать Python и зависимости вручную в системную среду не требуется.
• Учётная запись выполнения должна иметь доступ на чтение к проверяемым путям. Для сетевого ресурса нужны также сетевой доступ и права на ресурс.

Расширение поддерживает только локальное выполнение через ЕдиныйАгент. Удалённый запуск на АктивномШлюзе не предусмотрен. Локальный режим не запрещает проверку сетевого ресурса, если он доступен учётной записи выполнения на этом хосте.

Поддерживаются Azure File Share, а не Azure Blob Storage. Для Azure необходим доступ от хоста выполнения к файловому ресурсу; рекурсивный поиск в Azure не поддерживается.

Установка

1. Откройте раздел Расширения в Ключ-АСТРОМ.
2. Загрузите подписанный ZIP-пакет ru.ruscomtech.filesystem и активируйте нужную версию.
3. Добавьте конфигурацию мониторинга и выберите локальное выполнение на нужных хостах.
4. Добавьте проверки в список Filesystem check. Одна конфигурация содержит от 1 до 100 проверок.
5. Заполните параметры, сохраните и включите конфигурацию.

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

Конфигурация проверок

Основные параметры

• Check Type (check_type) — тип проверки. По умолчанию count:
  • count — количество объектов по заданному пути или шаблону;
  • size — суммарный размер найденных файлов;
  • modification_time — возраст самого нового либо самого старого файла;
  • age_count — количество файлов старше либо новее порога;
  • mount — состояние точки монтирования: 1 — смонтирована, 0 — нет.
• Path (path) — абсолютный путь к файлу, каталогу или glob-шаблон. Для mount укажите конкретную точку монтирования.
• File system (file_system_type) — local для файловой системы ОС либо azure для Azure File Share. По умолчанию local.
• Frequency (frequency) — период проверки в минутах, от 1 до 1440; по умолчанию 1.
• Enabled (enabled) — включает отдельную проверку; по умолчанию включено.

Параметры отдельных типов проверок

• Count directories (count_dirs) — учитывать каталоги вместе с файлами при локальном подсчёте. По умолчанию включено; отключите для подсчёта только файлов.
• Use newest file (modification_newest) — для modification_time возвращать возраст самого нового файла. По умолчанию включено; отключите для самого старого.
• Age comparison operator (modification_count_condition) — для age_count: greater (Older than) либо less (Newer than).
• File age (modification_count_threshold) — порог возраста в минутах для age_count.
• Mount type (file_system_mount_type) — unix для проверки точки монтирования. Этот тип проверки предназначен для Unix, а не для дисков Windows или Azure API.
• Azure account и Azure key — учётная запись хранилища Azure и её ключ для доступа к File Share. Ключ задавайте в секретном поле конфигурации, не сохраняйте его в Git или примерах.

Пути и шаблоны

Для локальных файлов доступны обычные glob-шаблоны, включая рекурсивный поиск через **.

• /var/log/myapp/*.log — журналы непосредственно в каталоге; /var/log/myapp/**/*.log — также во вложенных каталогах.
• C:\temp\*.log — журналы в каталоге Windows.
• Для поиска журналов старше часа выберите age_count, путь /var/log/myapp/*.log, оператор Older than и порог 60.

В путях поддерживаются подстановки даты: DDMMYYYY, DD-MM-YYYY, DD_MM_YYYY, YYYYMMDD, YYYY-MM-DD, YYYY_MM_DD, DDMmmYYYY, DDMMMYYYY и DDmmmYYYY. Например, /var/log/myapp/app-YYYY-MM-DD.log обозначает журнал за текущую дату по локальному времени хоста выполнения.

Для смещения даты добавьте суффикс |-3d: /var/log/myapp/app-YYYY-MM-DD.log|-3d проверит файл за три дня до текущей даты.

Выполнение от другого пользователя

По умолчанию используются права служебной учётной записи выполнения расширения. Если их недостаточно, включите Run check as another user (assumeUser).

• Для учётных данных из хранилища включите Use credential vault и выберите запись типа Username and password.
• При ручном вводе на Windows укажите Username в формате DOMAIN\Username и Password; поле SUDO Command оставьте пустым.
• На Linux доступны sudo и sesu. Поле Username задаёт целевого пользователя; если оно пустое, команда вызывается без явного имени пользователя.

Права на переключение пользователя настраиваются администратором ОС отдельно. Расширение не выдаёт эти права и не меняет правила sudo автоматически.

Расписание

Без расписания проверка выполняется круглосуточно с периодом Frequency.

Для ограничения времени работы включите Schedule enabled (schedule_enabled):

• Days enabled — разрешённые дни недели.
• Schedule time (schedule_time) — время начала окон в формате HH:MM; несколько значений разделяются точкой с запятой, например 09:00;18:00. Пустое поле означает отсутствие ограничения по времени суток.
• Schedule duration (timeout) — длительность каждого окна в минутах. Это не таймаут выполнения проверки. Например, начало 09:00 и длительность 480 задают восьмичасовое окно.

Advanced Scheduler (advanced_schedule) позволяет выбрать ежемесячное или ежегодное повторение:

• Ежемесячно: перечислите числа месяца в Day of month либо выберите день недели и его порядковое вхождение в месяц — первое, второе, третье, четвёртое или последнее.
• Ежегодно: перечислите даты в формате MM-DD через запятую.

Дни и время рассчитываются по локальному времени хоста выполнения. Расписание ограничивает доступные окна, а Frequency задаёт период проверок внутри них.

Дополнительные сведения

Включите Specify additional metadata (extra_dimensions), чтобы добавить до трёх измерений: info1, info2 и info3. Их можно использовать для команды сопровождения, назначения проверки или номера инструкции. Не помещайте в измерения пароли и другие секреты.

Метрики и проверка работы

• filesystem.file_count — количество найденных объектов.
• filesystem.file_size — размер файлов в байтах.
• filesystem.file_age — возраст файла в секундах.
• filesystem.file_age_count — количество файлов, соответствующих условию по возрасту.
• filesystem.file_mount — состояние точки монтирования.

Для контролируемых путей создаются сущности filesystem:path. В пакете доступны обзорные панели файлового мониторинга.

После сохранения конфигурации дождитесь проверки внутри разрешённого окна расписания. Убедитесь, что конфигурация не сообщает об ошибках, а метрика выбранного типа поступает с нужным измерением path.

Если данных нет, проверьте выбранные хосты, состояние EEC, права служебной учётной записи, путь и glob-шаблон, признак Enabled и расписание. Для Azure дополнительно проверьте доступ к File Share и учётные данные. Отсутствие файлов, запрет доступа и пропуск по расписанию — разные ситуации; уточняйте причину по статусу и журналу расширения.

История версий

Версия 1.5.7

Версия расширения для Ключ-АСТРОМ 1.318.0+; требуется EEC 1.310.0+.

• Доступны локальные проверки файлов, каталогов и точек монтирования, а также файловых ресурсов Azure File Share.
• Поддерживаются расширенные ежемесячные и ежегодные расписания, хранилище учётных данных и дополнительные измерения info1, info2, info3.
• В пакет включены обзорные панели файлового мониторинга.

Версия 1.3.3

• В параметры запуска проверок от имени другого пользователя на узлах Linux добавлена поддержка sesu.
• Исправлен запуск через sudo: если имя пользователя не указано, команда корректно вызывается служебным пользователем dtuser без явного имени целевого пользователя.

Версия 1.3.0

Начало поддержки расширения в Ключ-АСТРОМ 1.289.0+.