Spring Boot 2.x 集成 SLF4j + log4j2 日志框架

蔚落 2022-10-05 00:52 297阅读 0赞

目录

Apache log4j2 日志框架概述

Spring Boot 2.x 集成 SLF4j + log4j2 日志框架

monitorInterval 定时读取配置信息

LoggerConfig 动态修改日志记录器(推荐)

Spring boot Actuator 监控与切换日志

为什么将 Logger 对象声明为 private static final

Apache log4j2 日志框架概述

1、Apache log4j2 是对 Log4j 的升级，它提供了对其前身 log4j 1.x 的重大改进，并提供了 Logback 中可用的许多改进，同时修复了 Logback 体系结构中的一些固有问题。

2、Log4j 的 API 是独立于实现的，它向应用程序开发人员明确说明了在确保前向兼容性的同时可以使用哪些类和方法，这允许 Log4j 团队以兼容的方式安全地改进实现。

3、Log4j 2 分为 log4j-api 门面和 log4j-core 实现两个模块，API 和 slf4j 类似，属于日志抽象/门面，而实现部分 log4j-core，才是 Log4j 2 的核心。与 SLF4J 相比，Log4j API 有如下优点：

A、log4j API 支持记录消息，而不仅仅是字符串。
B、log4j API 支持 lambda 表达式。
C、Log4j API 提供了比 SLF4J 更多的日志记录方法。

4、除了 Slf4j 支持的”参数化日志”格式外，Log4j API 还支持使用 java.text.MessageFormat 语法的事件以及 printf 样式的消息。

5、log4j Api 提供 LogManager.shutdown() 方法，基础日志实现必须实现可终止接口，才能使方法生效。

Apache Log4j2 主页：http://logging.apache.org/log4j/2.x/download.html
log4j2 github 开源地址：https://github.com/apache/logging-log4j2
Spring boot 配置 log4j2：https://docs.spring.io/spring-boot/docs/2.1.3.RELEASE/reference/htmlsingle/#howto-configure-log4j-for-logging

用户指南(手册)：https://logging.apache.org/log4j/2.x/log4j-users-guide.pdf

6、Log4j2 包含基于 LMAX 中断器库的下一代异步记录器，在多线程场景中，异步记录器的吞吐量是 log4j1.x 和 Logback 的 18 倍，延迟也低几个数量级。

7、Log4j2 与 Logback 一样，可以在修改后自动重新加载其配置，与 Logback 不同的是，它在进行重新配置时不会丢失日志事件。

8、延申阅读：

Spring Boot 2.x 日志配置 与 指定 Logback 日志配置文件.

日志框架简述、slf4j 日志框架概述，slf4j + log4j 1.X 日志组合

































































































日志配置级别
TRACE DEBUG INFO WARN ERROR FATAL OFF
ALL YES YES YES YES YES YES NO
TRACE YES NO NO NO NO NO NO
DEBUG YES YES NO NO NO NO NO
INFO YES YES YES NO NO NO NO
WARN YES YES YES YES NO NO NO
ERROR YES YES YES YES YES NO NO
FATAL YES YES YES YES YES YES NO
OFF NO NO NO NO NO NO NO

Spring Boot 2.x 集成 SLF4j + log4j2 日志框架

1、spring-boot-starter-web 中的 spring-boot-starter-logging 日志启动器默认使用的 slf4j + logback ，而 Apache 的 log4j2 也是数一数二的日志框架，Spring boot 也对他进行了支持。

2、本文环境 spring-boot 2.3.5.RELEASE + JDK 1.8 + Log4j 2.13.3，先在 pom.xml 中排除掉默认的日志依赖，然后再引入 log4j 启动器。

  1. <!-- web 启动器-->
  2.         <dependency>
  3.             <groupId>org.springframework.boot</groupId>
  4.             <artifactId>spring-boot-starter-web</artifactId>
  5.             <exclusions>
  6.                 <!--移除掉 spring boot 默认的日志启动器-->
  7.                 <exclusion>
  8.                     <artifactId>spring-boot-starter-logging</artifactId>
  9.                     <groupId>org.springframework.boot</groupId>
  10.                 </exclusion>
  11.             </exclusions>
  12.         </dependency>
  14.         <!--引用 log4j2 spring boot 启动器，内部依赖了 slf4j、log4j-->
  15.         <dependency>
  16.             <groupId>org.springframework.boot</groupId>
  17.             <artifactId>spring-boot-starter-log4j2</artifactId>
  18.         </dependency>

