log4cpp有3个主要的组件:categories(类别)、appenders(附加目的地)、和 layouts(布局),layout类控制输出日志消息的显示样式(看起来像什么)。log4cpp当前提供以下layout格式: 
log4cpp::BasicLayout    // 以“时间戳 优先级(priority,下文介绍) 
                        // 类别(category,下文介绍) 
                        // NDC标签 
log4cpp::PatternLayout  // 让用户根据类似于 C 语言 printf 函数的转换模式来指定输出格式。 
log4cpp::SimpleLayout   // 以“优先级(priority) - 日志信息”格式显示。 

appender类用来输出日志(被layout格式化后的)到一些设备上。比如文件、syslog服务、 
某个socket等。可以定义自己的appender类输出日志信息到别的设备上,比如应用自身的 
日子处理进程、数据库等。appender和layout的关系是layout附在appender上, 
appender类调用layout处理完日志消息后,记录到某个设备上。log4cpp当前 
提供以下appender:

  1. log4cpp::IdsaAppender   // 发送到IDS或者logger,
  2. log4cpp::FileAppender   // 输出到文件
  3. log4cpp::RollingFileAppender  // 输出到回卷文件,即当文件到达某个大小后回卷
  4. log4cpp::OstreamAppender   // 输出到一个ostream类
  5. log4cpp::RemoteSyslogAppender  // 输出到远程syslog服务器
  6. log4cpp::StringQueueAppender  // 内存队列
  7. log4cpp::SyslogAppender   // 本地syslog
  8. log4cpp::Win32DebugAppender  // 发送到缺省系统调试器
  9. log4cpp::NTEventLogAppender  // 发送到win 事件日志

category 类真正完成记录日志功能,两个主要组成部分是appenders和priority(优先级)。优先级控制哪类日志信息可以被这个category记录,当前优先级分为:NOTSET, DEBUG, INFO, NOTICE, WARN, ERROR, CRIT, ALERT 或 FATAL/EMERG 。每个日志信息有个优先级,每个category有个优先级,当消息的优先级大于等于category的优先级时,这个消息才会被category记录,否则被忽略。优先级的关系如下。category类和appender的关系是,多个appender附在category上,这样一个日志消息可以同时输出到多个设备上。 
NOTSET < DEBUG < INFO < NOTICE < WARN < ERROR < CRIT < ALERT < FATAL = EMERG 
category被组织成一个树,子category创建时优先级缺省NOTSET,category缺省会继承父category的appender。而如果不希望这种appender的继承关系,log4cpp允许使用additivity 标签,为false时新的appender取代category的appender列表。 
log4cpp可以用手动方式使用,也可以使用配置文件使用,用配置文件的方式简单,便捷。所有,现在都用配置文件的方式。 

log 的优先级别解读,参阅源码 log4cpp-0.3.5rc3\include\log4cpp\Priority.hh 

由高到低 

EMERG 
FATAL 
ALERT 
CRIT 
ERROR 
WARN 
NOTICE 
INFO 
DEBUG 
NOTSET 
对应到 Category 相应函数,参阅源码 log4cpp-0.3.5rc3\include\log4cpp\Category.hh 
Category::emerg() 
Category::fatal() 
Category::alert() 
Category::crit() 
Category::error() 
Category::warn() 
Category::notice() 
Category::info() 
Category::debug() 
以上函数都有 2 个重载函数,可分别接受格式化字串或 std::string,例如 debug(),有

  1. void debug(const char* stringFormat, ...) throw();
  2. void debug(const std::string& message) throw();

关于优先级别使用的建议 
开发运行时,设为 DEBUG 级,而正式运营时,则设为 NOTICE ; 
一定要显示出来的信息则可以用 NOTICE 或以上级别; 
跟踪函数运行痕迹的信息用 INFO 级别; 
运行时调试的信息用 DEBUG 级别; 
举例说明

  1. void initialize(int argc, char* argv[])
  2. {
  3. log.info("initialize() : argc=%d", argc);
  4. for (int i=0; i < argc; ++i)
  5. {
  6. log.debug("initialize() : argv[%d]=%s", i, argv[i]);
  7. }
  8. log.notice("initialize() : done");
  9. }

log4cpp 的 category 分为 rootCategory 和其它自定义的 category。 
而每个 category 都可以输出到多个 appender。并且 category 也是有包含关系的。 
例如 rootCategory 就是所有 category 的根。而自定义的 category 也可以在配置文件中定义其包含关系。 
先看一个 rootCategory 的配置 
log4cpp.rootCategory=DEBUG, console, sample 
这个定义里,指定了 rootCategory 的 log 优先级是 DEBUG,其 appender 有 2 个,分别是 console 和 sample。 
即是说,等号右边内容以逗号分隔,第一项是优先级别,接下来的都是 appender 名字,可以有一个或多个。 
现在来看看自定义的 category 
log4cpp.category.demo=DEBUG, sample 
这里定义了一个名字为 demo 的 category,其优先级为 DEBUG,appender 为 sample。 
注意, category 和 appender 名字可以完全相同。 
再来看看有包含关系的 category 的定义 
log4cpp.category.demo.son=DEBUG, son 
log4cpp.category.demo.daughter=DEBUG, daughter 
以上定义了 2 个 category,名字分别为 son 和 daughter,其父 category 为 demo。 
son 产生的 log 会写到 son 和 demo 的 appender 中。同理,daughter 的 log 会写到 daughter 和 demo 的 appender 中。 
现在来看看 appender 的定义。appender 有很多种,我这里只介绍几种,分别是 
ConsoleAppender : 控制台输出,即 std::cout 
Win32DebugAppender : VC IDE 的输出,即 ::OutputDebugString 
FileAppender : 文件输出 
RollingFileAppender : 有待研究 
现在看一个 ConsoleAppender 的例子 
log4cpp.appender.console=ConsoleAppender 
log4cpp.appender.console.layout=PatternLayout 
log4cpp.appender.console.layout.ConversionPattern=%d [%p] - %m%n 
以上信息解释为:一个名为 console 的 appender,其类型为 ConsoleAppender,即 控制台输出 log 输出的布局是 指定的样式 
输出的格式 是 "%d [%p] - %m%n" (稍后再解释) 
再看一个 FileAppender 的例子 
log4cpp.appender.sample=FileAppender 
log4cpp.appender.sample.fileName=sample.log 
log4cpp.appender.sample.layout=PatternLayout 
log4cpp.appender.sample.layout.ConversionPattern=%d [%p] - %m%n 
以上信息解释为:一个名为 sample 的 appender,其类型为 FileAppender,即 文件输出指定的 log 文件名为 sample.log,输出的布局是 指定的样式,输出的格式 是 "%d [%p] - %m%n" 
对应 category 和 appender 的配置方式,可以发现 
category 是 "log4cpp.category." + "category name" 
category 名字可以用 "." 分隔,以标识包含关系 
appender 是 "log4cpp.appender." + "appender name" 
appender 名字 不能 用 "." 分隔,即是说 appender 是没有包含关系的 
现在看一个完整的配置文件例子 
#定义 root category 的属性 
log4cpp.rootCategory=DEBUG, console 

#定义 console 属性 
log4cpp.appender.console=ConsoleAppender 
log4cpp.appender.console.layout=PatternLayout 
log4cpp.appender.console.layout.ConversionPattern=%d [%p] - %m%n 

#定义 sample category 的属性 
log4cpp.category.sample=DEBUG, sample 

#定义 sample appender 的属性 
log4cpp.appender.sample=FileAppender 
log4cpp.appender.sample.fileName=sample.log 
log4cpp.appender.sample.layout=PatternLayout 
log4cpp.appender.sample.layout.ConversionPattern=%d [%p] - %m%n 

#定义 sample.son category 的属性 
log4cpp.category.sample.son=DEBUG, son 

#定义 son appender 的属性 
log4cpp.appender.son=FileAppender 
log4cpp.appender.son.fileName=son.log 
log4cpp.appender.son.layout=PatternLayout 
log4cpp.appender.son.layout.ConversionPattern=%d [%p] - %m%n 

