Использование Gatling. Разбираемся в тестировании HTTP31.03.2022 20:31

Шаг 4. Используем Feeders

Узнать о Feeders побольше можно из предыдущей статьи. В нашем примере мы будем использовать фидеры из подключаемой библиотеки gatling-picatinny. Для этого в директории myhttpservice создайте новую директорию feeders, а в ней — object Feeders.

package ru.tinkoff.load.myhttpservice.feeders

import io.gatling.core.feeder._
import ru.tinkoff.gatling.feeders._

object Feeders {

  // Для имени компьютера будем использовать случайную строку с нужным алфавитом.
  val randomComputerName: Feeder[String] =
    RandomRangeStringFeeder("randomComputerName", alphabet = ('A' to 'Z').mkString)

  // Используем фидер для создания случайной даты
  val introducedDate: Feeder[String] = RandomDateFeeder("introduced")

  // Создаем случайную дату со сдвигом относительно 'introduced' даты
  val discontinuedDate: Feeder[String] = RandomDateRangeFeeder("introduced", "discontinued", 3)

  // Объединяем фидеры в одну переменную для удобства                                                  
  val feeders: Feeder[Any] = randomComputerName ** introducedDate ** discontinuedDate

}

Шаг 5. Пишем сценарий теста

Для этого измените код в CommonScenario. Опишите класс CommonScenario, в котором создаете сценарий — порядок выполнения определенных действий.

package ru.tinkoff.load.myhttpservice.scenarios

import io.gatling.core.Predef._
import io.gatling.core.structure.ScenarioBuilder
import ru.tinkoff.load.myhttpservice.cases.Actions._
import ru.tinkoff.load.myhttpservice.feeders.Feeders._

/*
Объект-компаньон для класса CommonScenario,
по сути синтаксический сахар, чтобы можно было вызвать сценарий
таким образом CommonScenario(), вместо new CommonScenario().scn
*/
object CommonScenario {
  def apply(): ScenarioBuilder = new CommonScenario().scn
}

class CommonScenario {

  // Создаем сценарий и его имя
  val scn: ScenarioBuilder = scenario("CommonScenario")
    // Подключаем наши фидеры
    .feed(feeders)
    // Подключаем наши запросы
    .exec(pressButtonAddNewComputer)
    .exec(createNewComputer)
}

Шаг 6. Создаем описание HTTP-протокола

По умолчанию в проекте из шаблона g8 уже настроен протокол HTTP. Для нашего скрипта в файле myhttpserviсe.scala опишем еще один протокол. 

package ru.tinkoff.load

import io.gatling.core.Predef._
import io.gatling.http.Predef._
import io.gatling.http.protocol.HttpProtocolBuilder
// Подключаем стандартные переменные из gatling picatinny
import ru.tinkoff.gatling.config.SimulationConfig._

package object myhttpservice {

  val httpProtocol: HttpProtocolBuilder = http
    // Используем стандартную переменную из gatling picatinny, значение которой подтянется из simulation.conf
    .baseUrl(baseUrl)
    // Базовые заголовки. Для большинства кейсов этого будет достаточно и ничего менять не нужно.                     
    .acceptHeader("text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8")
    .acceptEncodingHeader("gzip, deflate")
    .acceptLanguageHeader("en-US,en;q=0.5")
    .userAgentHeader("Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:16.0) Gecko/20100101 Firefox/16.0")
    // Если требуется добавить авторизацию, можно использовать специальные методы.
    .authorizationHeader("Bearer token")
    // Или определить свой заголовок
    .header("customHeader", "value")
}

Шаг 7. Подготавливаем нагрузочные тесты

В файле Debug.scala раскомментируйте строку с proxy для локальной отладки. Перед заливкой в VCS нужно либо убрать proxy, либо закомментировать его. 

package ru.tinkoff.load.myhttpservice

import io.gatling.core.Predef._
import io.gatling.http.Predef._
import ru.tinkoff.gatling.config.SimulationConfig._
import ru.tinkoff.load.myhttpservice.scenarios.CommonScenario

