一. 工程pom依赖

springboot工程默认依赖 slf4j,logback 日志框架,如果使用lombok,依赖:

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-web</artifactId>
  4. </dependency>
  5. <dependency>
  6. <groupId>org.projectlombok</groupId>
  7. <artifactId>lombok</artifactId>
  8. <optional>true</optional>
  9. </dependency>

二. 配置

1. application.yml

  1. logging:
  2. # 日志配置文件
  3. config: classpath:logback-spring.xml
  4. level:
  5. # 日志打印sql语句
  6. dao: debug
  7. org:
  8. mybatis: debug

2. logback-spring.xml

使用,修改变量 log.path /name

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- 日志级别从低到高分为TRACE < DEBUG < INFO < WARN < ERROR < FATAL,如果设置为WARN,则低于WARN的信息都不会输出 -->
  3. <!-- scan:当此属性设置为true时,配置文档如果发生改变,将会被重新加载,默认值为true -->
  4. <!-- scanPeriod:设置监测配置文档是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。
  5. 当scan为true时,此属性生效。默认的时间间隔为1分钟。 -->
  6. <!-- debug:当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。 -->
  7. <configuration scan="true" scanPeriod="10 seconds">
  8. <contextName>logback</contextName>
  9. <!-- name的值是变量的名称,value的值时变量定义的值。通过定义的值会被插入到logger上下文中。定义后,可以使“${}”来使用变量。 -->
  10. <property name="log.path" value="D:/logs/log" />
  11. <property name="log.name" value="demo" />
  12. <!--0. 日志格式和颜色渲染 -->
  13. <!-- 彩色日志依赖的渲染类 -->
  14. <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
  15. <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
  16. <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
  17. <!-- 彩色日志格式 -->
  18. <property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
  19. <!--1. 输出到控制台-->
  20. <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
  21. <!--此日志appender是为开发使用,只配置最底级别,控制台输出的日志级别是大于或等于此级别的日志信息-->
  22. <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
  23. <level>debug</level>
  24. </filter>
  25. <encoder>
  26. <Pattern>${CONSOLE_LOG_PATTERN}</Pattern>
  27. <!-- 设置字符集 -->
  28. <charset>UTF-8</charset>
  29. </encoder>
  30. </appender>
  31. <!--2. 输出到文档-->
  32. <!-- 2.1 level为 DEBUG 日志,时间滚动输出 -->
  33. <appender name="DEBUG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  34. <!-- 正在记录的日志文档的路径及文档名 -->
  35. <file>${log.path}/${log.name}_debug.log</file>
  36. <!--日志文档输出格式-->
  37. <encoder>
  38. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  39. <charset>UTF-8</charset> <!-- 设置字符集 -->
  40. </encoder>
  41. <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  42. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  43. <!-- 日志归档 -->
  44. <fileNamePattern>${log.path}/${log.name}-debug-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  45. <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  46. <maxFileSize>100MB</maxFileSize>
  47. </timeBasedFileNamingAndTriggeringPolicy>
  48. <!--日志文档保留天数-->
  49. <maxHistory>15</maxHistory>
  50. </rollingPolicy>
  51. <!-- 此日志文档只记录debug级别的 -->
  52. <filter class="ch.qos.logback.classic.filter.LevelFilter">
  53. <level>debug</level>
  54. <onMatch>ACCEPT</onMatch>
  55. <onMismatch>DENY</onMismatch>
  56. </filter>
  57. </appender>
  58. <!-- 2.2 level为 INFO 日志,时间滚动输出 -->
  59. <appender name="INFO_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  60. <!-- 正在记录的日志文档的路径及文档名 -->
  61. <file>${log.path}/${log.name}_info.log</file>
  62. <!--日志文档输出格式-->
  63. <encoder>
  64. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  65. <charset>UTF-8</charset>
  66. </encoder>
  67. <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  68. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  69. <!-- 每天日志归档路径以及格式 -->
  70. <fileNamePattern>${log.path}/${log.name}-info-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  71. <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  72. <maxFileSize>100MB</maxFileSize>
  73. </timeBasedFileNamingAndTriggeringPolicy>
  74. <!--日志文档保留天数-->
  75. <maxHistory>15</maxHistory>
  76. </rollingPolicy>
  77. <!-- 此日志文档只记录info级别的 -->
  78. <filter class="ch.qos.logback.classic.filter.LevelFilter">
  79. <level>info</level>
  80. <onMatch>ACCEPT</onMatch>
  81. <onMismatch>DENY</onMismatch>
  82. </filter>
  83. </appender>
  84. <!-- 2.3 level为 WARN 日志,时间滚动输出 -->
  85. <appender name="WARN_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  86. <!-- 正在记录的日志文档的路径及文档名 -->
  87. <file>${log.path}/${log.name}_warn.log</file>
  88. <!--日志文档输出格式-->
  89. <encoder>
  90. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  91. <charset>UTF-8</charset> <!-- 此处设置字符集 -->
  92. </encoder>
  93. <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  94. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  95. <fileNamePattern>${log.path}/${log.name}-warn-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  96. <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  97. <maxFileSize>100MB</maxFileSize>
  98. </timeBasedFileNamingAndTriggeringPolicy>
  99. <!--日志文档保留天数-->
  100. <maxHistory>15</maxHistory>
  101. </rollingPolicy>
  102. <!-- 此日志文档只记录warn级别的 -->
  103. <filter class="ch.qos.logback.classic.filter.LevelFilter">
  104. <level>warn</level>
  105. <onMatch>ACCEPT</onMatch>
  106. <onMismatch>DENY</onMismatch>
  107. </filter>
  108. </appender>
  109. <!-- 2.4 level为 ERROR 日志,时间滚动输出 -->
  110. <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  111. <!-- 正在记录的日志文档的路径及文档名 -->
  112. <file>${log.path}/${log.name}_error.log</file>
  113. <!--日志文档输出格式-->
  114. <encoder>
  115. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  116. <charset>UTF-8</charset> <!-- 此处设置字符集 -->
  117. </encoder>
  118. <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  119. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  120. <fileNamePattern>${log.path}/${log.name}-error-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  121. <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  122. <maxFileSize>100MB</maxFileSize>
  123. </timeBasedFileNamingAndTriggeringPolicy>
  124. <!--日志文档保留天数-->
  125. <maxHistory>15</maxHistory>
  126. </rollingPolicy>
  127. <!-- 此日志文档只记录ERROR级别的 -->
  128. <filter class="ch.qos.logback.classic.filter.LevelFilter">
  129. <level>ERROR</level>
  130. <onMatch>ACCEPT</onMatch>
  131. <onMismatch>DENY</onMismatch>
  132. </filter>
  133. </appender>
  134. <!--
  135. <logger>用来设置某一个包或者具体的某一个类的日志打印级别、
  136. 以及指定<appender>。<logger>仅有一个name属性,
  137. 一个可选的level和一个可选的addtivity属性。
  138. name:用来指定受此logger约束的某一个包或者具体的某一个类。
  139. level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,
  140. 还有一个特俗值INHERITED或者同义词NULL,代表强制执行上级的级别。
  141. 如果未设置此属性,那么当前logger将会继承上级的级别。
  142. addtivity:是否向上级logger传递打印信息。默认是true。
  143. <logger name="org.springframework.web" level="info"/>
  144. <logger name="org.springframework.scheduling.annotation.ScheduledAnnotationBeanPostProcessor" level="INFO"/>
  145. -->
  146. <!--
  147. 使用mybatis的时候,sql语句是debug下才会打印,而这里我们只配置了info,所以想要查看sql语句的话,有以下两种操作:
  148. 第一种把<root level="info">改成<root level="DEBUG">这样就会打印sql,不过这样日志那边会出现很多其他消息
  149. 第二种就是单独给dao下目录配置debug模式,代码如下,这样配置sql语句会打印,其他还是正常info级别:
  150. 【logging.level.org.mybatis=debug logging.level.dao=debug】
  151. -->
  152. <!--
  153. root节点是必选节点,用来指定最基础的日志输出级别,只有一个level属性
  154. level:用来设置打印级别,大小写无关:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,
  155. 不能设置为INHERITED或者同义词NULL。默认是DEBUG
  156. 可以包含零个或多个元素,标识这个appender将会添加到这个logger。
  157. -->
  158. <!-- 4. 最终的策略,application.yml 使用 dev & prod 对应配置 -->
  159. <!-- 4.1 开发环境:打印控制台-->
  160. <springProfile name="dev">
  161. <root level="info">
  162. <appender-ref ref="CONSOLE" />
  163. </root>
  164. </springProfile>
  165. <!-- 4.2 生产环境:输出到文档
  166. <springProfile name="prod">
  167. <root level="info">
  168. <appender-ref ref="DEBUG_FILE" />
  169. <appender-ref ref="INFO_FILE" />
  170. <appender-ref ref="ERROR_FILE" />
  171. <appender-ref ref="WARN_FILE" />
  172. </root>
  173. </springProfile> -->
  174. </configuration>

三. 使用

  1. application.yml 使用哪个环境的配置文件,则使用不同的日志级别配置
  2. 通过工厂引入日志

    1. Logger logger = LoggerFactory.getLogger(getClass());

    3.通过 lombok 引入,类增加注解,直接 log.info().

    1. @Slf4j
    2. public class TestServiceImpl implements TestService {
    3. // 日志级别由低到高 ·{} 占位符方式·
    4. log.info("info级别日志");
    5. log.debug("debug级别日志");
    6. log.warn("warn{}","级别日志");
    7. log.error("error级别日志");