天天看点

logback的简单学习一

<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>&lt;dependency&gt;</code>

<code>          </code><code>&lt;groupId&gt;ch.qos.logback&lt;/groupId&gt;</code>

<code>          </code><code>&lt;artifactId&gt;logback-core&lt;/artifactId&gt;</code>

<code>          </code><code>&lt;version&gt;1.2.3&lt;/version&gt;</code>

<code>        </code><code>&lt;/dependency&gt;</code>

<code>        </code><code>&lt;dependency&gt;</code>

<code>          </code><code>&lt;artifactId&gt;logback-classic&lt;/artifactId&gt;</code>

<code>          </code><code>&lt;groupId&gt;org.slf4j&lt;/groupId&gt;</code>

<code>          </code><code>&lt;artifactId&gt;slf4j-api&lt;/artifactId&gt;</code>

<code>          </code><code>&lt;version&gt;1.7.7&lt;/version&gt;</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>&lt;artifactId&gt;jcl-over-slf4j&lt;/artifactId&gt;</code>

<code>        </code><code>&lt;/dependency&gt;   </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>&lt;?</code><code>xml</code> <code>version</code><code>=</code><code>"1.0"</code> <code>encoding</code><code>=</code><code>"UTF-8"</code><code>?&gt;</code>

<code>&lt;!-- if debug set to true, context info always print otherwise the contex</code>

<code>   </code><code>info will print when error occour --&gt;</code>

<code>&lt;</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>&gt;</code>

<code>    </code><code>&lt;</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>&gt;</code>

<code>        </code><code>&lt;</code><code>encoder</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>pattern</code><code>&gt;%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36}</code>

<code>                </code><code>[%file:%line] - %msg%n</code>

<code>            </code><code>&lt;/</code><code>pattern</code><code>&gt;</code>

<code>        </code><code>&lt;/</code><code>encoder</code><code>&gt;</code>

<code>    </code><code>&lt;/</code><code>appender</code><code>&gt;</code>

<code>    </code><code>&lt;!-- 所有日志文件 --&gt;</code>

<code>    </code><code>&lt;</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>&gt;</code>

<code>        </code><code>&lt;</code><code>file</code><code>&gt;${html5.log.path}html5.log&lt;/</code><code>file</code><code>&gt;</code>

<code>        </code><code>&lt;</code><code>rollingPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.TimeBasedRollingPolicy"</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>fileNamePattern</code><code>&gt;${html5.log.path}html5.%d{yyyy-MM-dd}.log</code>

<code>            </code><code>&lt;/</code><code>fileNamePattern</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>maxHistory</code><code>&gt;15&lt;/</code><code>maxHistory</code><code>&gt;</code>

<code>        </code><code>&lt;/</code><code>rollingPolicy</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>charset</code><code>&gt;UTF-8&lt;/</code><code>charset</code><code>&gt;</code>

<code>    </code><code>&lt;!--2016-07-13-han-add : just for scan error log clearly!--&gt;</code>

<code>    </code><code>&lt;</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>&gt;</code>

<code>        </code><code>&lt;</code><code>file</code><code>&gt;${html5.log.path}error.log&lt;/</code><code>file</code><code>&gt;</code>

<code>        </code><code>&lt;</code><code>filter</code> <code>class</code><code>=</code><code>"ch.qos.logback.classic.filter.LevelFilter"</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>level</code><code>&gt;ERROR&lt;/</code><code>level</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>onMatch</code><code>&gt;ACCEPT&lt;/</code><code>onMatch</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>onMismatch</code><code>&gt;DENY&lt;/</code><code>onMismatch</code><code>&gt;</code>

<code>        </code><code>&lt;/</code><code>filter</code><code>&gt;</code>

<code>            </code><code>&lt;</code><code>fileNamePattern</code><code>&gt;${html5.log.path}error.%d{yyyy-MM-dd}.log</code>

<code>    </code><code>&lt;!--2016-07-13-add-han-just for test some Class or package</code>

<code>    </code><code>&lt;logger name="com.vis.servlet.PhonePlayServlet" level="DEBUG" additivity="false"&gt;</code>

<code>        </code><code>&lt;appender-ref ref="STDOUT"/&gt;</code>

<code>        </code><code>&lt;appender-ref ref="ROLLING"/&gt;</code>

