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

1.简介log4cplus是C++编写的开源的日志系统，前身是java编写的log4j系统.受Apache Software License保护。作者是Tad E. Smith。log4cplus具有线程安全、灵活、以及多粒度控制的特点，通过将信息划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周期；你可以选择将信息输出到屏幕、文件、NT event log、甚至是远程服务器；通过指定策略对日志进行定期备份等等。2.下载最新的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文件夹

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目录下的测试程序

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);

文件名文件类型，可选择的文件类型包括app,ate,binary,in,out,trunc。缺省是trunc，表示将先前文件删除。缓冲刷新标志.

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信息会另存到新文件中，这里的频度包

2010-08-16 16:49:48