Pocket load tester

Scale curl requests, cousin of ab, siege, hey.

Code lines Comments

Demo

Install

go install github.com/vearutop/plt@latest
$(go env GOPATH)/bin/plt --help

Or download binary from releases.

Linux AMD64

wget -q https://github.com/vearutop/plt/releases/latest/download/linux_amd64.tar.gz && tar xf linux_amd64.tar.gz && rm linux_amd64.tar.gz
./plt -version

Usage

usage: plt [<flags>] <command> [<args> ...]

Pocket load tester pushes to the limit

Flags:
  --help            Show context-sensitive help (also try --help-long and --help-man).
  --number=1000     Number of requests to run, 0 is infinite.
  --concurrency=50  Number of requests to run concurrently.
  --rate-limit=0    Rate limit, in requests per second, 0 disables limit (default).
  --duration=1m     Max duration of load testing, 0 is infinite.
  --slow=1s         Min duration of slow response.
  --live-ui         Show live ui with statistics.

Commands:
  help [<command>...]
    Show help.

  curl [<flags>] [<url>]
    Repetitive HTTP transfer

You can "copy as cURL" in your browser and then prepend that with plt to throw 1000 of such requests.

For even better performance you can use plt curl --fast that will employ awesome fasthttp as transport. This mode lacks detailed breakdown of latencies, but can push request rate to the limit.

Use --http2 for HTTP/2 or --http3 for HTTP/3 (go1.19 or later).

If the server is wrapped with Envoy proxy, upstream latency distribution will be collected from the values of X-Envoy-Upstream-Service-Time response header.

In --live-ui mode you can control concurrency and rate limits with arrow keys.

Sending different requests

Sending same request over and over again is not very useful in some cases. It may hit caches or be blocked by the server. However, describing dynamic requests with predefined parameters is very difficult in general that's why plt does not attempt to provide such functionality.

Instead, you can extend plt with your own custom request preparer written in Go and having full control and flexibility with familiar API. Please check an example of customization with dynamic requests.

Example

plt --live-ui --duration=20s --rate-limit=60 curl -X GET "https://demo.phperf.ml/profile"

plt --live-ui --duration=20s --rate-limit=60 curl -X GET "https://demo.phperf.ml/profile"
Host resolved: 130.61.99.204

Requests per second: 59.96
Total requests: 1201
Time spent: 20.029s

Request latency percentiles:
99%: 101.73ms
95%: 64.88ms
90%: 44.57ms
50%: 28.09ms

Request latency distribution in ms:
[   min    max]  cnt total% (1201 events)
[ 19.03  19.03]    1  0.08%
[ 22.52  23.76]   25  2.08% ..
[ 23.78  25.26]  111  9.24% .........
[ 25.26  26.58]  200 16.65% ................
[ 26.58  29.61]  449 37.39% .....................................
[ 29.61  39.94]  287 23.90% .......................
[ 40.54  40.54]    1  0.08%
[ 41.00  62.45]   60  5.00% ....
[ 62.77 110.91]   57  4.75% ....
[126.64 260.53]   10  0.83%

Requests with latency more than 1s: 0

Bytes read 2.3MB / 23.5MB/s
Bytes written 105.4KB / 57.6KB/s

DNS latency distribution in ms:
[ min  max] cnt total% (16 events)
[0.44 0.44]  1  6.25% ......
[0.49 0.49]  1  6.25% ......
[0.50 0.50]  1  6.25% ......
[0.56 0.56]  1  6.25% ......
[0.61 0.61]  2 12.50% ............
[0.65 0.70]  3 18.75% ..................
[0.77 0.77]  1  6.25% ......
[0.88 0.88]  1  6.25% ......
[1.00 1.03]  3 18.75% ..................
[1.28 1.42]  2 12.50% ............

TLS handshake latency distribution in ms:
[   min    max] cnt total% (16 events)
[ 64.95  64.95]  1  6.25% ......
[ 65.14  65.14]  1  6.25% ......
[ 66.98  66.98]  1  6.25% ......
[ 70.94  71.81]  3 18.75% ..................
[ 74.10  76.13]  2 12.50% ............
[ 80.20  82.91]  2 12.50% ............
[ 90.86  90.86]  1  6.25% ......
[127.14 127.72]  2 12.50% ............
[157.99 161.84]  2 12.50% ............
[179.98 179.98]  1  6.25% ......

Time to first resp byte (TTFB) distribution in ms:
[   min    max]  cnt total% (1201 events)
[ 18.97  18.97]    1  0.08%
[ 22.49  23.77]   27  2.25% ..
[ 23.78  24.96]   81  6.74% ......
[ 24.96  26.56]  236 19.65% ...................
[ 26.57  29.52]  441 36.72% ....................................
[ 29.54  29.54]    1  0.08%
[ 29.56  40.90]  288 23.98% .......................
[ 41.16  62.68]   60  5.00% ....
[ 63.02 110.87]   56  4.66% ....
[126.59 260.27]   10  0.83%

