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;}
}