参考文档:https://spdlog.docsforge.com/master/
spdlog简介
Very fast, header only, C++ logging library. 一个header-only的C++日志库,十分高效且易用。
获取安装方式
https://github.com/gabime/spdlog 使用时只需要将git项目内的/include/spdlog文件夹整个放入项目的include目录下即可
使用样例
快速入门
几个核心概念
- logger:日志对象,每个日志内包含一个sink组成的vector,每个sink可以分别设置优先级,logger本身也可设置优先级
- sink:直译是水槽,实际上是引流的对象或者可以认为是输出目标,spdlog库内置了多种不同类型的logger可供选择
- formatter:格式化对象,绝大部分情况下spdlog默认的格式就足够用了,但是如果有个性化需求,可以进行自定义格式
- level:日志级别,不同的日志库可能会有不同的设置,但是基本情况下都会有debug、info、warn、error等的级别划分来处理不同的情况,具体各个级别的情况可以根据自己的实际情况选取
逻辑关系:每个logger包含一个vector,该vector由一个或多个std::shared_ptr<sink>
组成,logger的每条日志都会调用sink对象,由sink对象按照formatter的格式输出到sink指定的地方(有可能是控制台、文件等),接下来我们从内到外的讲解spdlog的这三个核心组件
formatter
formatter也即格式化对象,用于控制日志的输出格式,spdlog自带了默认的formatter,一般情况下,我们无需任何修改,直接使用即可。注意,每个sink会有一个formatter
默认formatter
默认formatter的格式为:[日期时间] [logger名] [log级别] log内容
自定义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代表单线程
文件sink
文件sink的类型有很多,这里展示几种经典类型
其他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方式设置(直接设置全局)
logger
日志对象,每个logger内包含了一个vector用于存放sink,每个sink都是相互独立 因此一个日志对象在输出日志时可以同时输出到控制台和文件等位置
使用默认logger
如果整个项目中只需要一个logger,spdlog提供了最为便捷的默认logger,注意,该logger在全局公用,输出到控制台、多线程、彩色
创建特定的logger
大部分情况下默认logger是不够用的,因为我们可能需要做不同项目模块各自的logger,可能需要logger输出到文件进行持久化,所以创建logger是很重要的一件事。好在创建logger也是非常简单的!
方式一:直接创建
与创建sink类似,我们可以非常便捷的创建logger 由于大部分时候一个logger只会有一个sink,所以spdlog提供了创建logger的接口并封装了创建sink的过程
方式二:组合sinks方式创建
有时候,单sink的logger不够用,那么可以先创建sink的vector,然后使用sinks_vector创建logger 以下样例中,首先创建了sink的vector,然后创建了两个sink并放入vector,最后使用该vector创建了logger,其中,set_level的过程不是必须的,register_logger一般是必须的,否则只能在创建logger的地方使用该logger,关于register的问题可以往下看
logger的注册与获取
在一个地方创建了logger却只能在该处使用肯定是不好用的,所以spdlog提供了一个全局注册和获取logger,我们只需要在某处先创建logger并注册,那么后面在其他地方使用时直接获取就可以了 注册:spdlog::register_logger() 获取:spdlog::get()
关于注册与获取需要注意的事
- 必须先创建注册才能获取,建议每个模块的logger都在整个模块最开始初始化时创建并注册。如果在全局尝试获取不存在的logger,会返回空指针,如果恰好又使用空指针尝试输出logger,会造成整个程序的崩溃(访问非法内存了,segment fault)
- 通过上述的方式一创建的logger是自动注册的,不需要手动注册,但是方式二创建的logger需要手动注册
- 一旦注册,全局使用,名字标识logger,在各个模块获取同一个名字的logger会获取到同一个logger的指针
logger的使用
获取到一个logger之后,就可以愉快的使用它了,使用起来很简单
logger的level设置
logger的默认level是info,如果处于开发环境或者生产环境,会只需要debug级别以上或者warn级别以上的log 要设置logger的级别,很简单:
可以设置全局logger级别
可以设置sink级别的logger
注意:一个logger内假如有多个sink,那么这些sink分别设置level是可以不同的,但是由于logger本身也有level,所以真正使用时,logger的level如果高于某个sink,会覆盖该sink的level,所以建议此时把logger的level手动设置为debug(默认为info)
样例代码
以下代码为本人对spdlog的简单使用封装,主要功能有:
- 一键初始化,根据环境变量可设置修改logger级别等
- 一键创建双sink的logger(控制台和文件)
- 一键获取logger,假如logger不存在则创建
头文件
源文件
标签: # c++
留言评论