README.md

Performance Test

This repository contains performance test examples for web applications. The test is based on the Grafana K6 tool.

How to run the test

1. Install the K6 tool. You can find the installation instructions here.

For example, on macOS, you can install it with the following command:

 brew install k6

2. Clone this repository.

3. Create a config.json file based on the config.example.json file and fill in the necessary information.

4. Run the test with the following command:

 k6 run examples/homepage_with_basic_auth.js

or with web dashboard:

 k6 run examples/homepage_with_basic_auth.js --out web-dashboard

by default, the test will run with scenario defined in the config.js file, but you can override it with the following command:

 k6 run examples/homepage_with_basic_auth.js --vus 20 --duration 40s

Your test results will be executed with 20 virtual users for 40 seconds.

Test results

The test results will be displayed in the terminal or in the web dashboard.

Terminal

Web Dashboard

The most important metrics

• http_req_duration: The time it took to complete the request.
• http_req_failed: The number of failed requests.
• iterations: Total number of iterations.

License

This project is licensed under the MIT License - see the LICENSE file for details.