aboutsummaryrefslogtreecommitdiffstats
path: root/test/http_perf_SUITE.erl
diff options
context:
space:
mode:
Diffstat (limited to 'test/http_perf_SUITE.erl')
-rw-r--r--test/http_perf_SUITE.erl220
1 files changed, 220 insertions, 0 deletions
diff --git a/test/http_perf_SUITE.erl b/test/http_perf_SUITE.erl
new file mode 100644
index 0000000..1484c03
--- /dev/null
+++ b/test/http_perf_SUITE.erl
@@ -0,0 +1,220 @@
+%% Copyright (c) Loïc Hoguin <[email protected]>
+%%
+%% Permission to use, copy, modify, and/or distribute this software for any
+%% purpose with or without fee is hereby granted, provided that the above
+%% copyright notice and this permission notice appear in all copies.
+%%
+%% THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+%% WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+%% MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+%% ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+%% WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+%% ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+%% OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+-module(http_perf_SUITE).
+-compile(export_all).
+-compile(nowarn_export_all).
+
+-import(ct_helper, [config/2]).
+-import(ct_helper, [doc/1]).
+-import(cowboy_test, [gun_open/1]).
+
+%% ct.
+
+all() ->
+ %% @todo Enable HTTP/3 for this test suite.
+ cowboy_test:common_all() -- [{group, h3}, {group, h3_compress}].
+
+groups() ->
+ cowboy_test:common_groups(ct_helper:all(?MODULE), no_parallel).
+
+init_per_suite(Config) ->
+ do_log("", []),
+ %% Optionally enable `perf` for the current node.
+% spawn(fun() -> ct:pal(os:cmd("perf record -g -F 9999 -o /tmp/http_perf.data -p " ++ os:getpid() ++ " -- sleep 60")) end),
+ Config.
+
+end_per_suite(_) ->
+ ok.
+
+init_per_group(Name, Config) ->
+ [{group, Name}|cowboy_test:init_common_groups(Name, Config, ?MODULE, #{
+ %% HTTP/1.1
+ max_keepalive => infinity,
+ %% HTTP/2
+ %% @todo Must configure Gun for performance too.
+ connection_window_margin_size => 64*1024,
+ enable_connect_protocol => true,
+ env => #{dispatch => init_dispatch(Config)},
+ max_frame_size_sent => 64*1024,
+ max_frame_size_received => 16384 * 1024 - 1,
+ max_received_frame_rate => {10_000_000, 1},
+ stream_window_data_threshold => 1024,
+ stream_window_margin_size => 64*1024
+ })].
+
+end_per_group(Name, _) ->
+ do_log("", []),
+ cowboy_test:stop_group(Name).
+
+%% Routes.
+
+init_dispatch(_) ->
+ cowboy_router:compile([{'_', [
+ {"/", hello_h, []},
+ {"/read_body", read_body_h, []}
+ ]}]).
+
+%% Tests: Hello world.
+
+plain_h_hello_1(Config) ->
+ doc("Plain HTTP handler Hello World; 10K requests per 1 client."),
+ do_bench_get(?FUNCTION_NAME, "/", #{}, 1, 10000, Config).
+
+plain_h_hello_10(Config) ->
+ doc("Plain HTTP handler Hello World; 10K requests per 10 clients."),
+ do_bench_get(?FUNCTION_NAME, "/", #{}, 10, 10000, Config).
+
+stream_h_hello_1(Config) ->
+ doc("Stream handler Hello World; 10K requests per 1 client."),
+ do_stream_h_hello(Config, 1).
+
+stream_h_hello_10(Config) ->
+ doc("Stream handler Hello World; 10K requests per 10 clients."),
+ do_stream_h_hello(Config, 10).
+
+do_stream_h_hello(Config, NumClients) ->
+ Ref = config(ref, Config),
+ ProtoOpts = ranch:get_protocol_options(Ref),
+ StreamHandlers = case ProtoOpts of
+ #{stream_handlers := _} -> [cowboy_compress_h, stream_hello_h];
+ _ -> [stream_hello_h]
+ end,
+ ranch:set_protocol_options(Ref, ProtoOpts#{
+ env => #{},
+ stream_handlers => StreamHandlers
+ }),
+ do_bench_get(?FUNCTION_NAME, "/", #{}, NumClients, 10000, Config),
+ ranch:set_protocol_options(Ref, ProtoOpts).
+
+%% Tests: Large body upload.
+
+plain_h_1M_post_1(Config) ->
+ doc("Plain HTTP handler body reading; 10K requests per 1 client."),
+ do_bench_post(?FUNCTION_NAME, "/read_body", #{}, <<0:8_000_000>>, 1, 10000, Config).
+
+plain_h_1M_post_10(Config) ->
+ doc("Plain HTTP handler body reading; 10K requests per 10 clients."),
+ do_bench_post(?FUNCTION_NAME, "/read_body", #{}, <<0:8_000_000>>, 10, 10000, Config).
+
+plain_h_10G_post(Config) ->
+ doc("Plain HTTP handler body reading; 1 request with a 10GB body."),
+ do_bench_post_one_large(?FUNCTION_NAME, "/read_body", #{}, 10_000, <<0:8_000_000>>, Config).
+
+%% Internal.
+
+do_bench_get(What, Path, Headers, NumClients, NumRuns, Config) ->
+ Clients = [spawn_link(?MODULE, do_bench_get_proc,
+ [self(), What, Path, Headers, NumRuns, Config])
+ || _ <- lists:seq(1, NumClients)],
+ {Time, _} = timer:tc(?MODULE, do_bench_wait, [What, Clients]),
+ do_log("~32s: ~8bµs ~8.1freqs/s", [
+ [atom_to_list(config(group, Config)), $., atom_to_list(What)],
+ Time,
+ (NumClients * NumRuns) / Time * 1_000_000]),
+ ok.
+
+do_bench_get_proc(Parent, What, Path, Headers0, NumRuns, Config) ->
+ ConnPid = gun_open(Config),
+ Headers = Headers0#{<<"accept-encoding">> => <<"gzip">>},
+ Parent ! {What, ready},
+ receive {What, go} -> ok end,
+ do_bench_get_run(ConnPid, Path, Headers, NumRuns),
+ Parent ! {What, done},
+ gun:close(ConnPid).
+
+do_bench_get_run(_, _, _, 0) ->
+ ok;
+do_bench_get_run(ConnPid, Path, Headers, Num) ->
+ Ref = gun:request(ConnPid, <<"GET">>, Path, Headers, <<>>),
+ {response, IsFin, 200, _RespHeaders} = gun:await(ConnPid, Ref, infinity),
+ {ok, _} = case IsFin of
+ nofin -> gun:await_body(ConnPid, Ref, infinity);
+ fin -> {ok, <<>>}
+ end,
+ do_bench_get_run(ConnPid, Path, Headers, Num - 1).
+
+do_bench_post(What, Path, Headers, Body, NumClients, NumRuns, Config) ->
+ Clients = [spawn_link(?MODULE, do_bench_post_proc,
+ [self(), What, Path, Headers, Body, NumRuns, Config])
+ || _ <- lists:seq(1, NumClients)],
+ {Time, _} = timer:tc(?MODULE, do_bench_wait, [What, Clients]),
+ do_log("~32s: ~8bµs ~8.1freqs/s", [
+ [atom_to_list(config(group, Config)), $., atom_to_list(What)],
+ Time,
+ (NumClients * NumRuns) / Time * 1_000_000]),
+ ok.
+
+do_bench_post_proc(Parent, What, Path, Headers0, Body, NumRuns, Config) ->
+ ConnPid = gun_open(Config),
+ Headers = Headers0#{<<"accept-encoding">> => <<"gzip">>},
+ Parent ! {What, ready},
+ receive {What, go} -> ok end,
+ do_bench_post_run(ConnPid, Path, Headers, Body, NumRuns),
+ Parent ! {What, done},
+ gun:close(ConnPid).
+
+do_bench_post_run(_, _, _, _, 0) ->
+ ok;
+do_bench_post_run(ConnPid, Path, Headers, Body, Num) ->
+ Ref = gun:request(ConnPid, <<"POST">>, Path, Headers, Body),
+ {response, IsFin, 200, _RespHeaders} = gun:await(ConnPid, Ref, infinity),
+ {ok, _} = case IsFin of
+ nofin -> gun:await_body(ConnPid, Ref, infinity);
+ fin -> {ok, <<>>}
+ end,
+ do_bench_post_run(ConnPid, Path, Headers, Body, Num - 1).
+
+do_bench_post_one_large(What, Path, Headers, NumChunks, BodyChunk, Config) ->
+ Client = spawn_link(?MODULE, do_bench_post_one_large_proc,
+ [self(), What, Path, Headers, NumChunks, BodyChunk, Config]),
+ {Time, _} = timer:tc(?MODULE, do_bench_wait, [What, [Client]]),
+ do_log("~32s: ~8bµs ~8.1freqs/s", [
+ [atom_to_list(config(group, Config)), $., atom_to_list(What)],
+ Time,
+ 1 / Time * 1_000_000]),
+ ok.
+
+do_bench_post_one_large_proc(Parent, What, Path, Headers0, NumChunks, BodyChunk, Config) ->
+ ConnPid = gun_open(Config),
+ Headers = Headers0#{<<"accept-encoding">> => <<"gzip">>},
+ Parent ! {What, ready},
+ receive {What, go} -> ok end,
+ StreamRef = gun:headers(ConnPid, <<"POST">>, Path, Headers#{
+ <<"content-length">> => integer_to_binary(NumChunks * byte_size(BodyChunk))
+ }),
+ do_bench_post_one_large_run(ConnPid, StreamRef, NumChunks - 1, BodyChunk),
+ {response, IsFin, 200, _RespHeaders} = gun:await(ConnPid, StreamRef, infinity),
+ {ok, _} = case IsFin of
+ nofin -> gun:await_body(ConnPid, StreamRef, infinity);
+ fin -> {ok, <<>>}
+ end,
+ Parent ! {What, done},
+ gun:close(ConnPid).
+
+do_bench_post_one_large_run(ConnPid, StreamRef, 0, BodyChunk) ->
+ gun:data(ConnPid, StreamRef, fin, BodyChunk);
+do_bench_post_one_large_run(ConnPid, StreamRef, NumChunks, BodyChunk) ->
+ gun:data(ConnPid, StreamRef, nofin, BodyChunk),
+ do_bench_post_one_large_run(ConnPid, StreamRef, NumChunks - 1, BodyChunk).
+
+do_bench_wait(What, Clients) ->
+ _ = [receive {What, ready} -> ok end || _ <- Clients],
+ _ = [ClientPid ! {What, go} || ClientPid <- Clients],
+ _ = [receive {What, done} -> ok end || _ <- Clients],
+ ok.
+
+do_log(Str, Args) ->
+ ct:log(Str, Args),
+ io:format(ct_default_gl, Str ++ "~n", Args).