log4cxx有三个主要组件:loggers(记录器),appenders(输出源)和layout(布局)。可以简单理解为日志类别,要输出的地方,输出形式。
Logger
创建Logger
Logger是有一个String类的名字识别的,且大小写敏感。
root logger是所有logger的祖先,是一直存在的, 通过Logger.getRootLogger()获得,并且不能通过名字获得。
在配置文件上:
log4j.logger.test=INFO,fa
log4j.appender.fa=org.apache.log4j.RollingFileAppender
在代码上
public static Logger Logger.getLogger(String name) 获得Logger
此时配置文件的“test”要和getLogger的参数name保持一致。
如:LoggerPtr m_logger = log4cxx::Logger::getLogger("test");
或者是
配置文件上:log4j.rootLogger=Debug,fa
log4j.appender.fa=org.apache.log4j.RollingFileAppender
在使用代码是:LoggerPtr m_logger = log4cxx::Logger::getLogger("test");
此时在代码上getLogger的参数name可自定义,如自定义为“test”
Logger的日志级别
每个logger都被分配了一个日志级别(log level),用来控制日志信息的输出。
所有的logger level及大小关系:
Level.ALL < Level.DEBUG < Level.INFO < Level.WARN < Level.ERROR < Level.FATAL < Level.OFF
对应的函数有:LOG4CXX_TRACE、LOG4CXX_DEBUG、LOG4CXX_INFO、LOG4CXX_WARN、LOG4CXX_ERROR、LOG4CXX_FATAL
如:
CString sText;
WCHAR *wTemp = sText.GetBuffer(sText.GetLength());
int size = WideCharToMultiByte( CP_ACP, 0, wTemp, -1, NULL,0, NULL, NULL );
char *pChar = new char[size+1];
WideCharToMultiByte( CP_ACP, 0, wTemp, -1, pChar, size, NULL, NULL );
sText.ReleaseBuffer();
LOG4CXX_DEBUG(m_logger,pChar);
Appenders
允许把日志输出到不同地方,如控制台、文件等,根据天数或文件大小产生新的文件,再或者可以以流的形式发送到其他地方等。
appender常见类
org.apache.log4j.ConsoleAppender (控制台)
org.apache.log4j.FileAppender (文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender (文件大小达到指定尺寸时产生一个新的文件)
org.apache.log4j.WriterAppender (将日志信息以流格式发送到任意指定的地方)
ConsoleAppender选项
Threshold = WARN : 指定日志信息的最低输出级别,默认为DEBUG
ImmediateFlush = true : 表示所有消息都被立即输出,设为false则不输出, 默认值为true
Target = System.err : 默认值是System.out
FileAppender选项
Threshold = WARD
ImmediateFlush = true
Append = false : true表示消息增加到指定文件中,false则将消息覆盖指定的文件内容,默认值是true
File = D:/logs/logging.log4j : 指定消息输出的文件目录名
DailyRollingFileAppender选项
Threshold = WARD
ImmediateFlush = true
Append = false
File = D:/logs/logging.log4j
DatePattern = '.'yyyy-MM : 每个月生成一个新的日志文件
'.'yyyy-ww : 每周
'.'yyyy-MM-dd:每天
'.'yyyy-MM-dd-a:每天2次
'.'yyyy-MM-dd-HH:每小时
'.'yyyy-MM-dd-HH-mm : 每分钟
RollingFileAppender选项
Threshold = WARD
ImmediateFlush = true
Append = false
File = D:/logs/logging.log4j
MaxFileSize = 100KB :文件达到该大小时,会自动滚动,即将原来的内容移到logging.log4j.1文件中
MaxBackupIndex = 2 : 指定可以产生滚动文件的最大数,例如,设为2则可以产生logging.log4j.1, logging.log4j.2两个滚动文件和一个log
配置模式:
log4j.appender.appenderName = className
log4j.appender.appenderName.Option1 = value1
...
log4j.appender.appenderName.optionN = valueN
Layouts
自定义日志输出格式,log4j.appender.appenderName后附加layouts来完成。
Layouts提供四种日志输出格式:
1. HTML样式 : org.apache.log4j.HTMLLayout
2. 自由指定样式:org.apache.log4j.PatternLayout
3. 包含日志级别和信息字符串的样式: org.apache.log4j.SimpleLayout
4. 包含日志产生的时间、线程、类别等信息:org.apache.log4j.TTCCLayout
HTMLLayout选项
LocaltionInfo = true : 输出java文件名和行号,默认值是false
Title = My Logging : 默认值是Log4j Log Messages
PatternLayout选项
ConversionPattern = %m%n : 设定以怎样的格式显示消息
格式化符号说明:
%p: 输出日志信息的优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以指定格式,eg.%d{yyyy/MM/dd HH:mm:ss,SSS}。
%r: 输出自应用程序启动到输出到该log信息耗费额毫秒数
%t: 输出产生该日志事件的线程名
%l: 输出日志事件的发生位置,相当于%c.%M(%F:%L)的组合,包括类全名、方法、文件名及在代码行中的行数。
eg.test.TestLog4j.main(TestLog4j.java:10)。
%c: logger所属类的全名,最小长度是20,若名称长度小于20,默认右对齐。
%M: 输出产生日志信息的方法名
%F: 输出日志消息产生时所在的文件名称
%L: 输出代码中的行号
%m:输出logger的日志消息,eg.LOG4CXX_DEBUG(m_logger,"日志消息")
%n:输出一个回车换行符,windows平台为"\r\n",Unix平台为"\n"
%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中
%%:输出一个"%"字符
另外,还可以在%与格式字符之间加上修饰符,来控制器最小长度、最大长度、文本对齐方式。如:
1) %-20c : "-"号表示左对齐
2) %.30c : 指定%c最大长度为30,若大于30,会将左边多出来的字符截掉,但小于30也不会补空格文章来源:https://www.toymoban.com/news/detail-600660.html
配置文件例子
Log4j支持两种配置文件格式,一种是XML格式的文件,一种是properties属性文件。下面以properties属性文件,如log.properties文件文章来源地址https://www.toymoban.com/news/detail-600660.html
//增量的日志方式
log4j.rootLogger=INFO,fa
log4j.appender.fa=org.apache.log4j.RollingFileAppender
log4j.appender.fa.File=./Log/testlog.log
log4j.appender.fa.Append=true
log4j.appender.fa.MaxFileSize=1024KB
log4j.appender.fa.MaxBackupIndex=1000
log4j.appender.fa.layout=org.apache.log4j.PatternLayout
log4j.appender.fa.layout.ConversionPattern=%d %-5p %c - %m%n
每天一个日志
log4j.rootLogger=Debug,test
log4j.appender.test= org.apache.log4j.DailyRollingFileAppender
log4j.appender.test.layout= org.apache.log4j.PatternLayout
log4j.appender.test.layout.ConversionPattern= [ %d ] [%c] [ %p ]: %m %n
log4j.appender.test.File= ./logs/test.log
log4j.appender.test.DatePattern=-yyyy-MM-dd
到了这里,关于C++日志系统log4cxx的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!