【C++】spdlog快速入门

spdlog简介

Very fast, header only, C++ logging library.
一个header-only的C++日志库，十分高效且易用。

获取安装方式

https://github.com/gabime/spdlog
使用时只需要将git项目内的/include/spdlog文件夹整个放入项目的include目录下即可

使用样例

#include "spdlog/spdlog.h"

int main() 
{
    spdlog::info("Welcome to spdlog!");
    spdlog::error("Some error message with arg: {}", 1);
    
    spdlog::warn("Easy padding in numbers like {:08d}", 12);
    spdlog::critical("Support for int: {0:d};  hex: {0:x};  oct: {0:o}; bin: {0:b}", 42);
    spdlog::info("Support for floats {:03.2f}", 1.23456);
    spdlog::info("Positional args are {1} {0}..", "too", "supported");
    spdlog::info("{:<30}", "left aligned");
    
    spdlog::set_level(spdlog::level::debug); // Set global log level to debug
    spdlog::debug("This message should be displayed..");    
    
    // change log pattern
    spdlog::set_pattern("[%H:%M:%S %z] [%n] [%^---%L---%$] [thread %t] %v");
    
    // Compile time log levels
    // define SPDLOG_ACTIVE_LEVEL to desired level
    SPDLOG_TRACE("Some trace message with param {}", 42);
    SPDLOG_DEBUG("Some debug message");
}

快速入门

几个核心概念

• logger：日志对象，每个日志内包含一个sink组成的vector，每个sink可以分别设置优先级，logger本身也可设置优先级
• sink：直译是水槽，实际上是引流的对象或者可以认为是输出目标，spdlog库内置了多种不同类型的logger可供选择
• formatter：格式化对象，绝大部分情况下spdlog默认的格式就足够用了，但是如果有个性化需求，可以进行自定义格式
• level：日志级别，不同的日志库可能会有不同的设置，但是基本情况下都会有debug、info、warn、error等的级别划分来处理不同的情况，具体各个级别的情况可以根据自己的实际情况选取
• 逻辑关系：每个logger包含一个vector，该vector由一个或多个std::shared_ptr组成，logger的每条日志都会调用sink对象，由sink对象按照formatter的格式输出到sink指定的地方（有可能是控制台、文件等），接下来我们从内到外的讲解spdlog的这三个核心组件

formatter

formatter也即格式化对象，用于控制日志的输出格式,spdlog自带了默认的formatter，一般情况下，我们无需任何修改，直接使用即可。注意，每个sink会有一个formatter

默认formatter

默认formatter的格式为：[日期时间] [logger名] [log级别] log内容

[2022-10-13 17:00:55.795] [service] [debug] found env XXXXXXX : true
[2022-10-13 17:00:55.795] [func_config] [debug] kafka_brokers : localhost:9092
[2022-10-13 17:00:55.795] [func_config] [debug] kafka_main_topic : kafka_test
[2022-10-13 17:00:55.795] [func_config] [debug] kafka_partition_value : -1
[2022-10-13 17:00:55.795] [service] [info] initialized

自定义formatter

如果默认的formatter不符合需求，可以自定义formatter，具体方式如下

set_parrtern(pattern_string);

例如：

• 全局级别的：spdlog::set_pattern(" [%H:%M:%S %z] [thread %t] %v ");
• 单个logger级别的：some_logger->set_parttern(“>>> %H:%M:%S %z %v <<<”);
• 单个sink级别的：some_sink-> set_parttern(“… %H: %M …”);

其中用到了%H %M这些占位符，事实上它们都是预先设定好的，想要查看所有的占位符情况，可以参考以下网站：
https://spdlog.docsforge.com/v1.x/3.custom-formatting/#pattern-flags

sink

每个sink对应着一个输出目标和输出格式，它内部包含一个formatter，输出目标可以是控制台、文件等地方。
所有的sink都在命名空间spdlog::sinks下，可以自行探索

控制台sink

spdlog中创建控制台sink非常简单，该方式创建的sink会输出到命令行终端，且是彩色的（也可以选非彩色的，但是有彩色的应该都会选彩色的吧……）。后缀的_mt代表多线程，_st代表单线程

auto sink1 = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();

文件sink

文件sink的类型有很多，这里展示几种经典类型

auto sink1 = std::make_shared<spdlog::sinks::basic_file_sink_mt>(log_file_name);//最简单的文件sink，只需要指定文件名

auto sink2 = std::make_shared<spdlog::sinks::daily_file_sink_mt>(log_file_name, path, 14, 22);//每天的14点22分在path下创建新的文件

auto sink3 = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(log_file_name, 1024 * 1024 * 10, 100, false);//轮转文件，一个文件满了会写到下一个文件，第二个参数是单文件大小上限，第三个参数是文件数量最大值

其他sink