<code>    </code><code>&lt;/logger&gt;</code>

<code>      </code><code>&lt;logger name="com.vis.servlet.PhoneUGCPlayListServlet" level="DEBUG" additivity="false"&gt;</code>

<code>      </code><code>&lt;logger name="com.vis.servlet.PhoneUGCWxServlet" level="DEBUG" additivity="false"&gt;</code>

<code>      </code><code>&lt;logger name="com.vis.servlet.PhoneUGCServlet" level="DEBUG" additivity="false"&gt;</code>

<code>      </code><code>&lt;logger name="com.vis.servlet.PhoneUGCPlayListWxServlet" level="DEBUG" additivity="false"&gt;</code>

<code>--&gt;</code>

<code>    </code><code>&lt;</code><code>root</code> <code>level</code><code>=</code><code>"info"</code><code>&gt;</code>

<code>        </code><code>&lt;</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"ROLLING"</code><code>/&gt;</code>

<code>        </code><code>&lt;</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"STDOUT"</code><code>/&gt;</code>

<code>        </code><code>&lt;</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"ERROR-OUT"</code><code>/&gt;</code>

<code>    </code><code>&lt;/</code><code>root</code><code>&gt;</code>

<code>&lt;/</code><code>configuration</code><code>&gt;</code>

配置说明:

一、根节点&lt;configuration&gt;包含的属性:

scan:

    当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。

scanPeriod:

                    设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。

                    当scan为true时,此属性生效。默认的时间间隔为1分钟。

debug:

            当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。

例子如上!

二、设置logger

&lt;logger&gt; : 用来设置某一个包或者具体的某一个类的日志打印级别、以及指定&lt;appender&gt;。&lt;logger&gt;仅有一个name属性,一个可选的level和一个可选的addtivity属性。

name : 用来指定受此logger约束的某一个包或者具体的某一个类。

level: 用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,

           还有一个特殊值INHERITED或者同义词NULL,代表强制执行上级的级别。

           如果未设置此属性,那么当前loger将会继承上级的级别。

addtivity: 是否向上级loger传递打印信息。默认是true。

                   &lt;logger&gt;可以包含零个或多个&lt;appender-ref&gt;元素,

                   标识这个appender将会添加到这个loger。

<code>&lt;!-- 该包所有类的日志的打印,但是并没用设置打印级别,</code>

<code>   </code><code>所以继承他的上级&lt;root&gt;的日志级别。</code>

<code>   </code><code>没有设置addtivity,默认为true,将此loger的打印信息向上级传递;</code>

<code>   </code><code>没有设置appender,此loger本身不打印任何信息。</code>

<code>&lt;</code><code>logger</code> <code>name</code><code>=</code><code>"com.book.web.controller"</code><code>/&gt;</code>

<code>&lt;!-- TestLogback类 ,此时该类的日志就不会输入到文件中,日志级别为INFO</code>

<code>additivity设置为true时,将打印两次日志!</code>

<code>&lt;</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>&gt;</code>

<code>    </code><code>&lt;</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"STDOUT"</code><code>/&gt;</code>

<code>&lt;/</code><code>logger</code><code>&gt;</code>

三、设置root

其实,他也是&lt;logger&gt;元素,但是它是根loger。只有一个level属性

level:

用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能设置为INHERITED或者同义词NULL。默认是DEBUG

&lt;root&gt;可以包含零个或多个&lt;appender-ref&gt;元素,标识这个appender将会添加到这个logger。

四、设置appender

&lt;appender&gt;:

&lt;appender&gt;是&lt;configuration&gt;的子节点,是负责写日志的组件。

&lt;appender&gt;有两个必要属性name和class。name指定appender名称,class指定appender的全限定名。

1.ConsoleAppender:

把日志添加到控制台,有以下子节点:

&lt;encoder&gt;:对日志进行格式化。

&lt;target&gt;:字符串 System.out 或者 System.err ,默认 System.out ;

2.FileAppender:

把日志添加到文件,有以下子节点:

&lt;file&gt;:被写入的文件名,可以是相对目录,也可以是绝对目录,如果上级目录不存在会自动创建,没有默认值。&lt;append&gt;:如果是 true,日志被追加到文件结尾,如果是 false,清空现存文件,默认是true。

