Log4cxx配置文件介绍

Log4cxx配置由三个重要的组件构成：日志信息的优先级，日志信息的输出目的地，日志信息的输出格式。

1.日志信息的优先级

Logger的语法：

log4j.rootLogger = [ level ] , appenderName, appenderName, …

 

其中，level 是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。

Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。

通过在这里定义的级别，可以控制到应用程序中相应级别的日志信息的开关。

比如这里定义了INFO级别，则应用程序中所有DEBUG级别的日志信息将不被打印出来。 

appenderName名字任意，用来标示日志信息输出到哪里，可以同时指定多个日志信息的输出目的地 。

 

Appender的语法：

log4j.appender.appenderName = fully.qualified.name.of.appender.class

log4j.appender.appenderName.option1 = value1

…

log4j.appender.appenderName.option = valueN

 

其中，Log4j提供的appender有以下几种：

org.apache.log4j.ConsoleAppender 控制台

org.apache.log4j.FileAppender 文件

org.apache.log4j.DailyRollingFileAppender 每天产生一个日志文件

org.apache.log4j.RollingFileAppender 文件大小到达指定尺寸的时候产生一个新的文件

org.apache.log4j.WriterAppender 将日志信息以流格式发送到任意指定的地方

 

2.日志信息的输出格式

Layout的语法：

log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class

log4j.appender.appenderName.layout.option1 = value1

…

log4j.appender.appenderName.layout.option = valueN

 

3.Log4j提供的Layout有以下几种：

org.apache.log4j.HTMLLayout 以HTML表格形式布局

org.apache.log4j.PatternLayout 可以灵活地指定布局模式

org.apache.log4j.SimpleLayout 包含日志信息的级别和信息字符串

org.apache.log4j.TTCCLayout 包含日志产生的时间、线程、类别等等信息

 

Log4j采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下：

%m 输出代码中指定的消息

%p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL

%r 输出自应用启动到输出该log信息耗费的毫秒数

%c 输出所属的类目，通常就是所在类的全名

%t 输出产生该日志事件的线程名

%n 输出一个回车换行符，Windows平台为“\r\n”，Unix平台为“\n” 

 

4. 例子：

# 设置root logger为DEBUG级别，使用了ca和fa两个Appender

log4j.rootLogger=DEBUG, ca, fa

 

#对Appender fa进行设置：

# 这是一个文件类型的Appender，

# 其输出文件（File）为./output.log，

# 输出方式（Append）为覆盖方式，

# 输出格式（layout）为PatternLayout

log4j.appender.fa=org.apache.log4j.FileAppender 

log4j.appender.fa.File=./output.log

log4j.appender.fa.Append=false

log4j.appender.fa.layout=org.apache.log4j.PatternLayout 

log4j.appender.fa.layout.ConversionPattern=%d [%t] %-5p %.16c - %m%n

 

#对Appender ca进行设置：

# 这是一个控制台类型的Appender

#  输出格式（layout）为PatternLayout

log4j.appender.ca=org.apache.log4j.ConsoleAppender 

log4j.appender.ca.layout=org.apache.log4j.PatternLayout 

log4j.appender.ca.layout.ConversionPattern=%d [%t] %-5p %.16c - %m%n