JtlReporter
Description
Online reporting application to generate reports from JMeter(Taurus), Locust and other tools by either uploading JTL(csv) file or streaming data from the test run continuously. JtlReporter's main objective is to help you to understand your performance reports better and to spot performance regression.
Features
- Detailed performance report
- Test run comparison
- Performance regression alerts
- Performance insights
- and more.
Installation steps
- Install Docker (Engine, Compose)
- Clone this repository and navigate into cloned folder
- Deploy JtlReporter using
docker-composewithin the same folder
$ docker-compose up -d- Open in your browser IP address of deployed environment at port
2020
$ http://IP_ADDRESS:2020
Migration from v3 to v4
- Shut down the app but leave DB (postgres) running
- Backup you v3 DB!
- Run following query to modify the DB schema:
ALTER TABLE jtl.items
DROP COLUMN data_id;
- Dump all of your data by running:
docker exec -t <container_name> pg_dumpall -a -U postgres > backup_v3.sql
- Import the data to v4 DB (make sure the DB is up):
docker exec -i <container_name> psql -U postgres -d jtl_report < backup_v3.sql
If you use Taurus, see the needed changes in upload script.
Documentation 📖
For additional information please refer to the documentation.
Analytics
Currently, the following metrics are collected:
- every 6 hours the backend application sends an event that the instance is alive
- report processing is finished
If you dont want the analytics to be used, you can set OPT_OUT_ANALYTICS to true for backend service.
Mixpanel service is used for storing the data.
Repositories structure
JtlReporter consists of the following parts:
Screenshot
License
Jtl Reporter is GNU Affero General Public License v3.0 licensed (frontend, backend and listener).
This repository is MIT licensed.