Работа с фильтрами

Данный раздел описывает процесс работы с фильтрами на конвейерах в системе. Работа осуществляется при настройке конфигурации конвейера.

О фильтрах

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

Доступные операции над фильтром:

Добавление фильтра

Чтобы добавить фильтр на конфигурацию конвейера:

  1. Перейдите в конфигурацию требуемого конвейера.

  2. Удостоверьтесь, что в выпадающем списке Версия на панели инструментов в окне конфигурации конвейера выбран вариант Черновик.

  3. Нажмите на кнопку Добавить элемент и выберите из выпадающего списка пункт Фильтр. Отобразится окно добавления фильтра.

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

  5. Введите название фильтра.

  6. Задайте условие фильтрации входящих событий на языке VRL.

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

    В редакторе кода доступны горячие клавиши.
    В VRL-программе для доступа к данным события используется символ точки (.), а к метаданным события — символ процента (%). В корреляционных событиях метаданные включают данные исходных событий.
  7. Установите флажок Сохранить как шаблон, если настройку фильтра необходимо сохранить в качестве шаблона для дальнейшего использования.

  8. Нажмите на кнопку Добавить. Новый фильтр отобразится на диаграмме конфигурации.

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

Чтобы добавить конфигурацию с правилами, где обнаружены ошибки, установите флажок Игнорировать ошибки. Если флажок не установлен, правила с ошибками будут исключены.

Нажмите на кнопку Готово, чтобы сохранить конфигурацию.

Пример фильтра

Условие фильтра, пропускающего только события, поля externalId и categoryOutcome которых имеют значения "4648" и "Success" соответственно:

.externalId == "4648" && .categoryOutcome == "Success"

Изменение фильтра

Способ изменения идентичен для всех элементов конвейера и приведен в разделе Работа с конвейерами.

Удаление фильтра

Способ удаления идентичен для всех элементов конвейера и приведен в разделе Работа с конвейерами.

Была ли полезна эта страница?

Обратная связь