Параметры и пример JSON-файла, описывающего пресеты

Файл формата JSON с описанием пресетов создается квалифицированным техническим специалистом Заказчика, сотрудником "Лаборатории Касперского" или сертифицированным интегратором. Файл с описанием пресетов загружается пользователем в разделе Пресеты.

В JSON-файле задается информация о пресетах в параметре presets, который в свою очередь содержит следующие параметры:

• name – имя пресета.

• code – идентификатор пресета в базе данных Kaspersky MLAD. Идентификатор присваивается автоматически при загрузке файла.
• sort – порядковый номер отображения пресета в разделе Пресеты.
• tags – список идентификаторов тегов, входящих в состав пресета.
• parent_category_id – идентификатор актива, к которому относится пресет. Идентификатор должен соответствовать значению параметра directory_id, указанному в Excel-файле, содержащем конфигурацию активов и тегов. Параметр имеет значение root, если пресет относится к головному элементу иерархической структуры.
  

  Способ представления объекта мониторинга в виде дерева, конечные узлы которого являются тегами, а промежуточные – активами.

• is_display_on_time_slice – параметр, определяющий, требуется ли отображать пресет в разделе Временной срез. Если параметр имеет значение true, пресет отображается в разделе Временной срез.
• evaluations – параметр, описывающий график в разделе Временной срез, с помощью следующих параметров:
  • axis_x_name – подпись для оси абсцисс на графике.
  • evaluations – параметр, описывающий выражение, по которому рассчитываются значения тегов для их отображения на графике, с помощью следующих параметров:
    • name – название выражения, по которому рассчитывается значение тегов для их отображения на графике.
    • yAxis – подпись для оси ординат на графике.
    • expression – выражение, по которому рассчитываются значения тегов.
    • expression_color – цвет графика, который будет отображаться для пресета. Цвет графика задается в соответствии с кодированием цвета в аддитивной цветовой модели RGB с альфа-каналом с помощью следующих параметров:
      • a – альфа-параметр, определяющий непрозрачность цвета. Вы можете указать значение в диапазоне от 0 до 1.
      • b – координата синего канала модели RGB. Вы можете указать значение в диапазоне от 0 до 255.
      • g – координата зеленого канала модели RGB. Вы можете указать значение в диапазоне от 0 до 255.
      • r – координата красного канала модели RGB. Вы можете указать значение в диапазоне от 0 до 255.
• graphic_areas – группа параметров, описывающих графические области в составе пресета.
  • name – название графической области.
  • description – описание графической области.
  • sort – порядковый номер отображения графической области в пресете в разделах Пресеты, История и Мониторинг.
  • display_max – верхняя граница отображения тегов графической области. Если параметр is_scale_mode_auto имеет значение true, укажите null в качестве значение параметра display_max.
  • display_min – нижняя граница отображения тегов графической области. Если параметр is_scale_mode_auto имеет значение true, укажите null в качестве значение параметра display_min.
  • additional_thresholds – группа параметров, описывающих контрольные линии.
    • id – идентификатор контрольной линии. Идентификатор присваивается автоматически при загрузке файла.
    • value – контрольное значение.
    • color – цвет графика, который будет отображаться для контрольной линии. Цвет графика задается в соответствии с кодированием цвета в аддитивной цветовой модели RGB с альфа-каналом с помощью следующих параметров:
      • a – альфа-параметр, определяющий непрозрачность цвета. Вы можете указать значение в диапазоне от 0 до 1.
      • r – координата красного канала модели RGB. Вы можете указать значение в диапазоне от 0 до 255.
      • g – координата зеленого канала модели RGB. Вы можете указать значение в диапазоне от 0 до 255.
      • b – координата синего канала модели RGB. Вы можете указать значение в диапазоне от 0 до 255.
  • scale_mode – режим масштабирования оси. Для параметра scale_mode вы можете указать одно из следующих значений:
    • single_axis – для отображения данных на графике используется общая ось ординат.
    • cast – для каждого тега данные масштабируются по оси ординат индивидуально, независимо от данных других тегов в составе графической области.
  • is_scale_mode_auto – параметр, определяющий способ масштабирования графика в режиме единой оси. Если параметр имеет значение true, график тегов масштабируется автоматически с учетом минимального и максимального значений данных среди всех тегов графической области.
  • tag_id_list – список идентификаторов тегов, входящих в состав графической области.
  • graphic_area_id – идентификатор графической области. Идентификатор присваивается автоматически при загрузке файла.
  • preset_id – идентификатор пресета, к которому относится графическая область. Идентификатор присваивается автоматически при загрузке файла.

Ниже приведен пример файла в формате JSON, который содержит описания пресетов.