1.依赖
<groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-logging</artifactId>
Spring Boot项目一般都会引用spring-boot-starter
或者spring-boot-starter-web
,而这两个起步依赖中都已经包含了对于spring-boot-starter-logging
的依赖,所以,无需额外添加依赖。
可以在idea右上角的maven中查看jar包依赖关系。
2.使用
2.1 关于约定
日志有很多东西需要配置,但是又好像不需要配置什么东西,今天一段话点醒了我。
据不同的日志系统,按照指定的规则组织配置文件名,并放在 resources 目录下,就能自动被 spring boot 加载:
- Logback:logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovy
- Log4j: log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xml
- Log4j2: log4j2-spring.xml, log4j2.xml
- JDK (Java Util Logging): logging.properties
这些内容就是springboot的优势了,约定优于配置。
想要自定义文件名的可配置:logging.config
指定配置文件名:
logging.config=classpath:logging-config.xml
pring Boot 官方推荐优先使用带有 -spring 的文件名作为你的日志配置(如使用 logback-spring.xml ,而不是 logback.xml ),命名为 logback-spring.xml 的日志配置文件, spring boot 可以为它添加一些 spring boot 特有的配置项。
2.2 配置文件内容
代码前的介绍
根节点<configuration>
有 5 个子节点,下面来进行一一介绍。
<root>
节点
root 节点是必选节点,用来指定最基础的日志输出级别,只有一个 level 属性,用于设置打印级别,可选如下:TRACE
,DEBUG
,INFO
,WARN
,ERROR
,ALL
,OFF
。
root 节点可以包含 0 个或多个元素,将appender
添加进来。如下:
<root level="debug">
<appender-ref ref="console" />
<appender-ref ref="file" />
</root>
appender 也是子节点之一,将会在后面说明。
<contextName>
节点
设置上下文名称,默认为default
,可通过%contextName
来打印上下文名称,一般不使用此属性。
<property>
节点
用于定义变量,方便使用。有两个属性:name,value。定义变量后,可以使用${}
来使用变量。如下:
<property name="path" value="./log"/>
<property name="appname" value="app"/>
<appender>
节点
appender 用来格式化日志输出的节点,这个最重要。有两个属性:
- name:该本 appender 命名
- class:指定输出策略,通常有两种:控制台输出,文件输出
<?xml version="1.0" encoding="UTF-8"?> <configuration debug="false"> <!--设置存储路径变量--> <property name="LOG_HOME" value="./log"/> <!--控制台输出appender--> <appender name="console" class="ch.qos.logback.core.ConsoleAppender"> <!--设置输出格式--> <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder"> <!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度%msg:日志消息,%n是换行符--> <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern> <!--设置编码--> <charset>UTF-8</charset> </encoder> </appender> <!--文件输出,时间窗口滚动--> <appender name="timeFileOutput" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!--日志名,指定最新的文件名,其他文件名使用FileNamePattern --> <File>${LOG_HOME}/timeFile/out.log</File> <!--文件滚动模式--> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!--日志文件输出的文件名,可设置文件类型为gz,开启文件压缩--> <FileNamePattern>${LOG_HOME}/timeFile/info.%d{yyyy-MM-dd}.%i.log.gz</FileNamePattern> <!--日志文件保留天数--> <MaxHistory>30</MaxHistory> <!--按大小分割同一天的--> <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> <maxFileSize>10MB</maxFileSize> </timeBasedFileNamingAndTriggeringPolicy> </rollingPolicy> <!--输出格式--> <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder"> <!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度%msg:日志消息,%n是换行符--> <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern> <!--设置编码--> <charset>UTF-8</charset> </encoder> </appender> <!--指定基础的日志输出级别--> <root level="INFO"> <!--appender将会添加到这个loger--> <appender-ref ref="console"/> <appender-ref ref="timeFileOutput"/> </root> </configuration>
在 appender 中设置,filter 子节点,在默认级别上再此过滤,配置 onMatch,onMismatch 可实现只输出单个级别
<appender ...>
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>INFO</level>
<!--接受匹配-->
<onMatch>ACCEPT</onMatch>
<!--拒绝不匹配的-->
<onMismatch>DENY</onMismatch>
</filter>
</appender>
<logger>
节点
构成
此节点用来设置一个包或具体的某一个类的日志打印级别、以及指定<appender>
,有以下三个属性:
- name: 必须。用来指定受此 loger 约束的某个包或者某个具体的类
- level:可选。设置打印级别。默认为 root 的级别。
- addtivity: 可选。是否向上级 loger(也就是 root 节点)传递打印信息。默认为 true。
- 不指定级别,不指定 appender
<!-- 控制com.example.service下类的打印,使用root的level和appender -->
<logger name="com.example.service"/>
2.指定级别,不指定 appender
<!-- 控制com.example.service下类的打印,使用root的appender打印warn级别日志 -->
<logger name="com.example.service" level="WARN"/>
3.指定级别,指定 appender
<!-- 控制com.example.service下类的打印,使用console打印warn级别日志 -->
<!-- 设置addtivity是因为这里已经指定了appender,如果再向上传递就会被root下的appender再次打印 -->
<logger name="com.example.service" level="WARN" addtivity="false">
<appender-ref ref="console">
</logger>
通过指定 appender 就能将指定的包下的日志打印到指定的文件中。
多环境日志输出
通过设置文件名为-spring 结尾,可分环境配置 logger。
<configuration> <!-- 测试环境+开发环境. 多个使用逗号隔开. --> <springProfile name="test,dev"> <logger name="com.example.demo.controller" level="DEBUG" additivity="false"> <appender-ref ref="console"/> </logger> </springProfile> <!-- 生产环境. --> <springProfile name="prod"> <logger name="com.example.demo" level="INFO" additivity="false"> <appender-ref ref="timeFileOutput"/> </logger> </springProfile> </configuration>