今天看了一场今年WCG的比赛,jaedong对阵stork,非常精彩。突然感觉星际里的微操和大局观就类同C和C++的开发,写C代码的时候就满脑子的字节、移位、共享内存、文件描述符之类的,C++就考虑类、模板、重载、IO流、标准库了。这只是个引子,在C开发一直用openlog()
, syslog()
来记录日志,虽然方便,但不够强大。今天来看一下C++中的一些日志操作库。
流行的一些C++日志库有好些,比如 log4cplus, log4cpp, log4cxx, boost log 功能依次增强吧。
当前的状况是,log4cplus已然停止开发许久;log4cpp去年突然有了更新,升级到1.0稳定版;log4cxx今年有了更新,现在属于apache的一个项目;boost log功能最强,而且文档十分详尽,不过不清楚为何当年申请进入boost库被reject。前三个有着共同的前缀log4,意思是它们都是从apache优秀的log4j日志操作库port出来的。优秀的实现总是在多个语言和平台上都会被人借鉴。
文档状况是,除了boost log外文档都很匮乏,主要参照内容就是doxygen生成的API文档。
性能上,一些早期的资料表明log4cpp性能相当出众,它也是较早移植log4j的C++库,log4cxx是后来apache自己的一个移植,具体性能影响和你使用的配置有关系。log4cxx是个线程安全并且支持多种appender的日志库。
其他细节,log4cpp提供了一个对比表。
log4cxx
log4j日志系统由三大类组成,它们又各自派生出不同功能的子类:
- Layout 用来控制输出日志消息的显示样式
- Appender 用来输出日志到某些设备上,比如文件、syslog、socket等
- Category 在log4cxx里叫作 Logger,真正完成日志记录功能
按日期记录日志
这里给出一个最常用的例子,就是按日期生成日志,但是代码异常简单。
#include <log4cxx/logmanager.h>
#include <log4cxx/xml/domconfigurator.h>
#include <log4cxx/patternlayout.h>
#include <log4cxx/rolling/rollingfileappender.h>
#include <log4cxx/rolling/fixedwindowrollingpolicy.h>
#include <log4cxx/rolling/filterbasedtriggeringpolicy.h>
#include <log4cxx/filter/levelrangefilter.h>
#include <log4cxx/helpers/pool.h>
#include <log4cxx/logger.h>
#include <log4cxx/propertyconfigurator.h>
#include <log4cxx/dailyrollingfileappender.h>
#include <log4cxx/helpers/stringhelper.h>
using namespace log4cxx;
using namespace log4cxx::rolling;
using namespace log4cxx::xml;
using namespace log4cxx::filter;
using namespace log4cxx::helpers;
void dailyRolling() {
PropertyConfigurator::configure(File("/etc/log4cxx.properties")); // Configure file, log4j format
LoggerPtr logger(Logger::getLogger("org.apache.log4j.DailyRollingFileAppender")); // Appender name
LOG4CXX_DEBUG(logger, "Hello World!"); // Debug level
LOG4CXX_INFO(logger, "Log4cxx's birth."); // INFO level
}
log4j配置
虽然C++代码可以写的很简单,但是我们可以进行很复杂的配置,让log4cxx灵活的记录信息,比如上边指定了配置文件/etc/log4cxx.properties
,这是一个Java特性文件:
log4j.rootLogger=DEBUG, test
log4j.appender.test=org.apache.log4j.DailyRollingFileAppender
log4j.appender.test.file=output/test1.log
log4j.appender.test.datePattern='.'yyyy-MM-dd
log4j.appender.test.Append=false
log4j.appender.test.layout=org.apache.log4j.PatternLayout
log4j.appender.test.layout.ConversionPattern=[QC] %p [%d] %C.%M(%L) | %m%n
# Prevent internal log4j DEBUG messages from polluting the output.
log4j.logger.org.apache.log4j.PropertyConfigurator=INFO
log4j.logger.org.apache.log4j.config.PropertySetter=INFO
log4j.logger.org.apache.log4j.FileAppender=INFO
Log4j配置由三个重要的组件构成:日志信息的优先级,日志信息的输出目的地,日志信息的输出格式。逐一解释下:
日志信息的优先级
Logger的语法:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,可以控制到应用程序中相应级别的日志信息的开关。比如这里定义了INFO级别,则应用程序中所有DEBUG级别的日志信息将不被打印出来。 appenderName名字任意,用来标示日志信息输出到哪里,可以同时指定多个。
日志信息的输出目的地
Appender的语法:
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
...
log4j.appender.appenderName.option = valueN
其中,Log4j提供的appender有以下几种:
org.apache.log4j.ConsoleAppender
控制台org.apache.log4j.FileAppender
文件org.apache.log4j.DailyRollingFileAppender
每天产生一个日志文件org.apache.log4j.RollingFileAppender
文件大小到达指定尺寸的时候产生一个新的文件org.apache.log4j.WriterAppender
将日志信息以流格式发送到任意指定的地方
日志信息的输出格式
Layout的语法:
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
...
log4j.appender.appenderName.layout.option = valueN
其中,Log4j提供的Layout有以下几种:
org.apache.log4j.HTMLLayout
以HTML表格形式布局org.apache.log4j.PatternLayout
可以灵活地指定布局模式org.apache.log4j.SimpleLayout
包含日志信息的级别和信息字符串org.apache.log4j.TTCCLayout
包含日志产生的时间、线程、类别等等信息
Log4j采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下:
%m
输出代码中指定的消息%p
输出优先级,即DEBUG
,INFO
,WARN
,ERROR
,FATAL
%r
输出自应用启动到输出该log信息耗费的毫秒数%c
输出所属的类目,通常就是所在类的全名%t
输出产生该日志事件的线程名%n
输出一个回车换行符,Windows平台为“\r\n
”,Unix平台为“\n
”%d
输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS}
,输出2008年11月14日 15:16:17,890
%l
输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。