Параметры и пример Excel-файла, содержащего конфигурацию активов и тегов
Конфигурационный файл создается квалифицированным техническим специалистом Заказчика, сотрудником "Лаборатории Касперского" или сертифицированным интегратором. Системный администратор загружает конфигурацию активов и тегов иерархической структуры в разделе Активы в меню администратора.
Порядок параметров на вкладках конфигурационного файла не важен.
Конфигурационный файл содержит следующие вкладки:
- readme – вкладка, содержащая общую информацию о конфигурационном файле.
- directory_types – вкладка, описывающая типы активов иерархической структуры с помощью следующих параметров:
- directory_type_id – идентификатор типа актива. Идентификатор присваивается автоматически при экспорте дерева активов.
- directory_type – уникальное имя типа актива.
- parameter<номер параметра>_label – имена специальных параметров, где <номер параметра> соответствует значению из диапазона от 1 до 5. Если у актива заданного типа отсутствует какой-либо специальный параметр, оставьте соответствующее поле в конфигурационном файле пустым.
- description – описание типа актива. Поле не обязательно для заполнения.
- directories – вкладка, описывающая активы иерархической структуры с помощью следующих параметров:
- directory_id – идентификатор актива. Идентификатор присваивается автоматически при экспорте дерева активов.
- directory_type – тип актива. Тип выбирается из типов активов, заданных на вкладке directory_types.
- directory_type row – номер строки на вкладке directory_types, на которой описан выбранный тип актива. Поле заполняется автоматически.
- directory_name – уникальное имя актива в рамках его родительского актива.
При вводе имени актива не допускается перенос части имени на новую строку и использование обратной косой черты (\).
- directory_info – описание актива. Поле не обязательно для заполнения.
- parent – родительский актив. Если импортируемый актив находится на верхнем уровне иерархии активов, оставьте поле parent пустым.
При вводе имени актива не допускается перенос части имени на новую строку и использование обратной косой черты (\).
- parent row – номер строки, на которой описан выбранный родительский актив. Поле заполняется автоматически.
- parent_id – идентификатор родительского актива. Идентификатор присваивается автоматически при экспорте дерева активов.
- parameter<номер параметра> – имена специальных параметров, где <номер параметра> соответствует значению из диапазона от 1 до 5. Имена специальных параметров заполняются автоматически, если для выбранного типа актива определены специальные параметры.
- value<номер параметра> – значения специальных параметров, где <номер параметра> соответствует значению из диапазона от 1 до 5. Если у актива отсутствует специальный параметр, оставьте поле для ввода соответствующего значения пустым.
- criticality – уровень критичности актива. Поле не обязательно для заполнения. Вы можете указать следующие значения:
- very_high – соответствует значению по умолчанию Очень высокий.
- high – соответствует значению по умолчанию Высокий.
- medium – соответствует значению по умолчанию Средний.
- low – соответствует значению по умолчанию Низкий.
- very_low – соответствует значению по умолчанию Очень низкий.
При необходимости вы можете изменить значения уровней критичности.
- tags – вкладка, описывающая теги иерархической структуры с помощью следующих параметров:
- tag_id – идентификатор тега. Значение идентификатора присваивается автоматически в диапазоне от 1 до 1 000 000 при экспорте первичных элементов иерархической структуры.
- tag_name – уникальное имя тега.
При вводе имени тега не допускается перенос части имени на новую строку и использование обратной косой черты (\).
- alternate_name – уникальное альтернативное имя тега. Поле не обязательно для заполнения.
При вводе альтернативного имени тега не допускается перенос части имени на новую строку и использование обратной косой черты (\).
- tag_description – описание тега.
- parent – родительский актив, к которому относится тег. Если для импортируемого тега родительским элементом является головной элемент иерархической структуры, оставьте поле parent пустым.
- parent_row – номер строки на вкладке directories, на которой описан выбранный родительский актив. Поле заполняется автоматически.
- parent_id – идентификатор родительского актива. Идентификатор присваивается автоматически при экспорте дерева активов.
- tag_type – тип тега. Поле не обязательно для заполнения.
- tag_units – единица измерения тега.
- red_min – нижний порог предельно допустимого значения тега. Поле не обязательно для заполнения.
- red_max – верхний порог предельно допустимого значения тега. Поле не обязательно для заполнения.
- yellow_min – нижний порог сигнализации, при достижении которого оператору следует обратить внимание на поведение тега. Поле не обязательно для заполнения.
- yellow_max – верхний порог сигнализации, при достижении которого оператору следует обратить внимание на поведение тега. Поле не обязательно для заполнения.
- validity_min – нижний порог физически возможных значений тега. Поле не обязательно для заполнения.
- validity_max – верхний порог физически возможных значений тега. Поле не обязательно для заполнения.
- comment – комментарий к тегу. Поле не обязательно для заполнения.
- x – координата расположения датчика объекта мониторинга по оси абсцисс. Поле не обязательно для заполнения.
- y – координата расположения датчика объекта мониторинга по оси ординат. Поле не обязательно для заполнения.
- z – координата расположения датчика объекта мониторинга по оси аппликат. Поле не обязательно для заполнения.
- bias – значение, которое необходимо добавить к значению тега, переданному в Kaspersky MLAD. Укажите
0, если конвертация значения не требуется.Конвертация значений, поступающих в Kaspersky MLAD выполняется при включенном переключателе Масштабировать полученные значения тегов в параметрах используемого коннектора и/или источника данных. Значение bias добавляется к результату умножения полученного значения тега на значение multiplier.
- multiplier – значение, на которое необходимо умножить значение тега, переданное в Kaspersky MLAD. Укажите
1, если конвертация значения не требуется.Конвертация значений, поступающих в Kaspersky MLAD выполняется при включенном переключателе Масштабировать полученные значения тегов в параметрах используемого коннектора и/или источника данных. Умножение полученного значения тега на значение multiplier выполняется перед добавлением значения bias.
На рисунках ниже приведен пример файла в формате XLSX, который содержит описания активов и тегов и их конфигурацию.
Вкладка directory_types
Вкладка directories
Вкладка tags