ostream_sink
syslog_sink
…
也可以通过继承base_sink创建子类来自定义sink，具体可以参考：
https://spdlog.docsforge.com/v1.x/4.sinks/#implementing-your-own-sink

sink的flush问题

创建好sink后建议设置flush方式，否则可能无法立刻在file中看到logger的内容
以下为两种重要的flush方式设置（直接设置全局）

spdlog::flush_every(std::chrono::seconds(1));
spdlog::flush_on(spdlog::level::debug);

logger

日志对象，每个logger内包含了一个vector用于存放sink，每个sink都是相互独立
因此一个日志对象在输出日志时可以同时输出到控制台和文件等位置

使用默认logger

如果整个项目中只需要一个logger，spdlog提供了最为便捷的默认logger，注意，该logger在全局公用，输出到控制台、多线程、彩色

//Use the default logger (stdout, multi-threaded, colored)
spdlog::info("Hello, {}!", "World");

创建特定的logger

大部分情况下默认logger是不够用的，因为我们可能需要做不同项目模块各自的logger，可能需要logger输出到文件进行持久化，所以创建logger是很重要的一件事。好在创建logger也是非常简单的！

方式一：直接创建

与创建sink类似，我们可以非常便捷的创建logger
由于大部分时候一个logger只会有一个sink，所以spdlog提供了创建logger的接口并封装了创建sink的过程

auto console = spdlog::stdout_color_mt("some_unique_name");//一个输出到控制台的彩色多线程logger，可以指定名字
auto file_logger = spdlog::rotating_logger_mt("file_logger", "logs/mylogfile", 1048576 * 5, 3);//一个输出到指定文件的轮转文件logger，后面的参数指定了文件的信息

方式二：组合sinks方式创建

有时候，单sink的logger不够用，那么可以先创建sink的vector，然后使用sinks_vector创建logger
以下样例中，首先创建了sink的vector，然后创建了两个sink并放入vector，最后使用该vector创建了logger，其中，set_level的过程不是必须的，register_logger一般是必须的，否则只能在创建logger的地方使用该logger，关于register的问题可以往下看

    std::vector<spdlog::sink_ptr> sinks;

    auto sink1 = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
    sink1->set_level(MyLoggers::getGlobalLevel());
    sinks.push_back(sink1);

    auto sink2 = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(log_file_name, 1024 * 1024 * 10, 100, false);
    sink2->set_level(spdlog::level::debug);
    sinks.push_back(sink2);
    
    auto logger = std::make_shared<spdlog::logger>("logger_name", begin(sinks), end(sinks));
    logger->set_level(spdlog::level::debug);
    spdlog::register_logger(logger);

logger的注册与获取

在一个地方创建了logger却只能在该处使用肯定是不好用的，所以spdlog提供了一个全局注册和获取logger，我们只需要在某处先创建logger并注册，那么后面在其他地方使用时直接获取就可以了
注册：spdlog::register_logger()
获取：spdlog::get()

//上面的代码中我们注册了一个logger，名字是logger_name，接下来尝试获取
auto logger = MyLoggers::getLogger("logger_name");

关于注册与获取需要注意的事

必须先创建注册才能获取，建议每个模块的logger都在整个模块最开始初始化时创建并注册。如果在全局尝试获取不存在的logger，会返回空指针，如果恰好又使用空指针尝试输出logger,会造成整个程序的崩溃（访问非法内存了，segment fault）

通过上述的方式一创建的logger是自动注册的，不需要手动注册，但是方式二创建的logger需要手动注册
一旦注册，全局使用，名字标识logger，在各个模块获取同一个名字的logger会获取到同一个logger的指针

logger的使用

获取到一个logger之后，就可以愉快的使用它了，使用起来很简单

logger->debug("this is a debug msg");
logger->warn("warn!!!!");
logger->info("hello world");
logger->error("烫烫烫烫");

logger的level设置

logger的默认level是info，如果处于开发环境或者生产环境，会只需要debug级别以上或者warn级别以上的log
要设置logger的级别，很简单：
logger->set_level(spdlog::level::debug);
可以设置全局logger级别
spdlog::set_level(spdlog::level::warn);
可以设置sink级别的logger
sink1->set_level(spdlog::level::info);

注意：一个logger内假如有多个sink，那么这些sink分别设置level是可以不同的，但是由于logger本身也有level，所以真正使用时，logger的level如果高于某个sink，会覆盖该sink的level，所以建议此时把logger的level手动设置为debug（默认为info）

样例代码

以下代码为对spdlog的简单使用封装，主要功能有：

一键初始化，根据环境变量可设置修改logger级别等
一键创建双sink的logger（控制台和文件）
一键获取logger，假如logger不存在则创建

头文件

#ifndef MY_LOGGER_H
#define MY_LOGGER_H

