亚洲日韩精品无码专区加勒比☆ ,亚洲福利精品一区二区三区,国精无码欧精品亚洲一区

从Tomcat 6.0开始，Tomcat引入一个对Apache Commons Logging重命名包后的�U�有实现�Q�从而允许web应用使用他们自己独立的原Apache Commons Logging库的lib包。在默认的发布包中，Apache Commons Logging�U�有实现是简单被��编码到java.util.logging框架�?/div>

实际使用中，通过配置org.apache.catalina.valves.AccessLogValve可以让tomcat打印讉K��日志�Q�默认禁用掉的）

王星�?/a> 2014-07-13 19:04 发表评论

logback_config_demo

Sun, 13 Jul 2014 11:03:00 GMT

我自己常用的一个logback配置框架�Q�有需要再在上面添加：

1 xml version="1.0" encoding="UTF-8"?>
2
3 <configuration>
4
5     <statusListener class="ch.qos.logback.core.status.OnConsoleStatusListener"/>
6
7
8     <consolePlugin />
9
10
11     <property name="LOG_PATH" value="d:/log" />
12
13
14
15     <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
16         <encoder>
17             <pattern>
18                 %d{HH:mm:ss.SSS} [%t] %-5p  %c{1} - %m%n
19             pattern>
20         encoder>
21     appender>
22
23
24     <appender name="COMMON-DEFAULT-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
25         <File>${LOG_PATH}/common-default.logFile>
26         <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
27             <FileNamePattern>
28                 ${LOG_PATH}/common-default.%d.log.gz
29
30             FileNamePattern>
31         rollingPolicy>
32         <encoder>
33             <Pattern>
34                 %d [%t] %-5p  %c{1} - %m%n
35             Pattern>
36         encoder>
37
38     appender>
39
40
41     <appender name="COMMON-ERROR-APPENDER" class="ch.qos.logback.core.rolling.RollingFileAppender">
42         <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
43             <level>ERRORlevel>
44         filter>
45         <File>${LOG_PATH}/common-error.logFile>
46         <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
47             <FileNamePattern>
48                 ${LOG_PATH}/common-error.%d.log.gz
49
50             FileNamePattern>
51         rollingPolicy>
52         <encoder>
53             <Pattern>
54                 %d [%t] %-5p  %c{1} - %m%n
55             Pattern>
56         encoder>
57
58     appender>
59
60
61     <root>
62         <level value="DEBUG"/>
63         <appender-ref ref="STDOUT"/>
64         <appender-ref ref="COMMON-DEFAULT-APPENDER"/>
65         <appender-ref ref="COMMON-ERROR-APPENDER"/>
66     root>
67
68 configuration>
69

王星�?/a> 2014-07-13 19:03 发表评论

logback_eclipse_plugin_beagle

Sun, 13 Jul 2014 11:01:00 GMT

http://logback.qos.ch/beagle/index.html

先安装依赖插�Ӟ��

http://download.eclipse.org/technology/nebula/snapshot (注意�q�个是稳定的release版的地址�Q�只需要安�?#8220;Nubula Release Individual Widgets”中的“Nebula Grid Feature”卛_��)

再安装logback-beagle插�g�Q?/div>

http://logback.qos.ch/p2/ ( "Logback" "Logback Beagle" "SLF4J"�q�三个都得�?

完成后按“alt-shift-Q,Q”弹出view选择框，扑ֈ�beagle打开卛_��Q�之后需要在logback-test.xml里配�|?lt;consolePlugin />�Q�参见logback文档�Q��?/div>

在logback-test.xml里加上配�|?lt;consolePlugin />卛_��

——实际上这个配�|�会自动创徏一个SocketAppender�Q��ƈ把日志发到本机的4321端口�?/div>

单击停止滚动�Q�双��d��始滚�?/div>