#定义 sample.daughter category 的属性 
log4cpp.category.sample.daughter=DEBUG, daughter 

#定义 daughter appender 的属性 
log4cpp.appender.daughter=FileAppender 
log4cpp.appender.daughter.fileName=daughter.log 
log4cpp.appender.daughter.layout=PatternLayout 
log4cpp.appender.daughter.layout.ConversionPattern=%d [%p] - %m%n 
ConversionPattern 参数解读,参阅源码 log4cpp-0.3.5rc3\src\PatternLayout.cpp 
%m log message 内容, 即 用户写 log 的具体信息 
%n 回车换行 
%c category 名字 
%d 时间戳 
%p 优先级 
%r 距离上一次写 log 的间隔, 单位毫秒 
%R 距离上一次写 log 的间隔, 单位秒 
%t 线程名 
%u 处理器时间 
%x NDC ? 
窃以为,以下格式就足够了,即输出 "时间 [线程名] 优先级 - log内容 回车换行" 
%d [%t] %p - %m%n 
配置的知识就差不多了,现在看看实际代码应用 
首先是初始化 log4cpp 的配置,例如我的配置文件名是 log4cpp.properties

  1. try
  2. {
  3. log4cpp::PropertyConfigurator::configure("log4cpp.properties");
  4. }
  5. catch (log4cpp::ConfigureFailure & f)
  6. {
  7. std::cerr << "configure problem " << f.what() << std::endl;
  8. }

初始化完成后,就可以这样用了(具体的应用技巧,你自己摸索吧)

  1. log4cpp::Category & log = log4cpp::Category::getInstance(std::string("sample"));
  2. log.debug("test debug log");
  3. log.info("test info log");
  4. // 用 sample.son
  5. log4cpp::Category & log = log4cpp::Category::getInstance(std::string("sample.son"));
  6. log.debug("test debug log of son");
  7. log.info("test info log of son");
  8. // 用 sample.daughter
  9. log4cpp::Category & log = log4cpp::Category::getInstance(std::string("sample.daughter"));
  10. log.debug("test debug log of daughter");
  11. log.info("test info log of daughter");

再举一个在自定义类中的使用

  1. #include <log4cpp/Category.hh>
  2. namespace demo
  3. {
  4. class Sample
  5. {
  6. public:
  7. Sample();
  8. ~Sample();
  9. public:
  10. Testing(int i);
  11. private:
  12. static log4cpp::Category & log;
  13. };
  14. }
  15. #include "Sample.h"
  16. namespace demo
  17. {
  18. log4cpp::Category & Sample::log = log4cpp::Category::getInstance(std::string("sample"));
  19. Sample::Sample()
  20. {
  21. log.debug("Sample::Sample()");
  22. }
  23. Sample::~Sample()
  24. {
  25. log.debug("Sample::~Sample()");
  26. }
  27. Sample::Testing(int i)
  28. {
  29. log.debug("Sample::Testing() : i=%d", i);
  30. }
  31. }

