作者:唐亚峰
个人QQ:1837307557
battcn开源群(适合新手):391619659
微信公众号(欢迎调戏):
battcn
Spring Boot
内部采用的是 Commons Logging
进行日志记录,但在底层为 Java Util Logging
、Log4J2
、Logback
等日志框架提供了默认配置 。
Java 虽然有很多可用的日志框架,但请不要担心,一般来说,使用
SpringBoot
默认的Logback
就可以了。
1 日志格式
SpringBoot
的默认输出的日志格式如下:
输出如下元素:
Logback
是没有 FATAL
级别的日志,它将被映射到 ERROR
- 时间日期:精确到毫秒,可以用于排序
- 日志级别:ERROR、WARN、INFO、DEBUG、TRACE
- 进程ID
- 分隔符:采用
---
来标识日志开始部分 - 线程名:方括号括起来(可能会截断控制台输出)
- Logger名:通常使用源代码的类名
- 日志内容:我们输出的消息
2 日志输出
SpringBoot
默认为我们输出的日志级别为 INFO
、WARN
、ERROR
,如需要输出更多日志的时候,可以通过以下方式开启
- 命令模式配置:
java -jar app.jar --debug=true
, 这种命令会被SpringBoot
解析,且优先级最高 - 资源文件配置:
application.properties
配置debug=true
即可。该配置只对 嵌入式容器、Spring、Hibernate生效,我们自己的项目想要输出DEBUG
需要额外配置(配置规则:logging.level.<logger-name>=<level>
)
日志输出级别配置
logging.level.root = WARN
logging.level.org.springframework.web = DEBUG
logging.level.org.hibernate = ERROR
#比如 mybatis sql日志
logging.level.org.mybatis = INFO
logging.level.mapper所在的包 = DEBUG
日志输出格式配置
- logging.pattern.console: 定义输出到控制台的格式(不支持JDK Logger)
- logging.pattern.file: 定义输出到文件的格式(不支持JDK Logger)
3 颜色编码
如果终端支持 ANSI
,默认情况下会给日志上个色,提高可读性,可以在配置文件中设置 spring.output.ansi.enabled
来改变默认值
- ALWAYS: 启用
ANSI
颜色的输出。 - DETECT: 尝试检测
ANSI
着色功能是否可用。 - NEVER: 禁用
ANSI
颜色的输出。
3.1 编码对照表
Level | Color |
---|---|
WARN |
Yellow |
FATAL 、ERROR |
Red |
INFO 、DEBUG 、TRACE |
Green |
如果想修改日志默认色值,可以通过使用 %clr
关键字转换。比如想使文本变为黄色 %clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){yellow}
。目前支持的颜色有(blue
、cyan
、faint
、green
、magenta
、red
、yellow
)
4 文件保存
默认情况下,SpringBoot
仅将日志输出到控制台,不会写入到日志文件中去。如果除了控制台输出之外还想写日志文件,则需要在application.properties
设置logging.file
或 logging.path
属性。
- logging.file: 将日志写入到指定的 文件 中,默认为相对路径,可以设置成绝对路径
- logging.path: 将名为
spring.log
写入到指定的 文件夹 中,如(/var/log
)
日志文件在达到 10MB
时进行切割,产生一个新的日志文件(如:spring.1.log、spring.2.log
),新的日志依旧输出到 spring.log
中去,默认情况下会记录 ERROR
、WARN
、INFO
级别消息。
- logging.file.max-size: 限制日志文件大小
- logging.file.max-history: 限制日志保留天数
5 自定义日志配置
由于日志在 ApplicationContext
之前就初始化好了,所以 SpringBoot
为我们提供了 logging.config
属性,方便我们配置自定义日志文件。默认情况它会根据日志的依赖自动加载。
Logging System | Customization |
---|---|
JDK (Java Util Logging) |
logging.properties |
Log4j2 、ERROR |
log4j2-spring.xml 或 log4j2.xml |
Logback |
logback-spring.xml、logback-spring.groovy、logback.xml、logback.groovy |
6 Logback扩展配置
该扩展配置仅适用 logback-spring.xml
或者设置 logging.config
属性的文件,因为 logback.xml
加载过早,因此无法获取 SpringBoot
的一些扩展属性
使用扩展属性 springProfile
与 springProperty
让你的 logback-spring.xml
配置显得更有逼格,当别人还在苦苦挣扎弄logback-{profile}.xml的时候 你一个文件就搞定了…
6.1 springProfile
<springProfile>
标签使我们让配置文件更加灵活,它可以选择性的包含或排除部分配置。
<springProfile name="dev">
<!-- 开发环境时激活 -->
</springProfile>
<springProfile name="dev,test">
<!-- 开发,测试的时候激活-->
</springProfile>
<springProfile name="!prod">
<!-- 当 "生产" 环境时,该配置不激活-->
</springProfile>
6.2 案例
<!-- 开发环境日志级别为DEBUG/并且开发环境不写日志文件 -->
<springProfile name="dev">
<root level="DEBUG">
<appender-ref ref="STDOUT"/>
</root>
</springProfile>
<!-- 测试环境日志级别为INFO/并且记录日志文件 -->
<springProfile name="test">
<root level="INFO">
<appender-ref ref="FILE"/>
<appender-ref ref="STDOUT"/>
</root>
</springProfile>
6.3 springProperty
<springProperty>
标签可以让我们在 Logback 中使用 Spring Environment 中的属性。如果想在logback-spring.xml
中回读 application.properties
配置的值时,这是一个非常好的解决方案
<!-- 读取 spring.application.name 属性来生成日志文件名
scope:作用域
name:在 logback-spring.xml 使用的键
source:application.properties 文件中的键
defaultValue:默认值
-->
<springProperty scope="context" name="logName" source="spring.application.name" defaultValue="myapp.log"/>
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>logs/${logName}.log</file>
</appender>
7 个人简单示例:
示例项目结构:
7.1 application.properties文件内容如下:
# 配置日志文件路径
logging.file=D:/BaiduNetdiskDownload/spring-boot/chapter1/log/myspringboot.log
logging.level.com.battcn.chapter1.controller=debug # 不同目录下可配置不同级别
logging.level.com.battcn.chapter1.pojo=info
logging.level.com.battcn.chapter1.other=warn
logging.level.com.battcn.chapter1=info
7.2 Chapter1Application.class文件内容如下:
@RestController
@SpringBootApplication
public class Chapter1Application {
protected static final Logger logger = LoggerFactory.getLogger(Chapter1Application.class);
public static void main(String[] args) {
logger.info("SpringBoot开始加载");
SpringApplication.run(Chapter1Application.class, args);
logger.info("SpringBoot加载完毕");
}
@GetMapping("/demo1")
public String demo1(){
return "Hello batch";
}
@Bean
public CommandLineRunner commandLineRunner(ApplicationContext ctx) {
// 目的是
return args -> {
System.out.println("来看看 SpringBoot 默认为我们提供的 Bean:");
String[] beanNames = ctx.getBeanDefinitionNames();
Arrays.sort(beanNames);
Arrays.stream(beanNames).forEach(System.out::println);
};
}
}
7.3 日志记录输出文件是:myspringboot.log文件
7.4 下载
链接:https://pan.baidu.com/s/1vpQcSTet3pdYWv7LcbeTvA 提取码:y1ux
8 总结
9 文章参考:
- 【系统学习SpringBoot】SpringBoot配置logging日志及输出日志:https://blog.csdn.net/small_mouse0/article/details/77840582
- SpringBoot2.0日志配置实例:https://blog.csdn.net/gozhuyinglong/article/details/80523756