&lt;encoder&gt;:对记录事件进行格式化。(具体参数稍后讲解 )

&lt;prudent&gt;:如果是 true,日志会被安全的写入文件,即使其他的FileAppender也在向此文件做写入操作,效率低,默认是 false。

<code>&lt;</code><code>configuration</code><code>&gt;  </code>

<code>  </code><code>&lt;</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>&gt;  </code>

<code>    </code><code>&lt;</code><code>file</code><code>&gt;testFile.log&lt;/</code><code>file</code><code>&gt;  </code>

<code>    </code><code>&lt;</code><code>append</code><code>&gt;true&lt;/</code><code>append</code><code>&gt;  </code>

<code>    </code><code>&lt;</code><code>encoder</code><code>&gt;  </code>

<code>      </code><code>&lt;</code><code>pattern</code><code>&gt;%-4relative [%thread] %-5level %logger{35} - %msg%n&lt;/</code><code>pattern</code><code>&gt;  </code>

<code>    </code><code>&lt;/</code><code>encoder</code><code>&gt;  </code>

<code>  </code><code>&lt;/</code><code>appender</code><code>&gt;  </code>

<code>          </code> 

<code>  </code><code>&lt;</code><code>root</code> <code>level</code><code>=</code><code>"DEBUG"</code><code>&gt;  </code>

<code>    </code><code>&lt;</code><code>appender-ref</code> <code>ref</code><code>=</code><code>"FILE"</code> <code>/&gt;  </code>

<code>  </code><code>&lt;/</code><code>root</code><code>&gt;  </code>

3.RollingFileAppender:

滚动记录文件,先将日志记录到指定文件,当符合某个条件时,将日志记录到其他文件。有以下子节点:

&lt;rollingPolicy&gt;:当发生滚动时,决定 RollingFileAppender 的行为,涉及文件移动和重命名。

&lt;triggeringPolicy &gt;: 告知 RollingFileAppender 合适激活滚动。

&lt;prudent&gt;:当为true时,不支持FixedWindowRollingPolicy。支持TimeBasedRollingPolicy,但是有两个限制,1不支持也不允许文件压缩,2不能设置file属性,必须留空。

3.1 rollingPolicy:

3.1.1  TimeBasedRollingPolicy: 最常用的滚动策略,它根据时间来制定滚动策略,

                                                        既负责滚动也负责出发滚动。有以下子节点:

&lt;fileNamePattern&gt;:

必要节点,包含文件名及“%d”转换符, “%d”可以包含一个<code>java.text.SimpleDateFormat指定的时间格式,如:%d{yyyy-MM}。如果直接使用 %d,默认格式是 yyyy-MM-dd。</code>RollingFileAppender 的file字节点可有可无,通过设置file,可以为活动文件和归档文件指定不同位置,当前日志总是记录到file指定的文件(活动文件),活动文件的名字不会改变;如果没设置file,活动文件的名字会根据fileNamePattern 的值,每隔一段时间改变一次。“/”或者“\”会被当做目录分隔符。

&lt;maxHistory&gt;:

可选节点,控制保留的归档文件的最大数量,超出数量就删除旧文件。假设设置每个月滚动,且&lt;maxHistory&gt;是6,则只保存最近6个月的文件,删除之前的旧文件。注意,删除旧文件是,那些为了归档而创建的目录也会被删除。

3.1.2 FixedWindowRollingPolicy: 根据固定窗口算法重命名文件的滚动策略。有以下子节点:

&lt;minIndex&gt;:窗口索引最小值

&lt;maxIndex&gt;:窗口索引最大值,当用户指定的窗口过大时,会自动将窗口设置为12。

&lt;fileNamePattern &gt;:

必须包含“%i”例如,假设最小值和最大值分别为1和2,命名模式为 mylog%i.log,会产生归档文件mylog1.log和mylog2.log。还可以指定文件压缩选项,例如,mylog%i.log.gz 或者 没有log%i.log.zip

3.2 triggeringPolicy:

SizeBasedTriggeringPolicy: 查看当前活动文件的大小,如果超过指定大小会告知RollingFileAppender 触发当前活动文件滚动。只有一个节点:

&lt;maxFileSize&gt;:这是活动文件的大小,默认值是10MB。

<code>&lt;!-- 每天生成一个文件,保留15天 --&gt;</code>

