%%-------------------------------------------------------------------- %% Copyright (c) 2020-2024 EMQ Technologies Co., Ltd. All Rights Reserved. %% %% Licensed under the Apache License, Version 2.0 (the "License"); %% you may not use this file except in compliance with the License. %% You may obtain a copy of the License at %% %% http://www.apache.org/licenses/LICENSE-2.0 %% %% Unless required by applicable law or agreed to in writing, software %% distributed under the License is distributed on an "AS IS" BASIS, %% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %% See the License for the specific language governing permissions and %% limitations under the License. %%-------------------------------------------------------------------- -module(emqx_mgmt_api_trace_SUITE). %% API -compile(export_all). -compile(nowarn_export_all). -include_lib("eunit/include/eunit.hrl"). -include_lib("kernel/include/file.hrl"). -include_lib("stdlib/include/zip.hrl"). -include_lib("snabbkaffe/include/snabbkaffe.hrl"). %%-------------------------------------------------------------------- %% Setups %%-------------------------------------------------------------------- all() -> emqx_common_test_helpers:all(?MODULE). init_per_suite(Config) -> emqx_mgmt_api_test_util:init_suite(), Config. end_per_suite(_) -> emqx_mgmt_api_test_util:end_suite(). t_http_test(_Config) -> emqx_trace:clear(), load(), %% list {ok, Empty} = request_api(get, api_path("trace")), ?assertEqual([], json(Empty)), %% create ErrorTrace = #{}, Opts = #{return_all => true}, {error, {{"HTTP/1.1", 400, "Bad Request"}, _, Body}} = emqx_mgmt_api_test_util:request_api(post, api_path("trace"), [], [], ErrorTrace, Opts), ?assertMatch(#{<<"code">> := <<"BAD_REQUEST">>}, json(Body)), Name = <<"test-name">>, Trace = [ {<<"name">>, Name}, {<<"type">>, <<"topic">>}, {<<"topic">>, <<"/x/y/z">>} ], {ok, Create} = request_api(post, api_path("trace"), Trace), ?assertMatch(#{<<"name">> := Name}, json(Create)), {ok, List} = request_api(get, api_path("trace")), [Data] = json(List), ?assertEqual(Name, maps:get(<<"name">>, Data)), %% update {ok, Update} = request_api(put, api_path("trace/test-name/stop"), #{}), ?assertEqual( #{ <<"enable">> => false, <<"name">> => <<"test-name">> }, json(Update) ), ?assertMatch( {error, {"HTTP/1.1", 404, _}}, request_api(put, api_path("trace/test-name-not-found/stop"), #{}) ), {ok, List1} = request_api(get, api_path("trace")), [Data1] = json(List1), Node = atom_to_binary(node()), ?assertMatch( #{ <<"status">> := <<"stopped">>, <<"name">> := <<"test-name">>, <<"log_size">> := #{Node := _}, <<"start_at">> := _, <<"end_at">> := _, <<"type">> := <<"topic">>, <<"topic">> := <<"/x/y/z">> }, Data1 ), %% delete {ok, Delete} = request_api(delete, api_path("trace/test-name")), ?assertEqual(<<>>, Delete), {error, {{"HTTP/1.1", 404, "Not Found"}, _, DeleteNotFound}} = emqx_mgmt_api_test_util:request_api(delete, api_path("trace/test-name"), [], [], [], Opts), ?assertEqual( #{ <<"code">> => <<"NOT_FOUND">>, <<"message">> => <<"test-name NOT FOUND">> }, json(DeleteNotFound) ), {ok, List2} = request_api(get, api_path("trace")), ?assertEqual([], json(List2)), %% clear {ok, Create1} = request_api(post, api_path("trace"), Trace), ?assertMatch(#{<<"name">> := Name}, json(Create1)), {ok, Clear} = request_api(delete, api_path("trace")), ?assertEqual(<<>>, Clear), unload(), ok. t_http_test_rule_trace(_Config) -> emqx_trace:clear(), load(), %% create Name = atom_to_binary(?FUNCTION_NAME), Trace = [ {<<"name">>, Name}, {<<"type">>, <<"ruleid">>}, {<<"ruleid">>, Name} ], {ok, Create} = request_api(post, api_path("trace"), Trace), ?assertMatch(#{<<"name">> := Name}, json(Create)), {ok, List} = request_api(get, api_path("trace")), [Data] = json(List), ?assertEqual(Name, maps:get(<<"name">>, Data)), %% update {ok, Update} = request_api(put, api_path(iolist_to_binary(["trace/", Name, "/stop"])), #{}), ?assertEqual( #{ <<"enable">> => false, <<"name">> => Name }, json(Update) ), {ok, List1} = request_api(get, api_path("trace")), [Data1] = json(List1), Node = atom_to_binary(node()), ?assertMatch( #{ <<"status">> := <<"stopped">>, <<"name">> := Name, <<"log_size">> := #{Node := _}, <<"start_at">> := _, <<"end_at">> := _, <<"type">> := <<"ruleid">>, <<"ruleid">> := Name }, Data1 ), %% delete {ok, Delete} = request_api(delete, api_path(["trace/", Name])), ?assertEqual(<<>>, Delete), unload(), ok. t_create_failed(_Config) -> load(), Trace = [{<<"type">>, <<"topic">>}, {<<"topic">>, <<"/x/y/z">>}], BadName1 = {<<"name">>, <<"test/bad">>}, ?assertMatch( {error, {"HTTP/1.1", 400, _}}, request_api(post, api_path("trace"), [BadName1 | Trace]) ), BadName2 = {<<"name">>, list_to_binary(lists:duplicate(257, "t"))}, ?assertMatch( {error, {"HTTP/1.1", 400, _}}, request_api(post, api_path("trace"), [BadName2 | Trace]) ), %% already_exist GoodName = {<<"name">>, <<"test-name-0">>}, {ok, Create} = request_api(post, api_path("trace"), [GoodName | Trace]), ?assertMatch(#{<<"name">> := <<"test-name-0">>}, json(Create)), ?assertMatch( {error, {"HTTP/1.1", 409, _}}, request_api(post, api_path("trace"), [GoodName | Trace]) ), %% MAX Limited lists:map( fun(Seq) -> Name0 = list_to_binary("name" ++ integer_to_list(Seq)), Trace0 = [ {name, Name0}, {type, topic}, {topic, list_to_binary("/x/y/" ++ integer_to_list(Seq))} ], {ok, _} = emqx_trace:create(Trace0) end, lists:seq(1, 30 - ets:info(emqx_trace, size)) ), GoodName1 = {<<"name">>, <<"test-name-1">>}, ?assertMatch( {error, {"HTTP/1.1", 400, _}}, request_api(post, api_path("trace"), [GoodName1 | Trace]) ), %% clear ?assertMatch({ok, _}, request_api(delete, api_path("trace"), [])), {ok, Create1} = request_api(post, api_path("trace"), [GoodName | Trace]), ?assertMatch(#{<<"name">> := <<"test-name-0">>}, json(Create1)), %% new name but same trace GoodName2 = {<<"name">>, <<"test-name-1">>}, ?assertMatch( {error, {"HTTP/1.1", 409, _}}, request_api(post, api_path("trace"), [GoodName2 | Trace]) ), %% new name but bad payload-encode GoodName3 = {<<"name">>, <<"test-name-2">>}, PayloadEncode = {<<"payload_encode">>, <<"bad">>}, ?assertMatch( {error, {"HTTP/1.1", 400, _}}, request_api(post, api_path("trace"), [GoodName3, PayloadEncode | Trace]) ), unload(), emqx_trace:clear(), ok. t_log_file(_Config) -> ClientId = <<"client-test-download">>, Now = erlang:system_time(second), Name = <<"test_client_id">>, load(), create_trace(Name, ClientId, Now), {ok, Client} = emqtt:start_link([{clean_start, true}, {clientid, ClientId}]), {ok, _} = emqtt:connect(Client), [ begin _ = emqtt:ping(Client) end || _ <- lists:seq(1, 5) ], ok = emqx_trace_handler_SUITE:filesync(Name, clientid), ?assertMatch( {error, {"HTTP/1.1", 404, "Not Found"}}, request_api(get, api_path("trace/test_client_not_found/log_detail")) ), {ok, Detail} = request_api(get, api_path("trace/test_client_id/log_detail")), ?assertMatch([#{<<"mtime">> := _, <<"size">> := _, <<"node">> := _}], json(Detail)), {ok, Binary} = request_api(get, api_path("trace/test_client_id/download")), {ok, [ Comment, #zip_file{ name = ZipName, info = #file_info{size = Size, type = regular, access = read_write} } ]} = zip:table(Binary), ?assert(Size > 0), ZipNamePrefix = lists:flatten(io_lib:format("~s-trace_~s", [node(), Name])), ?assertNotEqual(nomatch, re:run(ZipName, [ZipNamePrefix])), Path = api_path("trace/test_client_id/download?node=" ++ atom_to_list(node())), {ok, Binary2} = request_api(get, Path), ?assertMatch( {ok, [ Comment, #zip_file{ name = ZipName, info = #file_info{size = Size, type = regular, access = read_write} } ]}, zip:table(Binary2) ), {error, {_, 404, _}} = request_api( get, api_path("trace/test_client_id/download?node=unknown_node") ), {error, {_, 404, _}} = request_api( get, % known atom but unknown node api_path("trace/test_client_id/download?node=undefined") ), ?assertMatch( {error, {"HTTP/1.1", 404, "Not Found"}}, request_api( get, api_path("trace/test_client_not_found/download?node=" ++ atom_to_list(node())) ) ), ok = emqtt:disconnect(Client), ok. create_trace(Name, ClientId, Start) -> create_trace(Name, clientid, ClientId, Start). create_trace(Name, Type, TypeValue, Start) -> ?check_trace( #{timetrap => 900}, begin {ok, _} = emqx_trace:create([ {<<"name">>, Name}, {<<"type">>, Type}, {atom_to_binary(Type), TypeValue}, {<<"start_at">>, Start} ]), ?block_until(#{?snk_kind := update_trace_done}) end, fun(Trace) -> ?assertMatch([#{}], ?of_kind(update_trace_done, Trace)) end ). create_rule_trace(RuleId) -> Now = erlang:system_time(second), emqx_mgmt_api_trace_SUITE:create_trace(atom_to_binary(?FUNCTION_NAME), ruleid, RuleId, Now - 2). t_create_rule_trace(_Config) -> load(), create_rule_trace(atom_to_binary(?FUNCTION_NAME)), unload(), ok. t_stream_log(_Config) -> emqx_trace:clear(), load(), ClientId = <<"client-stream">>, Now = erlang:system_time(second), Name = <<"test_stream_log">>, create_trace(Name, ClientId, Now - 10), {ok, Client} = emqtt:start_link([{clean_start, true}, {clientid, ClientId}]), {ok, _} = emqtt:connect(Client), [ begin _ = emqtt:ping(Client) end || _ <- lists:seq(1, 5) ], emqtt:publish(Client, <<"/good">>, #{}, <<"ghood1">>, [{qos, 0}]), emqtt:publish(Client, <<"/good">>, #{}, <<"ghood2">>, [{qos, 0}]), ok = emqtt:disconnect(Client), ct:sleep(200), File = emqx_trace:log_file(Name, Now), ct:pal("FileName: ~p", [File]), {ok, FileBin} = file:read_file(File), ct:pal("FileBin: ~p ~s", [byte_size(FileBin), FileBin]), {ok, Binary} = request_api(get, api_path("trace/test_stream_log/log?bytes=10")), #{<<"meta">> := Meta, <<"items">> := Bin} = json(Binary), ?assertEqual(10, byte_size(Bin)), ?assertEqual(#{<<"position">> => 10, <<"bytes">> => 10}, Meta), Path = api_path("trace/test_stream_log/log?position=20&bytes=10"), {ok, Binary1} = request_api(get, Path), #{<<"meta">> := Meta1, <<"items">> := Bin1} = json(Binary1), ?assertEqual(#{<<"position">> => 30, <<"bytes">> => 10}, Meta1), ?assertEqual(10, byte_size(Bin1)), ct:pal("~p vs ~p", [Bin, Bin1]), %% in theory they could be the same but we know they shouldn't ?assertNotEqual(Bin, Bin1), BadReqPath = api_path("trace/test_stream_log/log?&bytes=1000000000000"), {error, {_, 400, _}} = request_api(get, BadReqPath), meck:new(file, [passthrough, unstick]), meck:expect(file, read, 2, {error, enomem}), {error, {_, 503, _}} = request_api(get, Path), meck:unload(file), {error, {_, 404, _}} = request_api( get, api_path("trace/test_stream_log/log?node=unknown_node") ), {error, {_, 404, _}} = request_api( get, % known atom but not a node api_path("trace/test_stream_log/log?node=undefined") ), {error, {_, 404, _}} = request_api( get, api_path("trace/test_stream_log_not_found/log") ), unload(), ok. t_trace_files_are_deleted_after_download(_Config) -> ClientId = <<"client-test-delete-after-download">>, Now = erlang:system_time(second), Name = <<"test_client_id">>, load(), create_trace(Name, ClientId, Now), {ok, Client} = emqtt:start_link([{clean_start, true}, {clientid, ClientId}]), {ok, _} = emqtt:connect(Client), [ begin _ = emqtt:ping(Client) end || _ <- lists:seq(1, 5) ], ok = emqtt:disconnect(Client), ok = emqx_trace_handler_SUITE:filesync(Name, clientid), %% Check that files have been removed after download and that zip %% directories uses unique session ids ?check_trace( begin %% Download two zip files Path = api_path(["trace/", binary_to_list(Name), "/download"]), {ok, Binary1} = request_api(get, Path), {ok, Binary2} = request_api(get, Path), ?assertMatch({ok, _}, zip:table(Binary1)), ?assertMatch({ok, _}, zip:table(Binary2)) end, fun(Trace) -> [ #{session_id := SessionId1, zip_dir := ZipDir1}, #{session_id := SessionId2, zip_dir := ZipDir2} ] = ?of_kind(trace_api_download_trace_log, Trace), ?assertEqual({error, enoent}, file:list_dir(ZipDir1)), ?assertEqual({error, enoent}, file:list_dir(ZipDir2)), ?assertNotEqual(SessionId1, SessionId2), ?assertNotEqual(ZipDir1, ZipDir2) end ), ok. t_download_empty_trace(_Config) -> ClientId = <<"client-test-empty-trace-download">>, Now = erlang:system_time(second), Name = <<"test_client_id_empty_trace">>, load(), create_trace(Name, ClientId, Now), ok = emqx_trace_handler_SUITE:filesync(Name, clientid), ?check_trace( begin ?wait_async_action( ?assertMatch( {ok, _}, request_api(put, api_path(<<"trace/", Name/binary, "/stop">>), #{}) ), #{?snk_kind := update_trace_done} ) end, [] ), {error, {{_, 404, _}, _Headers, Body}} = request_api(get, api_path(<<"trace/", Name/binary, "/download">>), [], #{return_all => true}), ?assertMatch(#{<<"message">> := <<"Trace is empty">>}, emqx_utils_json:decode(Body)), File = emqx_trace:log_file(Name, Now), ct:pal("FileName: ~p", [File]), ?assertEqual({ok, <<>>}, file:read_file(File)), ?assertEqual(ok, file:delete(File)), %% return 404 if trace file is not found {error, {{_, 404, _}, _Headers, Body}} = request_api(get, api_path(<<"trace/", Name/binary, "/download">>), [], #{return_all => true}), ?assertMatch(#{<<"message">> := <<"Trace is empty">>}, emqx_utils_json:decode(Body)), ok. to_rfc3339(Second) -> list_to_binary(calendar:system_time_to_rfc3339(Second)). request_api(Method, Url) -> request_api(Method, Url, []). request_api(Method, Url, Body) -> request_api(Method, Url, Body, #{}). request_api(Method, Url, Body, Opts) -> Opts1 = Opts#{httpc_req_opts => [{body_format, binary}]}, emqx_mgmt_api_test_util:request_api(Method, Url, [], [], Body, Opts1). api_path(Path) -> emqx_mgmt_api_test_util:api_path([Path]). json(Data) -> {ok, Jsx} = emqx_utils_json:safe_decode(Data, [return_maps]), Jsx. load() -> emqx_trace:start_link(). unload() -> gen_server:stop(emqx_trace).