首页 > 代码库 > logback 简单配置总述

logback 简单配置总述

       近来有一个系统日志分模块输出的需求。其实需求很简单,只是第一次使用slf4j+logback的日志架构。故参照了很多博客和一些实例进行配置和测试。

在测试过程中发现网上有很多配置是错误的,有很多是误导的,故将自己前前后后,反反复复测试了很多遍,最后完美通过的实例拿上来和大家分享一下。

       一、主要标签释义(因为都可以在网上查找到,我只列举几个重要的和我用到的)

1.configuration。是整个配置文件的父标签。有三个属性,我用到的是debug,默认false,因为途中需要看调试信息,查看配置是否有错误,故将该属性设置为true。

2.appender。负责写日志的组件。必要属性name指定appender的名称(可以自定义);class指定appender的全限定名。

appender有几种现实方式,较为常用的有三种。

(1)ConsoleAppender是把日志打印到控制台。

由于我做的日志系统没有这部分打印需求,故没有使用。

(2)FileAppender把日志打印到文件。可以实现结尾追加,也可以不结尾追加。

(3)RollingFileAppender滚动记录日志。先将日志记录到指定文件,当符合某个条件的时候将日志记录到其他文件。由于我的需求使用的是该方式实现。故重点讲该方式。

3.logger。该标签是子域,设定某包下的日志输出路径。

关键属性是additivity,默认为true,为true时则表明向上级结构输出。

4.root。该标签为父域,为根的意思。是logger的父。

       二、滚动生成日志策略实现

主要是实现日志的按天生成日志,旧日志会自动压缩备份。同时如果当天的日志文件大小超过1g,则自动创建新日志文件,旧日志文件进行压缩备份。

<appender name="FRONT-FILE"
		class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${LOG_HOME}/front/front.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<fileNamePattern>${LOG_HOME}/front/front.%d{yyyy-MM-dd}.%i.log.zip</fileNamePattern>
			<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
				<maxFileSize>1024MB</maxFileSize>
			</timeBasedFileNamingAndTriggeringPolicy>
			<maxHistory>30</maxHistory>
		</rollingPolicy>
		<layout class="ch.qos.logback.classic.PatternLayout">
			<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{55} -
				%msg%n
			</pattern>
		</layout>
	</appender>
对于这里的注意点有两个:

(1)网上很多网页误导人的一句是这里:

<fileNamePattern>${LOG_HOME}/front/front.%d{yyyy-MM-dd}.%i.log.zip</fileNamePattern>
丢写了%i,这样会导致每次都会覆盖原来文件,并没有达到备份的效果。
(2)时间和大小共同制约的策略实现。

有一些人是这样配置的:

<pre name="code" class="html" style="font-size: 14px;"><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<fileNamePattern>${LOG_HOME}/front/front.%d{yyyy-MM-dd}.%i.log.zip</fileNamePattern>
			<maxHistory>30</maxHistory>
		</rollingPolicy>
		<layout class="ch.qos.logback.classic.PatternLayout">
			<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{55} -
				%msg%n
			</pattern>
		</layout>
 

<triggeringPolicy
		class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
			<MaxFileSize>30MB</MaxFileSize>
		</triggeringPolicy>
使用triggeringPolicy标签来实现。事实证明,这个是logback的一个bug,是实现不了。所以要务必注意。


           三、日志多模块输出

一般日志会要求业务进行单独输出,这样的话可以理解为一个业务模块对应一个日志,多个业务模块对应不同日志。

<appender name="FRONT-FILE"
		class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${LOG_HOME}/front/front.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<fileNamePattern>${LOG_HOME}/front/front.%d{yyyy-MM-dd}.%i.log.zip</fileNamePattern>
			<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
				<maxFileSize>1024MB</maxFileSize>
			</timeBasedFileNamingAndTriggeringPolicy>
			<maxHistory>30</maxHistory>
		</rollingPolicy>
		<layout class="ch.qos.logback.classic.PatternLayout">
			<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{55} -
				%msg%n
			</pattern>
		</layout>
	</appender>
	
	<appender name="GOODS-FILE"
		class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${LOG_HOME}/goods/goods.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${LOG_HOME}/goods/goods.%d{yyyy-MM-dd}.%i.log.zip</FileNamePattern>
			<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
				<maxFileSize>1024MB</maxFileSize>
			</timeBasedFileNamingAndTriggeringPolicy>
			<maxHistory>30</maxHistory>
		</rollingPolicy>
		<layout class="ch.qos.logback.classic.PatternLayout">
			<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{55} -
				%msg%n
			</pattern>
		</layout>
	</appender>
<logger name="com.test.goods" level="INFO" additivity="false"><span style="white-space:pre">		</span><appender-ref ref="GOODS-FILE"/><span style="white-space:pre">	</span></logger>
<root level="INFO"><span style="white-space:pre">		</span><appender-ref ref="FRONT-FILE" /><span style="white-space:pre">	</span></root>
这样配置就能实现多模块输出了。以goods模块为模版,进行多模版配置即可。与相关业务相关的日志会打印到各自的日志中,与业务无关的日志则会打印到FRONT-FILE日志中。

希望对大家有些用处,共勉!