<code>&lt;</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>&gt;</code>

<code>   </code><code>&lt;</code><code>file</code><code>&gt;log/test.log&lt;/</code><code>file</code><code>&gt;</code>

<code>   </code><code>&lt;</code><code>rollingPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.TimeBasedRollingPolicy"</code><code>&gt;</code>

<code>        </code><code>&lt;</code><code>fileNamePattern</code><code>&gt;log/test.%d{yyyy-MM-dd}.log&lt;/</code><code>fileNamePattern</code><code>&gt;</code>

<code>        </code><code>&lt;</code><code>maxHistory</code><code>&gt;15&lt;/</code><code>maxHistory</code><code>&gt;</code>

<code>   </code><code>&lt;/</code><code>rollingPolicy</code><code>&gt;</code>

<code>   </code><code>&lt;</code><code>encoder</code><code>&gt;</code>

<code>       </code><code>&lt;</code><code>pattern</code><code>&gt;%d{HH:mm:ss.SSS} [%thread] [%-5level] %logger{50}.%M[%line] - %msg%n&lt;/</code><code>pattern</code><code>&gt;</code>

<code>       </code><code>&lt;</code><code>charset</code><code>&gt;UTF-8&lt;/</code><code>charset</code><code>&gt;</code>

<code>   </code><code>&lt;/</code><code>encoder</code><code>&gt;</code>

<code>&lt;/</code><code>appender</code><code>&gt;</code>

<code>   </code><code>&lt;!-- 按照固定窗口模式生成日志文件,当文件大于20MB时,生成新的日志文件。</code>

<code>       </code><code>窗口大小是1到3,当保存了3个归档文件后,将覆盖最早的日志。 --&gt;</code>

<code>  </code><code>&lt;</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>&gt;</code>

<code>    </code><code>&lt;</code><code>file</code><code>&gt;log/html5.log&lt;/</code><code>file</code><code>&gt;</code>

<code>    </code><code>&lt;</code><code>rollingPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.FixedWindowRollingPolicy"</code><code>&gt;</code>

<code>          </code><code>&lt;</code><code>fileNamePattern</code><code>&gt;log/html5.%i.log&lt;/</code><code>fileNamePattern</code><code>&gt;</code>

<code>         </code><code>&lt;</code><code>minIndex</code><code>&gt;1&lt;/</code><code>minIndex</code><code>&gt;</code>

<code>         </code><code>&lt;</code><code>maxIndex</code><code>&gt;3&lt;/</code><code>maxIndex</code><code>&gt;</code>

<code>    </code><code>&lt;/</code><code>rollingPolicy</code><code>&gt;</code>

<code>    </code><code>&lt;</code><code>triggeringPolicy</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy"</code><code>&gt;</code>

<code>       </code><code>&lt;</code><code>maxFileSize</code><code>&gt;20MB&lt;/</code><code>maxFileSize</code><code>&gt;</code>

<code>    </code><code>&lt;/</code><code>triggeringPolicy</code><code>&gt;</code>

<code>    </code><code>&lt;</code><code>encoder</code><code>&gt;</code>

<code>      </code><code>&lt;</code><code>pattern</code><code>&gt;%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} [%file:%line] - %msg%n&lt;/</code><code>pattern</code><code>&gt;</code>

<code>      </code><code>&lt;</code><code>charset</code><code>&gt;UTF-8&lt;/</code><code>charset</code><code>&gt;</code>

<code>    </code><code>&lt;/</code><code>encoder</code><code>&gt;</code>

<code>  </code><code>&lt;/</code><code>appender</code><code>&gt;</code>

五、设置encoder 

负责两件事,一是把日志信息转换成字节数组,二是把字节数组写入到输出流。

目前PatternLayoutEncoder 是唯一有用的且默认的encoder ,有一个&lt;pattern&gt;节点,用来设置日志的输入格式。使用“%”加“转换符”方式,如果要输出“%”,则必须用“\”对“\%”进行转义。

&lt;pattern&gt;里面的转换符说明:

转换符

作用

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>&lt;</code><code>encoder</code><code>&gt;</code>

<code>    </code><code>&lt;!--  --&gt;</code>

<code>    </code><code>&lt;</code><code>pattern</code><code>&gt;%d{HH:mm:ss.SSS} [%thread] [%-5level] %logger{50}.%M[%line] - %msg%n&lt;/</code><code>pattern</code><code>&gt;</code>

