springboot在所有内部日志中使用Commons Logging,但对底层日志的实现保持开放。为Java Util Logging,Log4j2,Logback提供了默认配置。在每一种情况下,记录器(logger)都被预设为使用控制台输出,也可以选择输出到文件。
默认情况下,如果你使用Starter,则默认使用Logback。适当的Logback路由也包括在内,以确保使用Java Util Logging,Commons,Logging,Log4J或SLF4J的依赖库都能正确工作。
有很多适用于Java的日志框架。如果上面的列表看起来很混乱,请不要担心。一般来说,你不需要改变你的日志依赖,Spring Boot的默认值就很好用。
当你把你的应用程序部署到一个servlet容器获取这应用服务器时,用Java Util Logging API执行的日志不会被传送到你的应用程序的日志中。这可以防止由容器或其他已经部署到它的应用程序执行的日志出现在你的应用程序的日志中。
1. 日志格式
Spring Boot默认日志输出格式类似于下面的格式。
2024-12-28 20:46:19.086 INFO 15440 --- [ main] ptablePropertiesBeanFactoryPostProcessor : Post-processing PropertySource instances
2024-12-28 20:46:19.088 INFO 15440 --- [ main] c.u.j.EncryptablePropertySourceConverter : Skipping PropertySource configurationProperties [class org.springframework.boot.context.properties.source.ConfigurationPropertySourcesPropertySource
2024-12-28 20:46:19.089 INFO 15440 --- [ main] c.u.j.EncryptablePropertySourceConverter : Converting PropertySource bootstrap [org.springframework.core.env.MapPropertySource] to EncryptableMapPropertySourceWrapper
输出的项目如下。
- Date和Time:精确到毫秒,易于排序。
- 日志级别:ERROR, WARN, INFO, DEBUG, 或TRACE。
- 进程ID。
- 一个---分隔符,以区分实际日志信息的开始。
- Application name
- 线程名称
- 相关ID
- 记录器名称:这通常是源类的名称。
- 日志信息。
Logback没有FATAL级别。它被映射到ERROR。
如果你有一个spring.application.name属性,但不希望它被记录,你可以将logging.include-application-name设置为false。
2. 控制台输出
默认情况下,日志输出error,warn和info级别的信息输出到控制台。你也可以通过用--debug标志用debug方式启动你的应用程序。
$ java -jar myapplication.jar --debug
或者你也可以在application.properties中指定debug=true。
当debug模式被启用时,一些核心记录器被配置为输出更多信息。启用debug模式并不意味这将你的应用程序配置为debug级别记录所有信息。
2.1 彩色输出日志
如果你的终端支持ansi,就会适用彩色输出来帮助阅读。你可以将sprinng.output.ansi.enabled设置为支持的值,已覆盖自动检测。
颜色编码时同适用%clr转换关键字来配置的。
日志级别和颜色的映射关系
日志级别 | 颜色 |
FATAL | 红 |
ERROR | 红 |
WARN | 黄 |
INFO | 绿 |
DEBUG | 绿 |
TRACE | 绿 |
3. 日志输出到文件
默认情况下,spring boot 之向控制台记录日志,不写日志文件。如果你想在控制台输出之外写入到日志文件,你需要设置logging.file.name或logging.file.path属性。
logging.file.name | logging.file.path | example | description |
不指定 | 不指定 | - | 只在控制台进行记录 |
指定文件 | 不指定 | app.log | 写入指定的日志文件。名称可以是一个确切的位置,也可以是目录的相对位置。 |
不指定 | 指定目录 | /var/log | 将spring.log写入到指定目录。名称可以是一个确切位置,也可以是与当前目录相对的位置。 |
日志文件在达到10MB时就会轮换,与控制台输出一样。默认情况下会记录ERROR,WARN和INFO级别的信息。
4. 文件级别
所有支持的日志系统都可以通过使用logging.level.<logger-name>=<level>,在spring的Environment中设置日志级别,其中level时TRACE,DEBUG,INFO,WARN,ERROR,FATAL,或OFF之一。root记录器的级别可以通过logging.level.root来配置。
logging:
level:
root: "warn"
org.springframework.web: "debug"
org.hibernate: "error"