HTTP Load Tester
A command-line utility for HTTP load testing that allows you to benchmark the performance of web servers and applications. This tool supports testing individual URLs or multiple URLs from a CSV file with configurable concurrency and request parameters.
Features
- Test single URLs with customizable request count and concurrency
- Process multiple URLs from a CSV file
- Configurable concurrency levels for both URL and file-based testing
- Comprehensive performance metrics including response time statistics
- Detailed logging to file
Installation
Prerequisites
- Go
Building from source
# Clone the repository
git clone https://github.com/falconakhil/HTTP-Load-Tester.git
# Build the binary
go build -o loadtest
git clone https://github.com/falconakhil/HTTP-Load-Tester.git
# Build the binary
go build -o loadtest
Usage
Testing a single URL
# Basic usage
./loadtest test https://example.com
# With custom parameters
./loadtest test https://example.com --requests 100 --concurrency 10 --logfile test.log
./loadtest test https://example.com
# With custom parameters
./loadtest test https://example.com --requests 100 --concurrency 10 --logfile test.log
Testing multiple URLs from a CSV file
# Basic usage
./loadtest file urls.csv
# With custom parameters
./loadtest file urls.csv --concurrent_urls 5 --logfile batch_test.log
./loadtest file urls.csv
# With custom parameters
./loadtest file urls.csv --concurrent_urls 5 --logfile batch_test.log
Command Line Options
Global Options
--logfile- Path to log file (default: stdout)
test Command Options
--requests, -n- Number of requests to send (default: 1)--concurrency, -c- Number of concurrent requests (default: 1)
file Command Options
--concurrent_urls, -c- Number of concurrent URL tests (default: 1)
CSV File Format
The CSV file for batch testing should have the following format:
URL,REQUESTS,CONCURRENCY
https://example.com,100,10
https://another-example.com,50,5
Each line contains:
- URL to test
- Number of requests to make
- Concurrency level for that URL
Project Structure
HTTP Load Tester/
+-- cmd/ # Command definitions and CLI handlers
| +-- file.go # Command for file-based testing
| +-- root.go # Root command definition
| +-- test.go # Command for single URL testing
+-- lib/ # Core library code
| +-- tester.go # Main testing functionality
| +-- testUrlWorker.go # Worker implementation for URL testing
+-- models/ # Data models and display functions
+-- main.go # Application entry point
Output Metrics
The tool provides the following performance metrics:
- Total Time: Overall time taken for all requests
- Average Response Time: Mean response time across all requests
- Min/Max Response Time: Fastest and slowest responses
- Success Rate: Percentage of successful responses
- Status Code Distribution: Count of responses by HTTP status code