3、官网参考链接，根据日志记录系统的不同，各自的配置文件文件也不同，在类路径下提供 log4j2 的配置文件 log4j2.xml，格式与 logback 的 logback.xml 基本差不多，示例如下：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!--日志级别从低到高优先级为：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF。-->
  3. <!--status：设置 log4j2 自身内部的信息输出，可以不设置-->
  4. <!--monitorInterval：监视配置文件变化间隔时间，单位秒，Log4j2 能够自动检测配置文件是否修改，同时更新配置-->
  5. <configuration status="WARN" monitorInterval="30">
  6.     <!--先定义所有的 appender 附加器-->
  7.     <appenders>
  8.         <!--控制台输出配置-->
  9.         <console name="Console" target="SYSTEM_OUT">
  10.             <!--输出日志的格式-->
  11.             <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - [%t] - %l - %m%n"/>
  12.         </console>
  14.         <!--文件存储文件设置-->
  15.         <!--fileName：文件存储路径及名称，可以是绝对路径或者相对路径; 存储的永远是最新的日志信息-->
  16.         <!--filePattern：当 fileName 指定的文件大小超过限制，就会根据此文件名规则新建存档目录与文件，同时将 fileName 文件中的
  17.          内容剪切到存档文件中，如下配置，会新建存档路径 logs/2021-06/info-2021-06-01-1.log -->
  18.         <RollingFile name="RollingFileInfo" fileName="logs/info.log"
  19.                      filePattern="logs/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log">
  20.             <!--日志文件中日志信息的格式-->
  21.             <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - [%t] - %l - %m%n"/>
  22.             <Policies>
  23.                 <TimeBasedTriggeringPolicy/>
  24.                 <!--日志文件大小超过多少时进行存档-->
  25.                 <SizeBasedTriggeringPolicy size="500 MB"/>
  26.             </Policies>
  27.         </RollingFile>
  28.     </appenders>
  29.     <!--然后定义logger，只有定义了logger并引入的appender，appender才会生效-->
  30.     <loggers>
  31.         <!--过滤掉 spring 和 mybatis 的一些无用的 DEBUG 信息;也可以单独指定自己的某个包-->
  32.         <logger name="org.springframework" level="INFO"></logger>
  33.         <logger name="org.mybatis" level="INFO"></logger>
  34.         <logger name="org.example.log4j2" level="INFO"></logger>
  36.         <!--root 与 logger 是父子关系，没有指定 logger 的，全部统一用 root 配置的日志级别处理.-->
  37.         <!--通常设置 debug、info、error 基本即可-->
  38.         <root level="ALL">
  39.             <appender-ref ref="Console"/>
  40.             <appender-ref ref="RollingFileInfo"/>
  41.         </root>
  42.     </loggers>
  43. </configuration>

如果只引入了 log4j2 依赖，没有提供 log4j2.xml 配置文件，则默认日志输出级别为 INFO，会打印在控制台，但是不会记录到文件中。

5、日志级别输出测试，Log4j2 也支持占位符：

  1. import org.apache.logging.log4j.LogManager;
  2. import org.apache.logging.log4j.Logger;
  3. /**
  4.  * 面向 log4j-api 原生接口编程
  5.  *
  6.  * @author wangMaoXiong
  7.  * @version 1.0
  8.  * @date 2021/6/9 16:50
  9.  */
  10. public class Example1 {
  11.     private static final Logger LOGGER = LogManager.getLogger();
  12.     public static void main(String... args) {
  13.         LOGGER.trace("hello, I am trace!");
  14.         LOGGER.debug("hello, I am debug!");
  15.         LOGGER.info("hello, I am info!");
  16.         LOGGER.warn("hello, I am {}!", "warn");
  17.         LOGGER.error("hello, I am {}!", "error");
  18.     }
  19. }

gif 演示动图：https://gitee.com/wangmx1993/my-document/blob/master/images/log4j2日志框架使用.gif

monitorInterval 定时读取配置信息

1、热加载配置文件是很有用的，比如服务上线之后，当需要输出详细日志信息排查问题时，可以降低优先级，比如 TRACE 、DEBUG，当完事之后，可以再调高优先级，比如 WARN、ERROR，减少日志记录，提供性能。

2、Log4j2 与 Logback 一样，可以在修改后自动重新加载其配置，与 Logback 不同的是，它在进行重新配置时不会丢失日志事件。

