Spring Boot项目使用SLF4J 和LogBack

概述

前文使用Spring Boot创建了SSM的项目(前文链接:https://www.jianshu.com/p/901a258df1b8)现在进行SLF4J和LogBack的使用和配置。

SLF4J

Simple Logging Facade for Java,简单日志门面,不是具体的日志解决方案,它提供日志框架的简单抽象,单独的SLF4J并不能工作,犹如JDBC,它为Java应用提供日志输出的统一接口,必须搭配LogBack或Log4J等使用。

LogBack

LogBack和Log4J是同一个作者,LogBack相当于Log4J的进阶版,相比Log4J有很多优势,诸如:更快的实现、充分的测试等等,所以此处使用LogBack。

配置

日志信息打印控制台

由于Spring Boot的核心依赖已经包含了SLF4J、LogBack和Log4J:


logback01.png

所以使用Spring Boot创建SSM项目完成之后,默认已经配置了日志,并且默认日志级别是info,这一点从启动日志中也能看到,默认的日志框架为LogBack:


logback02.png

默认的日志是只打印到控制台上,日志的级别从低到高:TRACE < DEBUG < INFO < WARN < ERROR < FATAL,如果设置为INFO,则低于INFO的信息都不会输出。
日志从左向右依次显示的内容是:

日期时间、日志级别、进程ID、分隔符、线程名、logger名、具体的日志信息。
日志默认不会写到日志文件中:


logback03.png

项目目录中没有任何log文件,可以在application.yml文件中进行级别的配置,将级别设置成debug:
logback04.png

启动项目:
logback05.png

此时日志debug级别已经设置成功。
级别控制:此处配置的是logging.level.root。
其中root也可以替换为项目目录下的某个包,这样就能不同的包配置不同的日志级别了。

生成日志信息文件

将日志信息写入日志文件的设置:


logback06.png

其中${spring.application.name}.log意思是日志文件名字为项目名,启动项目:


logback07.png

此时可以看到在项目目录下生成了sysmanagement.log文件,日志信息已经写入文件中。
可以定义一个logs目录,专门用来存放日志文件,先将这个日志文件删除,为了缩短启动时间,将日志级别设置回info:
logback08.png

启动项目:


logback09.png

此时在项目目录下生成了logs文件夹,并且生成了默认名称为spring.log的日志文件,这里将file行的配置进行了注释,是因为path和file不能同时配置,若二者同时配置,只有file生效,即只在项目目录下生成sysmanagement.log文件,不会生成logs文件夹。

使用logback-spring.xml文件自定义配置日志

可以通过外部配置文件进行项目的日志控制个管理。
由于不同的日志系统,需要不同的配置文件名称来进行正确的加载,其中-spring是Spring Boot官方推荐的优先使用的,所以LogBack框架的配置文件名就是logback-spring.xml ,该文件默认放在项目的resources目录下即可。
将刚才在application.yml文件中关于日志文件的配置信息和项目目录中的logs文件夹一同删除。
下面是项目配置文件的xml:


logback10.png

启动完成后,控制台打印的日志:


logback11.png

项目目录结构中生成的日志文件,在项目目录下的logs目录中:
logback12.png

可以看到生成了debug和info两个不同级别的日志文件。
然后来看一下配置文件中的各项配置说明:
<configuration>节点:

scan:当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。
scanPeriod:设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。当scan为true时,此属性生效。默认的时间间隔为1分钟。
debug:当此属性设置为true时,将打印出LogBack内部日志信息,实时查看LogBack运行状态。默认值为false。
<configuration>节点配置了两个属性和三个子节点:
第一个属性:<contextName>,logger默认上下文的名字是“default”,用这个属性可以自定义该名称,用于区分不同应用,一旦设置,不可修改。
第二个属性: <property>,用来设置变量,有两个属性,name的值是变量的名称,value的值时变量定义的值。通过定义的值会被插入到logger上下文中。定义变量后,可以使“${}”来使用变量。
这里设置的<property name="LOG_PATH " value="logs/" />是在项目目录下生成logs目录用来存放生成的日志文件。

第一个子节点:<appender>,设置日志输出策略,有两个属性,name用来定义名称,class用来定义输出策略的类别,通常设置的策略是输出到控制台和输出到文件。

  • 输出到控制台


    logback13.png

输出级别是info,<Pattern>是设置了${CONSOLE_LOG_PATTERN}变量的值,用来将在控制台输出的日志信息进行格式化和彩色化,由于在未使用自定义配置文件时,Spring Boot默认集成的logging的依赖包中由default.xml,其中包含了打印信息彩色化的配置,所以由前面的截图中可以看到控制台打印的信息也是彩色的。


logback14.png

具体的变量设置是在这里,由于CONSOLE_LOG_PATTERN的值太长,于是做了换行可以看得更清楚:


logback15.png
  • 输出到文件
    输出到文件的<appender>中class可以设置为class="ch.qos.logback.core.FileAppender",这样就可以将日志信息输出到一个指定的日志文件中了,但是随着系统运行时间不断写入日志信息,仅仅写入一个文件,这个日志文件会越来越大,这样会对阅读日志信息和服务硬盘空间资源使用等等造成困扰,所以这里配置选用了class="ch.qos.logback.core.rolling.RollingFileAppender",滚动输出到文件,当日志信息记录到符合某一条件时,切分记录到新文件。


    logback16.png

<file>日志信息写入的文件名,${LOG_PATH}/log_debug.log,是组合前面定义的路径变量,将日志文件log_debug.log写入项目目录的logs目录下。
<encoder>定义了文件输出的格式和字符编码。
<rollingPolicy>设置class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy",基于时间制定滚动策略。<fileNamePattern>定义了日志文件归档的路径和文件名称。
策略可以进行嵌套,<timeBasedFileNamingAndTriggeringPolicy>
设置 class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"设置对单个文件大小的判断,<maxFileSize>定义的单个文件最大值,当文件超过50M时,触发归档,归档时的文件名log-debug-%d{yyyy-MM-dd}.%i.log是组合了时间的名称,其中的%i是定义了规避同一天多个归档文件同名的问题。
<maxHistory>15</maxHistory>定义了文件最多只保留15日的。
<filter>设置class="ch.qos.logback.classic.filter.LevelFilter",定义了日志文件只记录某一个级别,这样在配置文件中可以分开记录不同级别的日志信息到对应的日志文件中(示例中定义了debug和info两个级别)。

第二个子节点:<logger>用来设置某一个包或者具体的某一个类的日志打印级别、以及指定<appender>。
例如:
<logger name="org.springframework.web" level="info"/>
<logger name="org.springframework.scheduling.annotation.ScheduledAnnotationBeanPostProcessor" level="INFO"/>
<logger>仅有一个name属性,一个可选的level和一个可选的addtivity属性。
name:用来指定受此logger约束的某一个包或者具体的某一个类。
level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,还有一个特殊值INHERITED或者同义词NULL,代表强制执行上级的级别,如果未设置此属性,那么当前logger将会继承上级的级别。
addtivity:是否向上级logger传递打印信息。默认是true。

第三个子节点:root节点是必选节点,用来指定最基础的日志输出级别,只有一个level属性,用来设置打印级别,不能设置为INHERITED或者同义词NULL。默认是DEBUG,可以包含零个或多个元素,标识这个appender将会添加到这个logger。

\color{red}{注意:}使用mybatis的时候,sql语句是debug下才会打印,而这里只配置了info,所以想要查看sql语句的话,有以下两种操作:
第一种把<root level="info">改成<root level="DEBUG">这样就会打印sql,不过这样日志那边会出现很多其他消息。
第二种就是单独给dao下目录配置debug模式,代码如下,这样配置sql语句会打印,其他还是正常info级别:

<springProfile name="dev">
  <logger name="com.huajie.mapper" level="debug"/>
</springProfile>

至此,Spring Boot创建SSM项目的日志配置和基本使用就完成了。

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

推荐阅读更多精彩内容