Автостоп
Автостоп - это плагин, настраиваемый при создании теста, который позволяет автоматически остановить тест в зависимости от заранее установленных критериев.
Автостоп применяется для ограничения времени и ресурсов, предусмотренных для тестирования, или когда после наступления определенных событий дальнейшее тестирование становится нецелесообразным.
Сработавший критерий автостопа приводит к досрочному завершению теста. Чтобы определить какой именно критерий остановил тест, им присваиваются различные Коды завершения, которые можно использовать для автоматической оценки результатов теста.
Формат блока autostop
в файле конфигурации тестирования yaml
:
autostop:
enabled: true
package: yandextank.plugins.Autostop
autostop:
- <критерий_автостопа>(<параметры_критерия>)
Важно
В файле конфигурации блок autostop
является обязательным, иначе тест не будет работать в новых версиях системы.
В блоке как минимум должен быть указан критерий limit
— предельное время работы теста.
Значение критерия limit
рекомендуется выставлять немного большим ожидаемой продолжительности теста, чтобы избежать не предусмотренного завершения теста автостопом при позитивном течении тестирования.
Основные критерии
Критерий | Описание |
---|---|
limit |
Обязательный критерий.Тест остановится через указанный период времени.Пример: limit(1m) . |
time |
Тест остановится, если в течение определенного периода среднее время ответа превысит установленное значение.Примеры: time(1s500ms,30s) , time(50,15) .Код завершения — 21 . |
http |
Тест остановится, если в течение определенного периода количество ответов с конкретными HTTP-кодами превысит установленное абсолютное или относительное значение. Используйте xx для всех ненулевых значений кодов.Примеры: http(404,10,15) , http(5xx,10%,1m) .Код завершения — 22 . |
net |
Аналогично http для net-кодов.Код завершения — 23 . |
quantile |
Тест остановится, если в течение определенного периода выбранный процентиль запросов превысит установленное значение. Доступные процентили: 25 , 50 , 75 , 80 , 90 , 95 , 98 , 99 , 100 .Пример: quantile(95,100ms,10s) , этот критерий остановит тест, если в течение 10 секунд 95 процентиль превысит 100 миллисекунд (в течение 10 секунд время обработки 5% запросов превысит 100 миллисекунд). |
instances |
Тест остановится, если в течение определенного периода количество тестирующих потоков превысит установленное значение.Примеры: instances(80%,30) , instances(50,1m) .Код завершения — 24 . |
steady_cumulative |
Тест остановится, если в течение определенного периода совокупные процентили не изменяются.Пример: steady_cumulative(1m) .Код завершения — 33 . |
Основные критерии не усредняются, они проверяются каждую секунду за указанный период. Например, критерий autostop=time(50,15)
остановит тест, если в течение 15 секунд среднее время ответа за каждую секунду превышает 50 миллисекунд.
Дополнительные критерии
Критерий | Описание |
---|---|
total_time |
Аналогично time , но суммарно за весь период времени (ответы, которые соответствуют критерию, могут быть не последовательными, но приходить за указанный период времени).Пример: total_time(300ms,70%,3s) .Код завершения — 25 . |
total_http |
Аналогично http , но суммарно за весь период времени. См. total_time .Примеры: total_http(5xx,10%,10s) , total_http(3xx,40%,10s) .Код завершения — 26 . |
total_net |
Аналогично net , но суммарно за весь период времени. См. total_time .Примеры: total_net(79,10%,10s) , total_net(11x,50%,15s) .Код завершения — 27 . |
negative_http |
Инвертированный total_http . Тест остановится, если в течение определенного периода суммарное количество ответов с конкретными HTTP-кодами будет меньше установленного абсолютного или относительного значения. Используйте HTTP-код 200 , чтобы удостовериться, что сервер отвечает.Пример: negative_http(2xx,10%,10s) .Код завершения — 28 . |
negative_net |
Инвертированный total_net . Аналогично negative_http для net-кодов.Пример: negative_net(0,10%,10s) .Код завершения — 29 . |
http_trend |
Тест остановится, если в течение определенного периода тренд для определенных http-кодов остается отрицательным. Тренд — это сумма усредненного коэффициента линейной функции, рассчитанный для каждой пары точек за последние n секунд, и стандартного отклонения для него.Пример: http_trend(2xx,10s) .Код завершения — 30 . |
Критерии для определенного тега
Все критерии, кроме limit
, могут применяться для определенного URI, помеченного тегом, а не для всего теста в целом.
Например, критерий time(1s,5s,/latest/index/)
остановит тест, если в течение 5 секунд среднее время ответа только с URL-адреса с тегом /latest/index/
превысит 1 секунду.
Таким образом, можно проводить тестирование для каждого конкретного URI. Например:
autostop:
enabled: true
package: yandextank.plugins.Autostop
autostop:
- limit(5m)
- http(4xx, 20%, 15s, case1)
- http(4xx, 5%, 5s, case2)
Такой автостоп остановит тест, если в течение 15 секунд количество ответов URI с тегом case1
с http-кодом 4xx
превысит 20%, или в течение 5 секунд количество ответов URI с тегом case2
с http-кодом 4xx
превысит 5%.