在Linux上的使用开源C++日志库---log4cplus

1.简介

log4cplus是C++编写的开源的日志系统，前身是java编写的log4j系统.受Apache Software License保护。作者是Tad E. Smith。

log4cplus具有线程安全、灵活、以及多粒度控制的特点，通过将信息划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周期；你可以选择将信息输出到屏幕、文件、NT event log、甚至是远程服务器；通过指定策略对日志进行定期备份等等。

2.下载

最新的log4cplus可以从以下网址下载。
log4cplus：http://sourceforge.net/projects/log4cplus/

3.安装

#tar xvzf log4cplus-1.0.4-rc10.tar.gz
#cd log4cplus-1.0.4-rc10
#./configure --prefix=/usr/local
#make
#make install
安装成功会在/usr/local/lib下看到liblog4cplus.a，在/usr/local/include下有个liblog4cplus文件夹
在Linux上的使用开源C++日志库---log4cplus

4.配置

确保你的Makefile中包含 /usr/local/lib/liblog4cplus.a（静态库）或-llog4cplus（动态库）即可。

头文件在/usr/local/include/log4cplus目录下。

对于动态库，要想正常使用，还得将库安装路径加入到 LD_LIBRARY_PATH 中，以管理员身份登录，在/etc/ld.so.conf中加入安装路径，这里是/usr/local/lib，然后执行 ldconfig使设置生效即可。

5.运行测试程序
直接运行源码包中tests目录下的测试程序
在Linux上的使用开源C++日志库---log4cplus

6.log4cplus内容介绍
1.log4cplus基本元素     Layouts       ：控制输出消息的格式。
    Appenders ：输出位置。
    Logger        ：日志对象。
    Priorities      ：优先权，包括TRACE, DEBUG, INFO, WARNING, ERROR, FATAL。
2.log4cplus基本结构
3. 使用步骤：     a.) 生成Appender对象。     b.) 生成Layout对象，并绑定到Appender。(可选)     c.) 生成Logger对象。     d.) 设置Logger优先级。(可选)     e.) 将需要关联Logger的Appender添加到Logger上。     f.) 使用Logger输出信息，所有大于设定的优先级的信息，并在所有挂接在该Logger对象上的Appender上以相应的Layout设定的格式显示出来。
4. Logger对象 Logger对象具有层次结构，按名称区分，如下代码：    Logger test = Logger::getInstance("test");
Logger subtest = Logger::getInstance("test.subtest");     对象subtest是test的子对象。 5. 优先级     log4cplus优先级有低到高：     NOT_SET_LOG_LEVEL ：接受缺省的LogLevel，如果有父logger则继承它的LogLevel
    ALL_LOG_LEVEL ：开放所有log信息输出
    TRACE_LOG_LEVEL ：开放trace信息输出(即ALL_LOG_LEVEL)
    DEBUG_LOG_LEVEL ：开放debug信息输出
    INFO_LOG_LEVEL ：开放info信息输出
    WARN_LOG_LEVEL ：开放warning信息输出
    ERROR_LOG_LEVEL ：开放error信息输出
    FATAL_LOG_LEVEL ：开放fatal信息输出
    OFF_LOG_LEVEL ：关闭所有log信息输出     各个logger可以通过setLogLevel设置自己的优先级，当某个logger的LogLevel设置成NOT_SET_LOG_LEVEL时，该logger会继承父logger的优先级，另外，如果定义了重名的多个logger, 对其中任何一个的修改都会同时改变其它logger。 6.Layout格式输出 1.) SimpleLayout
    是一种简单格式的布局器，在输出的原始信息之前加上LogLevel和一个"-"。 2.) TTCCLayout
    其格式由时间，线程ID，Logger和NDC 组成。 3.) PatternLayout     是一种有词法分析功能的模式布局器,类似正则表达式。以“%”作为开头的特殊预定义标识符，将产生特殊的格式信息。（1）"%%"，转义为% 。（2）"%c"，输出logger名称，如test.subtest 。也可以控制logger名称的显示层次，比如"%c{1}"时输出"test"，其中数字表示层次。
