Тест на вектор: Тест на психологические векторы (тест Толкачева-Бородянского), бесплатно — Psy8

Токио 108-0075

Vector Japan Co. Ltd.

Глобальные ворота, 10 эт.,
4-60-12 Hiraike-cho, Nakamura-ku, Nagoya-shi

Aichi, 453-6110

Vector Japan Co. Ltd.

9F Shin-Osaka Doi Building No.5
1-2-4 Miyahara, Yodogawa-ku, Osaka-shi

Osaka 532-0003

Vector Japan Co. Ltd.

31F Shinagawa Season Terrace,
1-2-70, Конан, Минато-ку

Токио 108-0075

Vector Japan Co. Ltd.

10F Global Gate,
4-60-12 Хирайке-чо, Накамура-ку, Нагоя-ши

Аити, 453-6110

Vector Japan Co. Ltd.

31F Shinagawa Season Terrace,
1-2-70, Конан, Минато-ку

Токио 108-0075

Vector Japan Co. Ltd.

31F Shinagawa Season Terrace,
1-2-70, Конан, Минато-ку

Токио 108-0075

Онлайн: support.vector.com

Часы приема указаны по следующему адресу:
— Телефон 10-12 / 13-17 (Пн- Пт, кроме выходных)
— Электронная почта, факс / круглосуточно в любое время

Vector Japan Co. Ltd.

31F Shinagawa Season Terrace,
1-2-70, Конан, Минато-ку

Токио 108-0075

Vector Japan Co. Ltd.

31F Shinagawa Season Terrace,
1-2-70, Конан, Минато-ку

Токио 108-0075

Штаб-квартираГенеральные продажиТехнические продажи встроенного программного обеспечения и AUTOSAR KoreaSupportVectorAcademy (Корея)

Vector Korea IT Inc.

9F, Yongsan Prugio Summit Office-07, 69, Hangang-daero, Yongsan-gu

Seoul 04378

Vector Korea IT Inc.

9F, Yongsan Prugio Summit Office-dong,
69, Hangang-Daero, Yongsan-Gu

Seoul 04378

Vector Korea IT Inc.

용산구 한강 대로 69 용산 푸르지오 밋 업무동

서울 04378

Vector Corea It Inc.

9f, yongsan

. Офис на высшем уровне-дон,
69, Hangang-daero, Yongsan-gu

Seoul 04378

Vector Korea IT Inc.

602, Yongsan Prugio Summit Office-dong

Seoul 04378

Штаб-квартира.

Электронная почта: [email protected]

Vector North America

66 Bovet Road, Suite 300

San Mateo, CA 94402

Телефон: +1 248 449-9290, вариант 1

3 Факс: +1 248 449-9704

Электронная почта: [email protected]

Vector North America

66 Bovet Road, Suite 300

San Mateo, CA 94402

Headquarters SalesSupportVectorAcademy

Vector North America

39500 Orchard Hill Place
Suite 500

Novi, Michigan 48375

Телефон: +1 248 449-9290, вариант 1

Факс: +1 248 449-9704

Электронная почта: sales@us. vector.com 0 Vector America

4

39500 Орчард Хилл Плэйс
Люкс 500

Novi, Michigan 48375

Vector North America

39500 Orchard Hill Place
Suite 500

Novi, Michigan 48375

Телефон: +1 248 449-9290, вариант 1

Факс: +1 248 449-9704

Электронная почта: [email protected] 0 Vector America

4

39500 Орчард Хилл Плэйс
Suite 500

Novi, Michigan 48375

Headquarters SalesSupport

Vector North America

1351 South County Trail, Suite 310

Восточный Гринвич, RI 02818

Vector North America

1351 South County Trail, Suite 310

East Greenwich, RI 02818

Vector North America

1351 South County Trail, Suite 310

East Greenwich, RI 03818 1351 South County Trail, Suite 310

4, RI 03818 1351 South County Trail, Suite 310

4, RI 03814 1351 South County, Suite 310

4, RI 03814 1351.

HeadquarterVecScan AB (Linköping)SalesSupportVectorAcademy

VecScan AB

Theres Svenssons Gata 9

417 55 Gothenburg

VecScan AB

Theres Gasta Svenssons 9

417 55 Gothenburg

VecScan AB

Theres Svenssons Gata 9

