Связаться с намиПодключиться

HTTP-тест с нагрузкой по сценарию с помощью Pandora

Статья создана
Обновлена 15 ноября 2024 г.

Load Testing можно использовать для тестирования сервиса с нагрузкой по сценарию по протоколу HTTP с помощью генератора нагрузки Pandora.

Чтобы провести нагрузочное тестирование:

  1. Подготовьте облако к работе.
  2. Подготовьте цель тестирования.
  3. Подготовьте инфраструктуру.
  4. Создайте агент.
  5. Подготовьте файл с тестовыми данными.
  6. Подготовьте файл сценария.
  7. Запустите тест.

Если созданные ресурсы вам больше не нужны, удалите их.

Подготовьте облако к работе

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

  1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
  2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

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

Подробнее об облаках и каталогах.

Если агент размещается на платформе Yandex Cloud, взимается плата за вычислительные ресурсы (см. тарифы Yandex Compute Cloud).

На стадии Preview использование сервиса Load Testing не тарифицируется.

Подготовьте цель тестирования

В этом примере будет тестироваться сервис с внутренним IP-адресом 172.17.0.10 в той же подсети, где будет размещен агент.

Убедитесь, что для доступа к сервису по протоколу HTTPS используется порт по умолчанию — 443.

Load Testing также можно использовать для нагрузочного тестирования сервиса, доступного публично или находящегося в другой подсети и группе безопасности относительно агента.

Для сервиса, доступного публично, разрешите входящий HTTPS-трафик на порт 443.

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

Подготовьте инфраструктуру

Создайте сервисный аккаунт

  1. Создайте сервисный аккаунт sa-loadtest в каталоге, где будет размещаться агент, с которого будет подаваться нагрузка.
  2. Назначьте сервисному аккаунту роль loadtesting.generatorClient.

Настройте сеть

Создайте и настройте NAT-шлюз в подсети, где размещается цель тестирования и будет размещен агент. Это обеспечит доступ агента к сервису Load Testing.

Настройте группы безопасности

  1. Настройте группу безопасности агента тестирования:

    1. Создайте группу безопасности агента agent-sg.
    2. Добавьте правила:

      1. Правило для исходящего HTTPS-трафика к публичному API Load Testing:

        • Диапазон портов: 443.
        • Протокол: TCP.
        • Назначение: CIDR.
        • CIDR блоки: 0.0.0.0/0.

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

      2. Правило для входящего SSH-трафика:

        • Диапазон портов: 22.
        • Протокол: TCP.
        • Назначение: CIDR.
        • CIDR блоки: 0.0.0.0/0.

        Это позволит подключаться к агенту по протоколу SSH и управлять тестами из консоли или собирать отладочную информацию.

      3. Правило для исходящего трафика при подаче нагрузки к цели тестирования:

        • Диапазон портов: 0-65535.
        • Протокол: Любой.
        • Назначение: Группа безопасности.
          Выберите Из списка. Укажите группу безопасности, в которой находится нужная цель тестирования.

        Создайте такое правило для каждой цели тестирования с уникальной группой безопасности.

  2. Настройте группу безопасности цели тестирования:

    1. Создайте группу безопасности цели тестирования load-target-sg.

    2. Добавьте правило для входящего трафика при подаче нагрузки к цели тестирования:

      • Диапазон портов: 0-65535.
      • Протокол: Любой.
      • Назначение: Группа безопасности.
        Выберите Из списка. Укажите группу безопасности, в которой находится нужная цель тестирования.

      Это правило позволит агентам подавать нагрузку на эту цель или подключать дополнительные средства мониторинга.

Создайте агент тестирования

  1. Если у вас еще нет пары SSH-ключей, создайте их.

  2. Создайте агент:

    1. В консоли управления выберите каталог, в котором будет создан агент.

    2. В списке сервисов выберите Load Testing.

    3. На вкладке Агенты нажмите кнопку Создать агент.

    4. Укажите имя агента, например agent-008.

    5. Укажите ту же зону доступности, в которой находится цель тестирования.

    6. В блоке Агент:

    7. В блоке Доступ укажите данные для доступа к агенту:

      • Выберите сервисный аккаунт sa-loadtest.

      • В поле Логин введите имя пользователя.

        Внимание

        Не используйте логин root или другие имена, зарезервированные операционной системой. Для выполнения операций, требующих прав суперпользователя, используйте команду sudo.

      • В поле SSH-ключ вставьте содержимое файла открытого ключа.

    8. Нажмите Создать.

    9. Дождитесь завершения процесса создания виртуальной машины. Статус агента должен смениться на Ready for test.

      Примечание

      Если процесс создания агента остановился на статусе Initializing connection, проверьте выполнение условий:

      • У агента есть доступ к loadtesting.api.cloud.yandex.net:443 и публичный IP-адрес.
      • В целевой подсети настроен NAT-шлюз.
      • У сервисного аккаунта, который назначен агенту, есть необходимые роли.

  3. Привяжите публичный IP-адрес к агенту для доступа по протоколу SSH:

    1. В консоли управления выберите каталог, в котором размещен агент.
    2. Выберите сервис Compute Cloud.
    3. Выберите ВМ с именем agent-008.
    4. В блоке Сетевой интерфейс в правом верхнем углу нажмите и выберите Добавить публичный IP-адрес.
    5. В открывшемся окне:
      • В поле Публичный адрес выберите получение адреса Автоматически.
      • Нажмите Добавить.

