fire-ant

fire-ant

Simple server benchmark tool.

Compile

You need to install Go 1.20 or the latest one.

go build main.go

Or you can run without compiling.

go run main.go

How to use

• This will send total 100 requests, but will be sent concurrently using 10 workers (can be seen as client):

  $ ./main -n 100 -c 10 -url http://localhost
  

• If you want to send request sequentially (which will not reflect the real performance), use this:

  $ ./main -n 100 -c 1 -url http://localhost
  

• Example with the results

  ./main -n 100 -c 3 -url https://google.com
  Test 100 requests using 3 workers to: https://google.com
  Average first byte time         78.8 ms
  Average time per request        78.9 ms
  Request per second                13 req/s
  

How it works

The app will send requests to target URL until it reaches value defined by parameter n and use c number of workers (clients) to finish all requests.

Let's say n = 10 and c = 3. We can create simulation diagram below using 3 clients (workers) and request time for each client. All 3 clients will start sending request in parallel (#1 - #3). Everytime a request was completed, the client will send another request. The last request (#10) will be handled by client 3 and client 1 and 2 will not create any request since total 10 requests have been reached.

client 1: ####(1) -> #####(4) -> #####(8)
client 2: ######(2) -> #####(6) -> #####(9)
client 3: #####(3) -> ###(5) -> ####(7) -> ####(10)

Total request time (e.g 10 requests above) will be used to determine the server performance.

total time = req (1) + req (2) + ... + req (n)

rps = total time / n