java?志,需要知道的?件事
?、 概念
Commons-logging : apache最早提供的?志的门?接?。避免和具体的?志?案直接耦合。类似于JDBC 的api 接?,具体的的JDBC driver 实现由各数据库提供商实现。通过统?接?解耦,不过其内部也实现了?些简单?志?案。
Log4j : 经典的?种?志解决?案。内部把?志系统抽象封装成Logger 、appender 、pattern 等实现。我们可以通过配置?件轻松的实现?志系统的管理和多样化配置。
Slf4j : 全称为Simple Logging Facade for JA V A:java简单?志门?。是对不同?志框架提供的?个门?封装。可以在部署的时候不修改任何配置即可接??种?志实现?案。和commons-loging 应该有?样的初衷。个?感觉设从计上更好?些,没有commons 那么多潜规则。同时有两个额外特点:
1.能?持多个参数,并通过{}占位符进?替换,避免?写logger.isXXXEnabled这种?奈的判断,带来性能提升见:https://www.sodocs.net/doc/9d18569274.html,/faq.html#logging_performance 。
2.OSGI 机制更好兼容?持
?图胜千?,官?上的?个图:
从上图可以发现,选择还是很多的。
Logback : LOGBack 作为?个通?可靠、快速灵活的?志框架,将作为Log4j 的替代和SLF4J 组成新的?志系统的完整实现。官?上称具有极佳的性能,在关键路径上执?速度是log4j 的10 倍,且内存消耗更少。具体优势见:http://logback.qos.ch/reasonsToSwitch.html
?、 常见?志?案和注意事项
https://www.sodocs.net/doc/9d18569274.html,mons-logging+log4j : 经典的?个?志实现?案。出现在各种框架?。如spring 、webx 、ibatis 等等。直接使?log4j 即可满?我们的?志?案。但是?般为了避免直接依赖具体的?志实现,?般都是结合commons-logging 来实现。常见代码如下:
import https://www.sodocs.net/doc/9d18569274.html,mons.logging.Log;
import https://www.sodocs.net/doc/9d18569274.html,mons.logging.LogFactory;
private static Log logger = LogFactory.getLog(CommonsLoggingTest.class);
代码上,没有依赖任何的log4j 内部的类。那么log4j 是如何被装载的?
Log 是?个接?声明。LogFactory 的内部会去装载具体的?志系统,并获得实现该Log 接?的实现类。?内部有?个Log4JLogger 实现类对Log 接?同时内部提供了对log4j logger 的代理。LogFactory 内部装载?志系统流程:
1. ?先,寻找https://www.sodocs.net/doc/9d18569274.html,mons.logging.LogFactory 属性配置
2. 否则,利?JDK1.3 开始提供的service 发现机制,会扫描classpah 下的META-INF/services/ https://www.sodocs.net/doc/9d18569274.html,mons.logging.LogFactory ?件,若找到则装载??的配置,使???的配置。
3. 否则,从Classpath ?寻找commons-logging.properties ,找到则根据??的配置加载。
4. 否则,使?默认的配置:如果能找到Log4j 则默认使?log4j 实现,如果没有则使?
JDK14Logger 实现,再没有则使?commons-logging 内部提供的SimpleLog 实现。
从上述加载流程来看,如果没有做任何配置,只要引?了log4j 并在classpath 配置了log4j.xml ,则commons-logging 就会使log4j 使?正常,?代码?不需要依赖任何log4j 的代码。
https://www.sodocs.net/doc/9d18569274.html,mons-logging+log4j+slf4j
如果在原有commons-logging 系统?,如果要迁移到slf4j, 使?slf4j 替换commons-logging ,也是可以做到的。原理使?到了上述commons-logging 加载的第?点。需要引?org.slf4j.jcl-over-
slf4j-1.5.6.jar 。这个jar 包提供了?个桥接,让底层实现是基于slf4j 。原理是在该jar 包?存放了配置META-INF/services/https://www.sodocs.net/doc/9d18569274.html,mons.logging.LogFactory
=https://www.sodocs.net/doc/9d18569274.html,mons.logging.impl.SLF4JLogFactory ,?commons-logging 在初始化的时候会找到这个serviceId ,并把它作为LogFactory 。
完成桥接后,那么那么简单?志门?SLF4J 内部又是如何来装载合适的log 呢?
原理是SLF4J 会在编译时会绑定import org.slf4j.impl.StaticLoggerBinder;该类??实现对具体?志?案的绑定接?。任何?种基于slf4j 的实现都要有?个这个类。如:
org.slf4j.slf4j-log4j12-1.5.6:提供对log4j的?种适配实现。
org.slf4j.slf4j-simple-1.5.6:是?种simple实现,会将log直接打到控制台。
……
那么这个地?就要注意了:如果有任意两个实现slf4j 的包同时出现,那就有可能酿就悲剧,你可能会发现?志不见了、或都打到控制台了。原因是这两个jar 包?都有各?的
org.slf4j.impl.StaticLoggerBinder,编译时候绑定的是哪个是不确定的。这个地?要特别注意!!出现过?次因为这个导致?志错乱的问题。
3.slf4j+logback
slf4j 和log4j 作者都是同?个?。logback 号称在性能各??有很多优势,也很诱?
直接使?slf4j 也很简单:
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class HelloWorld {
public static void main(String[] args) {
Logger logger = LoggerFactory.getLogger(HelloWorld.class);
https://www.sodocs.net/doc/9d18569274.html,("Hello World");
}
}
代码?也看不到任何具体?志实现?案的痕迹。程序运?时,logback会查找默认的配置?件logback.xml或者logback-test.xml?件,如果没有找到它就会使?默认的配置,将?志打印到console中
?、logback的介绍
Logback是由log4j创始?设计的又?个开源?志组件。logback当前分成三个模块:logback-core,logback- classic和logback-access。logback-core是其它两个模块的基础模块。logback-classic 是log4j的?个改良版本。此外logback-classic完整实现SLF4J API使你可以很?便地更换成其它?志系统如log4j或JDK14 Logging。logback-access访问模块与Servlet容器集成提供通过Http来访问?志的功能。 Logback是要与SLF4J结合起来?两个组件的官??站如下:
logback的官??站: http://logback.qos.ch y
SLF4J的官??站:https://www.sodocs.net/doc/9d18569274.html,
?、logback取代 log4j的理由:
Logback和log4j是?常相似的,如果你对log4j很熟悉,那对logback很快就会得?应?。下?列了logback相对于log4j的?些优点:
1、更快的实现 Logback的内核重写了,在?些关键执?路径上性能提升10倍以上。?且logback不仅性能提升了,初始化内存加载也更?了。
2、?常充分的测试 Logback经过了?年,数不清?时的测试。Logback的测试完全不同级别的。在作者的观点,这是简单重要的原因选择logback?不是log4j。
3、l ogback-classic?常?然实现了SLF4j Logback-classic实现了 SLF4j。在使?SLF4j中,你都感觉不到logback-classic。?且因为logback-classic?常?然地实现了SLF4J, 所以切换到
log4j或者其他,?常容易,只需要提供成另?个jar包就OK,根本不需要去动那些通过
SLF4JAPI实现的代码。
4、?常充分的?档 官??站有两百多页的?档。
5、?动重新加载配置?件 当配置?件修改了,Logback-classic能?动重新加载配置?件。扫描过程快且安全,它并不需要另外创建?个扫描线程。这个技术充分保证了应?程序能跑得很欢在JEE环境??。
6、Lilith Lilith是log事件观察者,和log4j的chainsaw类似。?lilith还能处理?数量的log数据
7、谨慎的模式和?常友好的恢复 在谨慎模式下,多个FileAppender实例跑在多个JVM下,能够安全地写道同?个?志?件。RollingFileAppender会有些限制。Logback的FileAppender和它的?类包括 RollingFileAppender能够?常友好地从I/O异常中恢复。
8、配置?件可以处理不同的情况 开发?员经常需要判断不同的Logback配置?件在不同的环境下(开发,测试,?产)。?这些配置?件仅仅只有?些很?的不同,可以通过,和来实现,这样?个配置?件就可以适应多个环境。
9、Filters(过滤器) 有些时候,需要诊断?个问题,需要打出?志。在log4j,只有降低?志级别,不过这样会打出?量的?志,会影响应?性能。在Logback,你可以继续保持那个?志级别?除掉某种特殊情况,如alice这个?户登录,她的?志将打在DEBUG级别?其他?户可以继续打在WARN级别。要实现这个功能只需加4?XML配置。可以参考MDCFIlter 。
10、SiftingAppender(?个?常多功能的Appender) 它可以?来分割?志?件根据任何?个给定的运?参数。如,SiftingAppender能够区别?志事件跟进?户的Session,然后每个?户会有?个?志?件
11、?动压缩已经打出来的log RollingFileAppender在产?新?件的时候,会?动压缩已经打出来的?志?件。压缩是个异步过程,所以甚?对于?的?志?件,在压缩过程中应?不会受任何影响。
12、堆栈树带有包版本 Logback在打出堆栈树?志时,会带上包的数据。
13、?动去除旧的?志?件 通过设置TimeBasedRollingPolicy或者SizeAndTimeBasedFNATP的maxHistory属性,你可以控制已经产??志?件的最?数量。如果设置maxHistory12,那那些log ?件超过12个?的都会被?动移除。
14、?志级别限制
在多数的Log?具中,级别是可以传递,例如如果指定了?志输出级别为DEBUG,那么INFO、ERROR级别的log也会出现在?志?件。这种默认给程序的调试带来了很多的?烦。?在logback中可以通过appender中的?lter来严格限制?志的输出级别:
?lter>
上?的设置中只会在?件中出现级别为INFO的?志内容。
15、同?个类中包含不同的?志
有时候?个类中可能要求打印不同的?志信息,例如有的?来调试,有的?来记录程序运?中的某些参数的变化等等。这时候可以通过下?的语句声明不同的?志:
Logger debugLogger = LoggerFactory.getLogger(MyClass.class);
Logger monitorLogger = LoggerFactory.getLogger("monitor");
然后在配置?件中分别指定不同的输出?件(debugLogger使?默认的配置):
……
这?通过设置additivity="false"禁?monitor?的内容向上传递,否则会同时显?在默认?志中 16、精确控制?志的应?范围
在程序调试中,经常出现的情况是:错误只在某?个或者?个类或者包?,所以只需要打开这?个类或者包?的DEBUG级别的log。在以前的项?,使?Spring和Hibernate时,?旦打开DEBUG级别的log,程序本?的 debug信息就会被Spring和Hibernate的?量?志淹没,??降低了调试的效率。?logback让这?切变的简单起来了:
这??就将org包下?的所有?志级别设为了ERROR,不会再打扰我们的DEBUG。
三、Logback的配置介绍
1、Logger、appender及layout
Logger作为?志的记录器,把它关联到应?的对应的context上后,主要?于存放?志对象,也可以定义?志类型、级别。
Appender主要?于指定?志输出的?的地,?的地可以是控制台、?件、远程套接字服务器、 MySQL、PostreSQL、 Oracle和其他数据库、 JMS和远程UNIX Syslog守护进程等。
Layout 负责把事件转换成字符串,格式化的?志信息的输出
2、logger context
各个logger 都被关联到?个 LoggerContext,LoggerContext负责制造logger,也负责以树结构排列各logger。其他所有logger也通过org.slf4j.LoggerFactory 类的静态?法getLogger取
得。 getLogger?法以 logger名称为参数。?同?名字调?LoggerFactory.getLogger ?法所得到的永远都是同?个logger对象的引?。
3、有效级别及级别的继承
Logger 可以被分配级别。级别包括:TRACE、DEBUG、INFO、WARN 和 ERROR,定义于ch.qos.logback.classic.Level类。如果 logger没有被分配级别,那么它将从有被分配级别的最近的祖先那?继承级别。root logger 默认级别是 DEBUG。
4、打印?法与基本的选择规则
打印?法决定记录请求的级别。例如,如果 L 是?个 logger 实例,那么,语句 https://www.sodocs.net/doc/9d18569274.html,("..")是?条级别为 INFO的记录语句。记录请求的级别在?于或等于其 logger 的有效级别时被称为被启?,否则,称为被禁?。记录请求级别为 p,其 logger的有效级别为 q,只有则当 p>=q时,该请求才会被执?。
该规则是 logback 的核?。级别排序为: TRACE < DEBUG < INFO < WARN < ERROR
四、Logback的默认配置
如果配置?件 logback-test.xml 和 logback.xml 都不存在,那么 logback 默认地会调?BasicCon?gurator ,创建?个最?化配置。最?化配置由?个关联到根 logger 的ConsoleAppender 组成。输出?模式为%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} -
%msg%n 的 PatternLayoutEncoder 进?格式化。root logger 默认级别是 DEBUG。
1、Logback的配置?件
Logback 配置?件的语法?常灵活。正因为灵活,所以?法? DTD 或 XML schema 进?定义。尽管如此,可以这样描述配置?件的基本结构:以
2、Logback默认配置的步骤
(1). 尝试在 classpath 下查找?件 logback-test.xml;
(2). 如果?件不存在,则查找?件 logback.xml;
(3). 如果两个?件都不存在,logback ? Bas icCon?gurator ?动对??进?配置,这会导致记录输出到控制台。
logback 配置详解(?)
?:根节点
scan:
当此属性设置为true时,配置?件如果发?改变,将会被重新加载,默认值为true。scanPeriod:
设置监测配置?件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。当scan 为true时,此属性?效。默认的时间间隔为1分钟。
debug:
当此属性设置为true时,将打印出logback内部?志信息,实时查看logback运?状态。默认值为false。
例如:
Xml代码
?:根节点
2.1设置上下?名称:
每个logger都关联到logger上下?,默认上下?名称为“default”。但可以使?
Xml代码
2.2设置变量:
?来定义变量值的标签,
例如使?
Xml代码
2.3获取时间戳字符串:
两个属性 key:标识此
例如将解析配置?件的时间作为上下?名称:
Xml代码
2.4设置logger:
?来设置某?个包或者具体的某?个类的?志打印级别、以及指定
name:?来指定受此logger约束的某?个包或者具体的某?个类。
level:?来设置打印级别,??写?关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和OFF,还有?个特殊值INHERITED或者同义词NULL,代表强制执?上级的级别。
如果未设置此属性,那么当前log g er将会继承上级的级别。
addtivity:是否向上级log g er传递打印信息。默认是true。
也是
level:?来设置打印级别,??写?关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和OFF,不能设置为INHERITED或者同义词NULL。默认是DEBUG。
例如:LogbackDemo.java类
Java代码
package logback;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class LogbackDemo {
private static Logger log = LoggerFactory.getLogger(LogbackDemo.c lass);
public static void main(String[] args) {
log.trace("======trace");
log.debug("======debug");
https://www.sodocs.net/doc/9d18569274.html,("======info");
log.warn("======warn");
log.error("======error");
}
}
logback.xml配置?件
第1种:只配置root
Xml代码
其中appender的配置表?打印到控制台(稍后详细讲解appender );
当执?logback.LogbackDemo类的main?法时,root将级别为“INFO”及?于“INFO”的?志信息交给已经配置好的名为“STDOUT”的appender处理,“STDOUT”appender将信息打印到控制台;打印结果如下:
Xml代码
1.13:30:38.484 [main] INFO logback.LogbackDemo - ======info
2.13:30:38.500 [main] WARN logback.LogbackDemo - ======warn
3.13:30:38.500 [main] ERROR logback.LogbackDemo - ======error
第2种:带有logger的配置,不指定级别,不指定appender,
Xml代码
其中appender的配置表?打印到控制台(稍后详细讲解appender );
没有设置addtivity,默认为true,将此logger的打印信息向上级传递;
没有设置appender,此logger本?不打印任何信息。
当执?logback.LogbackDemo类的main?法时,因为LogbackDemo 在包logback中,所以?先执?
root接到下级传递的信息,交给已经配置好的名为“STDOUT”的appender处理,
“STDOUT”appender将信息打印到控制台;
打印结果如下:
Xml代码
13:19:15.406 [main] DEBUG logback.LogbackDemo - ======debug
13:19:15.406 [main] INFO logback.LogbackDemo - ======info
13:19:15.406 [main] WARN logback.LogbackDemo - ======warn
13:19:15.406 [main] ERROR logback.LogbackDemo - ======error
第3种:带有多个logger的配置,指定级别,指定appender
Xml代码
其中appender的配置表?打印到控制台(稍后详细讲解appender );
没有设置addtivity,默认为true,将此loger的打印信息向上级传递;
没有设置appender,此loger本?不打印任何信息。
logback.LogbackDemo类的?志打印,打印级别为“INFO”;
additivity属性为false,表?此loger的打印信息不再向上级传递,
指定了名字为“STDOUT”的appender。
当执?logback.LogbackDemo类的main?法时,先执?
Xml代码
14:05:35.937 [main] INFO logback.LogbackDemo - ======info
14:05:35.937 [main] WARN logback.LogbackDemo - ======warn
14:05:35.937 [main] ERROR logback.LogbackDemo - ======error
如果将
没错,?志打印了两次,想必?家都知道原因了,因为打印信息向上级传递,logger本?打印?次,root接到后又打印?次
打印结果如下:
Xml代码
14:09:01.531 [main] INFO logback.LogbackDemo - ======info
14:09:01.531 [main] INFO logback.LogbackDemo - ======info
14:09:01.531 [main] WARN logback.LogbackDemo - ======warn
14:09:01.531 [main] WARN logback.LogbackDemo - ======warn
14:09:01.531 [main] ERROR logback.LogbackDemo - ======error
14:09:01.531 [main] ERROR logback.LogbackDemo - ======error
logback 常?配置详解(?)
1.ConsoleAppender:
把?志添加到控制台,有以下?节点:
例如:
Xml代码
2.FileAppender:
把?志添加到?件,有以下?节点:
:被写?的?件名,可以是相对?录,也可以是绝对?录,如果上级?录不存在会?动创建,没有默认值。
例如:
Xml代码
3.RollingFileAppender:
滚动记录?件,先将?志记录到指定?件,当符合某个条件时,将?志记录到其他?件。有以下?节点:
:被写?的?件名,可以是相对?录,也可以是绝对?录,如果上级?录不存在会?动创建,没有默认值。
rollingPolicy:
TimeBasedRollingPolicy: 最常?的滚动策略,它根据时间来制定滚动策略,既负责滚动也负责出发滚动。有以下?节点:
:
必要节点,包含?件名及“%d”转换符, “%d”可以包含?个java.text.SimpleDateFormat 指定的时间格式,如:%d{yyyy-MM}。如果直接使?%d,默认格式是yyyy-MM-dd。
RollingFileAppender 的?le字节点可有可?,通过设置?le,可以为活动?件和归档?件指定不同位置,当前?志总是记录到?le指定的?件(活动?件),活动?件的名字不会改变;如果没设置?le,活动?件的名字会根据?leNamePattern 的值,每隔?段时间改变?次。“/”或者“\”会被当做?录分隔符。
可选节点,控制保留的归档?件的最?数量,超出数量就删除旧?件。假设设置每个?滚动,且
FixedWindowRollingPolicy: 根据固定窗?算法重命名?件的滚动策略。有以下?节点:
:
必须包含“%i”例如,假设最?值和最?值分别为1和2,命名模式为 mylog%i.log,会产?归档?件mylog1.log和mylog2.log。还可以指定?件压缩选项,例如,mylog%i.log.gz 或者没有
log%i.log.zip
triggeringPolicy:
SizeBasedTriggeringPolicy: 查看当前活动?件的??,如果超过指定??会告知RollingFileAppender 触发当前活动?件滚动。只有?个节点:
例如:每天?成?个?志?件,保存30天的?志?件。
Java代码
fileNamePattern>
例如:按照固定窗?模式?成?志?件,当?件?于20MB时,?成新的?志?件。窗???是1到3,当保存了3个归档?件后,将覆盖最早的?志。
Xml代码
4.另外还有SocketAppender、SMTPAppender、DBAppender、SyslogAppender、SiftingAppender,并不常?,这些就不在这?讲解了,?家可以参考官??档。当然?家可以编写??的Appender。
负责两件事,?是把?志信息转换成字节数组,?是把字节数组写?到输出流。
?前PatternLayoutEncoder 是唯?有?的且默认的encoder ,有?个
Xml代码
转换符作?
c {length }
lo {length } logger {length } 输出?志的logger名,可有?个整形参数,功能是缩短logger 名,设置为0表?只输?logger最右边点符号之后的字符串。Conversion speci?er Logger name Result
%logger mainPackage.sub.sample.Bar
mainPackage.sub.sample.Bar
%logger{0}mainPackage.sub.sample.Bar Bar
%logger{5}mainPackage.sub.sample.Bar m.s.s.Bar
%logger{10}mainPackage.sub.sample.Bar m.s.s.Bar
%logger{15}mainPackage.sub.sample.Bar m.s.sample.Bar %logger{16}mainPackage.sub.sample.Bar m.sub.sample.Bar %logger{26}mainPackage.sub.sample.Bar mainPackage.sub.sample.Bar
C {length } class {length } 输出执?记录请求的调?者的全限定名。参数与上?的?样。尽量避免使?,除?执?速度不造成任何问题。
contextName
cn
输出上下?名称。
d {pattern } dat
e {pattern } 输出?志的打印?志,模式语法与
java.text.SimpleDateFormat 兼容。
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 / ?le 输出执?记录请求的java源?件名。尽量避免使?,除?执?速度不造成任何问题。
caller{depth}caller{depth, evaluator-1, ... evaluator-n}输出?成?志的调?者的位置信息,整数选项表?输出信息深度。
例如, %caller{2} 输出为:
0 [main] DEBUG - logging statement
Caller+0 at
mainPackage.sub.sample.Bar.sampleMethodName(Ba r.java:22)
Caller+1 at
mainPackage.sub.sample.Bar.createLoggingReques t(Bar.java:17)
例如, %caller{3} 输出为:
16 [main] DEBUG - logging statement
Caller+0 at
mainPackage.sub.sample.Bar.sampleMethodName(Ba r.java:22)
Caller+1 at
mainPackage.sub.sample.Bar.createLoggingReques t(Bar.java:17)
Caller+2 at
mainPackage.ConfigTester.main(ConfigTester.jav a:38)
L / line 输出执??志请求的?号。尽量避免使?,除?执?速度不造成任何问题。
格式修饰符,与转换符共同使?:
可选的格式修饰符位于“%”和转换符之间。
第?个可选修饰符是左对齐 标志,符号是减号“-”;接着是可选的最?宽度 修饰符,??进制数表?。如果字符?于最?宽度,则左填充或右填充,默认是左填充(即右对齐),填充符为空格。如果字符?于最?宽度,字符永远不会被截断。最?宽度 修饰符,符号是点号"."后?加?进制数。如果字符?于最?宽度,则从前?截断。点符号“.”后?加减号“-”在加数字,表?从尾部截断。
例如:%-4relative 表?,将输出从程序启动到创建?志记录的时间进?左对齐且最?宽度为4logback logback.xml 常?配置详解(三)
:过滤器,执??个过滤器会有返回个枚举值,即DENY ,NEUTRAL ,ACCEPT 其中之?。返回DENY ,?志将?即被抛弃不再经过其他过滤器;返回NEUTRAL ,有序列表?的下个过滤器过接着处理?志;返回ACCEPT ,?志会被?即处理,不再经过剩余过滤器。
过滤器被添加到
下?是?个常?的过滤器:
LevelFilter : 级别过滤器,根据?志级别进?过滤。如果?志级别等于配置级别,过滤器会根据onMath 和 onMismatch 接收或拒绝?志。有以下?节点:
例如:将过滤器的?志级别配置为INFO ,所有INFO 级别的?志交给appender 处理,?INFO 级别的?志,被过滤掉。Xml 代码
输出应?程序提供的信息。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', ''}"
%-4relative [%thread] %-5level %logger{30} - %msg%n
ThresholdFilter: 临界值过滤器,过滤掉低于指定临界值的?志。当?志级别等于或?于临界值时,过滤器返回NEUTRAL;当?志级别低于临界值时,?志会被拒绝。
例如:过滤掉所有低于INFO级别的?志。
Xml代码
class="ch.qos.logback.core.ConsoleAppender"> %-4relative [%thread] %-5level %logger{30} - %msg%n s
EvaluatorFilter: 求值过滤器,评估、鉴别?志是否符合指定条件。有?下?节点:
鉴别器,常?的鉴别器是JaninoEventEvaluato,也是默认的鉴别器,它以任意的java布尔值表达式作为求值条件,求值条件在配置?件解释过成功被动态编译,布尔值表达式返回true就表?符合过滤条件。evaluator有个?标签
求值表达式作?于当前?志,logback向求值表达式暴露?志的各种字段:
Name Type Description
event LoggingEvent 与记录请求相关联的原始记录事件,下?所有变量都来?event,例如,event.getMessage()返回下?"message"相同的字符串
例如:过滤掉所有?志消息中不包含“billing”字符串的?志。Xml 代码
message String ?志的原始消息,例如,设有logger mylogger ,"name"的值是"AUB",对于
https://www.sodocs.net/doc/9d18569274.html,("Hello {}",name); "Hello {}"就是原
始消息。
formatedMessage String ?志被各式话的消息,例如,设有logger
mylogger ,"name"的值是"AUB",对于
https://www.sodocs.net/doc/9d18569274.html,("Hello {}",name); "Hello Aub"就是
格式化后的消息。
logger String logger 名。
loggerContext LoggerContextVO ?志所属的logger 上下?。
level int 级别对应的整数值,所以 level > INFO 是正确的
表达式。
timeStamp long 创建?志的时间戳。
marker Marker 与?志请求相关联的Marker 对象,注
意“Marker”有可能为null ,所以你要确保它不能
是null 。
mdc Map 包含创建?志期间的MDC 所有值得map 。访问
?法是:mdc.get("myKey") 。mdc.get()返回的是
Object 不是String ,要想调?String 的?法就要强
转,例如, ((String) mdc.get("k")).contains("
val") .MDC 可能为null ,调?时注意。
throwable https://www.sodocs.net/doc/9d18569274.html,ng.Throwable 如果没有异常与?志关联"throwable" 变量为
null. 不幸的是, "throwable" 不能被序列化。在
远程系统上永远为null ,对于与位置?关的表达
式请使?下?的变量throwableProxy
throwableProxy IThrowableProxy
与?志事件关联的异常代理。如果没有异常与
?志事件关联,则变量"throwableProxy" 为 null.
当异常被关联到?志事件时,"throwableProxy"
在远程系统上不会为null
expression>
%-4relative [%thread] %-5level %logger - %msg%n
匹配器,尽管可以使?String类的matches()?法进?模式匹配,但会导致每次调?过滤器时都会创建?个新的Pattern对象,为了消除这种开销,可以预定义?个或多个matcher对象,定以后就可以在求值表达式中重复引?。
例如:
Xml代码
其他Filter不太常?我这?就不讲了,?家可以参见官?