1.Log4cpp使⽤

Log4cpp中主要包含Category(种类)，Appender(附加器)，Layout(布局)，Priorty(优先级)，NDC(嵌套的诊断上下⽂)。

Category、Appender与Layout三者的关系如下图:

2.安装

官网地址:https://sourceforge.net/projects/log4cpp/files/latest/downloa

解压：

tar zxf log4cpp-1.1.3.tar.gz

编译：

cd log4cpp

./configure

make

make check

sudo make install

sudo ldconfig

默认安装路径：

头⽂件：/usr/local/include/log4cpp

库⽂件：/usr/local/lib/liblog4cpp

测试范例

使⽤log4cpp的基本步骤如下：

1.实例化一个layout对象

2.初始化一个appender对象

3.把layout对象附着在appender对象

4.调用log4cpp::Category::getInstance("name")。实例化一个category对象；

5.把appender对象附加到category上，根据additivity的值取代其它appender或附加在其它appender后。

6.设置category的优先级

简单来说，上面存在这样一种关系:

layout-->appender-->category

#include "log4cpp/Category.hh"#include "log4cpp/FileAppender.hh"#include "log4cpp/BasicLayout.hint main(int argc,char *argv[]){// 1实例化⼀个layout 对象 log4cpp::Layout *layout = new log4cpp::BasicLayout(); //2. 初始化⼀个appender 对象log4cpp::Appender *appender = new log4cpp::FileAppender("FileAppender", "./test_log4cpp1.log"); // 3. 把layout对象附着在appender对象上 appender->setLayout(layout); //4. 实例化⼀个category对象 log4cpp::Category &warn_log = log4cpp::Category::getInstance("qaa"); //5. 设置additivity为false，替换已有的appender warn_log.setAdditivity(false); //6 把appender对象附到category上 warn_log.setAppender(appender); //设置category的优先级，低于此优先级的⽇志不被记录 warn_log.setPriority(log4cpp::Priority::WARN); //记录⼀些⽇志 warn_log.info("Program info which cannot be wirten"); warn_log.debug("This debug message will fail to write"); warn_log.alert("Alert info"); //其他记录⽇志⽅式 warn_log.log(log4cpp::Priority::WARN, "This will be a logged warning"); log4cpp::Priority::PriorityLevel priority; bool this_is_critical = true; if (this_is_critical) priority = log4cpp::Priority::CRIT; else priority = log4cpp::Priority::DEBUG; warn_log.log(priority, "Importance depends on context"); warn_log.critStream()<<"This will show up << as"<<1<<"critical message"; // clean up and flush all appenders log4cpp::Category::shutdown(); return 0;}

编译:g++ -o test_log4cpp1 test_log4cpp1.cpp -llog4cpp -lpthread

配置⽂件使用步骤

基本步骤:

1.读取解析配置文件。

2.实例化category对象。

3.正常使用这些category对象进行日志处理。

# ⽂件名: test_log4cpp2.conf# a simple test config#定义了3个category sub1, sub2, sub1.sub2log4j.rootCategory=DEBUG, rootAppenderlog4j.category.sub1=A1log4j.category.sub2=INFOlog4j.category.sub1.sub2=ERROR, A2# 设置sub1.sub2 的additivity属性log4j.additivity.sub1.sub2=false#定义rootAppender类型和layout属性log4j.appender.rootAppender=org.apache.log4j.ConsoleAppenderlog4j.appender.rootAppender.layout=org.apache.log4j.BasicLayout#定义A1的属性log4j.appender.A1=org.apache.log4j.FileAppenderlog4j.appender.A1.fileName=A1.loglog4j.appender.A1.layout=org.apache.log4j.SimpleLayout#定义A2的属性log4j.appender.A2=org.apache.log4j.ConsoleAppenderlog4j.appender.A2.layout=org.apache.log4j.PatternLayout#log4j.appender.A2.layout.ConversionPattern=The message '%m' at time%d%nlog4j.appender.A2.layout.ConversionPattern=%d %m %n// FileName: test_log4cpp2.cpp // Test log4cpp by config file. #include "log4cpp/Category.hh" #include "log4cpp/PropertyConfigurator.hh" int main(int argc, char *argv[]) { //1 读取解析配置⽂件 // 读取出错, 完全可以忽略，可以定义⼀个缺省策略或者使⽤系统缺省策略 // BasicLayout输出所有优先级⽇志到ConsoleAppender try{ log4cpp::PropertyConfigurator::configure(("./test_log4cpp2.conf"); }catch(log4cpp::ConfigureFailure& f){ std::cout << "Configure Problem " <<f.what()<<std::endl; return -1; } // 2 实例化category对象 // 这些对象即使配置⽂件没有定义也可以使⽤，不过其属性继承其⽗category// 通常使⽤引⽤可能不太⽅便，可以使⽤指针，以后做指针使⽤ // log4cpp::Category* root = &log4cpp::Category::getRoot(); log4cpp::Category& root = log4cpp::Category::getRoot() ; log4cpp::Category& sub1 = log4cpp::Category::getInstance(std::string("sub1")); log4cpp::Category& sub3 = log4cpp::Category::getInstance(std::string("sub1.sub2")); // 3 正常使⽤这些category对象进⾏⽇志处理。 // sub1 has appender A1 and rootappender. sub1.info("This is some info"); sub1.alert("A warning"); // sub3 only have A2 appender. sub3.debug("This debug message will fail to write"); sub3.alert("All hands abandon ship"); sub3.critStream() << "This will show up << as " << 1 << " critical message"; sub3 << log4cpp::Priority::ERROR << "And this will be an error";sub3.log(log4cpp::Priority::WARN, "This will be a logged warning"); return 0; }

编译：g++ -o test_log4cpp2 test_log4cpp2.cpp -llog4cpp -lpthread

Category类

这个是归类的意思，具有树型结构，将日志按"区域"划分。Log4cpp有且只⼀个根Category，可以有多个子Category组成树型结构。Category具有Priority、additivity属性与若干方法。下面列出所有的属性与常用方法。

属性：Name

Category的名称。不可重复。

相关⽅法

virtual const std::string& getName() const throw();

属性：Priority

⽇志的优先级

对于根Category，必须指定Priority。(priority < Priority::NOTSET)

对于⾮根Category，可以不指定Priority，此时优先级继承⾃⽗Category。

对于⾮根Category，也可以指定Priority，此时优先级覆盖⽗Category的优先级。

//设置当前Category的优先级virtual void setPriority(Priority::Value priority);//获取当前对象的优先级virtual Priority::Value getPriority() const throw();// 设置root Category的优先级static void setRootPriority(Priority::Value priority);// 获取root Category的优先级static Priority::Value getRootPriority() throw();//获取当前category继承表中的优先级，如果当前的优先值没有设置的话，则找他的父亲。//如果父亲没有找到的话，他会继续向上找，因为root Category的优先值默认为Priority::INFO//所以肯定能找到virtual Priority::Value getChainedPriority() const throw();// 返回当前拥有priority优先级virtual bool isPriorityEnabled(Priority::Value priority) const throw();

属性：additivity

每个Category都有一个additivity属性，该属性默认值为true。

如果值为true，则该Category的Appender包含了父Category的Appender。

如果值为false，则该Category的Appender取代了父Category的Appender。

相关⽅法

virtual void setAdditivity(bool additivity);

virtual bool getAdditivity() const throw();

属性：parent

上级Category。根Category的parent为空。

相关⽅法

virtual Category* getParent() throw();

virtual const Category* getParent() const throw();

⽅法：getRoot

静态⽅法。取得根Category。

static Category& getRoot();

⽅法：getInstance

静态⽅法。取得指定名称（参数name）的Category，如果不存在，则⾃动创建⼀个以name命名，parent为rootCategory，Priority为INFO的Category（说⽩了就是⼀个⼯⼚⽅法，不要和单例模式混了）。

static Category& getInstance(const std::string& name);

⽅法：exists

静态⽅法。判断是否存在指定名称（参数name）的Category。如果存在，则返回相应的Category（指针），否则返回空指针。

static Category* exists(const std::string& name);

⽅法：shutdownForced

静态⽅法。从所有的Category中移除所有的Appender，并且删除所有的Appender。(shutdown⽅法只是不使用Appender，并没有彻底从内存中销毁Appender)。

static void shutdownForced();