Connection latency distribution in ms:
[  min   max] cnt total% (16 events)
[28.04 28.04]  1  6.25% ......
[28.13 28.13]  1  6.25% ......
[29.68 29.68]  1  6.25% ......
[30.01 30.41]  2 12.50% ............
[31.04 31.12]  2 12.50% ............
[32.22 32.44]  2 12.50% ............
[33.37 34.07]  3 18.75% ..................
[36.04 36.04]  1  6.25% ......
[40.09 40.09]  1  6.25% ......
[43.50 45.20]  2 12.50% ............

Responses by status code
[200] 1201

Response samples (first by status code):
[200]
Connection: keep-alive
Content-Length: 1733
Content-Type: application/json; charset=utf-8
Date: Thu, 08 Apr 2021 15:25:54 GMT
Server: nginx/1.14.0 (Ubuntu)

{"recent":[{"addr":{"id":"606f1f90dcdc3"},"edges":3715,"wt":"190.55ms","cpu":"179.03ms","io":"11.52ms","peakMem":"3.52M"},{"addr":{"id":"606f1faf1c5c3"},"edges":3715,"wt":"270.14ms","cpu":"185.62ms","io":"84.52ms","peakMem":"3.52M"},{"addr":{"id":"606f1fc261e9d"},"edges":575,"wt":"3.4s","cpu":"3.39s","io":"9.71ms","peakMem":"28.03M"},{"addr":{"id":"606f1fcd6f694"},"edges":3715,"wt":"153.58ms","cpu":"143.68ms","io":"9.9ms","peakMem":"3.52M"},{"addr":{"id":"606f1feba911d"},"edges":3715,"wt":"202.18ms","cpu":"191.82ms","io":"10.36ms","peakMem":"3.52M"},{"addr":{"id":"606f20052f7c1"},"edges":471,"wt":"679.08ms","cpu":"669.01ms","io":"10.07ms","peakMem":"6.18M"},{"addr":{"id":"606f2009de4cd"},"edges":3715,"wt":"175.34ms","cpu":"163.14ms","io":"12.2ms","peakMem":"3.52M"},{"addr":{"id":"606f2028185dd"},"edges":3715,"wt":"677.03ms","cpu":"320.84ms","io":"356.19ms","peakMem":"3.52M"},{"addr":{"id":"606f2046c16a2"},"edges":3715,"wt":"313.28ms","cpu":"292.38ms","io":"20.9ms","peakMem":"3.52M"},{"...

S3 latency

usage: plt s3 --bucket=BUCKET --key=KEY [<flags>]

S3 transfer

Flags:
  --help                         Show context-sensitive help (also try --help-long and --help-man).
  --version                      Show application version.
  --number=1000                  Number of requests to run, 0 is infinite.
  --concurrency=50               Number of requests to run concurrently.
  --rate-limit=0                 Rate limit, in requests per second, 0 disables limit (default).
  --duration=1m                  Max duration of load testing, 0 is infinite.
  --slow=1s                      Min duration of slow response.
  --live-ui                      Show live ui with statistics.
  --access-key=ACCESS-KEY        Access key/id (env AWS_ACCESS_KEY).
  --secret-key=SECRET-KEY        Secret key (env AWS_SECRET_KEY).
  --session-token=SESSION-TOKEN  Session token (env AWS_SESSION_TOKEN).
  --region="eu-central-1"        Region.
  --url=URL                      Optional S3 URL (if not AWS).
  --bucket=BUCKET                Bucket name.
  --key=KEY                      Entry key.
  --path-style                   To use path-style addressing, i.e., `http://s3.amazonaws.com/BUCKET/KEY`.
  --save=SAVE                    Path to local file to save the entry.
  --upload=UPLOAD                Path to local file to upload to S3, enables upload load testing.

./plt --number 1000 --rate-limit 300 s3 --access-key=<redacted> --secret-key=<redacted> --url=ceph.example.com:7480 --bucket=foo --key=bar --path-style

Requests per second: 299.34
Successful requests: 1000
Time spent: 3.341s

Request latency percentiles:
99%: 46.36ms
95%: 15.99ms
90%: 9.35ms
50%: 7.01ms

Request latency distribution in ms:
[  min   max]  cnt total% (1000 events)
[ 6.44  6.44]    1  0.10%
[ 6.49  6.55]    9  0.90%
[ 6.55  6.66]   43  4.30% ....
[ 6.66  7.00]  445 44.50% ............................................
[ 7.00  7.89]  346 34.60% ..................................
[ 7.93  7.93]    1  0.10%
[ 7.93 10.39]   70  7.00% .......
[10.54 13.57]   23  2.30% ..
[13.65 28.34]   30  3.00% ...
[30.16 52.90]   32  3.20% ...

Requests with latency more than 1s: 0

Read: total 2600.89 MB, avg 2.60 MB, 778.49 MB/s

vearutop / plt

readme