--- highlight: an-old-hope theme: channing-cyan --- # 前言 > 近日，项目上遇到个关于日志生成的特定要求：最初要求日志按日志级别进行生成相应文件，后来要求按业务、接口、服务代码生成对应的日志文件。 > 对于后者一下有点懵，从来没有这么玩过，因为需要动态从请求接口中获取服务代码，生成该服务代码对应的日志文件。 > 从网上查询了相关资料，都说使用`org.slf4j.MDC`变量，但是根据配置后，发现压根儿就不生效、不成功！于是采用了自定义Logger+ThreadLocal存储方案实现了该需求，但是总感觉代码不够优雅、不够灵活。 > 直到再次提了个需要：因为并发情况下日志混乱问题，要求每行日志中有相关接服务代码，方便区分、排查。这时候虽然目前方案可行，但是再次起了使用动态变量来实现的心思，因此查阅大量资料，终于成功实现，于是特此记录。 # 按照日志级别生成日志文件 > 创建一个Logback日志框架的配置文件，这个配置可以让应用程序的日志输出到控制台和按天生成的日志文件中,并根据日志级别分别记录到不同的文件中。这样可以更好地管理和分析应用程序的日志信息。主要包含以下功能: 1.定义日志文件的存储地址LOG_PATH 2.配置控制台输出CONSOLE，输出格式为%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n 3.配置按天生成日志文件APP，文件名格式为 ${LOG_PATH}/%d{yyyy-MM-dd}/app.%i.log，最大文件大小为 100MB，保存30天 4.配置按日志级别分别记录到不同文件: ERROR_FILE: 记录错误级别的日志 WARN_FILE: 记录警告级别的日志 INFO_FILE: 记录信息级别的日志 DEBUG_FILE: 记录调试级别的日志 5.配置根Logger的日志级别为 INFO，并引用上述的所有Appender ## 配置logback.xml 创建日志配置文件：logback.xml ```bash %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n ${LOG_PATH}/%d{yyyy-MM-dd}/app.%i.log 30 100MB %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n ${LOG_PATH}/%d{yyyy-MM-dd}/error.%i.log 30 100MB %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n ERROR ${LOG_PATH}/%d{yyyy-MM-dd}/warn.%i.log 30 100MB %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n WARN ${LOG_PATH}/%d{yyyy-MM-dd}/info.%i.log 30 100MB %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n INFO ${LOG_PATH}/%d{yyyy-MM-dd}/debug.%i.log 30 100MB %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n DEBUG