417 55 Gothenburg

VecScan AB

Theres Svenssons Gata 9

417 55 Gothenburg

VecScan AB

Teknikringen 9

SE-583 30 Linköping

Тел.: +46 (0)13–560 18 14

Факс: +46 31 764 76 19

Эл. Векторная документация

Vector позволяет выполнять модульное тестирование преобразований в конвейере обработки. Модульные тесты в векторе работают точно так же, как модульные тесты в большинстве языков программирования:

1. Предоставляют набор входных данных для преобразования (или для нескольких объединенных в цепочку преобразований). вместе).
2. Укажите ожидаемые результаты изменений, внесенных преобразованием (или несколькими трансформируется).
3. Получайте оперативную информацию о любых сбоях теста.

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

Запуск модульных тестов

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

 vector test /etc/vector/vector.toml
 

Вы также можете указать несколько файлов конфигурации для тестирования:

 vector test /etc/vector/pipeline1.toml /etc/vector/pipeline2.toml
 

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

Проверка вывода

Вы можете использовать утверждения VRL, чтобы убедиться, что выходные данные тестируемых преобразований соответствует вашим ожиданиям. VRL предоставляет две функции утверждения:

• assert принимает логическое выражение в качестве первого аргумента. Если логическое значение разрешается в false , тест завершается неудачно, и Vector регистрирует ошибку.
• assert_eq принимает любые два значения в качестве первых двух аргументов. Если эти два значения не равны, тест завершается неудачно, и Vector регистрирует ошибку.

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

 # Именованный аргумент
assert!(1 == 2, сообщение: "правила арифметики нарушены")
assert_eq!(1, 2, сообщение: "правила арифметики нарушены")
# Позиционные аргументы также допустимы
assert!(1 == 2, "правила арифметики нарушены")
assert_eq!(1, 2, "правила арифметики нарушены")
 

Сделайте ваши утверждения непогрешимыми

Мы рекомендуем сделать вызовы assert и assert_eq в модульных тестах безошибочными, применив bang ( ! ) синтаксис, как в assert!(1 == 1) , а не assert(1 == 1) . ! указывает, что Программа VRL должна прерваться, если условие не выполняется.

Если вы используете функцию assert , вам необходимо передать логическое выражение в функцию в качестве первого аргумента. Особенно полезным при написании логических выражений является тип функции, такие функции, как существует , включает , is_nullish и содержат сравнения и VRL. Вот пример использование логического выражения, переданного функции assert :

 [[tests.outputs.conditions]]
тип = "врл"
источник = '''
утверждать!(is_string(.message) && is_timestamp(.timestamp) && !exists(.other))
'''
 

В этом случае программа VRL (под источником ) вычисляет одно логическое значение, которое выражает следующее:

