Thanks to visit codestin.com
Credit goes to github.com

Skip to content

README-ENGLISH.md

Latest commit

 

History

History
133 lines (106 loc) · 4.06 KB

README-ENGLISH.md

File metadata and controls

133 lines (106 loc) · 4.06 KB

ysab

ysab is a tool that can help you get some performance parameters of http server stress test. It can help you send requests with different parameters, so you can easily replay the real request online.

Installation

  • mac

wget https://github.com/yunsonbai/ysab/releases/download/install-tool/install_mac -O install_mac && sh install_mac && rm -rf install_mac

If report a permission problem, please execute: wget https://github.com/yunsonbai/ysab/releases/download/install-tool/install_mac -O install_mac && sudo sh install_mac && rm -rf install_mac

If you cannot enter the ysab command after installation, you can restart the terminal or execute source /etc/profile.

  • linux

wget https://github.com/yunsonbai/ysab/releases/download/install-tool/install_linux -O install_linux && sh install_linux && rm -rf install_linux

If report a permission problem, please execute: wget https://github.com/yunsonbai/ysab/releases/download/install-tool/install_linux -O install_linux && sudo sh install_linux && rm -rf install_linux

Usage

  • ysab -h
Options:
  -r  Rounds of request to run, total requests equal r * n
  -n  Number of multiple requests to make at a time, n>0 if n>900 n will be set to 900.
  -m  HTTP method, one of GET, POST, PUT, DELETE, Head. Default GET
  -u  Url of request, use " please
      For examples: 
      -u "https://yunsonbai.top/?name=yunson"
  -H  Add Arbitrary header line.
      For examples:
      -H "Accept: text/html". Set Accept to header.
      -H "Uid: yunson" -H "Content-Type: application/json". Set two fields to header.
  -t  Timeout for each request in seconds. Default 10s.
  -d  HTTP request body. 
      For examples:
      '{"a": "a"}'
  -h  This help
  -v  Show verison
  -urlsfile  The urls file path. If you set this Option, -u,-d,-r will be invalid.
      For examples:
      -urlfile /tmp/urls.txt
  • Note: -urlsfile is the key parameter for sending requests with different parameters. For details of the file, please refer to examples/post_urls.txt and examples/get_urls.txt

Some examples

Result show

(http://10.10.10.10:8080/test is API, it is writed by gin. The api will respone "hello world".)

[yunson ~]# ysab -n 900 -r 30 -u http://10.10.10.10:8080/test

Summary:
  Complete requests:		2700
  Failed requests:		2550
  Time taken (s):		2.203996471
  Total data size (Byte):	0
  Data size/request (Byte):	0
  Max use time (ms):		2076
  Min use time (ms):		3
  Average use time (ms):	139.997
  Requests/sec:			1225.047333571706
  SuccessRequests/sec:		68.05818519842812

Percentage of waiting time (ms):
    10.00%:		12
    25.00%:		26
    50.00%:		46
    75.00%:		69
    90.00%:		122
    95.00%:		1291
    99.00%:		1992
    99.90%:		2040
    99.99%:		2052


Time detail (ms)
  item		min		mean		max
  dns		0		0		0
  conn		0		11.714		78
  wait		3		69.509		1010
  resp		0		10.53		50

Response Time histogram (code: requests):
  200:		150
  429:		2550

about http code

  • 2xx: Success
  • != 2xx: Faild
    • 5xx:
      • 500: Server Error
      • 503: May be connection refused or connection reset by peer, you need to check your server.
    • other: http code

Note

  • use -urlsfile
You can use -urlsfile to send multiple requests with different body.

cmd example:
	ysab -n 500 -urlsfile ./examples/get_urls.txt
    ysab -n 500 -urlsfile -m POST ./examples/post_urls.txt

urls.txt example:
	examples/urls.txt
	You can use create_urls.py to create a urls.txt file.
  • use -u
example:
    ysab -n 900 -r 30 -u "http://10.121.130.218:8080/test"
    ysab -n 900 -r 30 -u 'http://10.121.130.218:8080/test'
    ysab -n 900 -r 30 -u http://10.121.130.218:8080/test

Acknowledgements