Добавление, изменение и удаление полей расширенной схемы событий

Пользователи с ролями Главный администратор, Администратор тенанта, Аналитик второго уровня, Аналитик первого уровня, Младший аналитик, Редактирование общих ресурсов могут добавлять новые и изменять существующие поля расширенной схемы событий. Удалять поля могут только пользователи с ролью Главный администратор.

Добавление полей

Чтобы добавить поле расширенной схемы событий:

1. В веб-интерфейсе перейдите в раздел Параметры → Другое → Поля расширенной схемы событий и нажмите на кнопку Добавить.
2. Включите или выключите переключатель Статус, чтобы разрешить или запретить использовать это поле расширенной схемы событий в ресурсах.

   По умолчанию переключатель включен. Выключенное поле все еще будет доступно в списке столбцов таблицы в разделе События для работы со старыми событиями.

3. В поле Тип выберите тип данных поля расширенной схемы событий.

   Доступные типы данных

   Тип	Доступность в нормализаторе	Тип данных
   S	Все типы	Строка.
   N	Все типы	Число.
   F	Все типы	Число с плавающей точкой.
   SA	KV, JSON	Массив строк. Порядок элементов массива соответствует порядку элементов сырого события.
   NA	KV, JSON	Массив целых чисел. Порядок элементов массива соответствует порядку элементов сырого события.
   FA	KV, JSON	Массив чисел с плавающей точкой. Порядок элементов массива соответствует порядку элементов сырого события.

4. В поле Имя поля укажите имя поля расширенной схемы событий.

   Имя поля расширенной схемы событий имеет следующие особенности:

   • Должно быть уникальным в рамках инсталляции KUMA.
   • Чувствительно к регистру. Например, имена Имя_поля и имя_поля считаются разными именами.
   • Допустимо использовать символы латиницы, кириллицы и числа. Не допускается использование пробелов и символов " ~ ` @ # $ % ^ & * ( ) + - [ ] { } | \ | / . " < > ; ! , : ? =.
   • Если вы хотите использовать поля расширенной схемы событий для поиска источников событий, допустимо использовать только символы латиницы и числа.
   • Максимальная длина – 128 символов.
5. При необходимости в поле Описание укажите описание поля расширенной схемы событий.

   Мы рекомендуем в описании указывать назначение добавляемого поля расширенной схемы событий. В описании допустимо использовать только символы Unicode. Максимальная длина – 256 символов.

6. Нажмите на кнопку Сохранить.

Новое поле расширенной схемы событий будет добавлено и отобразится в начале таблицы. Будет создано событие аудита о создании поля расширенной схемы событий. Если вы включили поле, вы сможете использовать его в нормализаторах и при конфигурации ресурсов.

Изменение полей

Чтобы изменить поле расширенной схемы событий:

1. В веб-интерфейсе в разделе Параметры → Другое → Поля расширенной схемы событий нажмите на название поля, которое вы хотите изменить.

   Откроется панель Редактирование расширенной схемы. В этой панели отображаются параметры выбранного поля, а также таблица Зависимости со списком ресурсов, макетов панели мониторинга, отчетов, пресетов и наборов полей для поиска источников событий, в которых используется это поле. Отображаются только те ресурсы, к тенантам которых у вас есть доступ. Если поле используется в тех ресурсах, к тенантам которых у вас нет доступа, эти ресурсы не будут отображаться в таблице.

   Вы можете нажать на название ресурса или сущности, чтобы перейти на его страницу (кроме ресурсов панели мониторинга, пресетов и сохраненных запросов пользователей).

2. Внесите необходимые изменения в доступные параметры.

   Вы можете изменить параметры Тип и Имя поля, только если у этого поля расширенной схемы событий нет зависимостей. Параметры Статус и Описание вы можете изменить для любого поля расширенной схемы событий. Поле со статусом Выключено все еще будет использоваться в уже работающих конфигурациях ресурсов, пока вы не удалите его из конфигурации вручную, а также будет доступно в списке столбцов таблицы в разделе События для работы со старыми событиями.

   Выключить использование поля расширенной схемы событий с помощью переключателя Статус может только пользователь с ролью Главный администратор.

3. Нажмите на кнопку Сохранить.

Поле расширенной схемы событий обновлено. Будет создано событие аудита об изменении поля.

Удаление полей

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

Чтобы удалить поля расширенной схемы событий:

1. В веб-интерфейсе перейдите в раздел Параметры → Другое → Поля расширенной схемы событий.
2. Установите флажки в первом столбце таблицы напротив одного или нескольких полей, которые вы хотите удалить.

   Вы можете выбрать все поля, установив флажок в первом столбце заголовка таблицы.

3. Нажмите на кнопку Удалить в верхней части таблицы.

   Кнопка Удалить активна, только если все выбранные поля выключены и не имеют зависимостей. Если хотя бы одно поле включено или имеет зависимость, кнопка неактивна.

   Если вы хотите удалить поле, которое используется хотя бы в одном ресурсе KUMA, но у вас нет доступа к его тенанту, кнопка Удалить будет активна при выборе этого поля, но при попытке удалить его отобразится ошибка.

Выбранные поля будут удалены. Будет создано событие аудита об удалении полей.