#include <stdlib.h>
#include "spdlog/spdlog.h"
#include "spdlog/sinks/stdout_color_sinks.h"
#include "spdlog/sinks/stdout_sinks.h"
#include "spdlog/sinks/basic_file_sink.h"
#include "spdlog/sinks/rotating_file_sink.h"
#include "spdlog/sinks/daily_file_sink.h"
#include <vector>

class MyLoggers
{
public:
    static void init();
    static spdlog::level::level_enum getGlobalLevel();
    static std::vector<spdlog::sink_ptr> createSinks(const std::string &log_file_name);
    static void createLogger(const std::string &logger_name);
    static std::shared_ptr<spdlog::logger> getLogger(const std::string &logger_name);

private:
    static spdlog::level::level_enum global_level;
};

#endif

源文件

#include "my_logger.h"

spdlog::level::level_enum MyLoggers::global_level = spdlog::level::info;

spdlog::level::level_enum MyLoggers::getGlobalLevel()
{
    return global_level;
}

std::vector<spdlog::sink_ptr> MyLoggers::createSinks(const std::string &log_file_name)
{
    std::vector<spdlog::sink_ptr> sinks;

    auto sink1 = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
    sink1->set_level(MyLoggers::getGlobalLevel());
    sinks.push_back(sink1);

    auto sink2 = std::make_shared<spdlog::sinks::rotating_file_sink_mt>(log_file_name, 1024 * 1024 * 10, 100, false);//根据文件大小，若文件大于10MB，则重新生成
    sink2->set_level(spdlog::level::debug);
    sinks.push_back(sink2);
    return sinks;
}

void MyLoggers::createLogger(const std::string &logger_name)
{
    std::string log_file_name = logger_name + "_log.txt";
    auto sinks = MyLoggers::createSinks(log_file_name);

    auto logger = std::make_shared<spdlog::logger>(logger_name, begin(sinks), end(sinks));
    logger->set_level(spdlog::level::debug);
    spdlog::register_logger(logger);
}

std::shared_ptr<spdlog::logger> MyLoggers::getLogger(const std::string &logger_name){
    auto logger = spdlog::get(logger_name);
    if(!logger){//looger指向为空
        createLogger(logger_name);
        logger = spdlog::get(logger_name);
    }
    return logger;
}


void MyLoggers::init()
{
    auto level = spdlog::level::debug;
    if (std::getenv("STAGE") != NULL)
    {
        std::string stage = std::getenv("STAGE");
        if (stage == "dev")
            level = spdlog::level::debug;
    }
    MyLoggers::global_level = level;

    spdlog::flush_every(std::chrono::seconds(1));
    spdlog::flush_on(spdlog::level::debug);

    MyLoggers::createLogger("service");
}

示例代码2

在Qt中，如果还需要考虑log文件被误删，可以利用定时器判断文件是否存在，每30s检测一次，若log文件不存在，则重新生存log文件。

QTimer* timer;
QString logFile;
QString currentDate;
QString logFileName;

void initLogger()
{
    logFile = "log/" + QDateTime::currentDateTime().toString("HHmmss") ;
    std::vector<spdlog::sink_ptr> sinks;
    sinks.push_back(std::make_shared<spdlog::sinks::stdout_color_sink_st>());
    sinks.push_back(std::make_shared<spdlog::sinks::daily_file_sink_st>(logFile.toStdString()+ ".log", 23, 59));
    auto combined_logger = std::make_shared<spdlog::logger>(logFile.toStdString()+ ".log", begin(sinks), end(sinks));
    combined_logger->set_pattern("[%^%Y-%m-%d %H:%M:%S.%e][%l]: %v%$");
    combined_logger->flush_on(this->_log_level);
    spdlog::register_logger(combined_logger);
    spdlog::set_default_logger(combined_logger);
    spdlog::set_level(this->_log_level);

    // qInstallMessageHandler
    qInstallMessageHandler(CusSpdLog);
}

void refreshLogFile()
{
    //由于daily_file_sink_st会生成带有日期的log，所以需要对logfile字符串重新修改，确保与log文件名一致
    currentDate = QDate::currentDate().toString("yyyy-MM-dd");
    logFileName = QString("%1_%2.log").arg(logFile, currentDate);

    // Periodically check if log file exists and is writable
    timer = new QTimer(this);
    connect(timer, &QTimer::timeout, [=]() {
        QFile file(logFileName);
        if (!file.exists() || !file.permissions().testFlag(QFile::WriteUser))
        {
            spdlog::drop_all();
            std::remove(logFileName.toStdString().c_str());

            this->initLogger();

            currentDate = QDate::currentDate().toString("yyyy-MM-dd");
            logFileName = QString("%1_%2.log").arg(logFile, currentDate);

            file.remove();
            file.close();
        }
    });
    timer->start(30000);  // Check every 30 sec
}

参考：

【C++】spdlog光速入门，C++logger最简单最快的库: