load.conf(5)

NAME
load.conf - yandex-tank(1) load test configuration file.

DESCRIPTION
This manual page explains the syntax, options and parameters which used in yandex-tank(1) config. Config is a classic INI file.

SECTIONS
Configuration file consists from sections and options. Each section contains options for a particular module. For example:
[phantom] - contains options for phantom module
address=127.0.0.1 - address option for phantom plugin. Some options may consist of multiple strings. To do that, begin next line with an indent:
[phantom]
rps_scedule = const(1,10)
  const(10,10m)

BASIC OPTIONS

address=FQDN , IP
    IP address(ipv6 supported as x:x:x:x:x:x:x:x)

port=PORT
    IP port

rps_scedule=...
    Load scheme of a test. These types of scheme stages may be used: const(RPS,DURATION), line (START_RPS,END_RPS,DURATION), step (START_RPS, END_RPS, STEP_RPS,DURATION_STEP). Load scheme is combined from multiple stages of those types: rps_schedule = line(1,10, 10) const(10,10)

uris=URL
    URL relative to server's root. You can use several uri= parameters. For example:
    uris = /
      /buy

header_http=HTTP_PROTO
    HTTP protocol versions. Versions 1.1 and 1.0 are supported, 1.0 as default

headers=[CUSTOM_HEADERS]
    Additional HTTP headers:
    headers=[Connection: Close]

ssl=SSL_ENABLED
    ssl=1 enable SSL, in ssl=0 disable SSL, default 0

autostop=...
    This is a multi-string option. Autostop criteria to stop the test automaticaly. For example:
    [autostop]
    autostop=time(1,10)
      http(404,1%,5s)
      net(xx,1,30) Further reading: https://github.com/yandex-load/yandex-tank#auto-stop

instances=NUM
    Number of concurrent connections.

writelog=NUM
    1 - enable request/answers log, 0 - disable (WARNING: disable when you have high RPS to lower the load on your generator machine)

time_periods=NUM,NUM2,NUM3...
    Distribution histogram boundaries, for example:
    [aggregator]
    time_periods = 10 45 50 100 150 300 500 1s 1500 2s 3s 10s

tank_type=NUM
    1 - HTTP protocol, 2 - raw data (any stateless protocol).

gatling_ip=IP IP2 IP3..
    Multiple source IPs.

EXAMPLE
# yandex-tank config file
[phantom]
address=127.0.0.1
port=80
writelog=1
rps_scedule = const (10,10m)
header_http = 1.1
headers = [Connection: Close]
  [target.yandex.net]
uris= /
#instances=10
#instances_schedule = line (1,1000,10m)
#tank_type=2
#gatling_ip = 141.8.153.82 141.8.153.81
ssl=0
[autostop]
autostop = http(5xx,100%,1)
[monitoring]
monitoring_config=none
[aggregator]
time_periods = 10 45 50 100 150 300 500 1s 1500 2s 3s 10s

SEE ALSO
yandex-tank (1)
https://github.com/yandex-load/yandex-tank#yandex-tank