右键菜单可以跌��{到调用行�Q�也可以查看最�?行调用栈

配置�Q?/div>

eclipse的preference�?

Run/Debug - Beagle

在这里可以自定义控制台输出的pattern

General - Appearance - Colors and Fonts

可以单独对Beagle讄��字体

王星�?/a> 2014-07-13 19:01 发表评论

logback_doc_manual_09_logging_separation

Sun, 13 Jul 2014 11:00:00 GMT

http://logback.qos.ch/manual/loggingSeparation.html

主要处理多个应用�E�序�q�行在同一个web容器�Q��ƈ且每个应用��用各自独立的日志环境�?/div>

——��x��一个tomcat�q�行了多个项�?#8212;—也就�?#8220;一个JVM�Q�多个ClassLoader�Q�每个ClassLoader拥有自己独立的Logger Context”的问题�?/div>

Context Selectors

调用LoggerFactory.getLogger("foo")的时候，会要求SLF4J�l�定一个ILoggerFactory�Q�如果SLF4J使用的是logback�Q�那�?#8220;�l�定ILoggerFactory”的方法，会代理给一个ContextSelector实例�Q�该实例会根据情况返回最合适的LoggerContext对象——�q�个对象实现了ILoggerFactory接口�?/div>

默认��L��q�回DefaultContextSelector�Q�可以在�pȝ��属性里通过logback.ContextSelector属性指定自��q��c�R�?/div>

ContextJNDISelector

�Ҏ��JNDI查找Selector——�q�样可以在各个项目的web.xml里配�|�自��q��JNDI环境变量�?/div>

��Z��在单个web��目重启和关闭的时候，对应的logger Context可以被回�Ӟ��最好配�|�ContextDetachingSCL监听�?/div>

不过每次获取logger都查找JNDI太慢�Q�可以配�|�LoggerContextFilter�q��o器来避免——会在每个http��h��到来的时候把logger context攑֜��U�程内部�Q�从而允�怹�后蟩�q�JNDI搜烦�?/div>

此时最好把logger全声明成static的，减少logger的获取��L��数�?/div>

Taming static references in shared libraries

如果有一个类属于�׃�n包，被两个web��目同时引用

1�Q�当�q�个�c�M��用非静态logger�Ӟ��一切良好，来自两个web��目的调用，会返回各自的logger context�?/div>

2�Q�当�q�个�c�M��用静态logger�Ӟ��会错误的�q�回首次调用它的web��目的logger context——对这个问题ContextJNDISelector无能为力�Q�eluded a solution for eons... 哈哈哈哈�Q?/div>

对于上述�?#8220;来自��q��的静态logger�Q�获取不同的logger context”的问题，有几个的办法�Q?/div>

1�Q�共享类�Ҏ��非静态logger——一般不现实�Q�因为共享类的源码往往不受��目控制�?/div>

2�Q�把�׃�n�c�L��到web��目�?#8212;—也够呛，一个两个类�q�好�Q�那么多�W�三方依赖咋弄？

3�Q�所以还有一�U�取巧的办法�Q�用SiftingAppender�Q�根据JNDI信息把不同的日志分别输出��C��同的文�g里去�Q�logback提供了JNDIBasedContextDiscriminator帮助做这事儿�Q?#8212;—也就是说�Q�两个项目分享同一个logger�Q�等到其兌��的appender需要把event输出到文件时�Q�再临时军_��输出到哪个文件�?/div>

上述�W?�U�方法有一个问题：

假如��目A和项目B都��用共享包S�?/div>

��目A启动�q�调用S的时候，��已�l�把S的logger context讄��为A了，日志会写入A.log中�?/div>

B启动�q�调用S的时候logger contex依然是A�Q�不�q�因为配�|�了SiftingAppender的存在，B的日志依然可以写到正��的B.log中）

——也就是说�Q�共享logger的问题�ƈ没有实质解决�Q�这个logger�q�是只能属于A或者B其中之一�Q�只不过logger在写日志前根据MDC里的JNDI可以��日志写到正��的文�g中去�?/div>

而初始化了两个不同的logger context都指向B.log�Q�存在多个线�E�写同一个文件的不安全问�?#8212;—需要对appender配置prudent参数来解冻I��会媄响性能�Q��?/div>

�Q�正�怋�用都是一个web container部��v一个web��目�Q�很��遇��C��q�情��c��这部分文档看的很蛋�?#8230;…�Q?/div>

王星�?/a> 2014-07-13 19:00 发表评论

logback_doc_manual_07_filters

Sun, 13 Jul 2014 10:59:00 GMT

http://logback.qos.ch/manual/filters.html

logback-classic有两�U�filter�Q�Regular filters和turbo filters�Q�挂在appender�?/div>

Regular filters

只有一个decide()�Ҏ��Q�返回DENY, NEUTRAL or ACCEPT

LevelFilter

INFO

DENY

ThresholdFilter

高于或等于指定日志��别的记录�Q�会�q�回NEUTRAL

INFO

EvaluatorFilter

EventEvaluator的实现判断某个条件是否满��?/div>

GEventEvaluator

接受groovy语法的布��表辑ּ�作�ؓ判断条�g�Q�需要依赖Groovy�q�行�Ӟ��表达式语句在配置的时候完成编译�?/div>

logback会自动将目标事�g作�ؓ一个变量传�q�来�Q�可以用“event”或�?#8220;e”来引用�?/div>

TRACE, DEBUG, INFO, WARN and ERROR�q�些�U�别也引入了�Q�所以可以这样判断相�{�： "event.level == DEBUG" �?/div>

其他比较�W�，大于��于�Q�需要�{换成int再比较�?/div>

e.level.toInt() >= WARN.toInt() &&
!(e.mdc?.get("req.userAgent") =~ /Googlebot|msnbot|Yahoo/ )

DENY
NEUTRAL

JaninoEventEvaluator

使用java表达式，使用上比��Z��groovy的GEventEvaluator�J�琐�Q�但执行速度更快�?/div>

详情略�?/div>

Matchers

执行上面的过滤器�Ӟ��可以调用String.matches()�Ҏ��Q�但代�h是每�ơ需要重�~�译一个正则Pattern对象�?/div>

所以可以预先定义和�~�译一个，以便复用�?/div>

详情略�?/div>

TurboFilters

跟普通过滤器功能一��P��但是�Q?/div>

1�Q�TurboFilter是跟logging context兌��的，而不是跟appender兌��。作用域更大。不仅在指定appender使用�Ӟ��而且在每�ơlogging��h��旉��会被调用�?/div>

2�Q�他们是在LoggingEvent对象创徏之前被调用，�q��o时不需要event实例做参敎ͼ�所以性能更高�Q�因为在event创徏之前��已�l�执行过滤了�Q��?/div>

内置了一些TurboFilter�Q?/div>

MDCFilter ��试指定的值是否存在于MDC�?/div>

DynamicThresholdFilter ��Z��MDC的key和level来限��?/div>

MarkerFilter ��试指定的marker是否出现在请求中

DuplicateMessageFilter

自动�q��o相同的消息�?/div>

使用��单的字符串比�?#8212;—即��两个字符串基本相同，相差一两个字母�Q�也会被认�ؓ不同�?/div>

仅比较raw字符�Ԍ��用{}转义�q�的字符串不��L��较�?/div>

可以通过AllowedRepetitions讄��允许的重复上限，��过上限的会被抛弃。默认大��ؓ5

需要通过一个内部cache来保存老的消息以便判断�Q�可以通过CacheSize讄��~�存大小�Q�默�?00.

在evaluator的expression里，��logging旉��与项目启动时间对比，可以控制仅输�?#8220;��目启动�?0�U�内的某�c�d��日志”——�q�个对于“��认某个定时��d��在启动时是运行状�?#8221;很有用，例如�Q?/div>

logger.getName().contains("LoggingTask") &&
message.contains("Howdydy-diddly-ho") &&
(timeStamp - event.getStartTime()) >= 20000

DENY

王星�?/a> 2014-07-13 18:59 发表评论

logback_doc_manual_08_mapped_diagnostic_contexts

Sun, 13 Jul 2014 10:59:00 GMT

http://logback.qos.ch/manual/mdc.html

MDC�Q�注意这个类在org.slf4j包里�Q?/div>

��Z��“多个�U�程同步处理多个��h��”的假设来设计的，上下文信息记录�?/div>

——子线�E�会自动拯��双亲�U�程的这�c�M��息�?/div>

——如果没有附加处理的话�Q�放入线�E�池处理的�Q务会丢失MDC上下文�?/div>

该设计假定向MDC放数据的速度不会太快�?/div>

最常用的web场景�Q�是集成在一个servlet的Filter中，在请求时载入MDC信息�Q�doFilter处理完成后卸载MDC信息�?/div>

——最好在“验证用户”�q�个Filter之后�Q�或者之中）�q�行�Q�这样可以把用户验证信息�Q�包括但不限于用户名�Q�写入MDC�?/div>

交给�U�程池处�?submit)之前�Q�MDC.getCopyOfContextMap()�Q�把�q�回的map当作参数传给��d��U�程

�U�程池处理代码的�W�一行：MDC.setContextMapValues()�Q�把接到的map参数讄��到本�U�程的MDC中（别忘了最后清除掉�Q?/div>

MDCInsertingServletFilter

��web��h��常用信息讄��到MDC中：

req.remoteHost as returned by the getRemoteHost() method

req.xForwardedFor value of the "X-Forwarded-For" header

req.requestURI as returned by getRequestURI() method

req.requestURL as returned by getRequestURL() method

req.queryString as returned by getQueryString() method

req.userAgent value of the "User-Agent" header

web.xml中的配置

MDCInsertingServletFilter

ch.qos.logback.classic.helpers.MDCInsertingServletFilter

MDCInsertingServletFilter
/*

注意filter��序�Q�经�q�该filter�q��o之后�Q�其它filter才能打印出MDC信息�Q�特别是struts之类依赖filter处理主逻辑的）

使用例子�Q?/div>

%X{req.remoteHost} %X{req.requestURI}%n%d - %m%n

——其实没多大意义，�q�是自己写这个filter�Q�挑选自��q��有效信息比较好�?/div>

王星�?/a> 2014-07-13 18:59 发表评论

logback_doc_manual_05_encoders

Sun, 13 Jul 2014 10:58:00 GMT

http://logback.qos.ch/manual/encoders.html

Encoder

负责��事件对象�{换�ؓ字节数组.

目前只有PatternLayoutEncoder是唯一有用的Encoder�?/div>

LayoutWrappingEncoder

兼容的包装器�Q�因��版本的logback是蟩�q�Encoder直接依赖Layout的）

PatternLayoutEncoder

针对PatternLayout�Q�最常用的layout�Q�定制的兼容包装器�?/div>

immediateFlush属性：是否��日志立��d��入磁盘，默认为true。将�q�个选项设�ؓfalse可以��N��4�?倍的吞吐量�?/div>

foo.log

%d %-5level [%thread] %logger{0}: %msg%n

false

outputPatternAsHeader属性：在日志文件的�剙��输出一行字�W�串样式�Q�默认flase�?/div>

foo.log

%d %-5level [%thread] %logger{0}: %msg%n
true

输出�l�果�Q?/div>

#logback.classic pattern: %d [%thread] %-5level %logger{36} - %msg%n
2012-04-26 14:54:38,461 [main] DEBUG com.foo.App - Hello world
2012-04-26 14:54:38,461 [main] DEBUG com.foo.App - Hi again

王星�?/a> 2014-07-13 18:58 发表评论

logback_doc_manual_06_layouts

Sun, 13 Jul 2014 10:58:00 GMT

http://logback.qos.ch/manual/layouts.html

PatternLayout

转换模式�c�M��于C语言里的printf()�?/div>

转移字符�Q?/div>

c{length}

lo{length}

logger{length}

其中的length代表输出的logger长度�?/div>

设�ؓ0的话例外�Q�仅输出最双��的logger名�?/div>

其余情况会自动计��，��量使得输出的��d��W�串长度��于指定长度——但是�Q�最双��的logger名称无论如何会完整保留，同时前面的每一�U�logger�Q�最��会被精��?个字�W��?/div>

——%c{1}

C{length}

class{length}

打印调用者的�c�d��U�ͼ�讄��Ҏ��与上面一栗��?/div>

性能不高�?/div>

contextName

打印logger在event最初绑定的logger context的名�U��?/div>

d{pattern}

date{pattern}

d{pattern, timezone}

date{pattern, timezone}

输入日志旉��Q��用java.text.SimpleDateFormat的日期格式化�Ҏ��?/div>

如果不指定日期格式，默认使用ISO8601�Q�也��是2006-10-20 14:06:49,812�q�种形式�?/div>

——%d

F / file

输出java源文件的名称�?/div>

性能不高�?/div>

caller{depth}

caller{depth, evaluator-1, ... evaluator-n}

打印日志事�g的调用堆栈�?/div>

使用评估器evaluator军_��是否打印�?/div>

line

输出日志记录��h��发�v的行数�?/div>

性能不高�?/div>

msg

message

日志正文

——%m

method

日志调用�Ҏ��名�?/div>

性能不高

操作�pȝ��对应的换行符

——%n

level

日志�{��

relative

应用�E�序启动到日志创建的相对旉��

thread

�U�程�?/div>

——%t

X{key:-defaultVal}

mdc{key:-defaultVal}

MDC信息

ex{depth}

exception{depth}

throwable{depth}

ex{depth, evaluator-1, ..., evaluator-n}

exception{depth, evaluator-1, ..., evaluator-n}

throwable{depth, evaluator-1, ..., evaluator-n}

输出异常堆栈深度�Q�如果有的话�Q�，默认full全部输出�?/div>

可以指定的参数��|��

short�Q�打印堆栈的�W�一�?/div>

full�Q�打印所有行

��M��数字�Q�指定行�?/div>

使用评估器evaluator军_��是否打印�?/div>

xEx{depth}

xException{depth}

xThrowable{depth}

xEx{depth, evaluator-1, ..., evaluator-n}

xException{depth, evaluator-1, ..., evaluator-n}

xThrowable{depth, evaluator-1, ..., evaluator-n}

跟上面的�c�M��Q�但是附加了包信息�?/div>

如果包信息不准确�Q�是猜测的）�Q�那么会自动在包信息前面附加一�?#8220;~”字符�?/div>

如果在日志信息模式里�Q�未指定��M��异常格式�Q�那么系�l�会自动在末��֊�上一�?xEx�?/div>

如果不想打印包信息（例如netbean里会出问题）�Q�那么在日志模式的末��明��指�?ex卛_��Q�就会输��Z��包含包信息的堆栈�?/div>

如果想不打印��M��异常堆栈信息�Q�可以��?nopex�?/div>

——%xEx

nopex

nopexception

加上%nopex可以��L��pȝ��自动在日志模式末��添�?xEx——也就是完全禁止异常堆栈打印�?/div>

marker

输出兌��的marker信息�Q�如果marker多��兌��Q�会都打印出来�?/div>

property{key}

输出key兌��的属�?#8212;—定义在logger context或者system properties里面�?/div>

replace(p){r, t}

��p中的所有符合r正则的字�W�串�Q�都替换成t�?/div>

例如%replace(%logger%msg){'\.', '/'}�Q�会��输出的logger和msg信息中的点号都替换成斜杠�?/div>

rEx{depth}

rootException{depth}

rEx{depth, evaluator-1, ..., evaluator-n}

rootException{depth, evaluator-1, ..., evaluator-n}

�c�M��于xEx�Q�也会打印异常的包信息，但是会将root exception打印到前面，跟普通的异常打印��序是反着的�?/div>

转义癑ֈ��P�� \%

正常情况下�{义字�W�会被正��分�Ԍ��但有些时候例外，例如%date%nHello�Q�系�l�会解析%nHello��p�|。如果真的需要在%n后紧跟一个Hello�Q�可以这��P��%date%n{}Hello

我一般用�q�个�Q?/div>

%d [%t] %-5p %c{1} - %m%n

------------------------------------------------------------------

Format modifiers

控制数据�D늚�补齐�?br /> 例如 %20.30logger

如果logger长度��于20�Q�则从左边用�I�格补齐�Q�如果logger长度大于30�Q�则从开�?左边)切去多余字符�?/div>

如果20或�?0前面有负��P��则左右颠倒�?/div>

假如想给日志�U�别只输�?个字�W�（T,D,W,I,E�Q�，不需要自己写一个Converter�Q�而只需要配�|�一下即可：%.-1level

转义选项�Q?/div>

如果转义选项里面包含�Ҏ��字符�Q�特别是在��用正则表辑ּ�的时候）�Q�例如大��括受��逗号、空��|��那么可以用单引号或双引号括�v来，例如�Q?/div>

%-5level - %replace(%msg){'\d{14,16}', 'XXXX'}%n

——�q�个可以�?4�?6位的数字�Q�信用卡��P��转换为XXXX�?/div>

------------------------------------------------------------------

括号的特�D�作用：

%-30(%d{HH:mm:ss.SSS} [%thread]) %-5level %logger{32} - %msg%n

可以让括号里的两个表辑ּ�联合��h��按照30个字�W�补齐�?/div>

括号可以用反斜杠转义�Q�$%d{HH:mm:ss.SSS} [%thread]$

------------------------------------------------------------------

Coloring

着�Ԍ��window需要引其它包，linux和mac os本��n支持着艌Ӏ?/div>

样例�Q?lt;pattern>[%thread] %highlight(%-5level) %cyan(%logger{15}) - %msg %n

%highlight会将ERROR设�ؓ�U�色加粗�Q�WARN设�ؓ�U�色�Q�INFO设�ؓ蓝色�Q�其余默认�?/div>

%cyan会将logger名称设�ؓ蓝绿艌Ӏ?/div>

------------------------------------------------------------------

Evaluators

EventEvaluator�cȝ��实现�Q�用来评��C��个事件是否符合打印条件�?/div>

logger.contains("chapters.layouts") && \
message.contains("who calls thee")

%-4relative [%thread] %-5level - %msg%n%caller{2, DISP_CALLER_EVAL}

注意因�ؓxml的关�p�，要用&转义&

应用场景�Q?/div>

例如�Q�如果日志��别是WARN以上�Q��ƈ且logger是来自一个胦务模�?#8212;—那么��打印caller信息�?/div>

注意�Q?/div>

�?caller转义模式中，当Evaluators�q�回true的时候才输出�?/div>

�?ex转义模式中，当Evaluatorstrue的时候不输出�?/div>

例如下面的配�|�，当异常对象�ؓTestException�Ӟ��不输出�?/div>

throwable != null && throwable instanceof \
chapters.layouts.TestException

%msg%n%ex{full, DISPLAY_EX_EVAL}

------------------------------------------------------------------

Creating a custom conversion specifier

�?/div>

------------------------------------------------------------------

HTMLLayout

使用html表格来布局日志信息�?/div>

可以使用普通的pattern转义�W�，但�{义字�W�之前，不许用包括空格在内的��M��字符分隔�?/div>

%relative%thread%mdc%level%logger%msg

test.html

HTMLLayout会自动创��Z��个DefaultThrowableRenderer�Q�将异常信息打印到完整的一行里。如果不惌��P��可以指定一个NOPThrowableRenderer�?/div>

用CSS指定表格的样式：�?/div>

该Layout最常见的用法是配合SMTPAppender�Q�发送html格式的日志邮件�?/div>

------------------------------------------------------------------

Logback access

�?/div>

王星�?/a> 2014-07-13 18:58 发表评论

logback_doc_manual_04_appenders

Sun, 13 Jul 2014 10:57:00 GMT

http://logback.qos.ch/manual/appenders.html

Appender都集成ch.qos.logback.core.Appender接口�?/div>

每个Appender可以�l�定若干个Filter�?/div>

每个Appender可以��Q务代理给Layout或者Encoder�?/div>

每个Layout或者Encoder只能属于1个Appender�?/div>

Appener也可以不包含Layout或者encoder�Q�例如SocketAppender�Q�直接把Event序列化传输�?/div>

ch.qos.logback.core.AppenderBase�q�是一个抽象类�Q�对Appender接口提供了骨架实玎ͼ��U�程安全�?/div>

ch.qos.logback.core.UnsynchronizedAppenderBase是对应的�U�程不安全的�c�，但是可以��线�E�安全性委托给下一层的�c�（例如OutputStream�Q?/div>

OutputStreamAppender是文件输出和控制台输出Appender的父�c�，�c�d��ơ结构如下：

ConsoleAppender

输出到System.out or System.err

可配�|�属性：

encoder

target: 默认是System.out

withJansi�Q? 默认false�Q�用来在windows中支持控制台色彩�?/div>

样例�Q?/div>

%-4relative [%thread] %-5level %logger{35} - %msg %n

----------------------------------------------------------

FileAppender

写入到文�Ӟ��新消息到来，写入前，才会判断是否该分割文件等�Q?/div>

可配�|�属性：

append�Q? 文�g�q�加�Q�默认�ؓtrue

encoder�Q?

file�Q? 文�g路径和名词（如果windows下，记得分隔�W��{义）

prudent�Q? 谨慎模式�Q�不同JVM�Q�甚臛_��在于不同��L��上）安全的写入同一个文件。默认关闭�?/div>

默认每行都flush到磁盘，可以修改Encoder的immediateFlush属性来改变�q�一行�ؓ�?/div>

样例�Q?/div>

testFile.log

true

%-4relative [%thread] %-5level %logger{35} - %msg%n

唯一名词的记录文�Ӟ��通过启动旉��戻I��Q?/div>

log-${bySecond}.txt

%logger{35} - %msg%n

——�q�样��可以在每次��目启动时生成一个新的文件�?/div>

默认是��用xml解析的时��_��也可以指定��用log context的创建时��_��

timeReference="contextBirth"/>

----------------------------------------------------------

RollingFileAppender

滚动记录日志文�g

有两个子�l��g�Q?/div>

RollingPolicy ——接管“滚动”操作�Q�控制该操作如何发生

TriggeringPolicy ——军_��滚动操作是否发生�Q�何时发�?/div>

默认情况下，必须同时含有上述两个�l��g。不�q�有的RollingPolicy也实��C��后者的接口�Q�那么可以��n�?职�?/div>

可配�|�属性：

file�Q?/div>

append�Q?/div>

encoder�Q?/div>

rollingPolicy�Q?/div>

triggeringPolicy�Q?/div>

prudent�Q?/div>

RollingPolicy

包含的操作：��当前的日志文�g归档�Q��ƈ重命名）�Q�压�~�（如果需要）

TimeBasedRollingPolicy

最常用的，��Z��旉��滚动�Q�同时实��C��RollingPolicy和TriggeringPolicy

可配�|�属性：

fileNamePattern�Q? 文�g名匹配格�?/div>

文�g�?日期定义�?#8220;%d”

日期定义器的格式在SimpleDateFormat中定�?/div>

滚动周期是通过日期定义器推断出来的

其父元素RollingFileAppender中file属性可以省略（因�ؓ可以用fileNamePattern猜测出当前时间的日志名）

也可以不省略�Q�这样可以�ؓ“当前日志文�g”�?#8220;归档日志文�g”分别制定不同的�\�?/div>

日志定义器中的正反斜杠都会被认�ؓ是目录分隔符

可以指定多个日期定义器，但只能有1个是主要的，其余的必��L��Cؓaux�Q�辅助的�Q?/div>

maxHistory�Q? 最大文件数

cleanHistoryOnStart�Q? 启动时清除历史归档日�?/div>

对fileNamePattern的更详细的解释和�C�Z��Q?/div>

/wombat/foo.%d

按天分隔日志

未指定格式，所以默认�ؓyyyy-MM-dd�Q�按天滚动）

如果在RollingFileAppender中指定了file�Q�默认日志文件名�Q�：

今天日志�?/wombat/foo.2006-11-24

昨天日志�?/wombat/foo.2006-11-23

如果没有在RollingFileAppender中指定file�?#8220;/wombat/foo.txt”�Q?/div>

今天日志�?/wombat/foo.txt

昨天日志�?/wombat/foo.2006-11-23

——其实不指定默认日志文件名的方式更好，因�ؓ避免了滚动时重命名操作，也就避免了潜在异常�?/div>

/wombat/%d{yyyy/MM}/foo.txt

�?#8220;�q?�?#8221;分两�U�文件夹�Q�文件名固定�?#8220;foo.txt”

如果在RollingFileAppender中指定了file�Q�默认日志文件名�Q�：

2006�q?0月日志�ؓ /wombat/2006/10/foo.txt

2006�q?1月日志�ؓ /wombat/2006/11/foo.txt

如果没有在RollingFileAppender中指定file�?#8220;/wombat/foo.txt”�Q?/div>

当前正在写的日志永远�?nbsp;/wombat/foo.txt

归档的日志格式�ؓ /wombat/2006/10/foo.txt

/wombat/foo.%d{yyyy-ww}.log

每个星期归档一个新文�g�Q�注意具�?#8220;哪天��是一个星期的�W�一�?#8221;取决于系�l�locale属性）

/wombat/foo%d{yyyy-MM-dd_HH}.log

每小时一�ơ归�?/div>

/wombat/foo%d{yyyy-MM-dd_HH-mm}.log

每分钟一�ơ归�?/div>

/foo/%d{yyyy-MM,aux}/%d.log

每天一�ơ归档，但每个月一个新文�g�?/div>

如果fileNamePattern文�g名是�?gz或�?zip�l�尾的，那么TimeBasedRollingPolicy会自动压�~�：

/wombat/foo.%d.gz

日志归档�?#8220;记录日志的事�?#8221;触发的，所以有一定�g�q�。例如第二天的第一条日志是临晨01:00才过来，那么�q�个时候才会归档前一天的日志�?/div>

配置样例�Q?/div>

logFile.log

logFile.%d{yyyy-MM-dd}.log

%-4relative [%thread] %-5level %logger{35} - %msg%n

----------------------------------------------------------

FixedWindowRollingPolicy

可配�|�属性：

minIndex:

maxIndex:

fileNamePattern:

必须包含“%i”占位�W�，用来表示��当前烦引值插入什么位�|��?/div>

例如“MyLogFile%i.log”配合“最��?�Q�最�?”�Q�表�C�文件名为：MyLogFile1.log, MyLogFile2.log, MyLogFile3.log

同样加上zip或gz后缀可以启用压羃

因�ؓ每次需要很多重命名操作�Q�重命名�ơ数�{�于window size�Q�，所以如果设�|�size��过20�Q�会被强制指定�ؓ20.

配置样例�Q?/div>

test.log

tests.%i.log.zip

5MB

%-4relative [%thread] %-5level %logger{35} - %msg%n

----------------------------------------------------------

SizeAndTimeBasedFNATP�Q�File Naming And Triggering Policy�Q?#8212;—是TimeBasedRollingPolicy的一个子�l��g

配置样例�Q?/div>

mylog.txt

mylog-%d{yyyy-MM-dd}.%i.txt

class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">

100MB

%msg%n

——每天滚动一个文�Ӟ��如果文�g体积辑ֈ�100M�Q�则也拆分�?/div>

——也支持自动删除老文�Ӟ��可以通过maxHistory指定保存的最多文件数�Q�每天最多这么多�Q�还是一共最多这么多�Q�）

----------------------------------------------------------

SizeBasedTriggeringPolicy——一般配合FixedWindowRollingPolicy使用

指定文�g��过“maxFileSize”指定大小�Ӟ��上层RollingFileAppender触发滚动操作�?/div>

默认“10MB”�Q�可以指定各�U�后�~��Q�KB,MB,GB

----------------------------------------------------------

SocketAppender and SSLSocketAppender

以及后面关于�|�络�Q�数据库�Q�远�E�日志服务器�Q�JNDI�{?#8230;…省略……

----------------------------------------------------------

SiftingAppender

可以�Ҏ��指定的变量分割文件。例如根据用户ID�Q�则每个用户一个日志文件�?/div>

可配�|�参敎ͼ�

timeout�Q�如果一个关联的appender如果��过默认30分钟没有被访问，则被SiftingAppender卸蝲掉�?/div>

maxAppenderCount�Q�可以最大追�t�的兌��appender数量�Q�默认int最大倹{�?/div>

�q�个Appener会把日志记录动作代理�l�关联的appender�?/div>

选择条�g由Discriminator指定�Q�默认�ؓMDCBasedDiscriminator�?/div>

�C�Z��Q�假讑ֺ�用程序这栯��|�了MDC信息�Q?/div>

logger.debug("Application started");
MDC.put("userid", "Alice");
logger.debug("Alice says hello");

然后�q�样配置�Q?/div>

userid

unknown

${userid}.log

false

%d [%thread] %level %mdc %logger{35} - %msg%n

因�ؓ��定timeout和maxAppenderCount比较困难�Q�所以如果程序可以知�?#8220;执行到某个地方很可能应该关闭对应的appender”�Q�那么可以明��指定一个FINALIZE_SESSION的marker。这样siftingAppender兌��的对应appender�Q�会在接到这个marker的几�U�钟后关闭。例如：

import static ch.qos.logback.classic.ClassicConstants.FINALIZE_SESSION_MARKER;

void job(String jobId) {

MDC.put("jobId", jobId);

logger.info("Starting job.");

// will cause the nested appender reach end-of-life. It will

// linger for a few seconds.

logger.info(FINALIZE_SESSION_MARKER, "About to end the job");

try {

.. perform clean up

} catch(Exception e);

// This log statement will be handled by the lingering appender.

// No new appender will be created.

logger.error("unexpected error while cleaning up", e);

}

----------------------------------------------------------

SMTPAppender

��日志事件缓存指定的数量�Q�被特定事�g触发后，异步发送邮件�?/div>

smtpHost

smtpPort 默认25

to 发送目标，多个联系人可以用逗号隔开�Q�也可以用多�?lt;to>元素

from 发送者邮��，如果惛_��含名字，可以用特定格�?#8220;Adam Smith <smith@moral.org>”

subject 邮�g标题�Q�可以��用PatternLayout的�{义字�W�，会用“触发该邮件的日志事�g”的信息替换�{义字�W?/div>

discriminator 默认只有一个缓存。通过指定该属性，可以有多个缓存，�q�样可以�Ҏ��事�g信息发给不同的�h或者ip

evaluator 声明一�?lt;EventEvaluator/>元素�Q�通过class属性指定类型。默认�ؓOnErrorEvaluator�Q�也可以自己指定OnMarkerEvaluator,JaninoEventEvaluator,GEventEvaluator

cyclicBufferTracker 环�Ş�~�存跟踪器，��Z��discriminator的返回值工作。默认保存缓存大��ؓ256

username

password

STARTTLS 如果开启，会发起STARTTLS命��o�Q�导致连接�{换�ؓSSL。连接默认是不��用加密的。默认�ؓfalse

SSL 如果开启，那么使用SSL�q�接。默认false�?/div>

charsetEncoding 默认UTF-8

localhost 如果SMTP发送方的hostname没配�|�好�Q�邮件服务器可能拒绝��h��Q�这个时候可以设�|�这个��gؓ客户端全名�?/div>

asynchronousSending 异步发送，默认true。特定情况下需要设�|��ؓfalse�Q�例如应用程序发送完邮�g��׃��立即关闭�?/div>

includeCallerData 包含调用者信息，默认为false�?/div>

sessionViaJNDI logback依赖javax.mail.Session来发送邮件。该属性默认�ؓfalse�Q�SMTPAppender会根据配�|�构建新的Session。如果设为true�Q�会去web容器��L��Session对象�Q�此时应用程序不应该再依赖mail.jar�{?/div>

jndiLocation 查找JNDI的�\径，例如"java:comp/env/mail/Session"

最多保�?56条日志事�Ӟ��否则内存消耗太大（不徏议自己指定其它��|��?/div>

发邮件依赖JavaMail API (mail.jar)和JavaBeans Activation Framework (activation.jar) ——maven里引入前者会自动依赖后者�?/div>

发送者和接收者都可以是动态属性：

${smtpHost}
${to}
${from}

注意上面的layout也可以用patternLayout�Q?/div>

%date %-5level %logger{35} - %message%n

触发事�g�Q?/div>

默认是OnErrorEvaluator�Q�但可以自己定制。SMTPAppender仅维护一个Evaluator�Q�这个Evaluator可以自己�l�护状态，例如可以实现一个CounterBasedEvaluator�?/div>

��Z��标记Marker的事件触发：

Marker notifyAdmin = MarkerFactory.getMarker("NOTIFY_ADMIN");
logger.error(notifyAdmin,
"This is a serious an error requiring the admin's attention",
new Exception("Just testing"));

NOTIFY_ADMIN

TRANSACTION_FAILURE

�q�可以��用更加通用的JaninoEventEvaluator或者GEventEvaluator�Q�他们提供更复杂更强大的甄别功能�Q�也包含了OnMarkerEvaluator的功能）�?/div>

�w�䆾验证/STARTTLS/SSL

SMTPAppender支持用户名和密码的加密验证�?/div>

STARTTLS方式是先使用非加密方式徏立连接，然后切换到SSL�Q�常用于server-server交互�Q��?/div>

SSL方式是直接徏立SSL�q�接�Q�一般用于client-sever交互�Q��?/div>

Appender configuration for Gmail (SSL)

smtp.gmail.com
465
true
YOUR_USERNAME@gmail.com
YOUR_GMAIL_PASSWORD

SMTPAppender for Gmail (STARTTLS)

smtp.gmail.com
587
true
YOUR_USERNAME@gmail.com
YOUR_GMAIL_xPASSWORD

Discriminator

用MDCBasedDiscriminator做示例，�Ҏ��MDC的��|��l�护多个�~�存

req.remoteHost
default

${HOSTNAME} -- %X{req.remoteHost} %msg"

%date%level%thread%X{req.remoteHost}%X{req.requestURL}%logger%msg

上面的例子先利用了MDCInsertingServletFilter把请求方的hostname或ip讄��到MDC中�?/div>

每一个remoteHost都有一个自��q��buffer�Q�一旦某个remoteHost触发了发送邮件的��h��Q�那么该buffer里的256条信息会被发送出厅R�?/div>

Buffer��理�Q?/div>

上面的例子，每一个远�E�地址都有自己的buffer�Q�会极大的消耗内存�?/div>

默认情况下，logback内部最多允�?4个buffer同时存在�Q�LRU��法换出。超�q?0分钟未��用的buffer也会被换出。该值可以通过maxNumberOfBuffers来设�|��?br />

�q�里有问题，通过各种手段都无法设�|�此��|��貌似是个bug�Q�我在尽我所能查遍所有资料后�Q�在stackoverflowh和官方jira上提了这个问题：

http://stackoverflow.com/questions/24836151

http://jira.qos.ch/browse/LOGBACK-996

在高强度�pȝ��中，上面�?个保护机制不够，需要加入手工管理：通过明确指定“FINALIZE_SESSION”�q�个Marker�Q�来告诉logback去释攑֯�应的buffer�Q�这样就可以安全的将maxNumberOfBuffers讄��?12乃至1024。（具体讄��办法参照SiftingAppender里描�q�的�Q?/div>

�q�里是官方的一个SMTPAppender的例子：

http://logback.qos.ch/recipes/emailPerTransaction.html

注意Marker可以叠加�Q�所以如果有必要�Q�可以把“发送邮件的Marker”�?#8220;�l�结Session�Q�以便清理buffer�Q�的Marker”兌��在一赗��?/div>

Marker SMTP_TRIGGER = MarkerFactory.getMarker("SMTP_TRIGGER");

SMTP_TRIGGER.add(FINALIZE_SESSION_MARKER);

----------------------------------------------------------

AsyncAppender

�c�M��于单独的一个事件分发器�Q�所以必��d��用另一个appender�?/div>

用一个BlockingQueue�~�冲事�g�Q�然后创��Z��个线�E�，从队列里获取事�g�q�分发给引用的appender�?/div>

默认情况下，如果队列辑ֈ�80%的容量，则丢弃TRACE,DEBUG,INFO�U�别的日志�?/div>

应用�E�序停止的时候，会通知LoggerContext停止�Q�在停止各个Appender�Ӟ��AsyncAppender会停止接收日志，�q�将信息flush到磁盘�?/div>

配置参数�Q?/div>

queueSize�Q�默�?56

discardingThreshold�Q�默认队�?0%可用的时候开始选择性抛弃信息，设�ؓ0表示不抛�?/div>

includeCallerData�Q�是否包括调用者信息（重开销�Q�，默认只复制线�E�名和MDC信息�Q�因为切换了�U�程�Q�其余信息会丢失�Q?/div>

队列全满的时候，写日志动作会被block�Q�直到队列有可用�I�间�?/div>

----------------------------------------------------------

自定义Appender

�?/div>

----------------------------------------------------------

Logback Access

大部分Appender�Q�在logback-classic与logback-access中��用方式类伹{�?/div>

王星�?/a> 2014-07-13 18:57 发表评论

logback_doc_manual_03_configuration

Sun, 13 Jul 2014 10:56:00 GMT

http://logback.qos.ch/manual/configuration.html

-------------------------------------------------------

与spring的配�|�：

貌似官网上没有介�l�，但是作者在github上徏立了一个扩展项目用于logback与spring�l�合�?/div>

https://github.com/qos-ch/logback-extensions

目前最新版本是0.1.2�Q�很多maven公开库里已经有了�?/div>

maven配置�Q?/div>

org.logback-extensions

logback-ext-spring

0.1.2

web.xml配置日志框架启动监听器：

logbackConfigLocation

/WEB-INF/classes/logback.xml

ch.qos.logback.ext.spring.web.LogbackConfigListener

-------------------------------------------------------

logback中的配置�Q?/div>

可以用java�E�序配置�Q�也可以用xml或者groovy脚本配置�?/div>

使用 http://logback.qos.ch/translator/ 可以把log4j的配�|�自动�{换过来�?/div>

logback内部查找配置的过�E�：

1�Q�在classpath查找“logback.groovy”

2�Q�在classpath查找“logback-test.xml”

3�Q�在classpath查找“logback.xml”

4�Q��用自�w�的BasicConfigurator做基本配�|�，所有日志被输出到控制台�?/div>

—— 一般把“logback-test.xml”攑ֈ�maven的测试�\径，�?#8220;logback.xml”攑ֈ�maven的正式�\径，前者优先��更高�?/div>

logback的状态，加蝲配置文�g的过�E�：

代码打印�Q?/div>

LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();

StatusPrinter.print(lc);

配置文�g形式打印�Q?/div>

...

也可以通过讄��StatusListener来监听logback的启动和打印状�?#8212;—在生产环境挺有用�Q�因为配�|�文件�\径挺深�?/div>

通过在系�l�变量里加入"logback.configurationFile"指定logback配置文�g路径�Q?/div>

java -Dlogback.configurationFile=/path/to/config.xml chapters.configuration.MyApp1

讄��自动扫描和遇到变更时重新加蝲配置文�g�Q�不指定周期的话默认�?分钟�Q�：

...

每当N个（logback会自动调节）日志��h��Q�logback会检查一下扫描周期是否已�l�到达，如到辑ֆ��查配�|�文件�?/div>

通过web讉K��状态信息：

在web.xml配置�Q?/div>

ViewStatusMessages

ch.qos.logback.classic.ViewStatusMessagesServlet

ViewStatusMessages

/lbClassicStatus

然后讉K��Q�http://host/yourWebapp/lbClassicStatus

注册控制台状态监听器�Q?/div>

java代码方式�Q?/div>

LoggerContext lc = (LoggerContext) LoggerFactory.getILoggerFactory();

StatusManager statusManager = lc.getStatusManager();

OnConsoleStatusListener onConsoleListener = new OnConsoleStatusListener();

statusManager.add(onConsoleListener);

用配�|�文件方式：

...

�pȝ��变量方式�Q?/div>

java -Dlogback.statusListenerClass=ch.qos.logback.core.status.OnConsoleStatusListener

停止logback�Q?/div>

java代码方式�Q?/div>

LoggerContext loggerContext = (LoggerContext) LoggerFactory.getILoggerFactory();

loggerContext.stop();

web应用�Q?/div>

ServletContextListener.contextDestroyed()会自动调用上面的stop�Ҏ��?/div>

-------------------------------------------------------

配置文�g格式�Q?/div>

最外层�?lt;configuration>元素�Q�里面有元素

元素�Q?/div>

level属性可以这些��|��TRACE, DEBUG, INFO, WARN, ERROR, ALL, OFF�Q�也可以明确指定�l�承�Q�INHERITED或者NULL

包含若干元素�Q�指定appender的名字�?/div>

从DEBUG改�ؓINFO�U�别�Q?/div>

%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n

-------------------------------------------------------

配置Appender�Q?/div>

name和class属�?/div>

内嵌0个或1个layout元素�Q?个或多个encoder元素�Q?个或多个filter元素。还可以内嵌��L��数量的appdenter�cȝ��属性（例如自定义的appender�c�）�?/div>

layout元素应该内嵌具体的layout�c�，但是默认��是PatternLayoutEncoder�?/div>

Appender的篏加性：

logger会记录在所有绑定在它自�w�的appender�Q�同时也会记录在该logger��先的appender上，所以有可能重复记录�Q?/div>

配置Logger Context�Q�可以用�?#8220;多个��目写入同一个日志文�?#8221;�q�种情况�Q�：

myAppName

...

-------------------------------------------------------

变量替换�Q?/div>

${USER_HOME}/myApp.log

...

——上面的变量定义在�pȝ��属性里也可以：java -DUSER_HOME="/home/sebastien" MyApp2

变量也可以定义在文�g里：

${USER_HOME}/myApp.log

...

——对应路径的文仉��应该加入“USER_HOME=/home/sebastien”

�Q�这路径��异啊�Q�是maven的结构，那打包后岂不是不能用了？�Q?/div>

像这样引用classpath的还靠谱些：

变量可以指定作用域：local�Q�context�Q�system

变量可以�怺�引用�Q?/div>

USER_HOME=/home/sebastien

fileName=myApp.log

destination=${USER_HOME}/${fileName}

命名引用�Q�如�?userid"会被替换�?alice"�Q�那�?${${userid}.password}"会被替换�?alice.password"对应的倹{�?/div>

变量可以指定默认��|��${aName:-golden} ——�q�就指定了默认值golden

变量的默认��g��可以引用变量�Q?nbsp;"${id:-${userid}}

预置变量�Q�HOSTNAME,CONTEXT_NAME

可以通过timestamp元素定义一个当前的日期和时间的动态元素�?/div>

可以自己�l�承PropertyDefiner实现动态生成属性，现在内置�?个动态属性生成器�Q?/div>

FileExistsPropertyDefiner 如果指定路径文�g存在�Q�则��指定属性设�?#8220;true”�Q�反之亦�?/div>

ResourceExistsPropertyDefiner 如果指定资源存在�Q�则��指定属性设�?#8220;true”�Q�反之亦�?/div>

条�g语句�Q?/div>

...

判断条�g只支持context变量和system变量�Q�用property()或者p()来引�?#8212;—如果没有讑֮�对应变量�Q�这两个�Ҏ��会返回空�Ԍ��而不是null�Q?/div>

isDefine()和isNull()分别判断变量是否讄��和变量是否�ؓ�I��?/div>

...

可以从JNDI��d��变量��|��作用域�ؓlocal�Q�。也可以��从JNDI��d��的变量存入另一个不同作用域的变量�?/div>

...

-------------------------------------------------------

文�g包含�Q�可以��用相对�\径。当前�\径已�l�在当前��目中定义，所以没必要与配�|�文件�\径关联）�Q?/div>

...

被包含的文�g必须�?lt;include>标签包裹�Q?/div>

"%d - %m%n"

�q�可以关联资源（例如classpath下的某个文�g�Q�：

�q�可以关联URL�Q?/div>

可以指定此次文�g包含�?#8220;可选的”�Q?/div>

-------------------------------------------------------

LoggerContextListener

其中一个实现LevelChangePropagator会监听日志环境的合适的生命周期�Q��ƈ把日志��别的变化传播�l�JUL�Q�这样JUL关闭的日志不会再传递给slf4j�Q�用�q�种方式�Ҏ��能冲击较小�Q�适合jul-to-slf4j的桥接包�?/div>

王星�?/a> 2014-07-13 18:56 发表评论