Формула peripheral-inventory-formula

Формула для сбора информации о подключенных периферийных устройствах (USB-устройства и мониторы) с использованием утилиты hwinfo и модуля peripheral_inventory.

Доступные состояния

Состояние peripheral-inventory.run

Устанавливает пакет hwinfo на целевом хосте и выполняет модуль peripheral_inventory.inventory для сбора данных о периферийных устройствах.

Результаты сбора отправляются в виде Salt-событий с тегом osmax/peripheral_inventory/inventory/{execution_id}/{batch_num}.

Данные собираются на основе параметров, заданных в pillar-файле формулы в объекте lookup.

Параметры сбора

Параметры сбора задаются в pillar-файле формулы в объекте lookup.

Поддерживаемые параметры:

Параметр Тип Описание Пример

collect_usb

Логическое значение

Включить сбор информации о USB-устройствах

True

collect_monitor

Логическое значение

Включить сбор информации о мониторах

True

full_info

Логическое значение

Включить полную детализацию устройств в формате JSON (включая все атрибуты hwinfo)

True

Пример задания параметров при создании версии конфигурации в пользовательском интерфейсе «Кабинет администратора»:

{
  "lookup": {
    "full_info": true,
    "collect_usb": true,
    "collect_monitor": true
  }
}
Обратите внимание — имя формулы указывать не требуется. Оно добавляется автоматически при сохранении версии конфигурации вместе с уникальным идентификатором (атрибут version_id).

Результат сохранения версии конфигурации:

peripheral inventory configuration version example

Особенности использования параметров:

  • значения по умолчанию: collect_usb: True, collect_monitor: True, full_info: False;

  • если full_info: False, возвращаются только базовые данные (тип, производитель, модель, серийный номер);

  • для корректной работы требуется наличие пакета hwinfo, который устанавливается автоматически при применении состояния;

  • сбор данных происходит на стороне агента, результаты не сохраняются локально и передаются как события.

Пример файла pillar.example

# Формула peripheral-inventory — сбор информации о периферийных устройствах
# Все параметры передаются через ключ peripheral-inventory в Pillar
peripheral-inventory:
  # Версия конфигурации. Автоматически генерируется при сохранении версии
  version_id: 20260130
  # lookup — объект с параметрами сбора данных
  lookup:
    # Собирать информацию о USB-устройствах
    collect_usb: True
    # Собирать информацию о мониторах
    collect_monitor: True
    # Включать полную информацию в формате JSON
    full_info: False

Обновлено: