Log4cpp 配置文件格式说明

https://www.cnblogs.com/diegodu/p/6100804.html

 

log4cpp有3个主要的组件：categories（类别）、appenders（附加目的地）、和 layouts（布局）

 

log4cpp当前提供以下layout格式： 

log4cpp::BasicLayout // 以“时间戳 优先级（priority，下文介绍） 类别（category，下文介绍）  NDC标签 

log4cpp::PatternLayout // 让用户根据类似于 C 语言 printf 函数的转换模式来指定输出格式。 

log4cpp::SimpleLayout // 以“优先级（priority） - 日志信息”格式显示。 

 

log4cpp当前提供以下appender：          

    log4cpp::IdsaAppender // 发送到IDS或者logger,  

    log4cpp::FileAppender // 输出到文件  

    log4cpp::RollingFileAppender // 输出到回卷文件，即当文件到达某个大小后回卷  

    log4cpp::OstreamAppender // 输出到一个ostream类  

    log4cpp::RemoteSyslogAppender // 输出到远程syslog服务器  

    log4cpp::StringQueueAppender // 内存队列  

    log4cpp::SyslogAppender // 本地syslog  

    log4cpp::Win32DebugAppender // 发送到缺省系统调试器  

    log4cpp::NTEventLogAppender // 发送到win 事件日志  

 

优先级：

当消息的优先级大于等于category的优先级时，这个消息才会被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 的 category 分为 rootCategory 和其它自定义的 category。而每个 category 都可以输出到多个 appender。并且 category 也是有包含关系的。 

rootCategory 就是所有 category 的根。而自定义的 category 也可以在配置文件中定义其包含关系。 

例子：

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 中。 

 

ConsoleAppender 的例子 

log4cpp.appender.console=ConsoleAppender 

log4cpp.appender.console.layout=PatternLayout 

log4cpp.appender.console.layout.ConversionPattern=%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 

 

完整例子：

#定义 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 ? 

 

代码使用配置文件：

try  { 
  log4cpp::PropertyConfigurator::configure("log4cpp.properties");  
} catch (log4cpp::ConfigureFailure & f)  {  
  std::cerr << "configure problem " << f.what() << std::endl;  
}  

初始化完成后，就可以这样用了

log4cpp::Category & log = log4cpp::Category::getInstance(std::string("sample"));  
log.debug("test debug log");  
log.info("test info log");  
 

// 用 sample.son  
log4cpp::Category & log = log4cpp::Category::getInstance(std::string("sample.son"));  
log.debug("test debug log of son");  
log.info("test info log of son");  


// 用 sample.daughter  
log4cpp::Category & log = log4cpp::Category::getInstance(std::string("sample.daughter"));  

log.debug("test debug log of daughter");  
log.info("test info log of daughter");