Plow is an HTTP(S) benchmarking tool, written in Golang. It uses excellent fasthttp instead of Go's default net/http due to its lightning fast performance.
Plow runs at a specified connections(option -c) concurrently and real-time records a summary statistics, histogram
of execution time and calculates percentiles to display on Web UI and terminal. It can run for a set duration(
option -d), for a fixed number of requests(option -n), or until Ctrl-C interrupted.
The implementation of real-time computing Histograms and Quantiles using stream-based algorithms inspired by prometheus with low memory and CPU bounds. so it's almost no additional performance overhead for benchmarking.
❯ ./plow http://127.0.0.1:8080/hello -c 20
Benchmarking http://127.0.0.1:8080/hello using 20 connection(s).
@ Real-time charts is listening on http://[::]:18888
Summary:
Elapsed 8.6s
Count 969657
2xx 776392
4xx 193265
RPS 112741.713
Reads 10.192MB/s
Writes 6.774MB/s
Statistics Min Mean StdDev Max
Latency 32µs 176µs 37µs 1.839ms
RPS 108558.4 112818.12 2456.63 115949.98
Latency Percentile:
P50 P75 P90 P95 P99 P99.9 P99.99
173µs 198µs 222µs 238µs 274µs 352µs 498µs
Latency Histogram:
141µs 273028 ■■■■■■■■■■■■■■■■■■■■■■■■
177µs 458955 ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
209µs 204717 ■■■■■■■■■■■■■■■■■■
235µs 26146 ■■
269µs 6029 ■
320µs 721
403µs 58
524µs 3
Binary and image distributions are available through the releases assets page.
go install github.com/six-ddc/plow@latest
# brew update
brew install plowdocker run --rm --net=host ghcr.io/six-ddc/plow
# docker run --rm -p 18888:18888 ghcr.io/six-ddc/plowusage: plow [<flags>] <url> A high-performance HTTP benchmarking tool with real-time web UI and terminal displaying, use --history to record a run and "plow history" to browse the recorded runs Examples: plow http://127.0.0.1:8080/ -c 20 -n 100000 plow https://httpbin.org/post -c 20 -d 5m --body @file.json -T 'application/json' -m POST Flags: --help Show context-sensitive help. -c, --concurrency=1 Number of connections to run concurrently --rate=infinity Number of requests per time unit, examples: --rate 50 --rate 10/ms --ramp-up=-1 Concurrently will increase pre seconds -n, --requests=-1 Number of requests to run -d, --duration=DURATION Duration of test, examples: -d 10s -d 3m -i, --interval=200ms Print snapshot result every interval, use 0 to print once at the end --seconds Use seconds as time unit to print --json Print snapshot result as JSON --trace Trace latency of request phases: DNS, Connect, TLS, Write, Wait(TTFB), Read -b, --body=BODY HTTP request body, if body starts with '@' the rest will be considered a file's path from which to read the actual body content --stream Specify whether to stream file specified by '--body @file' using chunked encoding or to read into memory -m, --method="GET" HTTP method -H, --header=K:V ... Custom HTTP headers --host=HOST Host header -T, --content=CONTENT Content-Type header --cert=CERT Path to the client's TLS Certificate --key=KEY Path to the client's TLS Certificate Private Key -k, --insecure Controls whether a client verifies the server's certificate chain and host name --listen=":18888" Listen addr to serve Web UI --timeout=DURATION Timeout for each http request --dial-timeout=DURATION Timeout for dial addr --req-timeout=DURATION Timeout for full request writing --resp-timeout=DURATION Timeout for full response reading --socks5=ip:port Socks5 proxy --http-proxy=username:password@ip:port Set HTTP proxy --auto-open-browser Specify whether auto open browser to show web charts --[no-]clean Clean the histogram bar once its finished. Default is true --output-errors=OUTPUT-ERRORS Output errors to file --summary Only print the summary without realtime reports --unix-socket=UNIX-SOCKET Unix domain socket path to use for connection --history Record this run in the history to browse by "plow history" --history-dir=DIR Directory to record the history, default is ~/.plow/history --label=LABEL Mark this run with a label, such as the change being tested --version Show application version. Flags default values also read from env PLOW_SOME_FLAG, such as PLOW_TIMEOUT=5s equals to --timeout=5s Args: <url> Request url
Basic usage:
plow http://127.0.0.1:8080/ -c 20 -n 10000 -d 10s
POST a json file:
plow https://httpbin.org/post -c 20 --body @file.json -T 'application/json' -m POSTTrace latency of request phases:
plow http://localhost:8080/ -c 20 -d 4s --trace
Latency Phases Count Min Mean P50 P90 P99 Max
DNS 20 2.963ms 4.073ms 3.785ms 5.381ms 5.565ms 5.565ms
Connect 20 226µs 1.025ms 1.014ms 1.8ms 2.475ms 2.475ms
TLS 0 - - - - - -
Write 12894 3µs 9µs 6µs 11µs 112µs 783µs
Wait 12894 4.869ms 5.758ms 5.585ms 6.332ms 8.845ms 25.494ms
Read 12894 70µs 253µs 178µs 426µs 1.231ms 17.633ms
DNS,ConnectandTLSare only measured when a new connection is established, so their counts are the number of connections.Writeis the time of writing the request,Waitis the time from the request written to the first response byte (TTFB),Readis the time of reading the rest of the response.- When a proxy is used (
--socks5orHTTP(S)_PROXYenv), the whole proxy dialing is measured asConnect. - The mean latency of each phase per second is also shown in the Web charts.
Benchmark history:
Add --history to record a run in ~/.plow/history, including the data of the real-time charts of each second. After the runs are finished, plow history serves a page to browse and compare them:
plow http://127.0.0.1:8080/ -c 20 -d 30s --history --label "after cache" plow history # http://127.0.0.1:18889, use --listen :18889 to allow the access from other hosts plow history --auto-open-browser --history-dir /path/to/history
- The runs of each method and URL are listed with their options, and the RPS, latency and error rate of each run are shown as trend charts.
- Select a run in the table or the charts to replay its real-time charts.
- Select two runs to compare them, the older one is the baseline unless swapped. The options, status codes, errors, latency and throughput are shown side by side, the changes over 3% are highlighted as better or worse, and the real-time charts of them are drawn together.
- Label a run by
--labelto tell it from the others, and clickRefreshto load the runs finished after the page is opened. - All the runs are kept, delete the ones not needed in the page.
# Add the statement to their bash_profile (or equivalent): eval "$(plow --completion-script-bash)" # Or for ZSH eval "$(plow --completion-script-zsh)"
See LICENSE.