SpringBoot2应用中基于API接口路径的Log4j2动态日志记录
本文介绍如何在SpringBoot2应用中利用Log4j2实现动态日志记录,并根据API接口路径将日志保存到指定文件。这不同于简单的RollingFileAppender,需要一种机制根据运行时请求动态创建日志文件。
用户需求:根据API接口地址(例如/paypage/createorder/addsave和/merchant/goodlist/getlistbyquery?currentpage=1&size=10)将日志分别保存到JAR包目录下的/logs/paypage/createorder/addsave/yyyy-mm-dd.log和/logs/merchant/goodlist/getlistbyquery/yyyy-mm-dd.log文件中。用户尝试在main函数和拦截器中动态设置Log4j2配置文件文件名,但由于RollingFileAppender在初始化时就确定了文件名,因此未能成功。
解决方案:使用Log4j2的RoutingAppender。RoutingAppender允许根据运行时条件将日志消息路由到不同的Appender。结合ThreadContext,我们可以将API路径作为路由键,动态生成日志文件。
实现步骤:
-
配置RoutingAppender: 在log4j-spring.xml中配置RoutingAppender,并使用
元素定义路由规则。一个重要的规则应使用 元素且不设置key属性,匹配所有未被其他规则匹配的请求,并根据ThreadContext中的路由键动态生成文件名。配置示例:
<configuration monitorInterval="5" status="debug"> <appenders> <routing name="routing"> <routes pattern="${ctx:routingkey}"> <route> <rollingFile filename="./logs/${ctx:routingkey}/${date:yyyy-mm-dd}.log" filePattern="./logs/${date:yyyy-mm}/${ctx:routingkey}-%d{yyyy-mm-dd}-%i.log.gz" name="rolling-${ctx:routingkey}"> <PatternLayout pattern="%d{iso8601} [%t] %p %c{3} - %m%n"/> <Policies> <TimeBasedTriggeringPolicy interval="1" modulate="true"/> <SizeBasedTriggeringPolicy size="10MB"/> </Policies> </rollingFile> </route> </routes> </routing> </appenders> <loggers> <root level="info"> <appender-ref ref="routing"/> </root> </loggers> </configuration>
- 拦截器设置路由键: 创建一个拦截器,在preHandle方法中获取API路径,并将其设置为ThreadContext中名为routingkey的键值。在postHandle中移除该键,避免干扰其他请求。代码示例:
public class Log4j2Interceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String apiPath = request.getRequestURI(); ThreadContext.put("routingkey", apiPath); return true; } @Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception { ThreadContext.remove("routingkey"); } }
- 注册拦截器: 在Spring配置类中注册该拦截器,使其拦截所有请求。
通过以上步骤,即可实现根据API接口路径动态创建日志文件,并将日志保存到对应路径。 请确保/logs目录已创建,且应用具有写入权限。 日志文件路径中避免特殊字符,以免出错。