转载文章: 
1. 便利的开发工具-log4cpp快速使用指南(http://www.ibm.com/developerworks/cn/linux/l-log4cpp/index.html) 
2. example of log4cpp properties configuration(http://blog.chinaunix.net/u1/50766/showart_400018.html)

Log4cpp配置文件格式说明的更多相关文章

  1. 配置文件格式用哪个?文件夹+纯文本文件,XML,SQLite

    稍具规模的软件都会须要一个配置文件来支持软件的执行.眼下常见的配置文件格式有纯文本.XML.SQLite.自己定义二进制格式,怎样进行选择呢? 1 纯文本--永远不会失效的文件格式 文本化是传统Uni ...

  2. ini配置文件格式

    转自:http://blog.sina.com.cn/s/blog_6988593e0101e6i4.html  程序没有任何配置文件,那么它对外是全封闭的,一旦程序需要修改一些参数必须要修改程序代码 ...

  3. INI配置文件格式解析

    INI配置文件有三要素parameters,sections和comments. 1.parameters 指一条配置,就像key = value这样的. 2.sections sections是pa ...

  4. Maven项目的pom.xml配置文件格式初识

    Maven项目 有pom.xml文件的项目就已经是一个maven项目了,但是还没有被maven托管,我们需要将该项目添加为maven项目 <project xmlns="http:// ...

  5. SQLHelper用到的配置文件格式

    格式要牢记 <configuration> <connectionStrings> <add name="dbConnStr" connectionS ...

  6. linux模范配置文件格式

    模范配置文件 #--------------------------------------------------------------------- # Global settings #--- ...

  7. 【转】 log4cpp 的使用

    [转自] http://sogo6.iteye.com/blog/1154315     Log4cpp配置文件格式说明   log4cpp有3个主要的组件:categories(类别).append ...

  8. Log4cpp 使用手册

    参考资料: log4cpp 配置 与 使用http://www.cnblogs.com/welkinwalker/archive/2011/06/23/2088197.html 便利的开发工具-log ...

  9. Log4cpp介绍及使用

    Log4cpp是一个开源的C++类库,它提供了在C++程序中使用日志和跟踪调试的功能.使用log4cpp,可以很便利地将日志或者跟踪调试信息写入字符流.内存字符串队列.文件.回滚文件.调试器.Wind ...

随机推荐

  1. poj2186 强连通缩点

    Popular Cows Time Limit: 2000MS   Memory Limit: 65536K Total Submissions: 29773   Accepted: 12080 De ...

  2. WebApi服务Uri加密及验证的两种方式

    最近的一个项目要求服务端与UI层分离,业务层以WebApi方式向外提供所有业务服务,服务在数据保密性方面提出了要求,主要包括: 1:客户端认证: 2:服务请求超时(默认5分钟): 3:服务Get请求的 ...

  3. SPDY 是什么?如何部署 SPDY?

    摘要:当老迈的 HTTP 协议逐渐不能满足人们需求的时候,Google 的 SPDY 协议出现在面前,那么这个长期以来一直被认为是 HTTP 2.0 唯一可行选择的 SPDY 是什么呢?当下我们如何能 ...

  4. C# JSon转换

    1. 先添加System.Web.Extensions.dll引用   var js = new System.Web.Script.Serialization.JavaScriptSerialize ...

  5. linux定时器(crontab)实例

    linux实验示例----实现每2分钟将“/etc”下面的文件打包存储到“/usr/lobal”目录下 ·Step1:编辑当前用户的crontab并保存终端输入:>crontab -u root ...

  6. Hibernate 执行原始SQL语句

    在hibernate中有时不需要用到表的映射,需要直接执行SQL语句. 其中sessionFactory在配置文件中配置,SSH详细配置见http://blog.csdn.NET/xumengxing ...

  7. js-this的用法,来自阮一峰老师的文章

    1. 随着函数使用场合的不同,this的值会发生变化.但是有一个总的原则,那就是this指的是,调用函数的那个对象. 或者说,this指向当前执行的函数的所有者. 2.情况一:纯粹的函数调用 这是函数 ...

  8. 【codevs1043】 方格取数

    http://codevs.cn/problem/1043/ (题目链接) 题意 N*N的方格,每个格子中有一个数,寻找从(1,1)走到(N,N)的两条路径,使得取到的数的和最大. Solution ...

  9. 【bzoj3884】 上帝与集合的正确用法

    http://www.lydsy.com/JudgeOnline/problem.php?id=3884 (题目链接) 题意 求 Solution 解决的关键: 当${n>φ(p)}$,有$${ ...

  10. bzoj2765[JLOI2010]铁人双项比赛

    题意:铁人双项比赛由长跑和骑自行车组成,参赛选手必须先完成k公里的长跑,然后完成r公里的骑车,才能到达终点.参赛选手有的擅长长跑,有的擅长骑车. 如果总赛程s=k+r一定,那么K越大,对擅长长跑的选手 ...