Spring Boot在所有外部日志中应用Commons Logging，然而对底层日志的实现是凋谢的。在Spring Boot生态中，为Java Util Logging 、Log4J2 和Logback 这些常见的日志框架都提供了自动化配置组件，每种Logger都能够通过配置在控制台或者文件中输入日志内容。默认状况下，当咱们应用各种Starter的时候，会应用Logback来实现日志治理。

如何记日志

在介绍写日志的形式有很多，这里就不对各种形式做列举了，只讲DD用得最多的形式！

首先，在代码层面，咱们不纠结到底用默认的Logback还是Log4j，而是间接用：Slf4j。

为什么不必管具体用Logback还是Log4j就能够去写代码呢？这个就是应用Slf4j益处，为什么是Slf4j？英文全称：Simple Logging Facade for Java，即：简略日志门面，它并不是一个具体的日志解决方案，理论工作的还是Logback或Log4j这样的日志框架。Slf4j就是23种设计模式中门面模式的典型利用案例。通过Slf4j这样一个门面的形象存在，让咱们在写代码的之后，只依赖这个形象的日志操作，而具体的实现会在Slf4j门面调用的时候委托给具体的实现。

比方上面的就是一个简略的日志记录例子：

@Slf4j@SpringBootApplicationpublic class Application {    public static void main(String[] args) {        SpringApplication.run(Application.class, args);        log.error("Hello World");        log.warn("Hello World");        log.info("Hello World");        log.debug("Hello World");        log.trace("Hello World");    }}

留神：这里咱们通过在pom.xml中引入了Lombok，而后应用@Slf4j申明引入Slf4j的log日志记录对象，之后就能够轻松的用它来日志了。而这个日志具体是如何写到控制台或者文件的，则有Spring Boot我的项目中引入了什么具体的日志框架决定，默认状况下就是Logback。

日志元素

启动任意一个Spring Boot我的项目，咱们都能够在控制台看到很多日志信息，比方上面这样的一条日志：

日志的输入内容中一共有7种元素，具体如下：

  1. 工夫日期：准确到毫秒
  2. 日志级别：ERROR, WARN, INFO, DEBUG or TRACE
  3. 过程ID
  4. 分隔符：--- 标识理论日志的开始
  5. 线程名：方括号括起来（可能会截断控制台输入）
  6. Logger名：通常应用源代码的类名
  7. 日志内容

日志输入

在Spring Boot利用中，日志会默认会输入到控制台中，默认的输入日志级别蕴含：ERROR、WARN和INFO，咱们能够帮下面写的Hello World例子跑起来，就能够验证这样的默认设定：

2021-12-28 17:37:25.578  INFO 65136 --- [           main] com.didispace.chapter81.Application      : Started Application in 2.695 seconds (JVM running for 3.957)2021-12-28 17:37:25.579 ERROR 65136 --- [           main] com.didispace.chapter81.Application      : Hello World2021-12-28 17:37:25.579  WARN 65136 --- [           main] com.didispace.chapter81.Application      : Hello World2021-12-28 17:37:25.579  INFO 65136 --- [           main] com.didispace.chapter81.Application      : Hello World

开启DEBUG日志

咱们能够通过两种形式切换至DEBUG级别：

第一种：在运行命令后退出--debug标记，如：$ java -jar myapp.jar --debug

第二种：在配置文件application.properties中配置debug=true

这里开启的DEBUG日志，仅影响外围Logger，蕴含嵌入式容器、hibernate、spring等这些框架层面的会输入更多内容，然而你本人利用的日志并不会输入为DEBUG级别，从上面的截图中咱们就能够看到，咱们本人编写的debug级别的Hello
World并没有输入。

日志配置

上面介绍一些罕用的日志配置，以帮忙咱们更好的治理好日志内容。

多彩输入