<code>    </code><code>&lt;!-- 本地调试用  </code>

<code>    </code><code>&lt;pattern&gt;%d{yyyy/MM/dd-HH:mm:ss} [%level] [%thread] %caller{1}-%msg%n&lt;/pattern&gt;</code>

<code>     </code><code>--&gt;</code>

<code>    </code><code>&lt;!-- </code>

<code>    </code><code>&lt;Pattern&gt;%date{yyyy-MM-dd HH:mm:ss.SSS} [ %-5level ][ %thread ] %logger{56}.%method[%L] - %msg%n&lt;/Pattern&gt; --&gt;</code> 

<code>    </code><code>&lt;</code><code>pattern</code><code>&gt;%-4relative [%thread] %-5level %logger{35} - %msg%n&lt;/</code><code>pattern</code><code>&gt;   </code>

<code>&lt;/</code><code>encoder</code><code>&gt;</code>

格式修饰符,与转换符共同使用:

可选的格式修饰符位于“%”和转换符之间。

第一个可选修饰符是左对齐 标志,符号是减号“-”;接着是可选的最小宽度 修饰符,用十进制数表示。如果字符小于最小宽度,则左填充或右填充,默认是左填充(即右对齐),填充符为空格。如果字符大于最小宽度,字符永远不会被截断。最大宽度 修饰符,符号是点号"."后面加十进制数。如果字符大于最大宽度,则从前面截断。点符号“.”后面加减号“-”在加数字,表示从尾部截断。

例如:%-4relative 表示,将输出从程序启动到创建日志记录的时间 进行左对齐 且最小宽度为4。

六、设置Filter

&lt;filter&gt;:过滤器,执行一个过滤器会有返回1个枚举值,即DENY,NEUTRAL,ACCEPT其中之一。

返回DENY,日志将立即被抛弃不再经过其他过滤器;

返回NEUTRAL,有序列表里的下个过滤器过接着处理日志;

返回ACCEPT,日志会被立即处理,不再经过剩余过滤器。

过滤器被添加到&lt;Appender&gt; 中,为&lt;Appender&gt; 添加一个或多个过滤器后,可以用任意条件对日志进行过滤。&lt;Appender&gt; 有多个过滤器时,按照配置顺序执行。

LevelFilter: 级别过滤器,根据日志级别进行过滤。如果日志级别等于配置级别,过滤器会根据onMath 和 onMismatch接收或拒绝日志。有以下子节点:

&lt;level&gt;:设置过滤级别

&lt;onMatch&gt;:用于配置符合过滤条件的操作

&lt;onMismatch&gt;:用于配置不符合过滤条件的操作

例如:将过滤器的日志级别配置为INFO,所有INFO级别的日志交给appender处理,非INFO级别的日志,被过滤掉。

<code>&lt;configuration&gt;   </code>

<code>  </code><code>&lt;appender name=</code><code>"CONSOLE"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.ConsoleAppender"</code><code>&gt;   </code>

<code>    </code><code>&lt;filter </code><code>class</code><code>=</code><code>"ch.qos.logback.classic.filter.LevelFilter"</code><code>&gt;   </code>

<code>      </code><code>&lt;level&gt;INFO&lt;/level&gt;   </code>

<code>      </code><code>&lt;onMatch&gt;ACCEPT&lt;/onMatch&gt;   </code>

<code>      </code><code>&lt;onMismatch&gt;DENY&lt;/onMismatch&gt;   </code>

<code>    </code><code>&lt;/filter&gt;   </code>

<code>    </code><code>&lt;encoder&gt;   </code>

<code>      </code><code>&lt;pattern&gt;   </code>

<code>        </code><code>%-4relative [%thread] %-5level %logger{</code><code>30</code><code>} - %msg%n   </code>

<code>      </code><code>&lt;/pattern&gt;   </code>

<code>    </code><code>&lt;/encoder&gt;   </code>

<code>  </code><code>&lt;/appender&gt;   </code>

<code>  </code><code>&lt;root level=</code><code>"DEBUG"</code><code>&gt;   </code>

<code>    </code><code>&lt;appender-ref ref=</code><code>"CONSOLE"</code> <code>/&gt;   </code>

