slf4j+logback的配置及使用


几种日志的区别

  • commons-logging
    apache最早提供的日志的门面接口。避免和具体的日志方案直接耦合。类似于JDBCapi 接口,具体的的JDBC driver 实现由各数据库提供商实现。通过统一接口解耦,不过其内部也实现了一些简单日志方案。
  • Log4j
    Logging for Java,经典的一种日志解决方案。内部把日志系统抽象封装成Loggerappenderpattern 等实现。我们可以通过配置文件轻松的实现日志系统的管理和多样化配置。
  • slf4j
    全称为Simple Logging Facade for Java。 是对不同日志框架提供的一个门面封装。可以在部署的时候不修改任何配置即可接入一种日志实现方案。和commons-loging 类似。个人感觉设从计上更好一些,没有commons 那么多潜规则。同时有两个额外特点:①能支持多个参数,并通过{}占位符进行替换,避免老写logger.isXXXEnabled这种无奈的判断,带来性能提升见;②OSGI机制更好兼容支持。
  • logback
    作为一个通用可靠、快速灵活的日志框架,将作为Log4j 的替代和slf4j 组成新的日志系统的完整实现。具有极佳的性能,在关键路径上执行速度是log4j 的10 倍,且内存消耗更少。
  • Log4j2
    Log4j2Log4j的升级版,与之前的版本Log4j 1.x相比、有重大的改进,在修正了Logback固有的架构问题的同时,改进了许多Logback所具有的功能。

可以这么理解,slf4jcommons-logging是一种抽象接口,Log4jLog4j2logback是它们的实现,在实际使用中,一般选择slf4j+Log4j2或者slf4j+logback

性能对比可以看:Apache Log4j 2.0值得升级吗

下文仅讨论slf4j+logback


配置及使用

1、引入相关日志依赖,去除其他无关日志依赖

既然选择了slf4j+logback,首先要将项目中的其他jar包,如commons-loggingLog4j去掉。
如果项目使用maven,可以使用mvn dependency:tree命令来查看描绘项目依赖树,看哪些显式的dependecy依赖了它们。
spring-core里面就集成了commons-logging,可以通过exclusions标签将其排除掉。

<dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
            <!--因为使用了sl4j,所以去掉commons-logging-->
            <exclusions>
                <exclusion>
                    <groupId>commons-logging</groupId>
                    <artifactId>commons-logging</artifactId>
                </exclusion>
            </exclusions>
</dependency>

但spring本身日志就使用的commons-logging,仅仅去掉就会使其不能正常工作,还需要添加commons loggingslf4j的桥接器jcl-over-slf4j,如下在项目中添加该依赖:

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>jcl-over-slf4j</artifactId>
    <version>${jcl.over.slf4j.version}</version>
</dependency>

如果有直接使用log4j的组件,也要将log4j排除掉,同时添加log4j-over-slf4

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>log4j-over-slf4j</artifactId>
</dependency>

最后,可以使用mvn dependency:tree或者mvn dependency:list查看项目依赖,看是否存在重复引入等,比如我们使用slf4j+logback的方案,只需要引入logback-classic即可,不必再显示添加slf4j-apilogback-core,因为logback-classic本身依赖它们。

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>${logback.version}</version>
</dependency>

这一步就是引入logbackslf4j,去掉common-loggingLog4jLog4j等无关日志组件,同时添加commons loggingslf4j的桥接器jcl-over-slf4j(如果项目中原来使用到了commons logging)。

2、配置logback

logback在启动时,根据以下步骤寻找配置文件:①在classpath中寻找logback-test.xml文件→②如果找不到logback-test.xml,则在 classpath中寻找logback.groovy文件→③如果找不到 logback.groovy,则在classpath中寻找logback.xml文件
如果上述的文件都找不到,则logback会使用JDKSPI机制查找 META-INF/services/ch.qos.logback.classic.spi.Configurator中的 logback 配置实现类,这个实现类必须实现Configuration接口,使用它的实现来进行配置
如果上述操作都不成功,logback 就会使用它自带的 BasicConfigurator 来配置,并将日志输出到console