如果你的终端反对ANSI，设置黑白输入会让日志更具可读性。通过在application.properties中设置spring.output.ansi.enabled参数来反对，该参数有三个选项：

  • NEVER：禁用ANSI-colored输入
  • DETECT：会查看终端是否反对ANSI，是的话就采纳黑白输入（默认项）
  • ALWAYS：总是应用ANSI-colored格局输入，若终端不反对的时候，会有很多烦扰信息，不举荐应用
留神：Spring Boot 1.x的时候，默认值为NEVER，2.x之后默认为DETECT，所以看咱们下面的截图，默认就曾经带有色彩了。所以如果是Spring Boot 2.x版本用户的话，这个根本就不必去批改了。

文件输入

Spring Boot默认配置只会输入到控制台，并不会记录到文件中，然而咱们通常生产环境应用时都须要以文件形式记录。

若要减少文件输入，须要在配置文件application.properties配置几个参数，比方这样：

logging.file.name=run.loglogging.file.path=./
  • logging.file.name：设置文件名
  • logging.file.path：设置文件门路
留神：这里跟1.x版本有区别，1.x的时候别离对应的参数为logging.file和logging.path。

文件滚动

始终把日志输入在一个文件里显然是不适合的，任何一个日志框架都会为此筹备日志文件的滚动配置。因为本篇将默认配置，所以就是Logback的配置，具体有这几个：

  • logging.logback.rollingpolicy.file-name-pattern：用于创立日志档案的文件名模式。
  • logging.logback.rollingpolicy.clean-history-on-start：应用程序启动时是否对进行日志归档清理，默认为false，不清理
  • logging.logback.rollingpolicy.max-history：要保留的最大归档日志文件数量，默认为7个
  • logging.logback.rollingpolicy.max-file-size：归档前日志文件的最大尺寸，默认为10MB
  • logging.logback.rollingpolicy.total-size-cap：日志档案在被删除前的最大容量，默认为0B

级别管制

如果要对各个Logger做一些简略的输入级别管制，那么只须要在application.properties中进行配置就能实现。

配置格局：logging.level.*=LEVEL

  • logging.level：日志级别管制前缀，*为包名或Logger名
  • LEVEL：选项TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF

举例：

  • logging.level.com.didispace=DEBUG：com.didispace包下所有class以DEBUG级别输入
  • logging.level.root=WARN：root日志以WARN级别输入

做了这样的配置之后，能够再执行下下面的程序，本来debug级别的Hello World就能够被胜利输入了。

自定义日志配置

因为日志服务个别都在ApplicationContext创立前就初始化了，它并不是必须通过Spring的配置文件管制。因而通过零碎属性和传统的Spring Boot内部配置文件仍然能够很好的反对日志管制和治理。

依据不同的日志零碎，你能够按如下规定组织配置文件名，就能被正确加载：

  • Logback：logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovy
  • Log4j2：log4j2-spring.xml, log4j2.xml
  • JDK (Java Util Logging)：logging.properties

Spring Boot官网举荐优先应用带有-spring的文件名作为你的日志配置（如应用logback-spring.xml，而不是logback.xml）

自定义输入格局

在Spring Boot中能够通过在application.properties配置如下参数管制输入格局：

  • logging.pattern.console：定义输入到控制台的款式（不反对JDK Logger）
  • logging.pattern.file：定义输入到文件的款式（不反对JDK Logger）

好了，明天的学习就到这里！如果您学习过程中如遇艰难？能够退出咱们超高品质的Spring技术交换群，参加交换与探讨，更好的学习与提高！汇总页面《Spring Boot基础教程》能够点击中转！，欢送珍藏与转发反对！

代码示例

本文的残缺工程能够查看上面仓库中2.x目录下的chapter8-1工程：

  • Github：https://github.com/dyc87112/SpringBoot-Learning/
  • Gitee：https://gitee.com/didispace/SpringBoot-Learning/

如果您感觉本文不错，欢送Star反对，您的关注是我保持的能源！

欢送关注我的公众号：程序猿DD。第一工夫理解前沿行业音讯、分享深度技术干货、获取优质学习资源