即席負荷試験ツールを実装するためのライブラリを作りました

ちなみに otchkiss.New() を使って実装した場合以下のコマンドラインオプションで実行時に設定値を変更することができるためお試し→本試験のような場合でも再ビルドする必要はありません。

• -p: ここで指定した数だけgoroutineを起動し並行的にリクエストを行う。
• -d: テストの実行時間。
• -w: リクエスト先をウォームアップする時間。ここで指定した時間の間リクエストは飛ぶがテスト結果に反映されない。

-d, -wがわかりづらいですが、実際に試験対象にリクエストが飛び続ける時間は d + w, テスト結果として集計対象となるのが d で指定した時間となります。

並行数・実行時間を指定する

前述の通り基本的な実装ではコマンドラインで指定した値もしくはデフォルトの値を使用しますがこの値を固定したい場合はハードコードすることも可能です。

その場合はサブパッケージである github.com/ryo-yamaoka/otchkiss/setting から設定structへ値を入れて otchkiss.FromConfig() に渡して下さい。

	s := &setting.Setting{
		MaxConcurrent: 10,
		RunDuration: 60 * time.Second,
		WarmUpTime: 10 * time.Second,
	}
	ot, err = otchkiss.FromConfig(&SampleRequester{}, s, 1000)

パフォーマンスチューニング

Otchkissは多数の平行リクエストを送りその成否・レイテンシーを記録していますが、内部的にはスライスが使われています。

方々のブログ記事で書かれているためご存知の方も多いかもしれませんがGoのスライスはアロケーションされたメモリが不足すると更に大きいメモリ領域を確保する、という振る舞いをします（参考: Go Slices: usage and internals）。

このため頻繁なアロケーションが発生するとパフォーマンス（＝RPS）に影響を及ぼす可能性があります。かといってメモリは有限のためあまり極端に大きくアロケーションすることもよろしくありません。

デフォルトでは100,000,000リクエスト分アロケーションするようになっていますが、最適値は各々異なると思うのでこれも指定できるようにしてあります。先程のサンプルコードにシレッと登場していますが下記コードの最終引数がそれなので必要に応じて指定して下さい（ちなみに↓のように10億を指定すると起動した瞬間にメモリが数GB食われます）。

	ot, err = otchkiss.FromConfig(&SampleRequester{}, s, 1000*1000*1000)

結果の表示フォーマットを変更する

デフォルトの表示は冒頭に示した通りですが otchkiss.TemplateReport() を使うことでお好みのフォーマットで出力できます。指定方法はGoのtemplateそのものを渡すだけなので特段難しいことはないでしょう。

パラメーターは下記デフォルトテンプレートに使われているものが全てです。