HTTP Test Tool

HTTP Test Tool is a tool for testing the performance of HTTP servers, supporting Linux's epoll. It allows users to set the number of threads, connections, and test duration, and outputs detailed test results. With Lua scripts, you can configure each HTTP request in detail.

Features

• Supports HTTP and HTTPS
• Supports customizing request through Lua script
• Supports multi-threaded and multi-connection testing
• Uses epoll to improve performance
• Outputs detailed test results (requests, transfer rate, latency, etc.)

Requirements

• Linux operating system
• OpenSSL library
• make tool

Installation

Follow these steps to install HTTP Test Tool:

git clone https://github.com/hongzhidao/http-test.git
cd http-test && make

Scripting

The http table is pre-populated with the values from command line arguments.

• http.method: Set the HTTP method.
• http.path: Set the request path.
• http.headers: Set the request headers.
• http.body: Set the request body.
• http.request: Define a custom request function.

Note:

• http.headers can override http host whose value is from url.
• You can enable chunked transfer encoding by setting http.headers["Transfer-Encoding"] = "chunked".
• The http.lua file is an example to custom request.

Usage

Run HTTP Test Tool and view the usage help:

./test -h

Output:

Usage: ./test [-t value] [-c value] [-d value] [-H header] [-s script] [-v] [-h] url
Options:
 -t value   Set the value of threads
 -c value   Set the value of connections
 -d value   Set the value of duration
 -H header  Set the request header
 -s file    Set the script file
 -v         print the version information
 -h         print this usage message
 url        The required URL to test

Example:

./test http://127.0.0.1/50k.html

Output example:

Testing 2 threads and 10 connections
@ http://127.0.0.1/50k.html for 10s

260849 requests and 233.83M bytes in 10.00s
  Requests/sec  26084
  Transfer/sec  23.38M

Latency:
  Mean      353.00us
  Stdev     73.00us
  Max       2.85ms
  +/-Stdev  81.23%

Latency Distribution:
  50%  341.00us
  75%  382.00us
  90%  433.00us
  99%  601.00us

License

This project is licensed under the BSD 2-Clause License. See the LICENSE file for details.

---

If you have any questions or suggestions, feel free to contact me (hongzhidao@gmail.com).