spdlog日志库中basic_file_sink的日志级别设置解析

在使用spdlog日志库时，开发者可能会遇到basic_file_sink的日志级别设置不生效的问题。本文将深入分析这一现象的原因，并解释spdlog日志系统中日志级别的正确设置方法。

问题现象

当开发者尝试为basic_file_sink设置日志级别时，可能会发现以下代码无法按预期工作：

auto file_sink = std::make_shared<spdlog::sinks::basic_file_sink_st>(
    "logs/basic-log.txt", true);

file_sink->set_level(spdlog::level::trace); // 设置似乎不生效

auto logger = std::make_shared<spdlog::logger>("basic", file_sink);

logger->trace("这是trace日志");  // 不会输出
logger->debug("这是debug日志");  // 不会输出
logger->info("这是info日志");    // 正常输出

尽管已经将sink的日志级别设置为trace，但trace和debug级别的日志仍然不会输出。

原因分析

spdlog的日志系统实际上有两层日志级别控制：

1. Logger级别：控制哪些级别的日志会被处理
2. Sink级别：控制哪些级别的日志会被输出到具体的输出目标

在spdlog的设计中，日志消息需要同时满足以下两个条件才会被输出：

• 日志级别 >= logger设置的级别
• 日志级别 >= sink设置的级别

在上面的例子中，虽然sink的级别被设置为trace，但logger的默认级别是info，因此trace和debug级别的日志在logger层面就被过滤掉了，根本不会传递到sink。

正确设置方法

要使trace级别的日志能够输出，需要同时设置logger和sink的日志级别：

auto file_sink = std::make_shared<spdlog::sinks::basic_file_sink_st>(
    "logs/basic-log.txt", true);

file_sink->set_level(spdlog::level::trace); // 设置sink级别

auto logger = std::make_shared<spdlog::logger>("basic", file_sink);
logger->set_level(spdlog::level::trace);    // 设置logger级别

logger->trace("现在trace日志会输出了");

多sink场景下的日志级别控制

在多sink场景下，每个sink可以有自己的日志级别设置。例如：

auto file_sink = std::make_shared<spdlog::sinks::basic_file_sink_st>(
    "logs/basic-log.txt", true);
file_sink->set_level(spdlog::level::debug); // 文件只记录debug及以上级别

auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
console_sink->set_level(spdlog::level::info); // 控制台只记录info及以上级别

spdlog::logger logger("multi_sink", {file_sink, console_sink});
logger.set_level(spdlog::level::trace); // logger处理所有级别

logger.trace("这条日志会写入文件但不会显示在控制台");
logger.info("这条日志会同时写入文件和显示在控制台");

这种设计使得开发者可以灵活地为不同的输出目标设置不同的日志级别，满足复杂的日志记录需求。

最佳实践

1. 明确区分logger级别和sink级别的用途
2. 在多sink场景下，合理设置每个sink的级别
3. 在创建logger后立即设置其日志级别，避免使用默认级别
4. 考虑使用spdlog的注册表机制来管理logger的生命周期

通过理解spdlog的日志级别控制机制，开发者可以更有效地利用这个强大的日志库来满足各种日志记录需求。