// Copyright (c) 2019-2022 The Bitcoin Core developers // Distributed under the MIT software license, see the accompanying // file COPYING or http://www.opensource.org/licenses/mit-license.php. #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using util::SplitString; using util::TrimString; BOOST_FIXTURE_TEST_SUITE(logging_tests, BasicTestingSetup) static void ResetLogger() { LogInstance().SetLogLevel(BCLog::DEFAULT_LOG_LEVEL); LogInstance().SetCategoryLogLevel({}); } struct LogSetup : public BasicTestingSetup { fs::path prev_log_path; fs::path tmp_log_path; bool prev_reopen_file; bool prev_print_to_file; bool prev_log_timestamps; bool prev_log_threadnames; bool prev_log_sourcelocations; std::unordered_map prev_category_levels; BCLog::Level prev_log_level; LogSetup() : prev_log_path{LogInstance().m_file_path}, tmp_log_path{m_args.GetDataDirBase() / "tmp_debug.log"}, prev_reopen_file{LogInstance().m_reopen_file}, prev_print_to_file{LogInstance().m_print_to_file}, prev_log_timestamps{LogInstance().m_log_timestamps}, prev_log_threadnames{LogInstance().m_log_threadnames}, prev_log_sourcelocations{LogInstance().m_log_sourcelocations}, prev_category_levels{LogInstance().CategoryLevels()}, prev_log_level{LogInstance().LogLevel()} { LogInstance().m_file_path = tmp_log_path; LogInstance().m_reopen_file = true; LogInstance().m_print_to_file = true; LogInstance().m_log_timestamps = false; LogInstance().m_log_threadnames = false; // Prevent tests from failing when the line number of the logs changes. LogInstance().m_log_sourcelocations = false; LogInstance().SetLogLevel(BCLog::Level::Debug); LogInstance().SetCategoryLogLevel({}); } ~LogSetup() { LogInstance().m_file_path = prev_log_path; LogPrintf("Sentinel log to reopen log file\n"); LogInstance().m_print_to_file = prev_print_to_file; LogInstance().m_reopen_file = prev_reopen_file; LogInstance().m_log_timestamps = prev_log_timestamps; LogInstance().m_log_threadnames = prev_log_threadnames; LogInstance().m_log_sourcelocations = prev_log_sourcelocations; LogInstance().SetLogLevel(prev_log_level); LogInstance().SetCategoryLogLevel(prev_category_levels); } }; BOOST_AUTO_TEST_CASE(logging_timer) { auto micro_timer = BCLog::Timer("tests", "end_msg"); const std::string_view result_prefix{"tests: msg ("}; BOOST_CHECK_EQUAL(micro_timer.LogMsg("msg").substr(0, result_prefix.size()), result_prefix); } BOOST_FIXTURE_TEST_CASE(logging_LogPrintStr, LogSetup) { LogInstance().m_log_sourcelocations = true; struct Case { std::string msg; BCLog::LogFlags category; BCLog::Level level; std::string prefix; std::source_location loc; }; std::vector cases = { {"foo1: bar1", BCLog::NET, BCLog::Level::Debug, "[net] ", std::source_location::current()}, {"foo2: bar2", BCLog::NET, BCLog::Level::Info, "[net:info] ", std::source_location::current()}, {"foo3: bar3", BCLog::ALL, BCLog::Level::Debug, "[debug] ", std::source_location::current()}, {"foo4: bar4", BCLog::ALL, BCLog::Level::Info, "", std::source_location::current()}, {"foo5: bar5", BCLog::NONE, BCLog::Level::Debug, "[debug] ", std::source_location::current()}, {"foo6: bar6", BCLog::NONE, BCLog::Level::Info, "", std::source_location::current()}, }; std::vector expected; for (auto& [msg, category, level, prefix, loc] : cases) { expected.push_back(tfm::format("[%s:%s] [%s] %s%s", util::RemovePrefix(loc.file_name(), "./"), loc.line(), loc.function_name(), prefix, msg)); LogInstance().LogPrintStr(msg, std::move(loc), category, level, /*should_ratelimit=*/false); } std::ifstream file{tmp_log_path}; std::vector log_lines; for (std::string log; std::getline(file, log);) { log_lines.push_back(log); } BOOST_CHECK_EQUAL_COLLECTIONS(log_lines.begin(), log_lines.end(), expected.begin(), expected.end()); } BOOST_FIXTURE_TEST_CASE(logging_LogPrintMacrosDeprecated, LogSetup) { LogPrintf("foo5: %s\n", "bar5"); LogPrintLevel(BCLog::NET, BCLog::Level::Trace, "foo4: %s\n", "bar4"); // not logged LogPrintLevel(BCLog::NET, BCLog::Level::Debug, "foo7: %s\n", "bar7"); LogPrintLevel(BCLog::NET, BCLog::Level::Info, "foo8: %s\n", "bar8"); LogPrintLevel(BCLog::NET, BCLog::Level::Warning, "foo9: %s\n", "bar9"); LogPrintLevel(BCLog::NET, BCLog::Level::Error, "foo10: %s\n", "bar10"); std::ifstream file{tmp_log_path}; std::vector log_lines; for (std::string log; std::getline(file, log);) { log_lines.push_back(log); } std::vector expected = { "foo5: bar5", "[net] foo7: bar7", "[net:info] foo8: bar8", "[net:warning] foo9: bar9", "[net:error] foo10: bar10", }; BOOST_CHECK_EQUAL_COLLECTIONS(log_lines.begin(), log_lines.end(), expected.begin(), expected.end()); } BOOST_FIXTURE_TEST_CASE(logging_LogPrintMacros, LogSetup) { LogTrace(BCLog::NET, "foo6: %s", "bar6"); // not logged LogDebug(BCLog::NET, "foo7: %s", "bar7"); LogInfo("foo8: %s", "bar8"); LogWarning("foo9: %s", "bar9"); LogError("foo10: %s", "bar10"); std::ifstream file{tmp_log_path}; std::vector log_lines; for (std::string log; std::getline(file, log);) { log_lines.push_back(log); } std::vector expected = { "[net] foo7: bar7", "foo8: bar8", "[warning] foo9: bar9", "[error] foo10: bar10", }; BOOST_CHECK_EQUAL_COLLECTIONS(log_lines.begin(), log_lines.end(), expected.begin(), expected.end()); } BOOST_FIXTURE_TEST_CASE(logging_LogPrintMacros_CategoryName, LogSetup) { LogInstance().EnableCategory(BCLog::LogFlags::ALL); const auto concatenated_category_names = LogInstance().LogCategoriesString(); std::vector> expected_category_names; const auto category_names = SplitString(concatenated_category_names, ','); for (const auto& category_name : category_names) { BCLog::LogFlags category; const auto trimmed_category_name = TrimString(category_name); BOOST_REQUIRE(GetLogCategory(category, trimmed_category_name)); expected_category_names.emplace_back(category, trimmed_category_name); } std::vector expected; for (const auto& [category, name] : expected_category_names) { LogDebug(category, "foo: %s\n", "bar"); std::string expected_log = "["; expected_log += name; expected_log += "] foo: bar"; expected.push_back(expected_log); } std::ifstream file{tmp_log_path}; std::vector log_lines; for (std::string log; std::getline(file, log);) { log_lines.push_back(log); } BOOST_CHECK_EQUAL_COLLECTIONS(log_lines.begin(), log_lines.end(), expected.begin(), expected.end()); } BOOST_FIXTURE_TEST_CASE(logging_SeverityLevels, LogSetup) { LogInstance().EnableCategory(BCLog::LogFlags::ALL); LogInstance().SetLogLevel(BCLog::Level::Debug); LogInstance().SetCategoryLogLevel(/*category_str=*/"net", /*level_str=*/"info"); // Global log level LogPrintLevel(BCLog::HTTP, BCLog::Level::Info, "foo1: %s\n", "bar1"); LogPrintLevel(BCLog::MEMPOOL, BCLog::Level::Trace, "foo2: %s. This log level is lower than the global one.\n", "bar2"); LogPrintLevel(BCLog::VALIDATION, BCLog::Level::Warning, "foo3: %s\n", "bar3"); LogPrintLevel(BCLog::RPC, BCLog::Level::Error, "foo4: %s\n", "bar4"); // Category-specific log level LogPrintLevel(BCLog::NET, BCLog::Level::Warning, "foo5: %s\n", "bar5"); LogPrintLevel(BCLog::NET, BCLog::Level::Debug, "foo6: %s. This log level is the same as the global one but lower than the category-specific one, which takes precedence. \n", "bar6"); LogPrintLevel(BCLog::NET, BCLog::Level::Error, "foo7: %s\n", "bar7"); std::vector expected = { "[http:info] foo1: bar1", "[validation:warning] foo3: bar3", "[rpc:error] foo4: bar4", "[net:warning] foo5: bar5", "[net:error] foo7: bar7", }; std::ifstream file{tmp_log_path}; std::vector log_lines; for (std::string log; std::getline(file, log);) { log_lines.push_back(log); } BOOST_CHECK_EQUAL_COLLECTIONS(log_lines.begin(), log_lines.end(), expected.begin(), expected.end()); } BOOST_FIXTURE_TEST_CASE(logging_Conf, LogSetup) { // Set global log level { ResetLogger(); ArgsManager args; args.AddArg("-loglevel", "...", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST); const char* argv_test[] = {"bitcoind", "-loglevel=debug"}; std::string err; BOOST_REQUIRE(args.ParseParameters(2, argv_test, err)); auto result = init::SetLoggingLevel(args); BOOST_REQUIRE(result); BOOST_CHECK_EQUAL(LogInstance().LogLevel(), BCLog::Level::Debug); } // Set category-specific log level { ResetLogger(); ArgsManager args; args.AddArg("-loglevel", "...", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST); const char* argv_test[] = {"bitcoind", "-loglevel=net:trace"}; std::string err; BOOST_REQUIRE(args.ParseParameters(2, argv_test, err)); auto result = init::SetLoggingLevel(args); BOOST_REQUIRE(result); BOOST_CHECK_EQUAL(LogInstance().LogLevel(), BCLog::DEFAULT_LOG_LEVEL); const auto& category_levels{LogInstance().CategoryLevels()}; const auto net_it{category_levels.find(BCLog::LogFlags::NET)}; BOOST_REQUIRE(net_it != category_levels.end()); BOOST_CHECK_EQUAL(net_it->second, BCLog::Level::Trace); } // Set both global log level and category-specific log level { ResetLogger(); ArgsManager args; args.AddArg("-loglevel", "...", ArgsManager::ALLOW_ANY, OptionsCategory::DEBUG_TEST); const char* argv_test[] = {"bitcoind", "-loglevel=debug", "-loglevel=net:trace", "-loglevel=http:info"}; std::string err; BOOST_REQUIRE(args.ParseParameters(4, argv_test, err)); auto result = init::SetLoggingLevel(args); BOOST_REQUIRE(result); BOOST_CHECK_EQUAL(LogInstance().LogLevel(), BCLog::Level::Debug); const auto& category_levels{LogInstance().CategoryLevels()}; BOOST_CHECK_EQUAL(category_levels.size(), 2); const auto net_it{category_levels.find(BCLog::LogFlags::NET)}; BOOST_CHECK(net_it != category_levels.end()); BOOST_CHECK_EQUAL(net_it->second, BCLog::Level::Trace); const auto http_it{category_levels.find(BCLog::LogFlags::HTTP)}; BOOST_CHECK(http_it != category_levels.end()); BOOST_CHECK_EQUAL(http_it->second, BCLog::Level::Info); } } void MockForwardAndSync(CScheduler& scheduler, std::chrono::seconds duration) { scheduler.MockForward(duration); std::promise promise; scheduler.scheduleFromNow([&promise] { promise.set_value(); }, 0ms); promise.get_future().wait(); } BOOST_AUTO_TEST_CASE(logging_log_rate_limiter) { CScheduler scheduler{}; scheduler.m_service_thread = std::thread([&scheduler] { scheduler.serviceQueue(); }); uint64_t max_bytes{1024}; auto reset_window{1min}; auto sched_func = [&scheduler](auto func, auto window) { scheduler.scheduleEvery(std::move(func), window); }; BCLog::LogRateLimiter limiter{sched_func, max_bytes, reset_window}; using Status = BCLog::LogRateLimiter::Status; auto source_loc_1{std::source_location::current()}; auto source_loc_2{std::source_location::current()}; // A fresh limiter should not have any suppressions BOOST_CHECK(!limiter.SuppressionsActive()); // Resetting an unused limiter is fine limiter.Reset(); BOOST_CHECK(!limiter.SuppressionsActive()); // No suppression should happen until more than max_bytes have been consumed BOOST_CHECK_EQUAL(limiter.Consume(source_loc_1, std::string(max_bytes - 1, 'a')), Status::UNSUPPRESSED); BOOST_CHECK_EQUAL(limiter.Consume(source_loc_1, "a"), Status::UNSUPPRESSED); BOOST_CHECK(!limiter.SuppressionsActive()); BOOST_CHECK_EQUAL(limiter.Consume(source_loc_1, "a"), Status::NEWLY_SUPPRESSED); BOOST_CHECK(limiter.SuppressionsActive()); BOOST_CHECK_EQUAL(limiter.Consume(source_loc_1, "a"), Status::STILL_SUPPRESSED); BOOST_CHECK(limiter.SuppressionsActive()); // Location 2 should not be affected by location 1's suppression BOOST_CHECK_EQUAL(limiter.Consume(source_loc_2, std::string(max_bytes, 'a')), Status::UNSUPPRESSED); BOOST_CHECK_EQUAL(limiter.Consume(source_loc_2, "a"), Status::NEWLY_SUPPRESSED); BOOST_CHECK(limiter.SuppressionsActive()); // After reset_window time has passed, all suppressions should be cleared. MockForwardAndSync(scheduler, reset_window); BOOST_CHECK(!limiter.SuppressionsActive()); BOOST_CHECK_EQUAL(limiter.Consume(source_loc_1, std::string(max_bytes, 'a')), Status::UNSUPPRESSED); BOOST_CHECK_EQUAL(limiter.Consume(source_loc_2, std::string(max_bytes, 'a')), Status::UNSUPPRESSED); scheduler.stop(); } BOOST_AUTO_TEST_CASE(logging_log_limit_stats) { BCLog::LogLimitStats counter{BCLog::RATELIMIT_MAX_BYTES}; // Check that counter gets initialized correctly. BOOST_CHECK_EQUAL(counter.GetAvailableBytes(), BCLog::RATELIMIT_MAX_BYTES); BOOST_CHECK_EQUAL(counter.GetDroppedBytes(), 0ull); const uint64_t MESSAGE_SIZE{512 * 1024}; BOOST_CHECK(counter.Consume(MESSAGE_SIZE)); BOOST_CHECK_EQUAL(counter.GetAvailableBytes(), BCLog::RATELIMIT_MAX_BYTES - MESSAGE_SIZE); BOOST_CHECK_EQUAL(counter.GetDroppedBytes(), 0ull); BOOST_CHECK(counter.Consume(MESSAGE_SIZE)); BOOST_CHECK_EQUAL(counter.GetAvailableBytes(), BCLog::RATELIMIT_MAX_BYTES - MESSAGE_SIZE * 2); BOOST_CHECK_EQUAL(counter.GetDroppedBytes(), 0ull); // Consuming more bytes after already having consumed 1MB should fail. BOOST_CHECK(!counter.Consume(500)); BOOST_CHECK_EQUAL(counter.GetAvailableBytes(), 0ull); BOOST_CHECK_EQUAL(counter.GetDroppedBytes(), 500ull); } void LogFromLocation(int location, std::string message) { switch (location) { case 0: LogInfo("%s\n", message); break; case 1: LogInfo("%s\n", message); break; case 2: LogPrintLevel(BCLog::LogFlags::NONE, BCLog::Level::Info, "%s\n", message); break; case 3: LogPrintLevel(BCLog::LogFlags::ALL, BCLog::Level::Info, "%s\n", message); break; } } void LogFromLocationAndExpect(int location, std::string message, std::string expect) { ASSERT_DEBUG_LOG(expect); LogFromLocation(location, message); } BOOST_FIXTURE_TEST_CASE(logging_filesize_rate_limit, LogSetup) { bool prev_log_timestamps = LogInstance().m_log_timestamps; LogInstance().m_log_timestamps = false; bool prev_log_sourcelocations = LogInstance().m_log_sourcelocations; LogInstance().m_log_sourcelocations = false; bool prev_log_threadnames = LogInstance().m_log_threadnames; LogInstance().m_log_threadnames = false; CScheduler scheduler{}; scheduler.m_service_thread = std::thread([&] { scheduler.serviceQueue(); }); auto sched_func = [&scheduler](auto func, auto window) { scheduler.scheduleEvery(std::move(func), window); }; auto limiter = std::make_unique(sched_func, 1024 * 1024, 20s); LogInstance().SetRateLimiting(std::move(limiter)); // Log 1024-character lines (1023 plus newline) to make the math simple. std::string log_message(1023, 'a'); std::string utf8_path{LogInstance().m_file_path.utf8string()}; const char* log_path{utf8_path.c_str()}; // Use GetFileSize because fs::file_size may require a flush to be accurate. std::streamsize log_file_size{static_cast(GetFileSize(log_path))}; // Logging 1 MiB should be allowed. for (int i = 0; i < 1024; ++i) { LogFromLocation(0, log_message); } BOOST_CHECK_MESSAGE(log_file_size < GetFileSize(log_path), "should be able to log 1 MiB from location 0"); log_file_size = GetFileSize(log_path); BOOST_CHECK_NO_THROW(LogFromLocationAndExpect(0, log_message, "Excessive logging detected")); BOOST_CHECK_MESSAGE(log_file_size < GetFileSize(log_path), "the start of the suppression period should be logged"); log_file_size = GetFileSize(log_path); for (int i = 0; i < 1024; ++i) { LogFromLocation(0, log_message); } BOOST_CHECK_MESSAGE(log_file_size == GetFileSize(log_path), "all further logs from location 0 should be dropped"); BOOST_CHECK_THROW(LogFromLocationAndExpect(1, log_message, "Excessive logging detected"), std::runtime_error); BOOST_CHECK_MESSAGE(log_file_size < GetFileSize(log_path), "location 1 should be unaffected by other locations"); log_file_size = GetFileSize(log_path); { ASSERT_DEBUG_LOG("Restarting logging"); MockForwardAndSync(scheduler, 1min); } BOOST_CHECK_MESSAGE(log_file_size < GetFileSize(log_path), "the end of the suppression period should be logged"); BOOST_CHECK_THROW(LogFromLocationAndExpect(1, log_message, "Restarting logging"), std::runtime_error); // Attempt to log 1MiB from location 2 and 1MiB from location 3. These exempt locations should be allowed to log // without limit. log_file_size = GetFileSize(log_path); for (int i = 0; i < 1024; ++i) { BOOST_CHECK_THROW(LogFromLocationAndExpect(2, log_message, "Excessive logging detected"), std::runtime_error); } BOOST_CHECK_MESSAGE(log_file_size < GetFileSize(log_path), "location 2 should be exempt from rate limiting"); log_file_size = GetFileSize(log_path); for (int i = 0; i < 1024; ++i) { BOOST_CHECK_THROW(LogFromLocationAndExpect(3, log_message, "Excessive logging detected"), std::runtime_error); } BOOST_CHECK_MESSAGE(log_file_size < GetFileSize(log_path), "location 3 should be exempt from rate limiting"); LogInstance().m_log_timestamps = prev_log_timestamps; LogInstance().m_log_sourcelocations = prev_log_sourcelocations; LogInstance().m_log_threadnames = prev_log_threadnames; scheduler.stop(); LogInstance().SetRateLimiting(nullptr); } BOOST_AUTO_TEST_SUITE_END()