spdlog 源码 github地址: https://github.com/gabime/spdlog 。spdlog日志库自身带有包括控制台日志记录、基础文件日志记录、循环文件日志记录、每日文件日志记录等在内的日志记录方式,能满足日常不同的情景需求。
spdlog日志库的基本使用,包括创建日志记录器(logger)、创建日志记录器槽(sink)、设置日志输出内容格式(pattern)、设置日志输出等级(level)等。
本文主要从以下方面进行介绍:
日志记录级别包括:
sink 进行底层操作(比如格式化内容、输出内容到控制台/文件)的类。spdlog自带的几种sinks已经能满足日常需求,也可以派生其基类设计新的sink以满足特殊的需求。
sink类型有:
sink类主要使用的函数包括:
spdlog中的logger对象和sink对象都有两种版本,一种是以st结尾的单线程版本,以及以mt结尾的多线程版本。
创建名称为LoggerName1、内容输出到控制台的单线程版本日志记录器
auto logger1 = std::make_shared<spdlog::logger>("LoggerName1",
std::make_shared<spdlog::sinks::stdout_color_sink_st>());
//<2.创建名称为LoggerName2、内容输出到Logs/BasicFileLog.txt的多线程版本日志记录器
auto logger2 = std::make_shared<spdlog::logger>("LoggerName2", std::make_shared<spdlog::sinks::basic_file_sink_mt>("Logs/BasicFileLog.txt"));
创建名称为LoggerName3、内容输出到Logs/RotatingFileLog.txt的多线程版本日志记录器。
auto logger3 = std::make_shared<spdlog::logger>("LoggerName3",
std::make_shared<spdlog::sinks::rotating_file_sink_mt>("Logs/RotatingFileLog.txt",1024 * 1024 * 5, 3));
创建名称为LoggerName4、内容输出到Logs/DailyFileLog.txt的多线程版本日志记录器。
参数2和30指定每天生成日志文件的时间为凌晨2点30分。
auto logger4 = std::make_shared<spdlog::logger>("LoggerName4",
std::make_shared<spdlog::sinks::daily_file_sink_mt>("Logs/DailyFileLog.txt", 2,30));
实例1
//设置输出到控制台
auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
console_sink->set_level(console_level);
//设置输出到文件
auto temp = spdlog::level::debug;
auto file_sink =
std::make_shared<spdlog::sinks::daily_file_sink_mt>(“./log/daily.txt”, 2, 30);
file_sink->set_level(daily_file_level);
spdlog::sinks_init_list sink_list = { file_sink, console_sink };
std::shared_ptr<spdlog::logger> m_logger;
m_logger =
std::make_shared<spdlog::logger>(logger_name, sink_list.begin(), sink_list.end());
m_logger->set_level(logger_level);
m_logger->flush_on(logger_level); //注意:通过本语句,可使指定级别以上的日志Daily日志实时刷新到文件里。
实例2
//创建多个sink
auto sink1 = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
auto sink2 = std::make_shared<spdlog::sinks::rotating_file_sink_mt>
("Logs/RotatingFileLog.txt", 1024 * 1024 * 5, 3);
std::vector< spdlog::sink_ptr> sinks = { sink1,sink2 };
//创建使用多个sink的单个logger,logger会把内容输出到不同位置,此处是控制台以及RotatingFileLog.txt
auto logger = std::make_shared<spdlog::logger>("LoggerName",
sinks.begin(), sinks.end());
(1)创建sink
(2)创建共同使用同个sink的多个logger
//(1)创建sink
auto sink = std::make_shared<spdlog::sinks::rotating_file_sink_mt>
("Logs/RotatingFileLog.txt", 1024 * 1024 * 5, 3);
//(2)创建共同使用sink的多个logger,这些logger把内容一起输出到RotatingFileLog.txt中
auto logger1 = std::make_shared<spdlog::logger>("LoggerName1", sink);
auto logger2 = std::make_shared<spdlog::logger>("LoggerName2", sink);
auto logger3 = std::make_shared<spdlog::logger>("LoggerName3", sink);
sink1->set_pattern("[%Y-%m-%d %H:%M:%S.%e][%l]>>>%v");
sink2->set_pattern("[%Y-%m-%d][%L]%v");
sink1->set_level(spdlog::level::debug);
sink2->set_level(spdlog::level::info);
logger->debug("The message will only be shown on stdout.");//因为日志等级为debug,所以只会调用sink1进行输出
logger->info("The message will only be shown on stdout.");//日志等级为info,sink1与sink2都会进行输出
//<1.创建logger
//A.cpp
auto logger1 = std::make_shared<spdlog::logger>("LoggerName1",
std::make_shared<spdlog::sinks::stdout_color_sink_mt>());
auto logger2 = std::make_shared<spdlog::logger>("LoggerName2",
std::make_shared<spdlog::sinks::stdout_color_sink_mt>());
spdlog::register(logger2);
auto logger3 = spdlog::stdout_color_st("LoggerName3");
//<2.使用spdlog::get(std::string)获取logger
//B.cpp
auto logger1 = spdlog::get("LoggerName1");//logger1为空,因为logger1在A.cpp中没被注册
if (logger1)
{
logger1->info("Hello world!");
}
auto logger2 = spdlog::get("LoggerName2");//logger2不为空,因为logger2在A.cpp中已被注册
if (logger2)
{
logger2->info("Good Morning.");//输出
}
auto logger3 = spdlog::get("LoggerName3");//logger2不为空,因为spdlog自带的logger对象在构造时会自动注册
if (logger3)
{
logger3->info("Good Afternoon.");//输出
}
//<1.创建logger,并且将logger设置为默认的日志记录器
//A.cpp
auto logger = spdlog::stdout_color_mt("LoggerName");
spdlog::set_default_logger(logger);
//<2.使用spdlog::default_logger()获取默认的日志记录器
//B.cpp
auto logger = spdlog::default_logger();
if (logger)
{
logger->info("Hello World");//输出
}
spdlog::info("Hello China");//同样使用default_logger进行输出,更加方便的调用方式;未作default_logger是否为空的判断,会有程序中断的可能。
#define SPDLOG_ACTIVE_LEVEL SPDLOG_LEVEL_INFO
#include <spdlog/spdlog.h>
SPDLOG_INFO("This message will be shown."); //输出
SPDLOG_DEBUG("This message will not be shown.");//不输出
spdlog::info("Support for string.For example,hello,{}.", "Leborn Jame");
输出:[2021-04-13 22:06:21.219] [info] Support for string.For example,hello,Leborn Jame.
spdlog::warn("Supprot for integer.For example,{:08d}.", 23);
输出:[2021-04-13 22:07:48.865] [warning] Supprot for integer.For example,00000023.
spdlog::error("Support for float.For example,{:3.2}.", 1.23456);
输出:[2021-04-13 22:07:48.865] [error] Support for float.For example,1.2.
spdlog::critical("Support for position parameter.For example,{1} and {0}.", "dog", "cat");
输出:[2021-04-13 22:07:48.866] [critical] Support for position parameter.For example,cat and dog.
//<1.创建名称为LoggerName1、内容输出到控制台的单线程版本日志记录器
auto logger1 = spdlog::stdout_color_st("LoggerName1");
//<2.创建名称为LoggerName2、内容输出到Logs/BasicFileLog.txt的多线程版本日志记录器
auto logger2 = spdlog::basic_logger_mt("LoggerName2", "Logs/BasicFileLog.txt");
//<3.创建名称为LoggerName3、内容输出到Logs/RotatingFileLog.txt的多线程版本日志记录器
//参数1024*1024*5设置了文件最大容量为5mb,参数3设置了文件最大数量为3
//当日志文件存储超过5mb时,将重命名日志文件并且新增另外一个日志文件
//当日志文件数量超过3时,将删除第一个日志文件
auto logger3 =
spdlog::rotating_logger_mt("LoggerName3", "Logs/RotatingFileLog.txt", 1024 * 1024 * 5, 3);
//<4.创建名称为LoggerName4、内容输出到Logs/DailyFileLog.txt的多线程版本日志记录器
//参数2和30指定每天生成日志文件的时间为凌晨2点30分
auto logger4 = spdlog::daily_logger_mt("LoggerName4", "Logs/DailyFileLog.txt", 2, 30);
参考:
https://github.com/gabime/spdlog
https://blog.csdn.net/qq_39568245/article/details/115714105