对于程序员来说,日志的重要性不用多提。下面,笔者就来简单介绍下日志的使用。
其实,日志不需要配得那么复杂,主要是为了记录和找问题,而且针对不同的框架会有些特定的配置。不过,一般的日志能提供控制台输出以及日志文件也就足以。
标题中的log4j是指的1.x版本的,log4j2是指的2.x版本,具体的差异大家查下官方文档就知道啦。不过,有个比较明显的区别就是,log4j的配置一般使用属性文件,而2.x的主要使用.xml文件,包含的内容和配置差不多。
接下来,分别来介绍Log4j和Log4j2的配置:
一、Log4j的配置
1、所需jar包
log4j-1.2.17.jar
2、java代码的使用
private static Logger logger = Logger.getLogger(TestLog4j.class);
3、log4j.properties属性文件的配置
主要包含日志级别、appender、layout以及最低日志级别的配置:
#DEBUG,console,debug,info,warn,error,fatal
#log4j.rootLogger=DEBUG,console,debug,info,warn,error
#log4j.rootLogger=DEBUG,console,debug
#log4j.rootLogger=console,error,info,warning
#log4j.rootLogger=DEBUG,console,error
log4j.rootLogger=DEBUG, console, info
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%p] [%d{yyyy-MM-dd HH:mm:ss}] [ THREAD = %t | Class = %C | Method = %M | Line = %L ] | MSG = %m |%n
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.Target=System.out
log4j.appender.console.Encoding=UTF-8
log4j.logger.info=info
log4j.appender.info=org.apache.log4j.DailyRollingFileAppender
log4j.appender.info.layout=org.apache.log4j.PatternLayout
log4j.appender.info.layout.ConversionPattern=[%p] [%d{yyyy-MM-dd HH:mm:ss}] [ THREAD = %t | Class = %C | Method = %M | Line = %L ] | MSG = %m |%n
log4j.appender.info.datePattern='.'yyyy-MM-dd
log4j.appender.info.Threshold=DEBUG
log4j.appender.info.append=true
log4j.appender.info.Encoding=UTF-8
log4j.appender.info.File=${loghome}/log/web_info.log
log4j.logger.debug=debug
log4j.appender.debug=org.apache.log4j.DailyRollingFileAppender
log4j.appender.debug.layout=org.apache.log4j.PatternLayout
log4j.appender.debug.layout.ConversionPattern=[%p] [%d{yyyy-MM-dd HH:mm:ss}] [ THREAD = %t | Class = %C | Method = %M | Line = %L ] | MSG = %m |%n
log4j.appender.debug.datePattern='.'yyyy-MM-dd
log4j.appender.debug.Threshold=DEBUG
log4j.appender.debug.append=true
log4j.appender.debug.Encoding=UTF-8
log4j.appender.debug.File=${loghome}/log/web_debug.log
log4j.logger.warn=warn
log4j.appender.warn=org.apache.log4j.DailyRollingFileAppender
log4j.appender.warn.layout=org.apache.log4j.PatternLayout
log4j.appender.warn.layout.ConversionPattern=[%p] [%d{yyyy-MM-dd HH:mm:ss}] [ THREAD = %t | Class = %C | Method = %M | Line = %L ] | MSG = %m |%n
log4j.appender.warn.datePattern='.'yyyy-MM-dd
log4j.appender.warn.Threshold=WARN
log4j.appender.warn.append=true
log4j.appender.warn.Encoding=UTF-8
log4j.appender.warn.File=${loghome}/log/web_warn.log
log4j.logger.error=error
log4j.appender.error=org.apache.log4j.DailyRollingFileAppender
log4j.appender.error.layout=org.apache.log4j.PatternLayout
log4j.appender.error.layout.ConversionPattern=[%p] [%d{yyyy-MM-dd HH:mm:ss}] [ THREAD = %t | Class = %C | Method = %M | Line = %L ] | MSG = %m |%n
log4j.appender.error.datePattern='.'yyyy-MM-dd
log4j.appender.error.Threshold=ERROR
log4j.appender.error.append=true
log4j.appender.error.Encoding=UTF-8
log4j.appender.error.File=${loghome}/log/web_error.log
#The log output to the directory
loghome=logs
二、Log4j2的配置
1、所需jar包
log4j-api-2.4.1.jar、log4j-core-2.4.1.jar
2、java代码使用方式
privatestatic Logger logger = LogManager.getLogger(MyApp.class.getName());
3、日志的级别
trace
<?xml version="1.0" encoding="UTF-8"?>
<configuration status="error">
<appenders>
<!--这个输出控制台的配置-->
<Console name="STDOUT">
<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" />
<PatternLayout pattern="[%level] %d{yyyy-MM-dd HH:mm:ss} [Line %L] %class{36}.%M - %msg%xEx%n" />
</Console>
<!--文件会打印出所有信息,这个log每次运行程序会自动清空,由append属性决定;同时可以按日期目录分类,适合临时测试用-->
<File name="debug" fileName="log/${date:yyyy-MM-dd}/debug.log" append="false">
<ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="DENY"/>
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5level %class{36} %L %M - %msg%xEx%n"/>
</File>
<File name="info" fileName="log/${date:yyyy-MM-dd}/info.log" append="false">
<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5level %class{36} %L %M - %msg%xEx%n"/>
</File>
<File name="error" fileName="log/${date:yyyy-MM-dd}/error.log" append="false">
<ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/>
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5level %class{36} %L %M - %msg%xEx%n"/>
</File>
<!--这个会打印出所有的信息,每次大小超过size,则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩,作为存档-->
<RollingFile name="InfoRollingFile" fileName="logs/sys/application-info.log"
filePattern="logs/$${date:yyyy-MM}/sys/application-info-%d{MM-dd-yyyy}-%i.log.gz">
<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY" />
<PatternLayout pattern="[%level] %d{yyyy-MM-dd HH:mm:ss} [Line %L] %class{36}.%M - %msg%xEx%n" />
<SizeBasedTriggeringPolicy size="5MB" />
</RollingFile>
<RollingFile name="DebugRollingFile" fileName="logs/sys/application-debug.log"
filePattern="logs/$${date:yyyy-MM}/sys/application-debug-%d{MM-dd-yyyy}-%i.log.gz">
<ThresholdFilter level="debug" onMatch="ACCEPT" onMismatch="DENY" />
<PatternLayout pattern="[%level] %d{yyyy-MM-dd HH:mm:ss} [Line %L] %class{36}.%M - %msg%xEx%n" />
<SizeBasedTriggeringPolicy size="5MB" />
</RollingFile>
<RollingFile name="WarnRollingFile" fileName="logs/sys/application-warn.log"
filePattern="logs/$${date:yyyy-MM}/sys/application-warn-%d{MM-dd-yyyy}-%i.log.gz">
<ThresholdFilter level="warn" onMatch="ACCEPT" onMismatch="DENY" />
<PatternLayout pattern="[%level] %d{yyyy-MM-dd HH:mm:ss} [Line %L] %class{36}.%M - %msg%xEx%n" />
<SizeBasedTriggeringPolicy size="5MB" />
</RollingFile>
<RollingFile name="ErrorRollingFile" fileName="logs/sys/application-error.log"
filePattern="logs/$${date:yyyy-MM}/sys/application-error-%d{MM-dd-yyyy}-%i.log.gz">
<ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY" />
<PatternLayout pattern="[%level] %d{yyyy-MM-dd HH:mm:ss} [Line %L] %class{36}.%M - %msg%xEx%n" />
<SizeBasedTriggeringPolicy size="5MB" />
</RollingFile>
</appenders>
<loggers>
<!--建立一个默认的root的logger-->
<root level="info">
<appender-ref ref="STDOUT" />
<appender-ref ref="debug" />
<appender-ref ref="info" />
<appender-ref ref="error" />
<appender-ref ref="InfoRollingFile" />
<appender-ref ref="DebugRollingFile" />
<appender-ref ref="WarnRollingFile" />
<appender-ref ref="ErrorRollingFile" />
</root>
</loggers>
</configuration>
5、打印mybaits日志
对于maven项目的话,打印mybatis的sql需要依赖slf4j,不然无输出;其它非maven项目,则不需要依赖,具体原因笔者也没深入研究。
maven依赖:
<!-- log4j2 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>${log4j2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>${log4j2.version}</version>
</dependency>
<!-- slf4j用于mybatis -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.7</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<version>2.0.2</version>
</dependency>
另外,主要log4j2还可以针对某个类或者包作特定的配置,主要是通过name来控制,如果大家想配置得很具体些,可以去了解下。
三、总结
其实,log4j2相对之前的1.x版本在各方面都有较大的提升,但基本的配置内容也没发生太大改变,一般的项目有以上的配置就足以。
就介绍到这人啦,希望对那些还不会使用log4j的童鞋提供点帮助,具体比较详细的配置介绍可以自行查阅下资料。