<code>package</code> <code>com.book.web.controller;</code>
<code>import</code> <code>org.slf4j.Logger;</code>
<code>import</code> <code>org.slf4j.LoggerFactory;</code>
<code>/**</code>
<code> </code><code>* logback的测试</code>
<code> </code><code>* @author liweihan</code>
<code> </code><code>*</code>
<code> </code><code>*/</code>
<code>public</code> <code>class</code> <code>TestLogback {</code>
<code> </code><code>/**</code>
<code> </code><code>1.引入jar包</code>
<code> </code><code><dependency></code>
<code> </code><code><groupId>ch.qos.logback</groupId></code>
<code> </code><code><artifactId>logback-core</artifactId></code>
<code> </code><code><version>1.2.3</version></code>
<code> </code><code></dependency></code>
<code> </code><code><dependency></code>
<code> </code><code><artifactId>logback-classic</artifactId></code>
<code> </code><code><groupId>org.slf4j</groupId></code>
<code> </code><code><artifactId>slf4j-api</artifactId></code>
<code> </code><code><version>1.7.7</version></code>
<code> </code>
<code> </code><code>2.logback 官方使用方式,其实就和slf4j集成了起来</code>
<code> </code><code>下面Logger、LoggerFactory都是slf4j自己的接口与类</code>
<code> </code><code>没有配置文件的情况下,使用的是默认配置。搜寻配置文件的过程如下:</code>
<code> </code><code>寻找logback.configurationFile的系统属性 →</code>
<code> </code><code>寻找 logback.groovy → </code>
<code> </code><code>寻找 logback-test.xml → </code>
<code> </code><code>寻找 logback.xml </code>
<code> </code>
<code> </code><code>目前路径都是定死的(放在类路径下),只有logback.configurationFile的系统属性是可以更改的,</code>
<code> </code><code>所以如果我们想更改配置文件的位置(不想放在类路径下),则需要设置这个系统属性:</code>
<code> </code><code>System.setProperty("logback.configurationFile","/path/to/config.xml");</code>
<code> </code><code>解析完配置文件后,返回的ILoggerFactory实例的类型是LoggerContext(它包含了配置信息)</code>
<code> </code><code>根据返回的ILoggerFactory实例,来获取Logger</code>
<code> </code><code>就是根据上述的LoggerContext来创建一个Logger,</code>
<code> </code><code>每个logger与LoggerContext建立了关系,并放到LoggerContext的缓存中</code>
<code> </code>
<code> </code><code>3.如果logback-和commons-logging集成,还需要加入jar包</code>
<code> </code><code><artifactId>jcl-over-slf4j</artifactId></code>
<code> </code><code></dependency> </code>
<code> </code><code>private static Log logger = LogFactory.getLog(TestLogback.class);</code>
<code> </code><code>logback本身的使用其实就和slf4j绑定了起来,现在要想指定commons-logging的底层log实现是logback,则需要2步走</code>
<code> </code><code>第一步: 先将commons-logging底层的log实现转向slf4j (jcl-over-slf4j干的事)</code>
<code> </code><code>第二步: 再根据slf4j的选择底层日志原理,我们使之选择上logback</code>
<code> </code><code>这样就可以完成commons-logging与logback的集成。即写着commons-logging的API,底层却是logback来进行输出</code>
<code> </code><code>*/</code>
<code> </code>
<code> </code><code>private</code> <code>static</code> <code>final</code> <code>Logger logger = LoggerFactory.getLogger(TestLogback.</code><code>class</code><code>);</code>
<code> </code><code>public</code> <code>static</code> <code>void</code> <code>main(String[] args) {</code>
<code> </code><code>if</code> <code>(logger.isDebugEnabled()) {</code>
<code> </code><code>logger.debug(</code><code>" ====== slf4j-logback debug message"</code><code>);</code>
<code> </code><code>}</code>
<code> </code><code>if</code> <code>(logger.isInfoEnabled()) {</code>
<code> </code><code>logger.info(</code><code>" ====== slf4j-logback info message"</code><code>);</code>
<code> </code><code>if</code> <code>(logger.isTraceEnabled()) {</code>
<code> </code><code>logger.trace(</code><code>" ====== slf4j-logback trace message"</code><code>);</code>
<code> </code><code>if</code> <code>(logger.isWarnEnabled()) {</code>
<code> </code><code>logger.error(</code><code>" ====== slf4j-logback error message"</code><code>);</code>
<code> </code><code>}</code>
<code>}</code>
如果我们不配置logback-test.xml或logback.xml,那么将要调用logback.configurationFile的系统属性。
logback.xml的配置:
<code><?</code><code>xml</code> <code>version</code><code>=</code><code>"1.0"</code> <code>encoding</code><code>=</code><code>"UTF-8"</code><code>?></code>
<code><!-- if debug set to true, context info always print otherwise the contex</code>
<code> </code><code>info will print when error occour --></code>
<code><</code><code>configuration</code> <code>scan</code><code>=</code><code>"true"</code> <code>scanPeriod</code><code>=</code><code>"20 seconds"</code> <code>debug</code><code>=</code><code>"false"</code><code>></code>
<code> </code><code><</code><code>appender</code> <code>name</code><code>=</code><code>"STDOUT"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.ConsoleAppender"</code><code>></code>
<code> </code><code><</code><code>encoder</code><code>></code>
<code> </code><code><</code><code>pattern</code><code>>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36}</code>
<code> </code><code>[%file:%line] - %msg%n</code>
<code> </code><code></</code><code>pattern</code><code>></code>
<code> </code><code></</code><code>encoder</code><code>></code>
<code> </code><code></</code><code>appender</code><code>></code>
<code> </code><code><!-- 所有日志文件 --></code>
<code> </code><code><</code><code>appender</code> <code>name</code><code>=</code><code>"ROLLING"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>></code>
<code> </code><code><</code><code>file</code><code>>${html5.log.path}html5.log</</code><code>file</code><code>></code>
<code> </code><code><</code><code>rollingPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.TimeBasedRollingPolicy"</code><code>></code>
<code> </code><code><</code><code>fileNamePattern</code><code>>${html5.log.path}html5.%d{yyyy-MM-dd}.log</code>
<code> </code><code></</code><code>fileNamePattern</code><code>></code>
<code> </code><code><</code><code>maxHistory</code><code>>15</</code><code>maxHistory</code><code>></code>
<code> </code><code></</code><code>rollingPolicy</code><code>></code>
<code> </code><code><</code><code>charset</code><code>>UTF-8</</code><code>charset</code><code>></code>
<code> </code><code><!--2016-07-13-han-add : just for scan error log clearly!--></code>
<code> </code><code><</code><code>appender</code> <code>name</code><code>=</code><code>"ERROR-OUT"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>></code>
<code> </code><code><</code><code>file</code><code>>${html5.log.path}error.log</</code><code>file</code><code>></code>
<code> </code><code><</code><code>filter</code> <code>class</code><code>=</code><code>"ch.qos.logback.classic.filter.LevelFilter"</code><code>></code>
<code> </code><code><</code><code>level</code><code>>ERROR</</code><code>level</code><code>></code>
<code> </code><code><</code><code>onMatch</code><code>>ACCEPT</</code><code>onMatch</code><code>></code>
<code> </code><code><</code><code>onMismatch</code><code>>DENY</</code><code>onMismatch</code><code>></code>
<code> </code><code></</code><code>filter</code><code>></code>
<code> </code><code><</code><code>fileNamePattern</code><code>>${html5.log.path}error.%d{yyyy-MM-dd}.log</code>
<code> </code><code><!--2016-07-13-add-han-just for test some Class or package</code>
<code> </code><code><logger name="com.vis.servlet.PhonePlayServlet" level="DEBUG" additivity="false"></code>
<code> </code><code><appender-ref ref="STDOUT"/></code>
<code> </code><code><appender-ref ref="ROLLING"/></code>
<code> </code><code></logger></code>
<code> </code><code><logger name="com.vis.servlet.PhoneUGCPlayListServlet" level="DEBUG" additivity="false"></code>
<code> </code><code><logger name="com.vis.servlet.PhoneUGCWxServlet" level="DEBUG" additivity="false"></code>
<code> </code><code><logger name="com.vis.servlet.PhoneUGCServlet" level="DEBUG" additivity="false"></code>
<code> </code><code><logger name="com.vis.servlet.PhoneUGCPlayListWxServlet" level="DEBUG" additivity="false"></code>
<code>--></code>
<code> </code><code><</code><code>root</code> <code>level</code><code>=</code><code>"info"</code><code>></code>
<code> </code><code><</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"ROLLING"</code><code>/></code>
<code> </code><code><</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"STDOUT"</code><code>/></code>
<code> </code><code><</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"ERROR-OUT"</code><code>/></code>
<code> </code><code></</code><code>root</code><code>></code>
<code></</code><code>configuration</code><code>></code>
配置说明:
一、根节点<configuration>包含的属性:
scan:
当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。
scanPeriod:
设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。
当scan为true时,此属性生效。默认的时间间隔为1分钟。
debug:
当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。
例子如上!
二、设置logger
<logger> : 用来设置某一个包或者具体的某一个类的日志打印级别、以及指定<appender>。<logger>仅有一个name属性,一个可选的level和一个可选的addtivity属性。
name : 用来指定受此logger约束的某一个包或者具体的某一个类。
level: 用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,
还有一个特殊值INHERITED或者同义词NULL,代表强制执行上级的级别。
如果未设置此属性,那么当前loger将会继承上级的级别。
addtivity: 是否向上级loger传递打印信息。默认是true。
<logger>可以包含零个或多个<appender-ref>元素,
标识这个appender将会添加到这个loger。
<code><!-- 该包所有类的日志的打印,但是并没用设置打印级别,</code>
<code> </code><code>所以继承他的上级<root>的日志级别。</code>
<code> </code><code>没有设置addtivity,默认为true,将此loger的打印信息向上级传递;</code>
<code> </code><code>没有设置appender,此loger本身不打印任何信息。</code>
<code><</code><code>logger</code> <code>name</code><code>=</code><code>"com.book.web.controller"</code><code>/></code>
<code><!-- TestLogback类 ,此时该类的日志就不会输入到文件中,日志级别为INFO</code>
<code>additivity设置为true时,将打印两次日志!</code>
<code><</code><code>logger</code> <code>name</code><code>=</code><code>"com.book.web.controller.TestLogback"</code> <code>level</code><code>=</code><code>"INFO"</code> <code>additivity</code><code>=</code><code>"false"</code><code>></code>
<code> </code><code><</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"STDOUT"</code><code>/></code>
<code></</code><code>logger</code><code>></code>
三、设置root
其实,他也是<logger>元素,但是它是根loger。只有一个level属性
level:
用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能设置为INHERITED或者同义词NULL。默认是DEBUG
<root>可以包含零个或多个<appender-ref>元素,标识这个appender将会添加到这个logger。
四、设置appender
<appender>:
<appender>是<configuration>的子节点,是负责写日志的组件。
<appender>有两个必要属性name和class。name指定appender名称,class指定appender的全限定名。
1.ConsoleAppender:
把日志添加到控制台,有以下子节点:
<encoder>:对日志进行格式化。
<target>:字符串 System.out 或者 System.err ,默认 System.out ;
2.FileAppender:
把日志添加到文件,有以下子节点:
<file>:被写入的文件名,可以是相对目录,也可以是绝对目录,如果上级目录不存在会自动创建,没有默认值。<append>:如果是 true,日志被追加到文件结尾,如果是 false,清空现存文件,默认是true。
<encoder>:对记录事件进行格式化。(具体参数稍后讲解 )
<prudent>:如果是 true,日志会被安全的写入文件,即使其他的FileAppender也在向此文件做写入操作,效率低,默认是 false。
<code><</code><code>configuration</code><code>> </code>
<code> </code><code><</code><code>appender</code> <code>name</code><code>=</code><code>"FILE"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.FileAppender"</code><code>> </code>
<code> </code><code><</code><code>file</code><code>>testFile.log</</code><code>file</code><code>> </code>
<code> </code><code><</code><code>append</code><code>>true</</code><code>append</code><code>> </code>
<code> </code><code><</code><code>encoder</code><code>> </code>
<code> </code><code><</code><code>pattern</code><code>>%-4relative [%thread] %-5level %logger{35} - %msg%n</</code><code>pattern</code><code>> </code>
<code> </code><code></</code><code>encoder</code><code>> </code>
<code> </code><code></</code><code>appender</code><code>> </code>
<code> </code>
<code> </code><code><</code><code>root</code> <code>level</code><code>=</code><code>"DEBUG"</code><code>> </code>
<code> </code><code><</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"FILE"</code> <code>/> </code>
<code> </code><code></</code><code>root</code><code>> </code>
3.RollingFileAppender:
滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将日志记录到其他文件。有以下子节点:
<rollingPolicy>:当发生滚动时,决定 RollingFileAppender 的行为,涉及文件移动和重命名。
<triggeringPolicy >: 告知 RollingFileAppender 合适激活滚动。
<prudent>:当为true时,不支持FixedWindowRollingPolicy。支持TimeBasedRollingPolicy,但是有两个限制,1不支持也不允许文件压缩,2不能设置file属性,必须留空。
3.1 rollingPolicy:
3.1.1 TimeBasedRollingPolicy: 最常用的滚动策略,它根据时间来制定滚动策略,
既负责滚动也负责出发滚动。有以下子节点:
<fileNamePattern>:
必要节点,包含文件名及“%d”转换符, “%d”可以包含一个<code>java.text.SimpleDateFormat指定的时间格式,如:%d{yyyy-MM}。如果直接使用 %d,默认格式是 yyyy-MM-dd。</code>RollingFileAppender 的file字节点可有可无,通过设置file,可以为活动文件和归档文件指定不同位置,当前日志总是记录到file指定的文件(活动文件),活动文件的名字不会改变;如果没设置file,活动文件的名字会根据fileNamePattern 的值,每隔一段时间改变一次。“/”或者“\”会被当做目录分隔符。
<maxHistory>:
可选节点,控制保留的归档文件的最大数量,超出数量就删除旧文件。假设设置每个月滚动,且<maxHistory>是6,则只保存最近6个月的文件,删除之前的旧文件。注意,删除旧文件是,那些为了归档而创建的目录也会被删除。
3.1.2 FixedWindowRollingPolicy: 根据固定窗口算法重命名文件的滚动策略。有以下子节点:
<minIndex>:窗口索引最小值
<maxIndex>:窗口索引最大值,当用户指定的窗口过大时,会自动将窗口设置为12。
<fileNamePattern >:
必须包含“%i”例如,假设最小值和最大值分别为1和2,命名模式为 mylog%i.log,会产生归档文件mylog1.log和mylog2.log。还可以指定文件压缩选项,例如,mylog%i.log.gz 或者 没有log%i.log.zip
3.2 triggeringPolicy:
SizeBasedTriggeringPolicy: 查看当前活动文件的大小,如果超过指定大小会告知RollingFileAppender 触发当前活动文件滚动。只有一个节点:
<maxFileSize>:这是活动文件的大小,默认值是10MB。
<code><!-- 每天生成一个文件,保留15天 --></code>
<code><</code><code>appender</code> <code>name</code><code>=</code><code>"ROLLING"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>></code>
<code> </code><code><</code><code>file</code><code>>log/test.log</</code><code>file</code><code>></code>
<code> </code><code><</code><code>rollingPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.TimeBasedRollingPolicy"</code><code>></code>
<code> </code><code><</code><code>fileNamePattern</code><code>>log/test.%d{yyyy-MM-dd}.log</</code><code>fileNamePattern</code><code>></code>
<code> </code><code><</code><code>maxHistory</code><code>>15</</code><code>maxHistory</code><code>></code>
<code> </code><code></</code><code>rollingPolicy</code><code>></code>
<code> </code><code><</code><code>encoder</code><code>></code>
<code> </code><code><</code><code>pattern</code><code>>%d{HH:mm:ss.SSS} [%thread] [%-5level] %logger{50}.%M[%line] - %msg%n</</code><code>pattern</code><code>></code>
<code> </code><code><</code><code>charset</code><code>>UTF-8</</code><code>charset</code><code>></code>
<code> </code><code></</code><code>encoder</code><code>></code>
<code></</code><code>appender</code><code>></code>
<code> </code><code><!-- 按照固定窗口模式生成日志文件,当文件大于20MB时,生成新的日志文件。</code>
<code> </code><code>窗口大小是1到3,当保存了3个归档文件后,将覆盖最早的日志。 --></code>
<code> </code><code><</code><code>appender</code> <code>name</code><code>=</code><code>"ROLLING2"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>></code>
<code> </code><code><</code><code>file</code><code>>log/html5.log</</code><code>file</code><code>></code>
<code> </code><code><</code><code>rollingPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.FixedWindowRollingPolicy"</code><code>></code>
<code> </code><code><</code><code>fileNamePattern</code><code>>log/html5.%i.log</</code><code>fileNamePattern</code><code>></code>
<code> </code><code><</code><code>minIndex</code><code>>1</</code><code>minIndex</code><code>></code>
<code> </code><code><</code><code>maxIndex</code><code>>3</</code><code>maxIndex</code><code>></code>
<code> </code><code></</code><code>rollingPolicy</code><code>></code>
<code> </code><code><</code><code>triggeringPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy"</code><code>></code>
<code> </code><code><</code><code>maxFileSize</code><code>>20MB</</code><code>maxFileSize</code><code>></code>
<code> </code><code></</code><code>triggeringPolicy</code><code>></code>
<code> </code><code><</code><code>encoder</code><code>></code>
<code> </code><code><</code><code>pattern</code><code>>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} [%file:%line] - %msg%n</</code><code>pattern</code><code>></code>
<code> </code><code><</code><code>charset</code><code>>UTF-8</</code><code>charset</code><code>></code>
<code> </code><code></</code><code>encoder</code><code>></code>
<code> </code><code></</code><code>appender</code><code>></code>
五、设置encoder
负责两件事,一是把日志信息转换成字节数组,二是把字节数组写入到输出流。
目前PatternLayoutEncoder 是唯一有用的且默认的encoder ,有一个<pattern>节点,用来设置日志的输入格式。使用“%”加“转换符”方式,如果要输出“%”,则必须用“\”对“\%”进行转义。
<pattern>里面的转换符说明:
转换符
作用
c {length }
lo {length }
logger {length }
输出日志的logger名,可有一个整形参数,功能是缩短logger名,设置为0表示只输入logger最右边点符号之后的字符串。Conversion specifierLogger nameResult%loggermainPackage.sub.sample.BarmainPackage.sub.sample.Bar%logger{0}mainPackage.sub.sample.BarBar%logger{5}mainPackage.sub.sample.Barm.s.s.Bar%logger{10}mainPackage.sub.sample.Barm.s.s.Bar%logger{15}mainPackage.sub.sample.Barm.s.sample.Bar%logger{16}mainPackage.sub.sample.Barm.sub.sample.Bar%logger{26}mainPackage.sub.sample.BarmainPackage.sub.sample.Bar
C {length }
class {length }
输出执行记录请求的调用者的全限定名。参数与上面的一样。尽量避免使用,除非执行速度不造成任何问题。
contextName
cn
输出上下文名称。
d {pattern }
date {pattern }
输出日志的打印日志,模式语法与<code>java.text.SimpleDateFormat</code> 兼容。Conversion PatternResult%d2006-10-20 14:06:49,812%date2006-10-20 14:06:49,812%date{ISO8601}2006-10-20 14:06:49,812%date{HH:mm:ss.SSS}14:06:49.812%date{dd MMM yyyy ;HH:mm:ss.SSS}20 oct. 2006;14:06:49.812
F / file
输出执行记录请求的java源文件名。尽量避免使用,除非执行速度不造成任何问题。
caller{depth}caller{depth, evaluator-1, ... evaluator-n}
输出生成日志的调用者的位置信息,整数选项表示输出信息深度。
例如, %caller{2} 输出为:
例如, %caller{3} 输出为:
L / line
输出执行日志请求的行号。尽量避免使用,除非执行速度不造成任何问题。
m / msg / message
输出应用程序提供的信息。
M / method
输出执行日志请求的方法名。尽量避免使用,除非执行速度不造成任何问题。
n
输出平台先关的分行符“\n”或者“\r\n”。
p / le / level
输出日志级别。
r / relative
输出从程序启动到创建日志记录的时间,单位是毫秒
t / thread
输出产生日志的线程名。
replace(p ){r, t}
p 为日志内容,r 是正则表达式,将p 中符合r 的内容替换为t 。
例如, "%replace(%msg){'\s', ''}"
我自己用的几个
<code><</code><code>encoder</code><code>></code>
<code> </code><code><!-- --></code>
<code> </code><code><</code><code>pattern</code><code>>%d{HH:mm:ss.SSS} [%thread] [%-5level] %logger{50}.%M[%line] - %msg%n</</code><code>pattern</code><code>></code>
<code> </code><code><!-- 本地调试用 </code>
<code> </code><code><pattern>%d{yyyy/MM/dd-HH:mm:ss} [%level] [%thread] %caller{1}-%msg%n</pattern></code>
<code> </code><code>--></code>
<code> </code><code><!-- </code>
<code> </code><code><Pattern>%date{yyyy-MM-dd HH:mm:ss.SSS} [ %-5level ][ %thread ] %logger{56}.%method[%L] - %msg%n</Pattern> --></code>
<code> </code><code><</code><code>pattern</code><code>>%-4relative [%thread] %-5level %logger{35} - %msg%n</</code><code>pattern</code><code>> </code>
<code></</code><code>encoder</code><code>></code>
格式修饰符,与转换符共同使用:
可选的格式修饰符位于“%”和转换符之间。
第一个可选修饰符是左对齐 标志,符号是减号“-”;接着是可选的最小宽度 修饰符,用十进制数表示。如果字符小于最小宽度,则左填充或右填充,默认是左填充(即右对齐),填充符为空格。如果字符大于最小宽度,字符永远不会被截断。最大宽度 修饰符,符号是点号"."后面加十进制数。如果字符大于最大宽度,则从前面截断。点符号“.”后面加减号“-”在加数字,表示从尾部截断。
例如:%-4relative 表示,将输出从程序启动到创建日志记录的时间 进行左对齐 且最小宽度为4。
六、设置Filter
<filter>:过滤器,执行一个过滤器会有返回1个枚举值,即DENY,NEUTRAL,ACCEPT其中之一。
返回DENY,日志将立即被抛弃不再经过其他过滤器;
返回NEUTRAL,有序列表里的下个过滤器过接着处理日志;
返回ACCEPT,日志会被立即处理,不再经过剩余过滤器。
过滤器被添加到<Appender> 中,为<Appender> 添加一个或多个过滤器后,可以用任意条件对日志进行过滤。<Appender> 有多个过滤器时,按照配置顺序执行。
LevelFilter: 级别过滤器,根据日志级别进行过滤。如果日志级别等于配置级别,过滤器会根据onMath 和 onMismatch接收或拒绝日志。有以下子节点:
<level>:设置过滤级别
<onMatch>:用于配置符合过滤条件的操作
<onMismatch>:用于配置不符合过滤条件的操作
例如:将过滤器的日志级别配置为INFO,所有INFO级别的日志交给appender处理,非INFO级别的日志,被过滤掉。
<code><configuration> </code>
<code> </code><code><appender name=</code><code>"CONSOLE"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.ConsoleAppender"</code><code>> </code>
<code> </code><code><filter </code><code>class</code><code>=</code><code>"ch.qos.logback.classic.filter.LevelFilter"</code><code>> </code>
<code> </code><code><level>INFO</level> </code>
<code> </code><code><onMatch>ACCEPT</onMatch> </code>
<code> </code><code><onMismatch>DENY</onMismatch> </code>
<code> </code><code></filter> </code>
<code> </code><code><encoder> </code>
<code> </code><code><pattern> </code>
<code> </code><code>%-4relative [%thread] %-5level %logger{</code><code>30</code><code>} - %msg%n </code>
<code> </code><code></pattern> </code>
<code> </code><code></encoder> </code>
<code> </code><code></appender> </code>
<code> </code><code><root level=</code><code>"DEBUG"</code><code>> </code>
<code> </code><code><appender-ref ref=</code><code>"CONSOLE"</code> <code>/> </code>
<code> </code><code></root> </code>
<code></configuration></code>
例子2:将错误日志单独到一个文件error.log中
<code> </code><code><appender name=</code><code>"ERROR-OUT"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>></code>
<code> </code><code><file>log/error.log</file></code>
<code> </code><code><encoder></code>
<code> </code><code><pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{</code><code>36</code><code>}</code>
<code> </code><code></pattern></code>
<code> </code><code><charset>UTF-</code><code>8</code><code></charset></code>
<code> </code><code></encoder></code>
<code> </code><code><filter </code><code>class</code><code>=</code><code>"ch.qos.logback.classic.filter.LevelFilter"</code><code>></code>
<code> </code><code><level>ERROR</level></code>
<code> </code><code><onMatch>ACCEPT</onMatch></code>
<code> </code><code><onMismatch>DENY</onMismatch></code>
<code> </code><code></filter></code>
<code> </code><code><rollingPolicy </code><code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.TimeBasedRollingPolicy"</code><code>></code>
<code> </code><code><fileNamePattern>log/error.%d{yyyy-MM-dd}.log</code>
<code> </code><code></fileNamePattern></code>
<code> </code><code><maxHistory></code><code>15</code><code></maxHistory></code>
<code> </code><code></rollingPolicy></code>
<code> </code><code></appender> </code>
<code> </code><code><root level=</code><code>"DEBUG"</code><code>> </code>
<code> </code><code><appender-ref ref=</code><code>"ERROR-OUT"</code><code>/></code>
<code> </code><code></root> </code>
例子3:当我们需要按时间滚动日志,同时又需要按照大小滚动时:
<code><configuration> </code>
<code> </code><code><appender name=</code><code>"ROLLING"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>> </code>
<code> </code><code><file>mylog.txt</file> </code>
<code> </code><code><rollingPolicy </code><code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"</code><code>> </code>
<code> </code><code><!-- rollover daily --> </code>
<code> </code><code><fileNamePattern>mylog-%d{yyyy-MM-dd}.%i.txt</fileNamePattern> </code>
<code> </code><code><!-- each file should be at most 100MB, keep </code><code>60</code> <code>days worth of history, but at most 20GB --> </code>
<code> </code><code><maxFileSize>100MB</maxFileSize> </code>
<code> </code><code><maxHistory></code><code>60</code><code></maxHistory> </code>
<code> </code><code><totalSizeCap>20GB</totalSizeCap> </code>
<code> </code><code></rollingPolicy> </code>
<code> </code>
<code> </code><code><encoder> </code>
<code> </code><code><pattern>%msg%n</pattern> </code>
<code> </code><code></encoder> </code>
<code> </code><code></appender> </code>
<code> </code><code><root level=</code><code>"DEBUG"</code><code>> </code>
<code> </code><code><appender-ref ref=</code><code>"ROLLING"</code> <code>/> </code>
<code> </code><code></root> </code>
一、
Logback是由log4j创始人Ceki Gülcü设计的又一个开源日志组件。Logback,一个“可靠、通用、快速而又灵活的Java日志框架”。logback当前分成三个模块:logback-core,logback- classic和logback-access。
logback-core是其它两个模块的基础模块。
logback-classic是log4j的一个改良版本。
logback-classic完整实现SLF4J API使你可以很方便地更换成其它日志系统如log4j或JDK Logging。logback-access访问模块与Servlet容器集成提供通过Http来访问日志的功能。
二、
Logback主要建立于Logger、Appender 和 Layout 这三个类之上。
1.
Logger:日志的记录器,把它关联到应用的对应的context上后,主要用于存放日志对象,也可以定义日志类型、级别。Logger对象一般多定义为静态常量.
2.
Appender:用于指定日志输出的目的地,目的地可以是控制台、文件、远程套接字服务器、 MySQL、 PostreSQL、Oracle和其他数据库、 JMS和远程UNIX Syslog守护进程等。
3.
Layout:负责把事件转换成字符串,格式化的日志信息的输出。
三、
Level 有效级别
Logger可以被分配级别。级别包括:TRACE、DEBUG、INFO、WARN和ERROR,定义于ch.qos.logback.classic.Level类。程序会打印高于或等于所设置级别的日志,设置的日志等级越高,打印出来的日志就越少。如果设置级别为INFO,则优先级高于等于INFO级别(如:INFO、 WARN、ERROR)的日志信息将可以被输出,小于该级别的如DEBUG将不会被输出。为确保所有logger都能够最终继承一个级别,根logger总是有级别,默认情况下,这个级别是DEBUG
四、
三值逻辑
Logback的过滤器基于三值逻辑(ternary logic),允许把它们组装或成链,从而组成任意的复合过滤策略。过滤器很大程度上受到Linux的iptables启发。这里的所谓三值逻辑是说,过滤器的返回值只能是ACCEPT、DENY和NEUTRAL的其中一个。
如果返回DENY,那么记录事件立即被抛弃,不再经过剩余过滤器;
如果返回NEUTRAL,那么有序列表里的下一个过滤器会接着处理记录事件;
如果返回ACCEPT,那么记录事件被立即处理,不再经过剩余过滤器。
五、
Filter 过滤器
Logback-classic提供两种类型的过滤器:常规过滤器和TuroboFilter过滤器。Logback整体流程:
Logger 产生日志信息;
Layout修饰这条msg的显示格式;
Filter过滤显示的内容;
Appender具体的显示,即保存这日志信息的地方。
六、参考文章
配置和使用
<a href="http://blog.csdn.net/haidage/article/details/6794509/" target="_blank">http://blog.csdn.net/haidage/article/details/6794509/</a>
<a href="http://blog.csdn.net/haidage/article/details/6794529" target="_blank">http://blog.csdn.net/haidage/article/details/6794529</a>
<a href="http://blog.csdn.net/haidage/article/details/6794540" target="_blank">http://blog.csdn.net/haidage/article/details/6794540</a>
<a href="http://blog.csdn.net/canot/article/details/53340295" target="_blank">http://blog.csdn.net/canot/article/details/53340295</a>
<a href="http://www.cnblogs.com/wenbronk/p/6529161.html" target="_blank">http://www.cnblogs.com/wenbronk/p/6529161.html</a>
<a href="http://blog.csdn.net/iamlihongwei/article/details/56283138" target="_blank">http://blog.csdn.net/iamlihongwei/article/details/56283138</a>
<a href="http://www.cnblogs.com/chenfeng1122/p/6179376.html" target="_blank">http://www.cnblogs.com/chenfeng1122/p/6179376.html</a>
//性能对比
<a href="https://my.oschina.net/OutOfMemory/blog/789267%E3%80%81" target="_blank">https://my.oschina.net/OutOfMemory/blog/789267、</a>
<a href="http://blog.csdn.net/yjh1271845364/article/details/70888262%E3%80%81" target="_blank">http://blog.csdn.net/yjh1271845364/article/details/70888262、</a>
//原理
<a href="https://my.oschina.net/pingpangkuangmo/blog/406618" target="_blank">https://my.oschina.net/pingpangkuangmo/blog/406618</a>
本文转自韩立伟 51CTO博客,原文链接:http://blog.51cto.com/hanchaohan/1951737,如需转载请自行联系原作者