Configuration¶
Config File (config.cfg)¶
Each project contains a config.cfg
file where test settings are defined.
The config file contains a [global]
section and [user_group-*]
sections.
Minimal Configuration¶
Here is a sample config.cfg
file showing minimal options, defining 1 group of virtual users:
[global]
run_time = 100
rampup = 100
results_ts_interval = 10
[user_group-1]
threads = 10
script = vu_script.py
Full Configuration¶
Here is a sample config.cfg
file showing all possible options, defining 2 groups of virtual users:
[global]
run_time = 300
rampup = 300
results_ts_interval = 30
progress_bar = on
console_logging = off
xml_report = off
results_database = sqlite:///my_project/results.db
post_run_script = python my_project/foo.py
[user_group-1]
threads = 30
script = vu_script1.py
[user_group-2]
threads = 30
script = vu_script2.py
Global Options¶
The following settings/options are available in the [global]
config section:
run_time
: duration of test (seconds) [required]rampup
: duration of user rampup (seconds) [required]results_ts_interval
: time series interval for results analysis (seconds) [required]progress_bar
: turn on/off console progress bar during test run [optional, default = on]console_logging
: turn on/off logging to stdout [optional, default = off]xml_report
: turn on/off xml/jtl report [optional, default = off]results_database
: database connection string [optional]post_run_script
: hook to call a script at test completion [optional]
User Groups¶
The following settings/options are available in each [user_group-*]
config section:
threads
: number of threads/virtual usersscript
: virtual user test script to run