• Поле сообщения должно быть строкой
• Поле timestamp должно быть действительной меткой времени или assert_eq утверждения:

   источник = '''
  утверждать!(существует(. message), "поле сообщения не предоставлено")
  assert!(!is_nullish(.message), "поле сообщения является пустой строкой")
  assert!(is_string(.message), "поле сообщения имеет неожиданный тип")
  assert_eq!(.message, "успех", "поле сообщения имеет непредвиденное значение")
  утверждать!(существует(.timestamp), "временная метка не указана")
  утверждать!(is_timestamp(.timestamp), "временная метка недействительна")
  assert!(!exists(.other), "присутствует другое постороннее поле")
  '''
   

  Вы также можете хранить логические выражения в переменных, а не передавать весь оператор в функция утверждает :

   source = '''
  message_field_valid = существует(.сообщение) &&
    !is_nullish(.сообщение) &&
    .message == "успех"
  утверждать!(message_field_valid)
  '''
   

  Пример конфигурации модульного теста

  Ниже приведен аннотированный пример набора модульных тестов для преобразования с именем add_metadata , который добавляет уникальный идентификатор и метку времени в журнал событий:

   [sources. all_container_services]
  тип = "докер_логи"
  docker_host = "http://localhost:2375"
  include_images = ["web_frontend", "web_backend", "auth_service"]
  # Тестируемое преобразование представляет собой преобразование Vector Remap Language (VRL), которое
  # добавляет два поля к каждому входящему событию журнала: метка времени и уникальный идентификатор
  [transforms.add_metadata]
  тип = "переназначить"
  входы = ["all_container_services"]
  источник = '''
  .timestamp = сейчас ()
  .id = uuid_v4()
  '''
  # Здесь мы начинаем настраивать наш набор тестов
  [[тесты]]
  name = "Тест преобразования add_metadata"
  # Входные данные для теста
  [[tests.inputs]]
  insert_at = "add_metadata" # Преобразование, в которое вставляется событие тестирования
  type = "log" # Тип события (журнал или метрика)
  # Событие журнала тестирования, которое передается в преобразование `add_metadata`
  [tests.inputs.log_fields]
  сообщение = "успешная транзакция"
  код = 200
  # Ожидаемые результаты теста
  [[tests.outputs]]
  Extract_from = "add_metadata" # Преобразование, из которого извлекается результирующее событие
  # Декларация того, что мы ожидаем
  [[тесты. выходные.условия]]
  тип = "врл"
  источник = '''
  утверждать!(is_timestamp(.timestamp))
  утверждать!(is_string(.id))
  assert_eq!(.message, "успешная транзакция")
  '''
   

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

  В этом модуле использовалось только одно векторное преобразование. Пример модульного теста с несколькими преобразованиями приведен ниже.

  Реальные и тестовые входные данные

  Важно отметить, что в этом примере конфигурация Vector настроена на получение реальных журналы из образов Docker с использованием docker_logs источник. Если бы Вектор работал в production, преобразование add_metadata , которое мы здесь тестируем, будет изменять реальные события журнала. Но мы тестируем , а не . Вместо этого директива insert_at = "add_metadata" искусственно вставляет наши тестовые входные данные в преобразование add_metadata . Вы должны думать о Векторе модульные тесты как способ имитировать источники данных наблюдаемости и гарантировать, что ваши преобразования отвечайте на эти фиктивные источники так, как вы ожидаете.

  Доступно несколько форматов конфигурации

  Приведенный выше пример модульного тестирования находится в TOML, но Vector также поддерживает YAML и JSON в качестве конфигурации форматы.

  Настройка модульных тестов

  Модульные тесты в Vector работают вместе с вашей конфигурацией топологии. Вы можете указать свои тесты в один и тот же файл конфигурации вместе с вашими определениями преобразования или разделите их в отдельный файл.

  Необходимость модульных тестов указана внутри массива тестов . Каждый тест требует имя :

   [[тесты]]
  имя = "тест 1"
  # Другая тестовая конфигурация
  [[тесты]]
  имя = "тест_2"
  # Другая тестовая конфигурация
  # и т. д.
   

  Внутри каждого определения теста необходимо указать две вещи:

  • Массив входных данных , который предоставляет входные события для теста.
  • Массив выводит , что обеспечивает ожидаемые результаты теста.

  Входы

  В входном массиве для теста у вас есть следующие опции:

  Параметр	Тип	Описание
  INSERT_AT	STRNSTERSER. Это особенно полезно, когда вы хотите протестировать только подмножество конвейера преобразования.
  значение	строка (необработанное значение события)	Необработанное строковое значение для действия в качестве входного события. Используйте только в тех случаях, когда события представляют собой необработанные строки, а не структурированные объекты с полями событий.
  log_fields	объект	Если преобразование обрабатывает события журнала, это пары ключ/значение, составляющие входное событие.
  метрика	объект	Если преобразование обрабатывает события метрики, это поля, составляющие эту метрику. Подполя включают имя , теги , вид и другие.

  Вот пример вводов 9Объявление 0742:

   [transforms.add_metadata]
  # преобразовать конфиг
  [[тесты]]
  name = "Протестировать преобразование add_metadata"
  [[tests.inputs]]
  insert_at = "добавить_метаданные"
  [tests.inputs.log_fields]
  message = "<102>1 2020-12-22T15:22:31.111Z vector-user.biz su 2666 ID389 - Что-то пошло не так"
   

  Выходы

  В массиве выходных данных конфигурации модульного тестирования вы указываете две вещи:

  Параметр	Тип	Описание
  extract_from	строка (имя преобразования)	Преобразование, выходные данные которого вы хотите проверить.
  условия	массив объектов	Условия VRL для работы с выходными данными.

  Каждое условие в массиве условий имеет два поля:

  Параметр	Тип	Описание
  type	string	Тип условия, которое вы предоставляете. vrl в настоящее время является единственным допустимым значением.
  источник	строка (логическое выражение VRL)	Подробно объяснено выше.

  Вот пример выводит объявление :

   [[tests.outputs]]
  Extract_from = "добавить_метаданные"
  [[тесты.выходные.условия]]
  тип = "врл"
  источник = '''
  утверждать!(is_string(.id))
  утверждать!(существует(.теги))
  '''
   

  Подтверждение отсутствия вывода

  В некоторых случаях может потребоваться утверждение, что никакое событие не выводится преобразованием. Вы можете указать это на корневом уровне конфигурации конкретного теста с использованием параметра no_outputs_from , который принимает список имен преобразований. Вот пример:

   [[тесты]]
  name = "Убедиться, что нет вывода"
  no_outputs_from = ["log_filter", "metric_filter"]
   

  В этой тестовой конфигурации Vector ожидает, что log_filter и metric_filter преобразования не выводить любые события.

  Некоторые примеры использования no_outputs_from :

  • При тестировании преобразования фильтра вы можете утверждать, что вход событие отфильтровано
  • При тестировании преобразования remap вам может потребоваться подтвердить, что функция VRL прерывания вызывается, когда предоставленная программа VRL обрабатывает событие ввода

  Ниже приведен полный пример использования no_outputs_from в модульном тесте Vector:

   [transforms. log_filter]
  тип = "фильтр"
  входы = ["log_source"]
  условие = '.env == "производство"'
  [[тесты]]
  name = "Отфильтровать непроизводственные события"
  no_outputs_from = ["log_filter"]
  [[tests.inputs]]
  тип = "журнал"
  insert_at = "log_filter"
  [tests.inputs.log_fields]
  сообщение = "успех"
  код = 202
  конечная точка = "/ транзакции"
  метод = "ПОСТ"
  env = "постановка"
   

  Этот модульный тест проходит успешно, так как поле env события ввода имеет значение постановка , которая не выполняет условие фильтрации .env == "production" ; поскольку условие не выполнено, событие не вывод преобразования log_filter в этом случае.

  Типы событий

  В настоящее время существует два типа событий, которые можно тестировать в Vector:

  • журнал события
  • метрика события

  журналы

  Как объяснялось в разделе о входных данных выше, при тестировании событий журнала можно указать либо структурированный объект события, либо необработанная строка.

  Объект

  Чтобы указать событие структурированного журнала в качестве входных данных теста, используйте log_fields :

   [tests.inputs.log_fields]
  сообщение = "успешная транзакция"
  код = 200
  идентификатор = "38c5b0d0-5e7e-42aa-ae86-2b642ad2d1b8"
   

  Если в имени поля есть дефисы, вам нужно будет заключить эту часть в кавычки (по крайней мере, в YAML):

   - имя: дефисы
      входы:
        - insert_at: дефисы
          тип: журнал
          log_fields:
            labels."this-has-hyphens": "это тест"
   

  Необработанное строковое значение

  Чтобы указать необработанное строковое значение для события журнала, используйте значение :

   [[tests.inputs]]
  insert_at = "добавить_метаданные"
  value = "<102>1 2020-12-22T15:22:31. 111Z vector-user.biz su 2666 ID389 - Что-то пошло не так"
   

  Метрики

  Можно указать поля в событии метрики для модульного тестирования с использованием объекта метрики :

   [[tests.inputs]]
  insert_at = "my_metric_transform"
  тип = "метрика"
  [тесты.входы.метрика]
  имя = "количество"
  вид = "абсолютный"
  счетчик = {значение = 1}
   

  Агрегированные метрики немного другие:

   тестов:
    входы:
      insert_at: my_aggregate_metrics_transform
      тип: метрика
      метрика:
        имя: http_rtt
        вид: инкрементный
        агрегированная_гистограмма:
          ведра: []
          сумма: 0
          количество: 0
   

  Вот полный сквозной пример модульного тестирования метрики с помощью преобразования:

   [transforms.add_env_to_metric]
  тип = "переназначить"
  входы = []
  источник = '''
  env, ошибка = get_env_var("ENV")
  если ошибка != ноль {
    журнал (ошибка, уровень: "ошибка")
  }
  tags. environment = окружение
  '''
  [[тесты]]
  имя = "add_unique_id_test"
  [[tests.inputs]]
  insert_at = "add_unique_id_to_metric"
  тип = "метрика"
  [тесты.входы.метрика]
  имя = "веб-сайт_хиты"
  вид = "абсолютный"
  счетчик = {значение = 1}
  [[tests.outputs]]
  extract_from = "добавить_уникальный_id_к_метрике"
  [[тесты.выходные.условия]]
  тип = "врл"
  источник = '''
  assert_eq!(.name, "website_hits")
  assert_eq!(.kind, "абсолютный")
  assert_eq!(.tags.environment, "производство")
  '''
   

  Множественные преобразования

  Примеры, приведенные до сих пор в этом документе, включали модульное тестирование одного преобразования. Это также однако возможно проверить вывод нескольких объединенных в цепочку преобразований. Представьте себе сценарий в котором у вас есть преобразование с именем add_env_metadata , которое помечает событие средой метаданные, преобразование под названием sanitize , которое удаляет некоторые нежелательные поля, и, наконец, преобразование называется add_host_metadata , который помечает событие именем хоста. Ниже приведен пример модульного теста конфигурация для этого набора преобразований с пояснительными аннотациями:

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

   # Этот источник, как и все источники, игнорируется в самом модульном тесте
  [sources.web_backend]
  тип = "докер_логи"
  docker_host = "http://localhost:2375"
  include_images = ["веб_бэкенд"]
  # Первое преобразование в цепочке
  [transforms.add_env_metadata]
  тип = "переназначить"
  входы = ["веб_бэкенд"]
  источник = '''
  .tags.environment = "производство"
  '''
  # Второе преобразование в цепочке
  [трансформирует.дезинфицировать]
  тип = "переназначить"
  inputs = ["add_env_metadata"]
  источник = '''
  дел(.имя пользователя)
  del(.электронная почта)
  '''
  # Финальное преобразование в цепочке
  [transforms. add_host_metadata]
  тип = "переназначить"
  входы = ["санировать"]
  источник = '''
  .tags.host = "web-backend1.vector-user.biz"
  '''
  [[тесты]]
  name = "Несколько связанных преобразований переназначения"
  [[tests.inputs]]
  тип = "журнал"
  # Вставляем тестовые входные события в первое преобразование
  insert_at = "добавить_env_metadata"
  # Входное событие для вставки в первое преобразование в цепочке
  [tests.inputs.log_fields]
  message = "изображение успешно загружено"
  код = 202
  имя пользователя = "tonydanza1337"
  электронная почта = "[email protected]"
  transaction_id = "bcef6a6a-2b72-4a9а-99а0-97ае89д82815"
  [[tests.outputs]]
  # Извлечь тестовые результаты из последнего преобразования
  Extract_from = "добавить_хост_метаданные"
  [[тесты.выходные.условия]]
  тип = "врл"
  # Наши утверждения VRL для тестового вывода
  источник = '''
  assert_eq!(.tags.environment, "production", "неверный тег окружения")
  assert_eq!(.tags.host, "web-backend1.vector-user.biz", "неверный тег хоста")
  утверждать!(!Существует(.имя пользователя))
  утверждать!(!Существует(. email))
  valid_transaction_id = существует(.transaction_id) &&
    is_string(.transaction_id) &&
    длина!(.transaction_id) == 36
  assert!(valid_transaction_id, "ID транзакции недействителен")
  '''
   

  С точки зрения тестирования все три преобразования здесь можно рассматривать как единое целое. Один пример событие вставляется в начало цепочки ( add_env_metadata ), одно выходное тестовое событие извлекается из конца цепочки ( add_host_metadata ) и один набор VRL assertions проверяет, что это выходное событие соответствует нашим ожиданиям.

  Вы также можете протестировать подмножество этой цепочки преобразований. Эта конфигурация, например, будет тестировать только первые два преобразования ( add_env_metadata и очистка ):

   [[тесты]]
  name = "Первые два преобразования"
  [[tests.inputs]]
  тип = "журнал"
  # Вставляем тестовый ввод в первое преобразование
  insert_at = "добавить_env_metadata"
  # Для сравнения мы можем использовать то же событие ввода, что и выше
  [tests.