locust-reporter
locust-reporter copied to clipboard
Generate HTML reports from Locust load test output
Locust HTML Report Converter
Simple Go command line application to convert the results of a Locust load test into a HTML report.
Locust is a developer focused load testing tool
The report will show three main sets of data:
- Summary statistics for all requests
- History data, with a range of metrics charted over the lifetime of the load test
- List of failures by request
This project uses Go templates, Sprig and Packr
Getting Started
Installing
Install with go get
go get -u github.com/benc-uk/locust-reporter/cmd/locust-reporter
This will install the binary into $GOPATH/bin/locust-reporter
, ensure this is in your path
Or download a pre-compiled binary (Linux x64)
wget https://github.com/benc-uk/locust-reporter/releases/download/v1.2.2/locust-reporter
Usage
The command takes the following arguments:
-
-dir
- The input directory, which contains the three Locust CSV files. Default is current directory. -
-prefix
- The prefix of the CSV files, required parameter -
-outfile
- The output HTML file, which will be created or overwritten. Default isout.html
-
-failures
- Include log of failures in the report, can result in very large output. Default isfalse
Example
./locust-reporter -help
╔════════════════════════════════════════════════╗
║ 🦗 Locust HTML Report Converter 📜 v1.2.2 ║
╚════════════════════════════════════════════════╝
-dir string
Directory holding input Locust CSV files (default ".")
-failures
Include failures in report, can result in very large output
-outfile string
Output HTML filename (default "./out.html")
-prefix string
Prefix for CSV files, required
Building & Running
Makefile reference
build Build binary executable, into bin directory
clean Clean up
help This help message :)
lint-fix Lint & format, will try to fix errors and modify code
lint Lint & format, will not fix but sets exit code on error
run Run locally
Screenshots
Known Issues
A very long test with high number of data points may take some processing to display
Change Log
See complete change log
License
This project uses the MIT software license. See full license file