Spring Boot 之日志记录

Spring Boot 之日志记录

Spring Boot 支持集成 Java 世界主流的日志库。

若是对于 Java 日志库不熟悉，能够参考：细说 Java 主流日志工具库

关键词： log4j, log4j2, logback, slf4j

<!-- TOC depthFrom:2 depthTo:3 -->

• 日志格式
• 控制台输出
  • 彩色打印
• 文件输出
• 日志级别
• 日志组
• 日志配置文件
• Spring Boot 中的日志配置
• 源码
• 引伸和引用

<!-- /TOC -->

Spring Boot 内部日志所有使用 Commons Logging 记录，但保留底层日志实现。为 Java Util Logging，Log4J2，和 Logback 提供了默认配置。在每种状况下，记录器都预先配置为使用控制台输出，而且还提供可选的文件输出。

默认状况下，若是使用“Starters”，则使用 Logback 进行日志记录。还包括适当的 Logback 路由，以确保使用 Java Util Logging，Commons Logging，Log4J 或 SLF4J 的依赖库都能正常工做。

日志格式

Spring Boot 日志默认格式相似下面的形式：

2014-03-05 10:57:51.112  INFO 45469 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet Engine: Apache Tomcat/7.0.52
2014-03-05 10:57:51.253  INFO 45469 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2014-03-05 10:57:51.253  INFO 45469 --- [ost-startStop-1] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 1358 ms
2014-03-05 10:57:51.698  INFO 45469 --- [ost-startStop-1] o.s.b.c.e.ServletRegistrationBean        : Mapping servlet: 'dispatcherServlet' to [/]
2014-03-05 10:57:51.702  INFO 45469 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean  : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]

说明：

• 日期和时间：精确到微秒
• 日志级别：ERROR, WARN, INFO, DEBUG, or TRACE.
• 进程 ID
• --- 分隔符后面是实际的日志内容
• 线程名
• 日志名
• 日志内容

控制台输出

Spring Boot 默认打印信息到控制台，而且仅打印ERROR, WARN, INFO 级别信息。

若是你想打印 debug 级别信息，能够设置 jar 启动参数，以下：

$ java -jar myapp.jar --debug

此外，也能够在 application.properties 中设置 debug = true 。

打印 trace 级别信息同上所示。

彩色打印

若是您的终端支持 ANSI，可使用彩色打印来提升可读性。您能够将 spring.output.ansi.enabled 设置为支持的值以覆盖自动检测。 使用 ％clr 转换字配置颜色编码。在最简单的形式中，转换器根据日志级别对输出进行着色，如如下示例所示：

%clr(%5p)
%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){yellow}

支持如下的颜色和样式：

• blue
• cyan
• faint
• green
• magenta
• red
• yellow

文件输出

默认状况下，Spring Boot 仅记录到控制台，不会写入日志文件。若是除了控制台输出以外还要编写日志文件，则须要设置 logging.file 或 logging.path 属性（例如，在 application.properties 中）。

详细配置参考：配置

日志级别

全部支持的日志系统均可以 在 Spring 环境中经过 logging.level.<logger-name>=<level> 属性设置日志级别（例如，在 application.properties 中）。其中 level 是 TRACE、DEBUG、INFO、WARN 、ERROR、FATAL 或 OFF。可使用 logging.level.root 配置根记录器。

示例：

logging.level.root=WARN
logging.level.org.springframework.web=DEBUG
logging.level.org.hibernate=ERROR

日志组

可以将相关记录器组合在一块儿以即可以同时配置它们一般颇有用。例如，您能够更改全部 Tomcat 相关记录器的日志记录级别，但您没法轻松记住顶级软件包。

Spring Boot 经过 logging.group 属性来提供这样的支持。

logging.group.tomcat=org.apache.catalina, org.apache.coyote, org.apache.tomcat
logging.level.tomcat=TRACE

如下是 Spring Boot 预设的日志组：

名称	Loggers
web	org.springframework.core.codec, org.springframework.http, org.springframework.web
sql	org.springframework.jdbc.core, org.hibernate.SQL

日志配置文件

能够经过在 classpath 中包含适当的库来激活各类日志记录系统，而且能够经过在 classpath 的根目录中或在如下 Spring Environment 属性指定的位置提供合适的配置文件来进一步自定义：logging.config。

您可使用 org.springframework.boot.logging.LoggingSystem 系统属性强制 Spring Boot 使用特定的日志记录系统。该值应该是 LoggingSystem 实现的彻底限定类名。您还可使用 none 值彻底禁用 Spring Boot 的日志记录配置。

因为在建立 ApplicationContext 以前初始化日志记录，所以没法在 Spring @Configuration 文件中控制来自 @PropertySources 的日志记录。更改日志记录系统或彻底禁用它的惟一方法是经过系统属性。

Logback 扩展

profile 指定配置

能够经过 <springProfile> 指定特定的 profile 下的配置，以下：

<springProfile name="staging">
	<!-- configuration to be enabled when the "staging" profile is active -->
</springProfile>

<springProfile name="dev | staging">
	<!-- configuration to be enabled when the "dev" or "staging" profiles are active -->
</springProfile>

<springProfile name="!production">
	<!-- configuration to be enabled when the "production" profile is not active -->
</springProfile>

环境属性

<springProperty> 标签容许指定从 Environment 中获取的属性，并在配置文件中引用。

<springProperty scope="context" name="fluentHost" source="myapp.fluentd.host"
		defaultValue="localhost"/>
<appender name="FLUENT" class="ch.qos.logback.more.appenders.DataFluentAppender">
	<remoteHost>${fluentHost}</remoteHost>
	...
</appender>

Spring Boot 中的日志配置

logging.config= # Location of the logging configuration file. For instance, `classpath:logback.xml` for Logback.
logging.exception-conversion-word=%wEx # Conversion word used when logging exceptions.
logging.file= # Log file name (for instance, `myapp.log`). Names can be an exact location or relative to the current directory.
logging.file.max-history=0 # Maximum of archive log files to keep. Only supported with the default logback setup.
logging.file.max-size=10MB # Maximum log file size. Only supported with the default logback setup.
logging.group.*= # Log groups to quickly change multiple loggers at the same time. For instance, `logging.level.db=org.hibernate,org.springframework.jdbc`.
logging.level.*= # Log levels severity mapping. For instance, `logging.level.org.springframework=DEBUG`.
logging.path= # Location of the log file. For instance, `/var/log`.
logging.pattern.console= # Appender pattern for output to the console. Supported only with the default Logback setup.
logging.pattern.dateformat=yyyy-MM-dd HH:mm:ss.SSS # Appender pattern for log date format. Supported only with the default Logback setup.
logging.pattern.file= # Appender pattern for output to a file. Supported only with the default Logback setup.
logging.pattern.level=%5p # Appender pattern for log level. Supported only with the default Logback setup.
logging.register-shutdown-hook=false # Register a shutdown hook for the logging system when it is initialized.

注：

• 日志配置属性在应用程序生命周期的早期初始化。所以，经过 @PropertySource 注释加载的属性文件中找不到日志记录属性。
• 日志配置属性独立于实际的日志记录基础结构。所以，spring Boot 无论理特定的配置密钥（例如 Logback 的 logback.configurationFile）。

源码

完整示例：源码

分别展现如何在 Spring Boot 中使用 log4j, log4j2, logback 记录日志。

引伸和引用

引伸

• 细说 Java 主流日志工具库
• Spring Boot 教程

引用

• Spring Boot 官方文档之 boot-features-logging

原文出处：https://www.cnblogs.com/jingmoxukong/p/10193303.html