Log4c配置详细笔记

Log4c配置详细笔记

1.Log工具简单比较

Log4cpp & Log4CPlus：C++的日志库，可移植移性相对差些
Log4c：C的日志库，基本上都是一些纯c的东西，移植性较好

2.Log4c的基本概念
Log4c中有三个重要的概念, Category, Appender, Layout。
 　　Category用于区分不同的日志，在一个程序中我们可以通过Category来指定很多的日志。
 　　Appdender用于描述输出流，通过为Category来指定一个Appdender，可以决定将log信息来输出到什么地方去，比如stdout, stderr, rollingfile等等。
 　　Layout用于指定日志信息的格式，通过为Appender来指定一个Layout,可以决定log信息以何种格式来输出，比如是否有带有时间戳， 是否包含文件位置信息等，以及他们在一条log信息中的输出格式的等。
Category, Appender, Layout三者之间的关系，一个Category需要为其指定一个appender， 一个appender亦要为其指定一个layout。
 另外，对于文件类型输出还有一个rollingpolicy。rollingpolicy用于描述文件输出的配置策略。

3.关于配置

配置文件示例如下：

<!DOCTYPE log4c SYSTEM "">
 <log4c version="1.2.0">
　　<config>
　　　　<bufsize>0</bufsize>
　　　　<debug level="0"/>
　　　　<nocleanup>0</nocleanup>
　　</config>
　　
 　　<layout name="dated" type="dated_l"/>
　　
 　　<!-- appenders ===================================== -->
　　　　<appender name="LoadBusinessLog" type="rollingfile" logdir="../etc/log"
　　　　　　　prefix="LoadBusiness-" layout="dated_l"　rollingpolicy="Policy1" />
　
 　　　 <appender name="CataRollingFileAppender" type="rollingfile" logdir="../etc/log/"
　　　　　　 prefix="testLog"　layout="dated"　rollingpolicy="RollingPolicy" />

 　　　　<!-- category ========================================= -->
　　　　<category name="root" priority="notice"/>
　　　　<category name="framework" priority="info" appender="FrameLog" />
　　　　<category name="test.log" priority="trace" appender="CataRollingFileAppender" />

 　　　　<!-- policy ======================================= -->
　　　　<rollingpolicy name="Policy1" type="timewin" timetype="1" maxnum="10" />
　　　　<rollingpolicy name="RollingPolicy" type="sizewin" maxsize="102400" maxnum="10" />
 </log4c>

3.1 category
name：日志的名称
priority：日志的优先级，共有fatal、alert、crit、error、warn、notice、info、debug、trace、notset和unknown11个级别，其级别逐步递增，记录在日志中的数据为小于等于指定级别的数据。
appender：输出流类型名称，为appender节点的name属性的值。

3.2 appender
name：输出流名称
type：输出流类型，共有stream、syslog、rollingfile三大类
layout：输出日志的格式的名称，为layout节点的name属性的值。
rollingpolicy：输出日志文件配置策略名称，为rollingpolicy节点的name属性的值。
rollingpolicy的timewin类型的日志输出为自定义类型

3.3 layout
name：输出日志的格式名称
type：输出日志格式的类型，共有base 、dated、dated_l等格式类型，对于自定义类型也有配置在这里，否则不能够加载。
base：%P %c - %m/n
　　　　 "%P" 日志信息的优先级
 　　　　 "%c" 日志的名称
 　　　　 "%m" 日志信息内容
dated：%d %P %c - %m/n
　　　　　"%d" 日志信息产生的时间，UTC格式yyyymmdd hh:mm:ss.mis
　　　　 "%P" 日志信息的优先级
 　　　　 "%c" 日志的名称
 　　　　 "%m" 日志信息内容
dated_l：%d %P %c - %m/n　（源代码里面没有，自己增加的）
 　　　　 "%d" 日志信息产生的时间，本地时间格式yyyymmdd hh:mm:ss
　　　　 "%P" 日志信息的优先级
 　　　　 "%c" 日志的名称
 　　　　 "%m"日志信息内容

3.4 rollingpolicy
name：日志文件输出的配置策略名称。
type：日志文件输出的配置策略的类型，有sizewin一种类型。
maxsize：输出日志文件的最大值。默认值为20KB
 maxnum：保存的历史日志文件总数。默认值为5

3.5 配置文件的路径 ：
${ LOG4C_RCPATH }/log4crc　　//环境变量中设置的配置文件夹下log4crc
 ${HOME}/.log4crc　　　　　　 //HOME文件夹下log4crc
./log4crc　　　　　　　　　　//当前可执行文件夹下log4crc

4、Log4c的基本使用
 

头文件 （直接引用log4c.h程序编译出错，因此只引用需要的头文件）
extern "C" {
 #include <log4c/init.h>
 #include <log4c/category.h>
 }

cpp文件
//初始化
log4c_init();
 //获取一个已有的category
 log4c_category_t* mycat = log4c_category_get("cata.log ");
//用该category进行日志输出，优先级为DEBUG，输出信息为 "Hello World!"
 log4c_category_log(mycat, LOG4C_PRIORITY_DEBUG, "Hello World!");
 //析构
log4c_fini();

//在日志输出过程中可以进行格式化输出：
log4c_category_log(mycat, LOG4C_PRIORITY_ERROR, "Error code = %d", 12345);
 //对于格式化输出也可以有如下写法：
void CLog::Trace(const char * format, ... )
 {
　　 if (log4c_category_is_priority_enabled(mycat, LOG4C_PRIORITY_TRACE))
　　 {
　　　　a_list argptr;
　　　　va_start(argptr, format);

 　　　　log4c_category_vlog(mycat, LOG4C_PRIORITY_TRACE, format, argptr);

 　　　　va_end(argptr);
　　 }
 }