Web API の負荷テストツールとして Siege を試してみたときのメモです。

インストール

% brew install siege

実行オプション

% siege --help
[alert] Zip encoding disabled; siege requires zlib support to enable it
SIEGE 4.0.2
Usage: siege [options]
       siege [options] URL
       siege -g URL
Options:
  -V, --version             VERSION, prints the version number.
  -h, --help                HELP, prints this section.
  -C, --config              CONFIGURATION, show the current config.
  -v, --verbose             VERBOSE, prints notification to screen.
  -q, --quiet               QUIET turns verbose off and suppresses output.
  -g, --get                 GET, pull down HTTP headers and display the
                            transaction. Great for application debugging.
  -c, --concurrent=NUM      CONCURRENT users, default is 10
  -r, --reps=NUM            REPS, number of times to run the test.
  -t, --time=NUMm           TIMED testing where "m" is modifier S, M, or H
                            ex: --time=1H, one hour test.
  -d, --delay=NUM           Time DELAY, random delay before each requst
  -b, --benchmark           BENCHMARK: no delays between requests.
  -i, --internet            INTERNET user simulation, hits URLs randomly.
  -f, --file=FILE           FILE, select a specific URLS FILE.
  -R, --rc=FILE             RC, specify an siegerc file
  -l, --log[=FILE]          LOG to FILE. If FILE is not specified, the
                            default is used: PREFIX/var/siege.log
  -m, --mark="text"         MARK, mark the log file with a string.
                            between .001 and NUM. (NOT COUNTED IN STATS)
  -H, --header="text"       Add a header to request (can be many)
  -A, --user-agent="text"   Sets User-Agent in request
  -T, --content-type="text" Sets Content-Type in request

Copyright (C) 2016 by Jeffrey Fulmer, et al.
This is free software; see the source for copying conditions.
There is NO warranty; not even for MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.

使い方

siege コマンドの引数に URL を指定すると、その URL に対して負荷テストを行います。
デフォルトではテスト時間が無制限のため、Ctrl+C で手動終了する必要があります。

% siege http://example.com/
[alert] Zip encoding disabled; siege requires zlib support to enable it
** SIEGE 4.0.2
** Preparing 25 concurrent users for battle.
The server is now under siege...
HTTP/1.1 200     0.25 secs:    1270 bytes ==> GET  /
HTTP/1.1 200     0.25 secs:    1270 bytes ==> GET  /
HTTP/1.1 200     0.24 secs:    1270 bytes ==> GET  /

...

^C
Lifting the server siege...
Transactions:                     75 hits
Availability:                 100.00 %
Elapsed time:                   1.56 secs
Data transferred:               0.09 MB
Response time:                  0.25 secs
Transaction rate:              48.08 trans/sec
Throughput:                     0.06 MB/sec
Concurrency:                   11.87
Successful transactions:          75
Failed transactions:               0
Longest transaction:            0.29
Shortest transaction:           0.23

使い方パターン

基本系

% siege -c 5 -r 1 -t 10S http://example.com

-c は同時接続数、-rは毎秒あたりの1接続でのリクエスト数、-t はテスト時間(S/s = 秒、M/m = 分、H/h = 時間)を指定します。
この場合だと、同時接続数5で毎秒1回ずつ、10秒間の負荷テストを行います。

POST リクエストを送信する場合

% siege -c 1 -T "text/plain" 'http://example.com/api POST key1=value1&key2=value2'

URL に続けて POST キーワードと送信するデータを指定することで POST リクエストを送信できます。
-T で Content-Type を指定します。
(デフォルトはapplication/x-www-form-urlencoded形式)

POST リクエストで JSON 形式のデータを送信する場合

% siege -c 1 -T "application/json" "http://example.com/api POST {"key1":"value1","key2":"value2"}"

URLをファイルから読み込む場合

% siege -c 1 -T "application/json" -f json.txt

json.txt

http://example.com/api POST {"key1":"value1","key2":"value2"}

-f でファイルから URL リストを受け取ることもできます。
一方、パラメータだけをファイルから受け取る場合は下記のようにします。

% siege -c 1 -T "application/json" "http://example.com/api POST < /path/to/json.txt"