``` ## 配置application.yaml 配置项目使用指定的日志配置文件 ```bash logging: config: classpath:logback.xml ``` ## 输出启动项目进行测试，如期生成相关日志文件 ![在这里插入图片描述](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/f58f090238314b5b8c2c82709a0fa5a0~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ29kZURldk1hc3Rlcg==:q75.awebp?rk3s=f64ab15b&x-expires=1767132883&x-signature=fefioVmFNg4t6t7q5VjTeMfW3K0%3D) # 使用动态变量 > 使用MDC(Mapped Diagnostic Context) 可以为每个线程关联一些上下文信息,在日志输出时可以包含这些信息,从而区分不同线程的日志输出。 ## 设置MDC变量只需要通过`MDC.put()`进行变量设置，然后就可以将该变量传递给Logback日志框架，当不需要的时候再通过`MDC.remove()`进行删除 ```bash import org.slf4j.MDC; @RequestMapping(value = "/test") public String index() { MDC.put("requestId", System.currentTimeMillis()+""); log.info("---------------------- hello ----------------------"); // 业务逻辑 MDC.remove("requestId"); return "OK"; } ``` ## 使用MDC变量 > 在logback.xml中，通过`%X{requestId}`形式的配置即可动态获取设置的MDC变量。在日志输出格式中使用动态变量 ```bash %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] -%X{requestId}- %-5level %logger{36} - %msg%n ``` ## 输出使用压测工具进行大批量的发送请求测试，可如期得到预计结果。 ![image.png](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/558904b6f4154b9ab2451d4c9969b465~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ29kZURldk1hc3Rlcg==:q75.awebp?rk3s=f64ab15b&x-expires=1767132883&x-signature=4LDeHz0WJlYQZBrYN71x5Sblzw8%3D) # 自定义Logger >通过自定义Logger对象，在相关业务、接口中使用该日志对象，即可实现按业务、接口生成对应日志文件。但是此种方式需要定义大量相关Logger对象，非常不够优雅。 ## 配置logback.xml >配置定义了一个名为 "ONEAPI" 的Appender，再将称为 "ONEAPI"的 Appender 与称为 "apiLog"的 Logger关联起来，将日志输出到 "ONEAPI" 关联的Appender定义文件中。在特定的模块、包、类中使用这个指定的自定义Logger ```bash ${LOG_PATH}/%d{yyyy-MM-dd}/apiLog.%i.log 30 100MB %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n

``` 也可以直接指定包、类使用的Logger，在包中、类中使用Logger将自动关联这个自定义Logger ```bash

``` ## 使用指定Logger ```bash @RequestMapping(value = "/test") public String index() { Logger apiLog = LoggerFactory.getLogger("apiLog"); apiLog.info("---------------------- apiLog ----------------------"); return "OK"; } ``` ## 输出经过测试也会如期得到期望的结果。 ![在这里插入图片描述](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/811faf20e086409bba859ba2c09106f5~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ29kZURldk1hc3Rlcg==:q75.awebp?rk3s=f64ab15b&x-expires=1767132883&x-signature=1FR%2BEm331u%2FKFrYvEyUfe5mF2K4%3D) # 根据业务、接口划分日志文件 >基于自定义Logger+TreadLocal方案实现后，由于需求、代码不优雅等原因，还是想找其他方法，在查询大量相关资料后，终于使用上述的MDC动态变量相关东西实现根据业务、接口划分日志文件。 ## 配置logback.xml > 如果要根据业务、接口划分日志文件，这里无疑要使用到上述的MDC动态变量相关东西。配置分析：当requestId这个MDC变量不存在时,就会使用other作为默认值。这可以确保每个请求都有独立的日志文件。在appender的文件名中使用 ${requestId}，这样可以根据requestId这个MDC变量的值,动态生成对应的日志文件名。在rollingPolicy中配置按日期滚动，可以实现按天滚动日志文件,避免单个日志文件过大。在encoder的pattern中使用%X{requestId}，可以在日志输出中包含 requestId 这个 MDC 变量的值,方便追踪和定位问题。 ```bash requestId other ${LOG_PATH}/%d{yyyy-MM-dd}/${requestId}.log %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] -%X{requestId}- %-5level %logger{36} - %msg%n ``` ## 设置MDC变量通过`MDC.put()`进行变量设置，然后就可以将该变量传递给Logback日志框架，当不需要的时候再通过`MDC.remove()`进行删除 ```bash @RequestMapping(value = "/test") public String index() { MDC.put("requestId", System.currentTimeMillis()+""); log.info("---------------------- HelloControler ----------------------"); MDC.remove("requestId"); return "OK"; } ``` ## 输出同样经过测试得出预期结果。 ![在这里插入图片描述](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/fc588845a8034654b7ddefee291156dc~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ29kZURldk1hc3Rlcg==:q75.awebp?rk3s=f64ab15b&x-expires=1767132883&x-signature=%2F7Qf8cgHK1TmTcz7DOAqERDZU94%3D) ## 按日期滚动、按大小分割这里模拟测试一个称为`000001`服务接口，指定文件大小1MB，进行循环请求生成日志 ```bash requestId other ${LOG_PATH}/%d{yyyy-MM-dd}/${requestId}-%i.log 1MB 30 3GB %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] -%X{requestId}- %-5level %logger{36} - %msg%n ``` 同样如期得出正确结果： ![在这里插入图片描述](https://p9-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/2f5b558348d64107985f549c510202a1~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAgQ29kZURldk1hc3Rlcg==:q75.awebp?rk3s=f64ab15b&x-expires=1767132883&x-signature=a%2FpVUoHbQPw8%2B4wlAGqoY18vJYo%3D)