<code>  </code><code>&lt;/root&gt;   </code>

<code>&lt;/configuration&gt;</code>

例子2:将错误日志单独到一个文件error.log中

<code>    </code><code>&lt;appender name=</code><code>"ERROR-OUT"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>&gt;</code>

<code>        </code><code>&lt;file&gt;log/error.log&lt;/file&gt;</code>

<code>        </code><code>&lt;encoder&gt;</code>

<code>            </code><code>&lt;pattern&gt;%d{HH:mm:ss.SSS} [%thread] %-5level %logger{</code><code>36</code><code>}</code>

<code>            </code><code>&lt;/pattern&gt;</code>

<code>            </code><code>&lt;charset&gt;UTF-</code><code>8</code><code>&lt;/charset&gt;</code>

<code>        </code><code>&lt;/encoder&gt;</code>

<code>        </code><code>&lt;filter </code><code>class</code><code>=</code><code>"ch.qos.logback.classic.filter.LevelFilter"</code><code>&gt;</code>

<code>            </code><code>&lt;level&gt;ERROR&lt;/level&gt;</code>

<code>            </code><code>&lt;onMatch&gt;ACCEPT&lt;/onMatch&gt;</code>

<code>            </code><code>&lt;onMismatch&gt;DENY&lt;/onMismatch&gt;</code>

<code>        </code><code>&lt;/filter&gt;</code>

<code>        </code><code>&lt;rollingPolicy </code><code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.TimeBasedRollingPolicy"</code><code>&gt;</code>

<code>            </code><code>&lt;fileNamePattern&gt;log/error.%d{yyyy-MM-dd}.log</code>

<code>            </code><code>&lt;/fileNamePattern&gt;</code>

<code>            </code><code>&lt;maxHistory&gt;</code><code>15</code><code>&lt;/maxHistory&gt;</code>

<code>        </code><code>&lt;/rollingPolicy&gt;</code>

<code>    </code><code>&lt;/appender&gt;  </code>

<code>    </code><code>&lt;root level=</code><code>"DEBUG"</code><code>&gt;   </code>

<code>       </code><code>&lt;appender-ref ref=</code><code>"ERROR-OUT"</code><code>/&gt;</code>

<code>    </code><code>&lt;/root&gt;   </code>

例子3:当我们需要按时间滚动日志,同时又需要按照大小滚动时:

<code>&lt;configuration&gt;  </code>

<code>  </code><code>&lt;appender name=</code><code>"ROLLING"</code> <code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.RollingFileAppender"</code><code>&gt;  </code>

<code>    </code><code>&lt;file&gt;mylog.txt&lt;/file&gt;  </code>

<code>    </code><code>&lt;rollingPolicy </code><code>class</code><code>=</code><code>"ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"</code><code>&gt;  </code>

<code>      </code><code>&lt;!-- rollover daily --&gt;  </code>

<code>      </code><code>&lt;fileNamePattern&gt;mylog-%d{yyyy-MM-dd}.%i.txt&lt;/fileNamePattern&gt;  </code>

<code>       </code><code>&lt;!-- each file should be at most 100MB, keep </code><code>60</code> <code>days worth of history, but at most 20GB --&gt;  </code>

<code>       </code><code>&lt;maxFileSize&gt;100MB&lt;/maxFileSize&gt;      </code>

<code>       </code><code>&lt;maxHistory&gt;</code><code>60</code><code>&lt;/maxHistory&gt;  </code>

<code>       </code><code>&lt;totalSizeCap&gt;20GB&lt;/totalSizeCap&gt;  </code>

<code>    </code><code>&lt;/rollingPolicy&gt;  </code>

<code>  </code> 

<code>    </code><code>&lt;encoder&gt;  </code>

<code>      </code><code>&lt;pattern&gt;%msg%n&lt;/pattern&gt;  </code>

<code>    </code><code>&lt;/encoder&gt;  </code>

<code>  </code><code>&lt;/appender&gt;  </code>

<code>  </code><code>&lt;root level=</code><code>"DEBUG"</code><code>&gt;  </code>

<code>    </code><code>&lt;appender-ref ref=</code><code>"ROLLING"</code> <code>/&gt;  </code>

<code>  </code><code>&lt;/root&gt;  </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,如需转载请自行联系原作者