Versions 4.1–5.2

httpstress 4.1–5.2

CLI utility for stress testing of HTTP servers with many concurrent connections.

Returns 0 if no errors, 1 if some requests failed, 2 on kill, 3 in case of invalid options and 4 if it encounters a setrlimit(2)/getrlimit(2) error.

Prints elapsed time and error count for each URL to stdout (if any; does not count successful attempts). Usage and runtime errors go to stderr.

Usage

httpstress [options] <URL list>

Options

• -c NUM – concurrent connections number (defaults to 1)
• -n NUM – total connections number (defaults to URL count)
• --version – print version to stdout and exit

Example usage

httpstress -c 1000 http://localhost https://google.com

Notes

• This ulility takes care of ulimit -n on Unix systems: sets it to the value of -c option plus 6, if the current limit is smaller.
• Output is YAML-formatted. Example:

Errors:
  - Location: http://localhost
    Count:    334
  - Location: https://127.0.0.1
    Count:    333
Elapsed time: 4.791903888s

• This utility follows HTTP redirects
• Non-200 HTTP return code is an error since v5