3、使用非常简单只需要在文件开始的 configuration 标签中指定 monitorInterval 属性即可，值大于 0 时会自动创建子线程进行定时扫描，更新配置；不配置或者值为0时，不会进行监控，运行中修改是无效的：

  1. <!--monitorInterval：监视配置文件变化间隔时间，单位秒，Log4j2 能够自动检测配置文件是否修改，同时更新配置-->
  2. <configuration status="WARN" monitorInterval="60">

4、如果是在本地 IDE 编辑器中测试，注意修改的是 classes 编译目录下的 log4j2.xml 文件，而不是 resources 目录的源文件。

20210814080308656.gif

5、对于可以手动修改配置文件的时候，此种方式还是很方便的，但是如果应用是打成 .jar、.war 包发布部署，则这种方式还是不太方便，因为仍然得从生产下载 jar、war 包，然后修改配置，重启服务。

LoggerConfig 动态修改日志记录器(推荐)

1、鉴于现在都是微服务开发，分布式部署，而且为了方便管理，基本都是打包后部署在一些平台上面。直接修改日志配置文件不太现实。

2、所以我们可以自己提供一个 Controller 请求接口，用于动态修改日志输出级别，想设置什么级别，只需要调用一下接口，传递一下参数即可，无论是设置整个 root 级别，还是对指定包或者类都能轻松设置，不用重启服务就能立马生效。

3、实现也是非常简单，在线演示源码如下：

https://gitee.com/wangmx1993/java-se/blob/master/src/main/resources/log4j2.xml

https://gitee.com/wangmx1993/java-se/blob/master/src/main/java/org/example/log4j2/Log4j2Controller.java

  1. /**
  2.      * Log4j2 动态修改 root(根)日志级别，修改之后配置立刻生效.
  3.      * http://localhost:8080/log4j/setRootLevel?level=TRACE
  4.      *
  5.      * @param level ：可选值有：ALL、TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF，否则默认会设置为 DEBUG，不区分大小写。
  6.      * @return
  7.      */
  8.     @GetMapping(value = "/log4j/setRootLevel")
  9.     public Map<String, Object> setRootLevel(@RequestParam(value = "level") String level) {
  10.         Map<String, Object> dataMap = new HashMap<>();
  11.         dataMap.put("code", 200);
  12.         dataMap.put("msg", "修改root日志级别成功");
  13.         try {
  14.             //LoggerContext getContext(final boolean currentContext)：获取 log4j 日志上下文，false 表示返回合适调用方的上下文
  15.             LoggerContext loggerContext = (LoggerContext) LogManager.getContext(false);
  17.             //返回当前配置，发生重新配置时，将替换该配置。
  18.             Configuration configuration = loggerContext.getConfiguration();
  19.             //查找记录器名称的相应 LoggerConfig
  20.             LoggerConfig loggerConfig = configuration.getLoggerConfig(LogManager.ROOT_LOGGER_NAME);
  22.             //设置日志级别
  23.             //如果 level 值不属于 ALL、TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF，则默认会设置为 DEBUG.
  24.             Level toLevel = Level.toLevel(level);
  25.             loggerConfig.setLevel(toLevel);
  27.             //根据当前配置更新所有记录器
  28.             loggerContext.updateLoggers();
  30.             //查询 root(根)日志输出级别结果返回
  31.             String root_logger_name = LogManager.getRootLogger().getLevel().name();
  32.             dataMap.put("data", root_logger_name);
  33.         } catch (Exception e) {
  34.             dataMap.put("code", 500);
  35.             dataMap.put("msg", e.getMessage());
  36.             e.printStackTrace();
  37.         }
  38.         return dataMap;
  39.     }

20210814111407365.gif

Spring boot Actuator 监控与切换日志

Spring boot Actuator 监控与管理日志

为什么将 Logger 对象声明为 private static final

1、private：是为了防止其他类使用当前类的日志对象.

2、static：是为了让每个类中的日志对象只生成一份，是属于类的，不是属于具体的实例的.

3、final：是为了避免日志对象在运行时被修改.

发表评论

表情：
评论列表 （有 0 条评论，297人围观）

还没有评论，来说两句吧...

相关阅读

    相关 Log4j-Log4j2-Slf4j不同点

    1 三者之间的不同之处 该博客只说明三者使用注意点，不过多阐述具体使用细节。 Log4j是基于Java开发的日志框架,其作者Ceki Gülcü将Log4j捐献给了Ap

    桃扇骨桃扇骨/ 0 赞/ 179 阅读