class Debug extends Simulation {

  setUp(
    // Запускаем наш сценарий
    CommonScenario()
      // Запускать будет один пользователь - одну итерацию
      .inject(atOnceUsers(1)),
  ).protocols(
    // Работа будет проходить по протоколу, который описан в конфигурации httpProtocol
    httpProtocol
      // Настраиваем прокси для отладки запросов, используем для этого fiddler 
      // или charles (8888 стандартный порт для прокси)
      .proxy(Proxy("localhost", 8888).httpsPort(8888))                                                
  )
    // Максимальное время теста равно testDuration, если тест не завершится за меньшее время, 
    // он будет остановлен автоматически
    .maxDuration(testDuration)
}

Для MaxPerformance- и Stability-тестов ничего менять не нужно. Подойдут дефолтные настройки для HTTP.

Шаг 8. Запускаем Debug-тест

Для запуска используйте GatlingRunner. После выполнения скрипта можно посмотреть консоль fiddler или charles и увидеть наши запросы.

package ru.tinkoff.load.myhttpservice

import io.gatling.app.Gatling
import io.gatling.core.config.GatlingPropertiesBuilder

object GatlingRunner {

  def main(args: Array[String]): Unit = {

    // Указывает имя симуляции Debug, либо какой-то другой, 
    // например, MaxPerformance
    val simulationClass = classOf[Debug].getName

    val props = new GatlingPropertiesBuilder
    props.simulationClass(simulationClass)

    Gatling.fromMap(props.build)
  }

}

Так, например, выглядят наши запросы в charles.

Также скрипт можно запустить из консоли командой.

sbt "Gatling / testOnly ru.tinkoff.load.myhttpservice.Debug"

Ниже — пример успешного запуска скрипта.

Simulation ru.tinkoff.load.myhttpservice.Debug started...                             

================================================================================
2022-01-27 11:44:22                                           0s elapsed
---- Requests ------------------------------------------------------------------
> Global                                                   (OK=3      KO=0     )
> pressButtonAddNewComputer                                (OK=1      KO=0     )
> createNewComputer                                        (OK=1      KO=0     )
> createNewComputer Redirect 1                             (OK=1      KO=0     )

---- CommonScenario ------------------------------------------------------------
[##########################################################################]100%
          waiting: 0      / active: 0      / done: 1     
================================================================================

Simulation ru.tinkoff.load.myhttpservice.Debug completed in 0 seconds
Parsing log file(s)...
Parsing log file(s) done
Generating reports...

================================================================================
---- Global Information --------------------------------------------------------
> request count                                          3 (OK=3      KO=0     )
> min response time                                    153 (OK=153    KO=-     )
> max response time                                    319 (OK=319    KO=-     )
> mean response time                                   209 (OK=209    KO=-     )
> std deviation                                         78 (OK=78     KO=-     )
> response time 50th percentile                        154 (OK=154    KO=-     )
> response time 75th percentile                        237 (OK=237    KO=-     )
> response time 95th percentile                        303 (OK=303    KO=-     )
> response time 99th percentile                        316 (OK=316    KO=-     )
> mean requests/sec                                      3 (OK=3      KO=-     )
---- Response Time Distribution ------------------------------------------------
> t < 800 ms                                             3 (100%)
> 800 ms < t < 1200 ms                                   0 (  0%)
> t > 1200 ms                                            0 (  0%)
> failed                                                 0 (  0%)
================================================================================

Заключение

Мы рассказали, как быстро и легко создать проект из нашего шаблона и написать скрипты для HTTP-протокола. В этом нам помогла наша библиотека Picatinny.

В следующих статьях поговорим о том, как написать скрипты для протоколов gRPC,   AMQP, JDBC и kafka.

Полезные ссылки

1. Подробнее о сессии в Gatling.

2. Подробнее о составлении HTTP-запросов в Gatling.

3. Подробнее о фидерах в Gatling.

4. Подробнее о настройке протокола HTTP в Gatling.

5. Проект Gatling из примеров этой статьи.

© Habrahabr.ru