阿里妹导读
一、配置入口
logback-spring.xml是由 Spring Boot 找到,插入自己的上下文信息[1]并做进一步处理后再传递给Logback的,你可以在其中使用<springProfile>区分环境配置,也可以使用<springProperty>拿到Spring上下文信息(比如spring.application.name)。
logback.xml是由Logback自己找到的,自然不会有Spring Boot相关的能力。
二、配置文件介绍
confinuration:最外层的父标签,其中有几个属性配置,但项目中较少使用,就不啰嗦了;
property:定义变量;
appender:负责日志输出(一般是写到文件),我们可以通过它设置输出方案;
logger:用来设置某个LoggerName的打印级别;
root:logger的兜底配置,从而我们不必配置每个LoggerName;
2.1 springProperty 和 property
<springProperty scope="context" name="APP_NAME" source="spring.application.name"/>
<property name="LOG_PATH" value="${user.home}/${APP_NAME}/logs"/>
<property name="APP_LOG_FILE" value="${LOG_PATH}/application.log"/>
<property name="APP_LOG_PATTERN"
value="%date{yyyy-MM-dd HH:mm:ss.SSS}|%-5level|%X{trace_id}|%thread|%logger{20}|%message%n%exception"/>
2.2 appender
<appender name="APPLICATION" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${APP_LOG_FILE}</file>
<encoder>
<pattern>${APP_LOG_PATTERN}</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${APP_LOG_FILE}.%d{yyyy-MM-dd}.%i</fileNamePattern>
<maxHistory>30</maxHistory>
<maxFileSize>200MB</maxFileSize>
<totalSizeCap>10GB</totalSizeCap>
</rollingPolicy>
</appender>
<appender name="APPLICATION-async" class="ch.qos.logback.classic.AsyncAppender">
<queueSize>256</queueSize>
<discardingThreshold>0</discardingThreshold>
<neverBlock>true</neverBlock>
<appender-ref ref="APPLICATION"/>
</appender>
示例中涉及的变量在上一节已经提到,这里不啰嗦了。需要关注的是以下几个点:
ch.qos.logback.core.rolling.RollingFileAppender负责将日志滚动打印,避免单文件体积过大。具体的滚动策略都在<rollingPolicy>中指定,各配置项都还算好理解。
ch.qos.logback.classic.AsyncAppender负责将日志异步打印,避免大量打印日志时阻塞线程。
2.3 logger和root
<logger level="INFO" additivity="false" name="com.foo.bar">
<appender-ref ref="APPLICATION-async"/>
</logger>
<root level="INFO">
<appender-ref ref="APPLICATION-async"/>
</root>
上面的配置指定所有LoggerName为com.foo.bar的日志以INFO级别进行打印(TRACE和DEBUG级别将不会输出),此配置绑定的输出器(appender)为APPLICATION-async。
<root>
2.4 springProfile
<springProfile name="production">
<root level="INFO">
<appender-ref ref="APPLICATION-async"/>
</root>
</springProfile>
<springProfile name="staging,testing">
<root level="TRACE">
<appender-ref ref="APPLICATION-async"/>
</root>
</springProfile>
三、占位符
3.1 Conversion Word
另外,针对%logger额外做一下补充。%logger的参数中可以传一个正整数,用于指定输出长度,当LoggerName长度超过限制时,Logback会以 . 为分隔智能缩短。假设LoggerName是com.example.foo.bar.ExampleService(这个字符串长度为34),那么:
3.2 Format modifiers
-:第一个-表示不足最小长度时在右侧填充空格,即输出内容左对齐(默认是在左侧填充空格,即右对齐);
10:第一个数字表示输出最小长度,不足的补空格;
.:与后边两项配置的分隔符,本身没有含义;
-:第二个-表示超过最大长度时先裁剪右侧,即保留左侧字符(默认先裁剪左侧,即保留右侧字符);
20:第二个数字表示输出最大长度,超出部分会做裁剪;
四、Java API
场景一:使用log.info("obj={}", obj) 时,如何将obj统一转JSON String后输出;
场景二:日志中涉及到的手机号、身份证号,如何脱敏后再记录日志;
场景三:Logback配置基于XML,如何不改代码不发布,也可以动态修改日志级别;
五、MDC 中的 traceId
log.info("traceId={}, blah blah blah", Span.current().getSpanContext().getTraceId());
六、后记
[1]https://docs.spring.io/spring-boot/docs/current/reference/html/howto.html#howto.logging.logback
[2]https://logback.qos.ch/manual/configuration.html#variableSubstitution
[3]https://logback.qos.ch/manual/appenders.html
[4]https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.profiles
[5]https://logback.qos.ch/manual/layouts.html#conversionWord
[6]https://www.iso.org/iso-8601-date-and-time-format.html
[7]https://logback.qos.ch/manual/layouts.html#formatModifiers
[8]https://logback.qos.ch/apidocs/index.html
[9]https://logback.qos.ch/apidocs/ch/qos/logback/classic/pattern/MessageConverter.html
[10]https://logback.qos.ch/apidocs/ch/qos/logback/classic/LoggerContext.html
[11]https://logback.qos.ch/apidocs/ch/qos/logback/classic/Logger.html
[12]https://www.aliyun.com/product/xtrace
点击查看《Java日志通关(二) - Slf4j+Logback 整合及排包》