Работа с VRL-трансформациями
Данный раздел описывает процесс работы с VRL-трансформациями на конвейерах в системе. Работа осуществляется при настройке конфигурации конвейера.
О VRL-трансформациях
VRL-трансформация — это элемент конвейера, который позволяет обрабатывать и преобразовывать события с применением языка VRL.
На диаграмме конфигурации конвейера VRL-трансформация имеет один вход и один выход. Этот элемент конвейера принимает на вход события, проводит их преобразование и на выходе предоставляет уже преобразованные события.
В отличие от нормализаторов, VRL-трансформация позволяет задать простые правила преобразования событий на языке VRL без предварительного создания правил нормализации и привязки к ним.
VRL-трансформация удобна в тех случаях, когда требуется провести несложные модификации в структуре событий, например:
-
использовать одну или несколько функций для упрощения дальнейшей работы с событиями;
-
добавить, изменить или удалить какое-нибудь поле в структуре событий.
Для проведения более сложных преобразований, применения одних и тех же преобразований в нескольких конвейерах, поддержки версионирования (возможности изменения правил преобразований без перезапуска конвейера) рекомендуется использовать нормализаторы, основанные на правилах нормализации.
Доступные операции над VRL-трансформацией:
Добавление VRL-трансформации
Чтобы добавить VRL-трансформацию на конфигурацию конвейера:
-
Перейдите в конфигурацию требуемого конвейера.
-
Удостоверьтесь, что в выпадающем списке Версия на панели инструментов в окне конфигурации конвейера выбран вариант Черновик.
-
Нажмите на кнопку Добавить элемент и выберите из выпадающего списка пункт VRL-трансформация. Отобразится окно добавления VRL-трансформации.
-
При необходимости выберите шаблон для автоматического заполнения полей VRL-трансформации. По умолчанию выбран вариант Без шаблона.
-
Введите название VRL-трансформации.
-
Введите правило, по которому будет преобразовываться событие, на языке VRL.
В редакторе кода доступны горячие клавиши. В VRL-программе для доступа к данным события используется символ точки ( .), а к метаданным события — символ процента (%). В корреляционных событиях метаданные включают данные исходных событий. -
При необходимости из выпадающего списка Обработка ошибок выберите шину коллектора, в которую будет отправлено событие в случае возникновения ошибок обработки. По умолчанию выбран вариант События с ошибкой.
-
Установите флажок Сохранить как шаблон, если настройку VRL-трансформации необходимо сохранить в качестве шаблона для дальнейшего использования.
-
Нажмите на кнопку Добавить. Новая VRL-трансформация отобразится на диаграмме конфигурации.
|
Если в добавленных правилах содержатся отсутствующие активные списки или таблицы обогащения, система отобразит список ошибок с указанием ID и названий правил. Чтобы добавить конфигурацию с правилами, где обнаружены ошибки, установите флажок Игнорировать ошибки. Если флажок не установлен, правила с ошибками будут исключены. Нажмите на кнопку Готово, чтобы сохранить конфигурацию. |
Пример:
Условие на языке VRL, согласно которому исходное событие будет обогащаться дополнительным полем responseStatus. В нем будет устанавливаться значение "Bad request", если в поле status приходящего на VRL-трансформацию события установлено значение 401 или 404:
if .status == "404" || .status == "401" {
.responseStatus = "Bad request"
}Изменение VRL-трансформации
Способ изменения идентичен для всех элементов конвейера и приведен в разделе Работа с конвейерами.
Удаление VRL-трансформации
Способ удаления идентичен для всех элементов конвейера и приведен в разделе Работа с конвейерами.
Была ли полезна эта страница?
