README
¶
Load Testing
Load testing framework and loadtests for the kcp project. Please note this setup is intended to be used for load-testing only and not setting up fully production grade environments.
Architecture
Please refer to the drawing of the general layout.
Setup
Installation scripts and manuals are provided in setup/Readme.
Usage
Local Development
All test cases are organized in the testing folder. You can run the entire suite using:
go test ./testing/...
The tests will prompt you for any specific required variables and configs.
Alternatively you can run a subset of tests using standard go test syntax. E.g.:
go test ./testing/... -run ^TestExample
Report Creation
If you are running the tests to create reports, please use the suite.sh helper script. It automatically
ensures that all files get generated using unified timestamps in a .loadtest-results folder.
./suite.sh TestExample
Additionally you can also overwrite default parameters, by supplying a custom config file:
./suite.sh --config config.example.json TestExample
The script will show live output and is safe to run in jumphost environments where connectivity might break.
Development
The load-testing framework itself is organized in the pkg folder. You can run its unit
tests directly using:
go test ./pkg/...
Partitioning
You can partition your loadtest by providing it with a unique start number. Please be advised that this multiplexes your test. Any load you place will be multiplied by the number of partitions. Depending per test, adjust throughput values like qps accordingly.
Directories