这里采用xml格式的配置文件:在resources目录下新建logback.xml文件,logback.xml文件的具体配置如下(仅供参考):

<?xml version="1.0" encoding="UTF-8"?>
<!--scan:
            当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。
scanPeriod:
            设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。当scan为true时,此属性生效。默认的时间间隔为1分钟。
debug:
            当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。

configuration 子节点为 appender、logger、root

            -->
<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <!--用于区分不同应用程序的记录-->
    <contextName>edu-cloud</contextName>
    <!--日志文件所在目录,如果是tomcat,如下写法日志文件会在则为${TOMCAT_HOME}/bin/logs/目录下-->
    <property name="LOG_HOME" value="logs"/>

    <!--控制台-->
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度 %logger输出日志的logger名 %msg:日志消息,%n是换行符 -->
            <pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] %-5level %logger{36} : %msg%n</pattern>
            <!--解决乱码问题-->
            <charset>UTF-8</charset>
        </encoder>
    </appender>

    <!--滚动文件-->
    <appender name="infoFile" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- ThresholdFilter:临界值过滤器,过滤掉 TRACE 和 DEBUG 级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>INFO</level>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_HOME}/log.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory><!--保存最近30天的日志-->
        </rollingPolicy>
        <encoder>
            <charset>UTF-8</charset>
            <pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] %-5level %logger{36} : %msg%n</pattern>
        </encoder>
    </appender>

    <!--滚动文件-->
    <appender name="errorFile" class="ch.qos.logback.core.rolling.RollingFileAppender">
             <!-- ThresholdFilter:临界值过滤器,过滤掉 TRACE 和 DEBUG 级别的日志 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>error</level>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_HOME}/error.%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory><!--保存最近30天的日志-->
        </rollingPolicy>
        <encoder>
            <charset>UTF-8</charset>
            <pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] %-5level %logger{36} : %msg%n</pattern>
        </encoder>
    </appender>

    <!--将日志输出到logstack-->
    <!--<appender name="logstash" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
        <destination>47.93.173.81:7002</destination>
        <encoder class="net.logstash.logback.encoder.LogstashEncoder">
            <charset>UTF-8</charset>
        </encoder>
        <keepAliveDuration>5 minutes</keepAliveDuration>
    </appender>-->

    <!--这里如果是info,spring、mybatis等框架则不会输出:TRACE < DEBUG < INFO <  WARN < ERROR-->
    <!--root是所有logger的祖先,均继承root,如果某一个自定义的logger没有指定level,就会寻找
    父logger看有没有指定级别,直到找到root。-->
    <root level="debug">
        <appender-ref ref="stdout"/>
        <appender-ref ref="infoFile"/>
        <appender-ref ref="errorFile"/>
        <appender-ref ref="logstash"/>
    </root>

    <!--为某个包单独配置logger

    比如定时任务,写代码的包名为:com.seentao.task
    步骤如下:
    1、定义一个appender,取名为task(随意,只要下面logger引用就行了)
    appender的配置按照需要即可


    2、定义一个logger:
    <logger name="com.seentao.task" level="DEBUG" additivity="false">
      <appender-ref ref="task" />
    </logger>
    注意:additivity必须设置为false,这样只会交给task这个appender,否则其他appender也会打印com.seentao.task里的log信息。

    3、这样,在com.seentao.task的logger就会是上面定义的logger了。
    private static Logger logger = LoggerFactory.getLogger(Class1.class);
    -->

</configuration>

在进行配置的时候,主要要理解或记住以下几点(主要标签的用处):

  • appender,负责定义日志的输出目的地(控制台、日志文件、滚动日志文件,其他如logstash等)。

    • encoder负责定义日志的输出样式和字符编码,如果在控制台出现?????或乱码,则指定编码(一般是UTF-8)就好了。
    • filter负责过滤日志,即使logger传来了dubug级别以上的日志,如果filter中设定了级别为info,则该appender只会将info级别及以上的日志输出到目的地。
    • rollingPolicy负责制定日志文件的滚动规则,是根据日志文件大小还是根据日期进行滚动。
  • logger,负责定义我们实际代码中使用的loggerlogger中有一个非常重要的属性namename必须指定。在logback中,logger有继承关系,而所有的logger的祖先是root
    举个例子,如果我们有个类叫UserService,所在的包为com.maxwell.service,在UserService中要打印日志,我们一般会这么写:

