【转】 log4cpp 的使用

时间:2022-10-14 21:59:01

【转自】 http://sogo6.iteye.com/blog/1154315     Log4cpp配置文件格式说明

 
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:

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(),有

开发运行时,设为 DEBUG 级,而正式运营时,则设为 NOTICE ; 
一定要显示出来的信息则可以用 NOTICE 或以上级别; 
跟踪函数运行痕迹的信息用 INFO 级别; 
运行时调试的信息用 DEBUG 级别; 

举例说明

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 : 回滚文件输出,对多个日志文件0,..., n-1,依次记录满后,回滚至第0个文件开始记录。 
现在看一个 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" 

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 

再看一个 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
配置的知识就差不多了,现在看看实际代码应用 
首先是初始化 log4cpp 的配置,例如我的配置文件名是 log4cpp.properties 
 
 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");

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

转载文章: 
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. Log4cpp配置文件格式说明

    Log4cpp配置文件格式说明 博客分类: log4cpp log4cpp  log4cpp有3个主要的组件:categories(类别).appenders(附加目的地).和 layouts(布局) ...

  2. Log4cpp介绍及使用

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

  3. 快速使用Log4Cpp

    封了一下接口,快速使用. 其他的你都不用管了. 这里封装了需要读取外部conf文件配置输出项.否则可以用getInstance初始化日志类 #include "L4Cpp.h" v ...

  4. 【转】Log4cpp 封装

    [转自]http://blog.csdn.net/ylioi/article/details/9049591 这篇文章对Log4cpp使用了宏定义和类进行封装,非常有借鉴意义. log4cpp 是参考 ...

  5. 自定义Log4cpp的日志输出格式

    // 1. 实例化一个PatternLayout对象 log4cpp::PatternLayout* pLayout = new log4cpp::PatternLayout(); // 2. 实例化 ...

  6. log4cpp的初步使用

    (1)下载log4cpp的工程,编译生成lib文件和dll库 下载路径为:http://sourceforge.net/projects/log4cpp/files/latest/download 如 ...

  7. log4cpp日志不能是溶液子体积

     我们的项目用途log4cpp由于日志输出模块,但在使用中发现,假设Services,或者是在Windows Server版本号.不会有一个正常的日志切削现象.该日志已被写入到文件中,持续,即使超 ...

  8. log4cpp退出时内存泄露的修复方案

    1.缘由 一直对log4cpp非常有好感,就在自己的项目中集成了log4cpp1.1.1版本,并围绕着它建立了一系列的封装函数方便外部调用.写完了一个测试代码后,忽然想看看自己写的程序有没有内存泄露问 ...

  9. Log4Cpp的使用&lpar;转&rpar;

    本文介绍如何使用Log4CPP. Log4Cpp介绍 Log4Cpp的Api接口可以在http://log4cpp.sourceforge.net/api/index.html中查询得到. Log4C ...

随机推荐

  1. python 之redis

    redis是一个key-value存储系统,与memcached类似,它支持存储到value类型相对更多,包括string(字符串),list(列表),set(集合),zset(sorted set ...

  2. HTML5-Video &amp&semi; Audio

    <!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <title&g ...

  3. PHP利用socket&lowbar;bind函数切换IP地址采集数据

    在利用PHP进行数据采集的过程中,通常会遇到IP被屏蔽或出现验证码的情况:为了能够继续采集,我们需要切换不同的ip,每访问一次,随机切换一个IP.当然也可以通过收集大量代理,通过切换代理的方式进行采集 ...

  4. c&plus;&plus; 10

    一.二叉树 1.基本特征 1)树型结构的最简模型,每个节点最多有两个子节点--左子节点和右子节点. 2)单根性,每个子节点有且仅有一个父节点,整棵树有且仅有一个根节点. 3)递归性,以任何一个节点为根 ...

  5. 关于hasnextLine&lpar;&rpar;方法的一些理解

    以前对于hasnextline的理解就是 :判断是否有下一个值 今天发现了个特例,它竟然是个阻塞式的方法 看下面一个案例 这是服务器 package Service; import java.io.I ...

  6. 信步漫谈之Jenkins&mdash&semi;集成环境搭建

    一.环境准备 1)Jenkins 部署 WAR 包:jenkins.war(2.164.2 版本,WAR 包官方下载路径:https://jenkins.io/download/)2)Tomcat 服 ...

  7. django rest framework serializer中获取request中user方法

    views.py   serializer = self.get_serializer(data=request.data, context={'request': request}) seriali ...

  8. for循环以及数据类型

    一.for循环(迭代式循环) 了解:当我们在写代码时,如果代码是纯运算的代码,会占用大量的CPU,如果是I/O代码,则不会占用CPU. for i in range(10):  #可以是任意类型(字符 ...

  9. 变长编码表 ASCII代码等长编码

    小结: 1.ASCII编码.GBK编码不是变长编码: 2.数据压缩: 示例: aabacdab → 00100110111010 → |0|0|10|0|110|111|0|10| → aabacda ...

  10. 【题解】Luogu P2605 &lbrack;ZJOI2010&rsqb;基站选址

    原题传送门:P2604 [ZJOI2010]基站选址 看一眼题目,变知道这题一定是dp 设f[i][j]表示在第i个村庄修建第j个基站且不考虑i+1~n个村庄的最小费用 可以得出f[i][j] = M ...