log4j2启动异步日志与动态修改日志级别

启动异步日志

启用 Log4j2 的异步日志记录功能可以显著提升日志记录的性能，尤其是在高并发的环境下。异步日志记录通过将日志事件放入队列中进行处理，从而减少了日志记录对应用程序性能的影响。以下是如何启用 Log4j2 异步日志记录的详细步骤。

1. 添加依赖

如果你使用的是 Maven，首先需要确保你的 pom.xml 文件中包含 Log4j2 的依赖：

<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-core</artifactId>
  <version>2.x.x</version>
</dependency>
<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-api</artifactId>
  <version>2.x.x</version>
</dependency>
<dependency>
  <groupId>com.lmax</groupId>
  <artifactId>disruptor</artifactId>
  <version>3.4.2</version>
</dependency>

2. 配置 Log4j2

Log4j2 支持两种方式启用异步日志记录：

• 异步日志记录器（Asynchronous Loggers）
• 异步追加器（Asynchronous Appenders）

异步日志记录器（Asynchronous Loggers）

异步日志记录器是全局性的，所有日志记录器都将异步地处理日志事件。以下是 log4j2.xml 的示例配置：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" packages="">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n" />
    </Console>
  </Appenders>
  <Loggers>
    <Root level="info" includeLocation="false">
      <AppenderRef ref="Console" />
    </Root>
  </Loggers>
</Configuration>

然后，在 Java 运行参数中添加以下系统属性来启用全局异步日志记录器：

-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector

异步追加器（Asynchronous Appenders）

异步追加器是局部性的，只将指定的追加器配置为异步。以下是 log4j2.xml 的示例配置：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" packages="">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n" />
    </Console>
    <Async name="AsyncConsole">
      <AppenderRef ref="Console" />
    </Async>
  </Appenders>
  <Loggers>
    <Root level="info" includeLocation="false">
      <AppenderRef ref="AsyncConsole" />
    </Root>
  </Loggers>
</Configuration>

3. 测试异步日志

创建一个简单的 Java 应用程序来测试异步日志记录：

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class AsyncLoggerExample {

    private static final Logger logger = LogManager.getLogger(AsyncLoggerExample.class);

    public static void main(String[] args) {
        for (int i = 0; i < 1000; i++) {
            logger.info("This is an async log message {}", i);
        }
    }
}

4. 启动应用

确保在启动应用时设置了正确的系统属性（如果使用异步日志记录器）：

java -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector -jar your-app.jar

总结

• 使用异步日志记录器可以全局地处理日志事件，使所有日志记录器异步地处理日志。
• 使用异步追加器可以局部地将特定的追加器配置为异步。
• 通过将日志事件放入队列中处理，异步日志记录可以显著提升应用程序的性能，特别是在高并发环境中。

选择合适的方式来启用异步日志记录，并根据需要调整配置文件，以获得最佳性能和日志记录效果。

动态修改日志级别

在 Spring Boot 应用中，动态修改日志级别是一个常见需求，可以用于在运行时调整日志输出，以便进行调试或监控。Spring Boot 提供了一些方便的方式来实现这一点，包括通过 Spring Boot Actuator 和程序内配置修改。
以下是详细的实现方法：

方法 1: 使用 Spring Boot Actuator

Spring Boot Actuator 提供了对应用程序的管理端点，其中包括修改日志级别的功能。

1. 添加依赖

在你的 pom.xml 中添加 Actuator 依赖：

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

2. 配置 Actuator 端点

在 application.properties 或 application.yml 文件中启用必要的端点：

management.endpoints.web.exposure.include=*

或者

management:
  endpoints:
    web:
      exposure:
        include: "*"

3. 修改日志级别

启动应用后，可以使用以下 HTTP 请求来修改日志级别：

• 获取当前日志级别：

curl -s -X GET http://localhost:8080/actuator/loggers/{logger.name}

例如：

curl -s -X GET http://localhost:8080/actuator/loggers/com.example.MyClass

• 修改日志级别：

curl -s -X POST http://localhost:8080/actuator/loggers/{logger.name} -H 'Content-Type: application/json' -d '{"configuredLevel":"DEBUG"}'

例如：

curl -s -X POST http://localhost:8080/actuator/loggers/com.example.MyClass -H 'Content-Type: application/json' -d '{"configuredLevel":"DEBUG"}'

方法 2: 通过程序内代码动态修改日志级别

你可以通过编程方式在应用运行时修改日志级别。

1. 使用 Logback 的 API

如果你使用的是 Logback 作为日志框架：

import org.slf4j.LoggerFactory;
import ch.qos.logback.classic.Level;
import ch.qos.logback.classic.LoggerContext;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/loglevel")
public class LogLevelController {

    @PostMapping("/{loggerName}/{level}")
    public String changeLogLevel(@PathVariable String loggerName, @PathVariable String level) {
        LoggerContext loggerContext = (LoggerContext) LoggerFactory.getILoggerFactory();
        ch.qos.logback.classic.Logger logger = loggerContext.getLogger(loggerName);
        logger.setLevel(Level.toLevel(level));
        return "Log level for " + loggerName + " changed to " + level;
    }
}

2. 使用 Log4j2 的 API

如果你使用的是 Log4j2 作为日志框架：

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.config.Configurator;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/loglevel")
public class LogLevelController {

    @PostMapping("/{loggerName}/{level}")
    public String changeLogLevel(@PathVariable String loggerName, @PathVariable String level) {
        org.apache.logging.log4j.Logger logger = LogManager.getLogger(loggerName);
        Configurator.setLevel(loggerName, org.apache.logging.log4j.Level.toLevel(level));
        return "Log level for " + loggerName + " changed to " + level;
    }
}

方法 3: 配置文件示例

确保在 application.properties 或 application.yml 中配置日志框架：

logging.level.com.example=INFO

或者

logging:
  level:
    com.example: INFO

测试动态修改日志级别

1. 启动你的 Spring Boot 应用。
2. 使用上述方法修改日志级别。
3. 观察日志输出，确认日志级别已动态更新。

总结

通过以上方法，你可以在 Spring Boot 应用中动态修改日志级别，无论是通过 Actuator 提供的 HTTP 接口还是通过程序内的代码修改。这些方法使你可以灵活地调整日志级别，以满足不同场景下的调试和监控需求。