Apache log4cxx用法

一个好的系统通常需要日志输出帮助定位问题 。Apache基金会的log4cxx提供的完善的Log分级和输出功能。所以准备把该Log模块加入的系统中。

使用log4cxx需要满足一下功能:

1.提供日志分级输出功能

2.能将日志导出到文件

3.每个Log占一行,在每行的前面输出时间,因为很多时候定位问题需要时间值

4. 每天更换日志文件

5.支持线程安全

6.支持用代码配置Log属性

在网上google了很久,都是零散的信息,对于中文网页,千篇一律都是一样的文章。下面介绍log4cxx的用法。

使用log4cxx 需要引入头文件

#include <log4cxx/logger.h>

#include <log4cxx/helpers/object.h>

#include <log4cxx/helpers/pool.h>

#include <log4cxx/basicconfigurator.h>

#include <log4cxx/PatternLayout.h>

#include <log4cxx/DailyRollingFileAppender.h>

如果使用到其他log4cxx的类,也需要include对应的头文件。

同时需要将log4cxx.lib添加到工程中,并且将log4cxx.dll拷贝到exe所在目录。

网上很多例子都是用配置文件来设置Log系统,但是使用外部Log文件可能会暴露过多的信息,导致系统风险。所以改用代码中配置。

log4cxx::PatternLayout提供通过字符串格式化日志;

%r [%t] %-5p - %m\n 用来格式化日志

%r 显示从程序启动到记录本日志经历的毫秒数。

%t 输出该日志的线程ID

%-5p 5个字符宽显示日志的优先级

%m 日志消息

\n 换行输出日志

FileAppender是log4cxx中用于配置日志输出到文件的类,FileAppender只能配置固定的文件作为Log输出,但是DailyRollingFileAppender可以用DatePattern来设置Log系统每日更换Log文件。由于软件需要24×7小时运行,所以必须定时更换Log文件,否则单个日志文件会过于庞大。

DatePattern为 '.'yyyy-MM-dd 将会在进入下一天时将前一天的Log文件,如 jianyu.me 更名为 jianyu.me.2013-07-10 这样就避免在同一个Log文件中输出太多Log信息。

"./Log/jianyu.me" 为当前操作的日志文件名,在Log目录下的 jianyu.me文件

使用前需要创建一个LoggerPtr 对象,

例如:

LoggerPtr m_logger;

使用以下宏来输出Log,这几个宏代表不同的Log等级

LOG4CXX_DEBUG(logger, message)

LOG4CXX_TRACE(logger, message)

LOG4CXX_INFO(logger, message)

LOG4CXX_WARN(logger, message)

LOG4CXX_ERROR(logger, message)

关于log4cxx编译可以参考另一篇i帖子

代码如下:

#include <log4cxx/logger.h>

#include <log4cxx/helpers/object.h>

#include <log4cxx/helpers/pool.h>

#include <log4cxx/basicconfigurator.h>

#include <log4cxx/PatternLayout.h>

#include <log4cxx/DailyRollingFileAppender.h>

using namespace log4cxx;

using namespace log4cxx::helpers;

#pragma comment(lib, "log4cxx.lib")

LoggerPtr m_logger;

log4cxx::LogString logFile(L"./Log/jianyu.me");

log4cxx::LogString patternStr(L"\%r [\%t] \%-5p - \%m\n");

log4cxx::LogString strDatePattern(L"\'.\'yyyy-MM-dd");

log4cxx::FileAppender* fileAppender = new log4cxx::DailyRollingFileAppender(

log4cxx::LayoutPtr(new log4cxx::PatternLayout(patternStr)),

logFile, strDatePattern);

log4cxx::helpers::Pool p;

fileAppender->activateOptions(p);

log4cxx::BasicConfigurator::configure(log4cxx::AppenderPtr(fileAppender));

log4cxx::Logger::getRootLogger()->setLevel(log4cxx::Level::getDebug());

m_logger = log4cxx::Logger::getLogger("logger");

LOG4CXX_DEBUG(m_logger, strLog);