bench

An HTTP load tester and compare results tool.

Import

import "github.com/thiagonache/bench"

Install binary

$ go install github.com/thiagonache/bench/cmd/simplebench@latest
$

CLI

The CLI supports two sub commands, run or cmp.

Run

Runs http benchmark and outputs the results to standard output. It supports any HTTP method and several other configs.

Usage of simplebench:
  -b string
        http body for the requests
  -c int
        number of concurrent requests (users) to run benchmark (default 1)
  -g    generate graphs
  -m string
        http method for the requests (default "GET")
  -r int
        number of requests to be performed in the benchmark (default 1)
  -t string
        requests content type header (default "text/html")
  -u string
        url to run benchmark

Examples:

• GET

  $ simplebench run -r 20 -c 2 -u https://httpbin.org
  Site: https://httpbin.org
  Requests: 20
  Successes: 20
  Failures: 0
  P50(ms): 150.359
  P90(ms): 431.346
  P99(ms): 761.359

• POST

    $ simplebench run -m POST -t "application/json" -b '{"data":"abc"}' -r 20 -c 2 -u https://httpbin.org/post
    Site: https://httpbin.org/post
    Requests: 20
    Successes: 20
    Failures: 0
    P50(ms): 143.970
    P90(ms): 395.692
    P99(ms): 574.325

• DELETE

    $ simplebench run -m DELETE -r 20 -c 2 -u https://httpbin.org/delete
    Site: https://httpbin.org/delete
    Requests: 20
    Successes: 20
    Failures: 0
    P50(ms): 145.996
    P90(ms): 596.712
    P99(ms): 640.887

Cmp

It compares two executions and provide the difference.

$ simplebench run -r 10 -u https://httpbin.org/delay/2 > stats1.txt
$ simplebench run -r 10 -u https://httpbin.org/delay/1 > stats2.txt
$ simplebench cmp stats{1,2}.txt
Site: https://httpbin.org/delay/2
Metric              Old                 New                 Delta               Percentage
P50(ms)             2144.024            1146.673            -997.351            -46.52
P90(ms)             2221.990            1362.111            -859.879            -38.70
P99(ms)             2599.690            1613.528            -986.162            -37.93