⽅法：Appender相关

//添加⼀个Appender到Category中。// 该⽅法将把Appender的所有权交给Category管理virtual void addAppender(Appender* appender);// 添加⼀个Appender到Category中。// 但是该⽅法并不把Appender的所有权交给Category管理virtual void addAppender(Appender& appender);// 获取指定名字的Appender（指针）。如果不存在则返回空指针virtual Appender* getAppender(const std::string& name) const;// 获取所有的Appender，以指针的⽅式存储在set中virtual AppenderSet getAllAppenders() const;// 删除所有的Appendervirtual void removeAllAppenders();// 删除指定的Appendervirtual void removeAppender(Appender* appender);// 判断指定Appender是否被当前Category拥有所有权。如果是的话，在删除该Appender时，将同时销毁它。virtual bool ownsAppender(Appender* appender) const throw();

使⽤virtual void addAppender(Appender* appender);⽅法时，Category会接管appender的所有权，并确保会在**的时机销毁它，所以不要再在外⾯调⽤delete⽅法去销毁它。所以不要轻易删除。

如下面代码:

log4cpp::Appender*appender = new log4cpp::OstreamAppender("default", &std::cout);root.addAppender(appender);delete appender; // Error! Don't delete it

⽅法：⽇志相关

Category的⽇志输出⽅式有两种，⼀种是简单的传递std::string类型的字符串，⼀种是采⽤类似c api中的printf，可以格式化⽣成字符串。

// 以指定的优先级⽣成⽇志virtual void log(Priority::Value priority,const std::string& message) throw();//以指定的优先级与格式化⽣成⽇志，类似c api中的printf⽅法virtual void log(Priority::Value priority, const char* stringFormat,...) throw();// 格式化⽣成⽇志的⼀种变体，直接传递va_list参数virtual void logva(Priority::Value priority, const char* stringFormat,va_list va) throw();//除了以上三种通⽤⽇志三种⽅法外，Log4cpp还指供了多种预定义Priority的⽅法，如：void debug(const char* stringFormat, ...) throw();void info(const char* stringFormat, ...) throw();.....

例⼦：

log4cpp::Category& rootCategory = log4cpp::Category::getRoot();

rootCategory.error("This is error message\n");

rootCategory.log(log4cpp::Priority::DEBUG, "This is %d message\n", 8);

⽅法： CategoryStream

每个CategoryStream对象封装⼀种优先级的⽇志输出，并提供了对“<<”符号的重载函数。CategoryStream对象内部借由std::ostringstream来实现流式格式化输出⽣成⽇志消息(std::string)。

// 获取（⽣成）指定优先级的CategoryStreamvirtual CategoryStream getStream(Priority::Value priority);// 对运算符“<<”的重载。也是获取（⽣成）指定优先级的CategoryStreamvirtual CategoryStream operator<<(Priority::Value priority);// 快捷⽅法。还有infoStram()等预定义优先级的快捷⽅法。inline CategoryStream debugStream();.....

CategoryStream只是作为临时对象，总在对象销毁时才会正真将日志输出(flush)。可以强制调用CategoryStream的flush方法，这样会不利于阅读，日志代码应该跟实际业务无关，代码行尽可能少，随时可以屏蔽日志功能。

例⼦：

log4cpp::Category& root = log4cpp::Category::getRoot();

root << log4cpp::Priority::ERROR << "This is error message";

root.debugStream() << "This is " << 8 << " message";

Appender类

Appender负责把日志写入相应设备，如控制台，文件，调试器，windows日志，syslog等。

比如下面输出到文件系统中。

FileAppender

作⽤：输出到⽂件系统。

构造函数：

FileAppender(const std::string& name, const std::string& fileName,bool append = true, mode_t mode = 00644);

DailyRollingFileAppender

功能:

一种特例化的FileApppender，⽂件系统以天为单位进⾏管理，当⽣成⽇志时的⽇期发⽣变化时，将会⽣成新的⽇志⽂件。

构造函数：

DailyRollingFileAppender(const std::string& name,const std::string& fileName,unsigned int maxDaysToKeep = maxDaysToKeepDefault,bool append = true,mode_t mode = 00644);

OstreamAppender