Подготовьте файл с тестовыми данными

  1. Сформируйте тестовые данные в файле users.csv:

    user_id,name,pass
1,John,123
2,Jack,456
3,Jim,789
4,Joe,0asdf
5,Jane,12dasdf
6,Jill,asdf
7,Joy,zxcv
8,Joy,zxcv
9,Joy,zxcv
10,Joy,zxcv

Подготовьте файл сценария

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

  • hcl;
  • yaml;
  • json.

  1. Подготовьте сценарий в файле payload.hcl:

    variable_source "variables" "variables" {
   variables = {
      auth_path = "/auth"
      order_path = "/order"
   }
}


variable_source "users" "file/csv" {
   file              = "users.csv"
   fields            = ["user_id", "name", "pass"]
   ignore_first_line = true
   delimiter         = ","
}

request "auth_req" {
   method  = "POST"
   uri     = "{{.source.variables.auth_path}}"
   headers = {
      Content-Type = "application/json"
      Useragent    = "Yandex"
   }
   body = <<EOF
{"user_id":  {{.request.auth_req.preprocessor.user_id}}}
EOF
   tag  = "auth"

   preprocessor {
      mapping = {
         user_id = "source.users[next].user_id"
      }
   }
}

request "order_req" {
   method  = "POST"
   uri     = "{{.source.variables.order_path}}?sleep=100"
   headers = {
      Useragent     = "Yandex"
   }
   body = <<EOF
{"item_id": test_item_id}
EOF
   tag  = "order"
}

scenario "test_scenario" {
   min_waiting_time = 1000
   requests = [
      "auth_req",
      "sleep(100)",
      "order_req(3, 100)"
   ]
}

    В данном сценарии test_scenario описаны запросы auth_req и order_req. Запросу можно передавать аргументы: количество повторений и задержка между ними. В данном примере order_req(3, 100) означает, что запрос order_req будет выполнен трижды с интервалом в 100 миллисекунд между повторениями.

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

    В сценарии создан источник переменных variables, содержащий переменные auth_path и order_path. Значения этих переменных используются для указания uri в запросах.

    Также в сценарии создан источник переменных users, использующий данные из внешнего файла users.csv. Для работы с массивом пользователей используется препроцессор, в котором доступны следующие модификаторы:

    • next для получения следующего элемента массива;
    • last для получения последнего элемента массива;
    • rand для получения случайного элемента массива.

Запустите тест

  1. В консоли управления выберите сервис Load Testing.

  2. На панели слева выберите Тесты. Нажмите Создать тест.

  3. В параметре Агенты выберите агент agent-008.

  4. В блоке Прикрепленные файлы нажмите Выбрать файлы и выберите сохраненные ранее файлы users.csv и payload.hcl.

  5. В блоке Настройки теста выберите способ настройки: Конфигурационный файл.

  6. В поле для ввода конфигурации введите настройки тестирующих потоков в формате yaml:

       uploader:
      enabled: true
      package: yandextank.plugins.DataUploader
      api_address: loadtesting.api.cloud.yandex.net:443
   pandora:
      enabled: true
      package: yandextank.plugins.Pandora
      config_content:
         pools:
            - id: Pool name
               gun:
                  type: http/scenario
                  target: 172.17.0.10:80
               ammo:
                  type: http/scenario
                  file: payload.hcl
               result:
                  type: phout
                  destination: ./phout.log
               rps:
                  - duration: 10s
                     type: line
                     from: 1
                     to: 5
               startup:
                  type: once
                  times: 5
         log:
            level: debug
   autostop:
      enabled: true
      package: yandextank.plugins.Autostop
      autostop:
         - limit (5m)
   core: {}

  7. Нажмите Создать.

После этого конфигурация пройдет проверки, и агент начнет нагружать тестируемый сервис.

Чтобы наблюдать за результатами выполнения тестирования, выберите созданный тест и перейдите на вкладку Результаты теста.

Как удалить созданные ресурсы

Некоторые ресурсы платные. Чтобы за них не списывалась плата, удалите ресурсы, которые вы больше не будете использовать:

  1. Удалите агент.
  2. Удалите таблицу маршрутизации.
  3. Удалите NAT-шлюз.
Предыдущая
HTTPS-тест со ступенчатой нагрузкой с помощью Pandora
Следующая
Нагрузочный тест с помощью JMeter