Log4j.properties配置

 

一、配置log4j的基本流程

1、为工程配置依赖

加入log4j-1.2.8.jar(可以选择log4j的更高版本)到lib下。

如果使用maven项目，也可以选择在pom.xml中新增依赖：

<!-- 加入log4j支持 -->

<dependency>

<groupId>log4j</groupId>

<artifactId>log4j</artifactId>

<version>1.2.17</version>

</dependency>

 

2、在CLASSPATH下建立log4j.properties。内容如下：修改其参数为你所需要的 

### 设置###
log4j.rootLogger=debug,stdout,R

### 输出信息到控制台 ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n
 
### 输出DEBUG 级别以上的日志到=E://Logs/log.log（每天产生一个日志文件） ###
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
log4j.appender.R.File=E://Logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss,SSS} applicationName[%-5p] - method:%l%n message:%m%n
 
### 输出ERROR 级别以上的日志到=E://logs/error.log（每天产生一个日志文件）###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =E://Logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n



log4j.logger.com.neusoft=DEBUG
log4j.logger.com.opensymphony.oscache=ERROR
log4j.logger.net.sf.navigator=ERROR
log4j.logger.org.apache.commons=ERROR
log4j.logger.org.apache.struts=WARN
log4j.logger.org.displaytag=ERROR
log4j.logger.org.springframework=DEBUG
log4j.logger.com.ibatis.db=WARN
log4j.logger.org.apache.velocity=FATAL
 
log4j.logger.com.canoo.webtest=WARN
 
log4j.logger.org.hibernate.ps.PreparedStatementCache=WARN
log4j.logger.org.hibernate=DEBUG
log4j.logger.org.logicalcobwebs=WARN

3、在要输出日志的类中加入相关语句：

定义属性：static Logger logger = Logger.getLogger(LogDemo.class); //LogDemo为相关的类

在相应的方法中：

if (logger.isDebugEnabled()){

logger.debug(“System …..”);

}

 

二、log4j.properties参数的配置介绍

1、配置根Logger：

log4j.rootLogger = [ level ] , appenderName1, appenderName2, …（默认输出目的地，当前端传入类名）

level ：设定日志记录的最低级别，可设的值有OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别，Log4j建议只使用四个级别，优先级从高到低分别是 ERROR、WARN、INFO、DEBUG。通过在这里设定级别，您可以控制应用程序中相应级别的日志信息的开关。

比如配置OFF则不打出任何信息，如果在这里设定了INFO级别，则应用程序中所有DEBUG级别的日志信息将不会被打印出来。

日志输出 级别
FATAL    0  
ERROR    3  
WARN     4  
INFO     6  
DEBUG    7 

appenderName：就是指定日志信息要输出到哪里。可以同时指定多个输出目的地，用逗号隔开。

例如：log4j.rootLogger＝INFO,A1,B2,C3

 

2、配置日志信息输出目的地（appender）：

log4j.appender.[appenderName] = className

appenderName：自定义appderName，在log4j.rootLogger设置中使用；
className：可设值如下：
(1)org.apache.log4j.ConsoleAppender（控制台）
(2)org.apache.log4j.FileAppender（文件）
(3)org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件）
(4)org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）
(5)org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

 

3、配置日志信息的格式Layout

log4j.appender.[appenderName] .layout = Layout

Layout:
org.apache.log4j.HTMLLayout（以HTML表格形式布局），
org.apache.log4j.PatternLayout（可以灵活地指定布局模式）推荐使用，
org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息)

 

3.1使用pattern布局就要指定打印信息的具体格式ConversionPattern

log4j.appender.stdout.layout.ConversionPattern= [QC] %p [%t] %C.%M(%L) | %m%n

打印参数如下：
[QC]是log信息的开头，可以为任意字符，一般为项目简称。

参数	含义
%p	输出日志信息的优先级，即DEBUG，INFO，WARN，ERROR，FATAL
%d	输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，如：%d{yyyy/MM/dd HH:mm:ss,SSS}
%l	输出日志事件的发生位置，相当于%c.%M(%F:%L)的组合，包括类全名、方法、文件名以及在代码中的行数。例如：test.TestLog4j.main(TestLog4j.java:10)
%m	输出代码中指定的具体日志信息（日志内容）
%X	用于输出与生成日志事件的线程关联的MDC(映射诊断上下文)。必须在X转换字符后面加上位于大括号之间的映射键，比如在%X{clientNumber}中，clientNumber是键。与密钥对应的MDC中的值将被输出。 有关更多细节，请参阅MDC类。如：%X{value}
%c	输出日志信息所属的类目，通常就是所在类的全名
%M	输出产生日志信息的方法名
%F	输出日志消息产生时所在的文件名称
%L	输出代码中的行号
%r	输出自应用程序启动到输出该log信息耗费的毫秒数
%n	输出一个回车换行符，Windows平台为"rn"，Unix平台为"n"
%x	输出和当前线程相关联的NDC(嵌套诊断环境)，尤其用到像java servlets这样的多客户多线程的应用中
%%	输出一个"%"字符
%t	输出产生该日志事件的线程名

另外，还可以在%与格式字符之间加上修饰符来控制其最小长度、最大长度、和文本的对齐方式。如：
1) c：指定输出category的名称，最小的长度是20，如果category的名称长度小于20的话，默认的情况下右对齐。
2)%-20c："-"号表示左对齐。
3)%.30c：指定输出category的名称，最大的长度是30，如果category的名称长度大于30的话，就会将左边多出的字符截掉，但小于30的话也不会补空格。

输出的信息
[TS] DEBUG [main] AbstractBeanFactory.getBean(189) | Returning cached instance of singleton bean 'MyAutoProxy'

举例：

%d{yyyy-MM-dd HH:mm:ss,SSS} applicationName[%-5p] - method:%l%n message:%m%n

2018-10-14 18:22:50,192 applicationName[ERROR] - method:com.demo.Log4jDemo1.main(Log4jDemo1.java:23)  message:java.lang.ArithmeticException: / by zero

 

4、将Log信息输出到文件

log4j.appender.[appenderName].File = E://Logs/log.log

 

5、Log4j Threshold属性指定输出等级

log4j.appender.[appenderName].Threshold = Level

Level: OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL
有时候我们需要把一些报错ERROR日志单独存到指定文件，这时候，Threshold属性就派上用场了；
Threshold属性可以指定日志level 
比如我们指定某个appender的Threshold为WARN，那这个appender输出的日志信息就是WARN级别以及WARN以上的级别； 
假如我们指定的是ERROR，那这个就输出ERROR或者FATAL日志信息；
当然这里有个前提：rootLogger里配置的level比如小于Threshold层级  否则无效 还是按照总的rootLogger里的level来输出，一般我们实际实用的话 rootLogger里配置DEBUG，然后某个文件专门存储ERRO日志，就配置下Threshold为ERROR，这个就是我们的最佳实践.

 

6、Log4j Append属性指定是否追加内容

log4j.appender.[appenderName].Append = true

Log4j默认是不断的把日志内容追加到日志文件；
这里就有个属性 Append 默认就是true；
假如我们设置成false 就不追加了 直接覆盖前面的内容；