①private  Logger logger = LoggerFactory.getLogger(UserService.class);
或者
②private  Logger logger = LoggerFactory.getLogger("com.maxwell.service.UserService");

这两种写法是一样的,第①中写法实际会转化为②中的方式来获取一个logger实例。
当我们写下这行代码时,logback会依次检查以下各个logger实例的是否存在,如果不存在则依次创建:

com
com.maxwell
com.maxwell.service
com.maxwell.service.UserService

而创建logger实例的时候,就会去配置文件中查找名字为comcom.maxwellcom.maxwell.servicecom.maxwell.service.UserServicelogge标签,并根据其中定义的规则创建。所以,假如你在配置文件中没有定义name为上述字符串的logger时,就会找到root这个祖先,根据root标签定义的规则创建logger实例。

理解了上面的这一点,想要实现某个包或者某个类单独输出到某日志文件的需求就很好实现了:①定义一个appender,指明日志文件的输出目的地;②定义一个loggername设为那个包或类的全路径名。如果只想将这个类或包的日志输出到刚才定义的appender中,就将additivity设置为false

还有就是,上面的参考配置可以保证mybatissql语句、spring的日志正常输出到控制台,但由于mybatissql语句输出的级别为debug,所以不会输出到nameinfoFileappender中,因为该appender中设置了级别为info的过滤器filter,如果想将mybatissql语句也输出到日志文件中,请将info改为debug
也就是,一条日志想要顺利到达输出目的地,除了logger的级别要低于该级别,appender中的filter中设置的级别也要低于该级别。(TRACE < DEBUG < INFO < WARN < ERROR)

3、使用

在代码中获取logger时,我们可能有两种方式:

private static Logger logger = LoggerFactory.getLogger(UserService.class);
private Logger logger = LoggerFactory.getLogger(UserService.class);

你可能会认为不加static会为UserService类的不同实例创建多个logger实例,实际不是的,某个类的logger实例一旦创建,logback会将其缓存在一个map中(Map<String, Logger> loggerCache),下次获取的时候直接从这个map中获取。所以,上述两种写法性能差距不大,只多一个很小的从cache中取对象的开销:加上static,下次获取的时候就直接从内存中取了(类变量是多个实例共享的),不会再调用LoggerFactory.getLogger(UserService.class),而不加static则从logback的缓存中取,需要调用LoggerFactory.getLogger(UserService.class)

最后要注意的是,这里的LoggerLoggerFactoryslf4j包里的,不要选成了java.util.logging。如果你的IDE出现了slf4jjava自带日志包外的其他选项,就要考虑你是不是没有将其他不相关的日志组件从你的项目中去掉。


参考

logback中logger对象的创建过程源码分析
Why log4j's Logger.getLogger() need pass a Class type?
logback logback.xml常用配置详解
java日志,需要知道的几件事(commons-logging,log4j,slf4j,logback)
logback 配置详解
logback为单独的包配置日志输出文件
Apache Log4j 2.0值得升级吗

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容

  • 在应用程序中添加日志记录总的来说基于三个目的:监视代码中变量的变化情况,周期性的记录到文件中供其他应用进行统计分析...
    时待吾阅读 4,907评论 0 6
  • 在项目开发过程中,我们可以通过 debug 查找问题。而在线上环境我们查找问题只能通过打印日志的方式查找问题。因此...
    Java架构阅读 3,407评论 2 41
  • 一、Log4j简介 Log4j有三个主要的组件:Loggers(记录器),Appenders (输出源)和Layo...
    默默守护阅读 1,863评论 2 8
  • 在应用程序中添加日志记录总的来说基于三个目的:监视代码中变量的变化情况,周期性的记录到文件中供其他应用进行统计分析...
    时待吾阅读 4,817评论 1 13
  • Log Java日志:(slf4j、log4j、logback、common-logging ) slf4j 是规...
    年少懵懂丶流年梦阅读 17,276评论 1 11