Do you have any documentation to explain what each information in the summary generated by "hey" means?

[insinfo]

Do you have any documentation to explain what each information in the summary generated by "hey" means?

PS C:\Users\isaque.neves> hey -n 10000 -c 118 -m GET -T "application/json" -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7ImFub19leGVyY2ljaW8iOiIyMDIzIiwiYW5vX2V4ZXJjaWNpb19zZXRvciI6IjIwMDMiLCJjb2RfZGVwYXJ0YW1lbnRvIjoyLCJjb2Rfb3JnYW8iOjIsImNvZF9zZXRvciI6MSwiY29kX3VuaWRhZGUiOjg5LCJjcGYiOm51bGwsIm5vbV9jZ20iOiJJc2FxdWUgTmV2ZXMgU2FudCdhbmEiLCJudW1jZ20iOjE0MDA1MCwidXNlcm5hbWUiOiJpc2FxdWUuc2FudGFuYSJ9LCJleHAiOjE2OTA0OTQxNTksImlhdCI6MTY5MDQ2MTc1OSwiaXNzIjoibmV3c2FsaS5yaW9kYXNvc3RyYXMucmouZ292LmJyIiwibmJmIjoxNjkwNDYxNzU5fQ.0BvLPlghuRtMkceOQHhjFfYZMvYx9wgRFiv_q4khKh0" "http://192.168.66.123:3350/api/v1/protocolo/processos?limit=12&offset=0&search=10&orderDir=desc&searchInFields=%5B%7B%22label%22%3A%22N%C2%BA+Processo%22%2C%22field%22%3A%22sw_processo.cod_processo%22%2C%22active%22%3Atrue%2C%22operator%22%3A%22%3D%22%7D%5D"

Summary:
  Total:        283.1386 secs
  Slowest:      5.7365 secs
  Fastest:      0.1105 secs
  Average:      3.3655 secs
  Requests/sec: 35.0076


Response time histogram:
  0.110 [1]     |
  0.673 [11]    |
  1.236 [17]    |
  1.798 [13]    |
  2.361 [39]    |
  2.923 [42]    |
  3.486 [8371]  |■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
  4.049 [1332]  |■■■■■■
  4.611 [32]    |
  5.174 [48]    |
  5.736 [6]     |


Latency distribution:
  10% in 3.2394 secs
  25% in 3.2943 secs
  50% in 3.3550 secs
  75% in 3.4282 secs
  90% in 3.5316 secs
  95% in 3.6286 secs
  99% in 3.9377 secs

Details (average, fastest, slowest):
  DNS+dialup:   0.0000 secs, 0.1105 secs, 5.7365 secs
  DNS-lookup:   0.0000 secs, 0.0000 secs, 0.0000 secs
  req write:    0.0000 secs, 0.0000 secs, 0.0286 secs
  resp wait:    3.3447 secs, 0.1103 secs, 5.7315 secs
  resp read:    0.0206 secs, 0.0000 secs, 0.5954 secs

Status code distribution:
  [200] 9912 responses

[ky7i]

Hi @insinfo

There isn't currently dedicated documentation that breaks down each field in the hey summary output. I agree that having a clear explanation would be extremely helpful, especially for newcomers who want to interpret results correctly.

Here's what each field generally represents, based on my understanding.
I’d be happy if the document could help Hey users better understand the tool !!

Summary

Summary:
  Total:        49.4259 secs
  Slowest:      0.1643 secs
  Fastest:      0.0004 secs
  Average:      0.0195 secs
  Requests/sec: 202.3231
  
  Total data:   280000 bytes
  Size/request: 28 bytes

• Total: Total elapsed time for all requests.
• Slowest / Fastest / Average: Response time statistics.
• Requests/sec: Throughput — number of completed requests per second.
• Total data: Amount of data received in bytes.
• Size/request: Average response body size in bytes.

Histogram

> hey -n 10000 -c 4 "http://example.com"
~~~
Response time histogram:
  0.000 [1]     |
  0.017 [5170]  |■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
  0.033 [3133]  |■■■■■■■■■■■■■■■■■■■■■■■■
  0.050 [1213]  |■■■■■■■■■
  0.066 [342]   |■■■
  0.082 [103]   |■
  0.099 [26]    |
  0.115 [8]     |
  0.132 [1]     |
  0.148 [1]     |
  0.164 [2]     |

• In each column, represents " response time [counts] | histogram "
• Display 11 columns by dividing the duration (slowest - fastest) into 11 equal intervals.
• The sum of counts equals request number that is (value of -n ).
  When the number of requests is not divisible by concurrency, it is (-n - ( -n % -c ))

Latency distribution

Latency distribution:
  10% in 0.0029 secs
  25% in 0.0074 secs
  50% in 0.0160 secs
  75% in 0.0277 secs
  90% in 0.0405 secs
  95% in 0.0493 secs
  99% in 0.0695 secs

• This section shows response times at various percentiles.

Details

Details (average, fastest, slowest):
  DNS+dialup:   0.0000 secs, 0.0000 secs, 0.0077 secs
  DNS-lookup:   0.0000 secs, 0.0000 secs, 0.0069 secs
  req write:    0.0000 secs, 0.0000 secs, 0.0003 secs
  resp wait:    0.0195 secs, 0.0003 secs, 0.1643 secs
  resp read:    0.0000 secs, 0.0000 secs, 0.0003 secs

• DNS+dialup: Time to establish a network connection
• DNS-lookup: Time spent resolving the domain name to an IP address