Spring Boot在所有内部日志中使用 Commons Logging,但是默认配置也提供了对常用日志的支持,如:Java Util Logging,Log4J, Log4J2 和 Logback。每种 Logger 都可以通过配置使用控制台或者文件输出日志内容。
默认情况下,SpringBoot使用Logback作为日志框架。
日志打印出内存地址解决
使用logback/log4j等原生的日志框架,在日志输出的时候可能会遇到一个问题:
如果被打印参数未重写 toString 方法,则打印出来的都是 XXX@xx。
一般简单的解决办法是,可以通过 JSON 把对象转成 String,如:
log.info("obj = {}", JSON.toJSONString(obj));
这种方式显然不够优雅,而且笨拙,有一个好办法:
借助logback(log4j也有类似的功能)的MessageConverter。无侵入性的解决这个问题
1、自定义一个Layout
/**
* 参数JSON格式化类
*
* @author Hollis
*/
public class ArgumentJsonFormatLayout extends MessageConverter {
@Override
public String convert(ILoggingEvent event) {
try {
return MessageFormatter.arrayFormat(event.getMessage(), Stream.of(event.getArgumentArray())
.map(JSON::toJSONString).toArray()).getMessage();
} catch (Exception e) {
return event.getMessage();
}
}
}
2、在logback中配置上这个Layout
<configuration>
<conversionRule conversionWord="m" converterClass="com.xx.ArgumentJsonFormatLayout"/>
</configuration>
然后,就可以直接使用log.info("obj = {}",obj)
这样的形式记录日志了。
格式化日志
默认的日志输出如下:
2017-05-08 08:23:50.120 INFO 37397 --- [ main] org.hibernate.Version : HHH000412: Hibernate Core {4.3.11.Final}
输出内容元素具体如下:
- 时间日期 — 精确到毫秒
- 日志级别 — ERROR, WARN, INFO, DEBUG or TRACE
- 进程ID
- 分隔符 — --- 标识实际日志的开始
- 线程名 — 方括号括起来(可能会截断控制台输出)
- Logger名 — 通常使用源代码的类名
- 日志内容
控制台输出
在 Spring Boot 中默认配置了 ERROR
、WARN
和 INFO
级别的日志输出到控制台。
我们可以通过两种方式切换至 DEBUG
级别:
在运行命令后加入 --debug
标志,如:java -jar myapp.jar --debug
在 application.properties
中配置 debug=true
,该属性置为 true
的时候,核心 Logger(包含嵌入式容器、hibernate、spring)会输出更多内容,但是你自己应用的日志并不会输出为 DEBUG
级别。
#多彩输出
如果你的终端支持 ANSI
,设置彩色输出会让日志更具可读性。通过在 application.properties
中设置 spring.output.ansi.enabled
参数来支持。
- NEVER:禁用ANSI-colored输出(默认项)
- DETECT:会检查终端是否支持ANSI,是的话就采用彩色输出(==推荐项==)
- ALWAYS:总是使用ANSI-colored格式输出,若终端不支持的时候,会有很多干扰信息,不推荐使用 #文件输出 Spring Boot 默认配置只会输出到控制台,并不会记录到文件中,但是我们通常生产环境使用时都需要以文件方式记录。
若要增加文件输出,需要在 application.properties
中配置 logging.file
或 logging.path
属性。
- logging.file,设置文件,可以是绝对路径,也可以是相对路径。如:
logging.file=my.log
- logging.path,设置目录,会在该目录下创建spring.log文件,并写入日志内容,如:
logging.path=/var/log
日志文件会在10Mb大小的时候被截断,产生新的日志文件,默认级别为:ERROR、WARN、INFO
#级别控制
在Spring Boot中只需要在 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级别输出 #自定义日志配置 由于日志服务一般都在ApplicationContext
创建前就初始化了,它并不是必须通过 Spring 的配置文件控制。因此通过系统属性和传统的 Spring Boot 外部配置文件依然可以很好的支持日志控制和管理。
根据不同的日志系统,你可以按如下规则组织配置文件名,就能被正确加载:
- Logback:
logback-spring.xm
,logback-spring.groovy
,logback.xml
,logback.groovy
- Log4j:
log4j-spring.properties
,log4j-spring.xml
,log4j.properties
,og4j.xml
- 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)
使用 logback 出现LOG_PATH_IS_UNDEFINED
的问题解决
- 1、将
logback.xml
改成logback-spring.xml
。 - 2、在
application.xxx
配置文件中增加:logging.path
或logging.file
日志文件路径配置。 - 3、修改
logback-spring.xml
文件,将logPath
的value
中改成${LOG_PATH:-.}
,例如:
<property name="logPath" value="${LOG_PATH:-.}"></property>
这样 logback 会读取到 springboot application 配置文件中指定的日志目录位置。
贴一个目前使用的logback-spring.xml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<!-- 日志地址 -->
<property name="logPath" value="${LOG_PATH:-.}"></property>
<!--配置console打印的log-->
<appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender">
<layout class="ch.qos.logback.classic.PatternLayout">
<pattern>[%date{yyyy-MM-dd HH:mm:ss}] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
</layout>
</appender>
<!--自定义配置-->
<appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>INFO</level>
<onMatch>ACCEPT</onMatch>
<onMismatch>DENY</onMismatch>
</filter>
<encoder>
<!--日志内容格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度%msg:日志消息,%n是换行符-->
<!--<pattern>[%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] %logger{50} - %msg%n</pattern>-->
<pattern>[%date{yyyy-MM-dd HH:mm:ss}] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
<!--滚动策略,按天输出日志-->
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!--设置文件保存路径,timeBasedFileNamingAndTriggeringPolicy标签时,这里的%i要加上,不然会导致运行报错-->
<fileNamePattern>${logPath}/info.%d-%i.log</fileNamePattern>
<!-- 配置日志文件不能超过2M,若超过2M,日志文件会以索引0开始,命名日志文件,例如info.2018-12-21-0.log -->
<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<maxFileSize>10MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
<!--日志文件保留天数-->
<maxHistory>5</maxHistory>
</rollingPolicy>
</appender>
<appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>ERROR</level>
</filter>
<encoder>
<pattern>[%date{yyyy-MM-dd HH:mm:ss}] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
<!--滚动策略 按天生成日志-->
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!--路径-->
<fileNamePattern>${logPath}/error.%d.log</fileNamePattern>
</rollingPolicy>
</appender>
<root level="info">
<appender-ref ref="consoleLog" />
<appender-ref ref="fileInfoLog" />
<appender-ref ref="fileErrorLog" />
</root>
<!--日志指定包路径-->
<logger name="com.sherlocky" level = "INFO">
<appender-ref ref="consoleLog" />
<appender-ref ref="fileInfoLog" />
<appender-ref ref="fileErrorLog" />
</logger>
</configuration>
改良版
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<!-- 读取系统环境属性 -->
<property name="log_path" value="${LOG_PATH:-./logs}"></property>
<!-- 读取当前应用Environment中的属性 -->
<!--
<springProperty scope="context" name="log_path" source="logging.path" defaultValue="./demo-logs"/>
-->
<springProperty scope="context" name="app_name" source="spring.application.name" defaultValue="demo"/>
<!-- 日志文件保留天数 -->
<springProperty scope="context" name="logger_max_history" source="logging.file.max-history" defaultValue="7"/>
<!-- 日志文件大小:默认50MB -->
<springProperty scope="context" name="max_file_size" source="logging.file.max-size" defaultValue="10MB"/>
<contextName>${app_name}</contextName>
<!-- Log Appender Begin -->
<appender name="STDOUT" 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>-->
<pattern>#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
<springProfile name="prod">
<!--输出到文件-->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
<maxFileSize>${max_file_size}</maxFileSize>
<maxHistory>${logger_max_history}</maxHistory>
<totalSizeCap>1GB</totalSizeCap>
</rollingPolicy>
<encoder>
<pattern>#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
</springProfile>
<springProfile name="test">
<!--输出到文件-->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
<maxFileSize>${max_file_size}</maxFileSize>
<maxHistory>${logger_max_history}</maxHistory>
<totalSizeCap>1GB</totalSizeCap>
</rollingPolicy>
<encoder>
<pattern>#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
</springProfile>
<springProfile name="prod">
<root level="INFO">
<appender-ref ref="FILE"/>
</root>
</springProfile>
<springProfile name="test">
<root level="DEBUG">
<appender-ref ref="FILE"/>
</root>
</springProfile>
<springProfile name="dev">
<root level="DEBUG">
<appender-ref ref="STDOUT"/>
</root>
</springProfile>
</configuration>
彩色日志版
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<!-- 读取系统环境属性 -->
<property name="log_path" value="${LOG_PATH:-./logs}"></property>
<!-- 读取当前应用Environment中的属性 -->
<!--
<springProperty scope="context" name="log_path" source="logging.path" defaultValue="./demo-logs"/>
-->
<springProperty scope="context" name="app_name" source="spring.application.name" defaultValue="demo"/>
<!-- 日志文件保留天数 -->
<springProperty scope="context" name="logger_max_history" source="logging.file.max-history" defaultValue="7"/>
<!-- 日志文件大小:默认50MB -->
<springProperty scope="context" name="max_file_size" source="logging.file.max-size" defaultValue="10MB"/>
<contextName>${app_name}</contextName>
<property name="log_pattern_old" value="#${app_name}# [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%thread] [%-5level] [%logger:%line] --%mdc{client} %msg%n"/>
<!-- 可参考:spring-boot.jar!/org/springframework/boot/logging/logback/defaults.xml -->
<!-- https://logback.qos.ch/manual/layouts.html#coloring 彩色日志另一种写法,举个例子
<pattern>%yellow(%date{yyyy-MM-dd HH:mm:ss}) |%highlight(%-5level) |%green(%logger:%line) |%black(%msg%n)</pattern>
-->
<conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
<conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
<conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
<property name="log_pattern" value="#${app_name}# %clr([%d{yyyy-MM-dd HH:mm:ss.SSS}]){faint} [%thread] %clr([%-5level]) %clr([%-60.60logger{60}:%-3line]){cyan} --%mdc{client} %msg%n%wEx"/>
<!-- Log Appender Begin -->
<appender name="STDOUT" 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>-->
<pattern>${log_pattern}</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
<springProfile name="prod">
<!--输出到文件-->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
<maxFileSize>${max_file_size}</maxFileSize>
<maxHistory>${logger_max_history}</maxHistory>
<totalSizeCap>1GB</totalSizeCap>
</rollingPolicy>
<encoder>
<pattern>${log_pattern}</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
</springProfile>
<springProfile name="test">
<!--输出到文件-->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${log_path}/${app_name}/${app_name}-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
<maxFileSize>${max_file_size}</maxFileSize>
<maxHistory>${logger_max_history}</maxHistory>
<totalSizeCap>1GB</totalSizeCap>
</rollingPolicy>
<encoder>
<pattern>${log_pattern}</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
</springProfile>
<springProfile name="prod">
<root level="INFO">
<appender-ref ref="FILE"/>
</root>
</springProfile>
<springProfile name="test">
<root level="DEBUG">
<appender-ref ref="FILE"/>
</root>
</springProfile>
<springProfile name="dev">
<root level="DEBUG">
<appender-ref ref="STDOUT"/>
</root>
</springProfile>
</configuration>
application.properties 样例:
spring.application.name=qiniu-sync-nas
# 日志配置
logging.path=D:/vfsroot/logs
logging.file.max-history=7
logging.file.max-size=10MB
# 会检查终端是否支持ANSI,是的话就采用彩色输出
spring.output.ansi.enabled=detect
旧 web 项目使用 logback 配置可参考旧 web 项目使用 logback
日志规范可参考:惊讶!我定的日志规范被CTO在全公司推广了
评论区