（3）"%D"，显示本地时间，比如："2004-10-16 18:55:45"，%d显示标准时间。     可以通过%d{...}定义更详细的显示格式，比如%d{%H:%M:%s}表示要显示小时:分钟：秒。大括号中可显示的
     预定义标识符如下：

   %a -- 表示礼拜几，英文缩写形式，比如"Fri"
   %A -- 表示礼拜几，比如"Friday"
   %b -- 表示几月份，英文缩写形式，比如"Oct"
   %B -- 表示几月份，"October"
   %c -- 标准的日期＋时间格式，如 "Sat Oct 16 18:56:19 2004"
   %d -- 表示今天是这个月的几号(1-31)"16"
   %H -- 表示当前时刻是几时(0-23)，如 "18"
   %I -- 表示当前时刻是几时(1-12)，如 "6"
   %j -- 表示今天是哪一天(1-366)，如 "290"
   %m -- 表示本月是哪一月(1-12)，如 "10"
   %M -- 表示当前时刻是哪一分钟(0-59)，如 "59"
   %p -- 表示现在是上午还是下午， AM or PM
   %q -- 表示当前时刻中毫秒部分(0-999)，如 "237"
   %Q -- 表示当前时刻中带小数的毫秒部分(0-999.999)，如 "430.732"
   %S -- 表示当前时刻的多少秒(0-59)，如 "32"
   %U -- 表示本周是今年的第几个礼拜，以周日为第一天开始计算(0-53)，如 "41"
   %w -- 表示礼拜几，(0-6, 礼拜天为0)，如 "6"
   %W -- 表示本周是今年的第几个礼拜，以周一为第一天开始计算(0-53)，如 "41"
   %x -- 标准的日期格式，如 "10/16/04"
   %   X -- 标准的时间格式，如 "19:02:34"
   %y -- 两位数的年份(0-99)，如 "04"
   %Y -- 四位数的年份，如 "2004"
   %Z -- 时区名，比如 "GMT" （4）"%F"，输出当前记录器所在的文件名称，比如"main.cpp"
（5）"%L"，输出当前记录器所在的文件行号，比如"51"
（6）"%l"，输出当前记录器所在的文件名称和行号，比如"main.cpp:51"
（7）"%m"，输出原始信息。
（8）"%n"，换行符。（9）"%p"，输出LogLevel，比如"DEBUG"
（10）"%t"，输出记录器所在的线程ID，比如 "1075298944"
（11）"%x"，嵌套诊断上下文NDC (nested diagnostic context) 输出，从堆栈中弹出上下文信息，NDC可以用对不同源的log信息（同时地）交叉输出进行区分。
（12）格式对齐，比如"%-10m"时表示左对齐，宽度是10，当然其它的控制字符也可以相同的方式来使用，比如"%-12d"，"%-5p"等等。 7.) Appender输出位置（1）控制台输出         ConsoleAppender （2）文件输出         FileAppender / RollingFileAppender / DailyRollingFileAppender . FileAppender :     实现了基本的文件操作功能，构造函数如下:     FileAppender(filename,mode,immediateFlush); <filename > 文件名
<mode> 文件类型，可选择的文件类型包括app,ate,binary,in,out,trunc。缺省是trunc，表示将先前文件删除。
<immediateFlush> 缓冲刷新标志. RollingFileAppender: RollingFileAppender(filename,maxFileSize,maxBackupIndex,immediateFlush)

filename       : 文件名
maxFileSize    : 文件的最大尺寸
maxBackupIndex : 最大记录文件数
immediateFlush : 缓冲刷新标志

可以根据你预先设定的大小来决定是否转储，当超过该大小，后续log信息会另存到新文件中，除了定义每个记录文件的大小之外，你还要确定在 RollingFileAppender类对象构造时最多需要多少个这样的记录文件(maxBackupIndex+1)，当存储的文件数目超过 maxBackupIndex+1时，会删除最早生成的文件，保证整个文件数目等于maxBackupIndex+1 。 DailyRollingFileAppender： DailyRollingFileAppender(filename, schedule,immediateFlush, maxBackupIndex)

filename : 文件名
schedule : 存储频度
immediateFlush : 缓冲刷新标志
maxBackupIndex : 最大记录文件数 DailyRollingFileAppender类可以根据你预先设定的频度来决定是否转储，当超过该频度，后续log信息会另存到新文件中，这里的频度包

秒客网

在Linux上的使用开源C++日志库---log4cplus

相关文章