作用:输出到指定流，需要指定std:ostream对象，可以是std::cout或std::cerr或其它派生自std::ostream的流对象。

构造函数:OstreamAppender(const std::string& name, std::ostream* stream);

例子:

log4cpp::OstreamAppender * osAppender = new log4cpp::OstreamAppender("osAppender",&std::cout);

RemoteSyslogAppender

作⽤：输出到远程syslog系统。

构造函数：

RemoteSyslogAppender(const std::string& name,

const std::string& syslogName,

const std::string& relayer,

int facility = LOG_USER,

int portNumber = 514);

相关参数：

SmptAppender

作⽤：通过**tp协议发送到指定邮箱。

构造函数：

SmptAppender(const std::string& name, const std::string& host, const std::string& from,const std::string& to, const std::string& subject);

相关参数：

StringQueueAppender

作⽤：输出到内存/字符串队列。

构造函数：StringQueueAppender(const std::string& name);

相关参数：

SyslogAppender

作⽤：输出到本地syslog系统。

相关参数：

SyslogAppender(const std::string& name, const std::string& syslogName,int facility = LOG_USER);

BufferingAppender

作⽤：输出到缓存队列

Win32DebugAppender

作⽤：输出到Windows缺省调试器。

IdsaAppender

作⽤：输出到Idsa服务。

NTEventLogAppender

输出到Windows⽇志系统

Layout类

Layout控制输出⽇志的显示样式。Log4cpp内置了4种Layout。

PassThroughLayout

没有布局的“布局”，你让它写什么它就写什么，它不会为你添加任何东⻄，连换⾏符都懒得为你加。

SimpleLayout

简单布局。只有简单优先级输出，相当于PatternLayout格式化为：“%p: %m%n”。

BasicLayout

基本布局。添加“时间”、“优先级”、“种类”、“NDC”。相当于PatternLayout格式化“%R %p %c %x: %m%n”

PatternLayout

格式化布局。它的使⽤⽅式类似C语⾔中的printf，使⽤格式化它符串来描述输出格式。⽬前⽀持的转义定义如下：

%% - 转义字符'%'

%c - Category

%d - ⽇期，如%d{%H:%M:%S,%l}。⽇期的格式符号与ANSI C函数strftime中的⼀致。但**了⼀个格式符号%l，表示毫秒，占三个⼗进制位。

%m - 消息

%n - 换⾏符；会根据平台的不同⽽不同，但对⽤户透明。

%p - 优先级

%r - ⾃从layout被创建后的毫秒数

%R - 从1970年1⽉1⽇开始到⽬前为⽌的秒数

%u - **开始到⽬前为⽌的时钟周期数

%x - NDC

%t - 线程id

Priority优先级

⽇志的优先级。Log4cpp内置了10种优先级。

typedef enum {EMERG = 0,FATAL = 0,ALERT = 100,CRIT = 200,ERROR = 300,WARN = 400,NOTICE = 500,INFO = 600,DEBUG = 700,NOTSET = 800} PriorityLevel;

取值越⼩，优先级越⾼。如⼀个Category的优先级为INFO(600)，则包括EMEGR、FATAL、ALERT、CRIT、ERROR、WARN、INFO等⼩于或等于600的⽇志都会被输出，⽽DEBUG等⼤于600的⽇志则不会被输出。

注意:优先级是⼀个整数，不⼀定要只取上⾯的预定义值，⽐如说101也是可以。对于根Category，优先级不能⼤于或等于NOTSET(800)。

NDC

NDC是以线程为基础的，每个线程拥有且只有⼀个NDC。NDC的⼏个常⽤⽅法是push、pop、get、clear。

Push：把⼀个字符串压⼊NDC栈。

Pop：从NDC栈中退出上⼀次压⼊的字符串。

Get：取得当前NDC栈中的字符串，每次压⼊的字符串⽤空格隔开。

Clear：清空NDC栈中的字符串。

NDC⽤法可以在每个函数⼊⼝处调⽤NDC::push(__FUNCTION__); 在函数出⼝处调⽤NDC::pop(); 在PatternLayout中指定%x参数。这样就可以在⽇志中清晰的知道函数的调⽤情况。

这篇文章就**到这里，欢迎关注，转发，点赞，收藏。