SpringBoot项目集成logback日志分等级配置

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: SpringBoot项目集成logback日志分等级配置

背景:

日志的作用:

boot项目集成logback:

一、单模块项目配置:

1、添加依赖

2、添加logback-spring.xml配置文件到resources目录下

3、接下来启动一下项目,就可以看到我们的日志已经区分等级打印了

二、多微服务项目集成logback共同一份配置:

1、将你的logback-spring.xml配置文件在nacos中创建出来

2、在项目的配置文件中添加logback文件读取的配置:

3、在logback-spring.xml配置文件中也需要修改一下

4、运行项目,可以看到运行了两个服务,log文件打出来也是按照各服务名称来区分目录的


背景:

在程序中写日志是一件非常重要,但是很容易被开发人员忽视的地方。写好程序的日志可以帮助我们大大减轻后期维护压力。在实际的工作中,开发人员往往迫于巨大时间压力,而写日志又是一个非常繁琐的事情,往往没有引起足够的重视。开发人员应在一开始就养成良好的日志撰写习惯,并且应在实际的开发工作中为写日志预留足够的时间。


日志的作用:

一般程序日志出自下面几个方面的需求:


记录用户操作的审计日志,甚至有的时候就是监管部门的要求。

快速定位问题的根源

追踪程序执行的过程。

追踪数据的变化

数据统计和性能分析

采集运行环境数据

一般在程序上线之后,一旦发生异常,第一件事就是要弄清楚当时发生了什么。用户当时做了什么操作,环境有无影响,数据有什么变化,是不是反复发生等,然后再进一步的确定大致是哪个方面的问题。确定是程序的问题之后再交由开发人员去重现、研究、提出解决方案。这时,日志就给我们提供了第一手的资料。


boot项目集成logback:

一、单模块项目配置:

1、添加依赖

<!--logback依赖-->
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-logging</artifactId>
</dependency>

2、添加logback-spring.xml配置文件到resources目录下

<?xml version="1.0" encoding="UTF-8"?>
<!--
scan:当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。
scanPeriod:设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒;当scan为true时,此属性生效。默认的时间间隔为1分钟。
debug:当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。
-->
<configuration scan="false" scanPeriod="10 seconds" debug="false">
  <contextName>logback</contextName>
  <property name="log.path" value="./logs/merit" />
  <!-- 彩色日志 -->
  <!-- 彩色日志依赖的渲染类 -->
  <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
  <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
  <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
  <!-- 彩色日志格式 -->
  <property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
  <!--1. 输出到控制台-->
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <!--此日志appender是为开发使用,只配置最底级别,控制台输出的日志级别是大于或等于此级别的日志信息-->
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>debug</level>
    </filter>
    <encoder>
      <Pattern>${CONSOLE_LOG_PATTERN}</Pattern>
      <!-- 设置字符集 -->
      <charset>UTF-8</charset>
    </encoder>
  </appender>
  <!--2. 输出到文档-->
  <!-- 2.1 level为 DEBUG 日志,时间滚动输出  -->
  <appender name="DEBUG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <!-- 正在记录的日志文档的路径及文档名 -->
    <file>${log.path}/debug/debug.log</file>
    <!--日志文档输出格式-->
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
      <charset>UTF-8</charset> <!-- 设置字符集 -->
    </encoder>
    <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <!-- 日志归档 -->
      <fileNamePattern>${log.path}/debug-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
      <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
        <maxFileSize>100MB</maxFileSize>
      </timeBasedFileNamingAndTriggeringPolicy>
      <!--日志文档保留天数-->
      <maxHistory>15</maxHistory>
    </rollingPolicy>
    <!-- 此日志文档只记录debug级别的 -->
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>debug</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>
  <!-- 2.2 level为 INFO 日志,时间滚动输出  -->
  <appender name="INFO_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <!-- 正在记录的日志文档的路径及文档名 -->
  <file>${log.path}/info/info.log</file>
  <!--日志文档输出格式-->
  <encoder>
  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  <charset>UTF-8</charset>
</encoder>
  <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  <!-- 每天日志归档路径以及格式 -->
  <fileNamePattern>${log.path}/info/info-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  <maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
  <!--日志文档保留天数-->
  <maxHistory>15</maxHistory>
</rollingPolicy>
  <!-- 此日志文档只记录info级别的 -->
  <filter class="ch.qos.logback.classic.filter.LevelFilter">
  <level>info</level>
  <onMatch>ACCEPT</onMatch>
  <onMismatch>DENY</onMismatch>
</filter>
</appender>
  <!-- 2.3 level为 WARN 日志,时间滚动输出  -->
  <appender name="WARN_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <!-- 正在记录的日志文档的路径及文档名 -->
  <file>${log.path}/warn/warn.log</file>
  <!--日志文档输出格式-->
  <encoder>
  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  <charset>UTF-8</charset> <!-- 此处设置字符集 -->
</encoder>
  <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  <fileNamePattern>${log.path}/warn/warn-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  <maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
  <!--日志文档保留天数-->
  <maxHistory>15</maxHistory>
</rollingPolicy>
  <!-- 此日志文档只记录warn级别的 -->
  <filter class="ch.qos.logback.classic.filter.LevelFilter">
  <level>warn</level>
  <onMatch>ACCEPT</onMatch>
  <onMismatch>DENY</onMismatch>
</filter>
</appender>
  <!-- 2.4 level为 ERROR 日志,时间滚动输出  -->
  <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <!-- 正在记录的日志文档的路径及文档名 -->
  <file>${log.path}/error/error.log</file>
  <!--日志文档输出格式-->
  <encoder>
  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  <charset>UTF-8</charset> <!-- 此处设置字符集 -->
</encoder>
  <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  <fileNamePattern>${log.path}/error/error-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  <maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
  <!--日志文档保留天数-->
  <maxHistory>15</maxHistory>
</rollingPolicy>
  <!-- 此日志文档只记录ERROR级别的 -->
  <filter class="ch.qos.logback.classic.filter.LevelFilter">
  <level>ERROR</level>
  <onMatch>ACCEPT</onMatch>
  <onMismatch>DENY</onMismatch>
</filter>
</appender>
  <!-- 4. 最终的策略 -->
  <!-- 4.1 开发环境:打印控制台-->
  <springProfile name="dev">
  <logger name="com.sdcm.pmp" level="debug"/>
</springProfile>
<root level="info">
  <appender-ref ref="CONSOLE"/>
  <appender-ref ref="DEBUG_FILE"/>
  <appender-ref ref="INFO_FILE"/>
  <appender-ref ref="WARN_FILE"/>
  <appender-ref ref="ERROR_FILE"/>
</root>
</configuration>

3、接下来启动一下项目,就可以看到我们的日志已经区分等级打印了;


38b691df1f0d5b50c73a41da96fe1fdb.png


二、多微服务项目集成logback共同一份配置:

如果项目是使用了微服务架构,将一个大项目拆分成多个模块之后,如果配置打日志区分等级的话,需要在每个模块的resources目录下添加一个这样的配置;这样太麻烦了,几个模块要求的打日志区分出来的等级以及保存策略是一样的,那么我们如何实现将logback-spring.xml文件复用呢?这里我使用的是nacos做的配置管理;

1、将你的logback-spring.xml配置文件在nacos中创建出来;


8c53403f41fcec1b49965e3b0e97decd.png


2、在项目的配置文件中添加logback文件读取的配置:


a7224ce270f1366f7953d978216f13c5.png


这里你在nacos上添加了logback的配置文件之后,上图中config的值最后读取出来实际就是logging-spring.xml的文件;


logging.config实际读取为:http://nacos服务所在的IP地址/nacos/v1/cs/config?group=文件所在的分组&tenant=文件所在的命名空间username=nacos服务的账号&password=nacos服务的账号&dataId=logback-spring.xml


3、在logback-spring.xml配置文件中也需要修改一下:

因为是将项目拆分成了多个模块,所以这里需要动态的获取一下每个服务的服务名;


logback-spring.xml的加载顺序早于springboot的application.yml (或application.properties) 配置文件所以在logback-spring.xml文件中使用<property>标签读不到application.yml(或application.properties)文件中的值。这里需要通过springProperty标签来引用:<springProperty name="APPLICATION_NAME" source="spring.application.name"/>

<?xml version="1.0" encoding="UTF-8"?>
<!--
scan:当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。
scanPeriod:设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒;当scan为true时,此属性生效。默认的时间间隔为1分钟。
debug:当此属性设置为true时,将打印出logback内部日志信息,实时查看logback运行状态。默认值为false。
-->
<configuration scan="false" scanPeriod="10 seconds" debug="false">
  <contextName>logback</contextName>
  <springProperty name="APPLICATION_NAME" source="spring.application.name"/>
  <property name="log.path" value="./logs/${APPLICATION_NAME}" />
  <!-- 彩色日志 -->
  <!-- 彩色日志依赖的渲染类 -->
  <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
  <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
  <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
  <!-- 彩色日志格式 -->
  <property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
  <!--1. 输出到控制台-->
  <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <!--此日志appender是为开发使用,只配置最底级别,控制台输出的日志级别是大于或等于此级别的日志信息-->
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>debug</level>
    </filter>
    <encoder>
      <Pattern>${CONSOLE_LOG_PATTERN}</Pattern>
      <!-- 设置字符集 -->
      <charset>UTF-8</charset>
    </encoder>
  </appender>
  <!--2. 输出到文档-->
  <!-- 2.1 level为 DEBUG 日志,时间滚动输出  -->
  <appender name="DEBUG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <!-- 正在记录的日志文档的路径及文档名 -->
    <file>${log.path}/debug/debug.log</file>
    <!--日志文档输出格式-->
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
      <charset>UTF-8</charset> <!-- 设置字符集 -->
    </encoder>
    <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
      <!-- 日志归档 -->
      <fileNamePattern>${log.path}/debug-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
      <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
        <maxFileSize>100MB</maxFileSize>
      </timeBasedFileNamingAndTriggeringPolicy>
      <!--日志文档保留天数-->
      <maxHistory>15</maxHistory>
    </rollingPolicy>
    <!-- 此日志文档只记录debug级别的 -->
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>debug</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>
  <!-- 2.2 level为 INFO 日志,时间滚动输出  -->
  <appender name="INFO_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <!-- 正在记录的日志文档的路径及文档名 -->
  <file>${log.path}/info/info.log</file>
  <!--日志文档输出格式-->
  <encoder>
  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  <charset>UTF-8</charset>
</encoder>
  <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  <!-- 每天日志归档路径以及格式 -->
  <fileNamePattern>${log.path}/info/info-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  <maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
  <!--日志文档保留天数-->
  <maxHistory>15</maxHistory>
</rollingPolicy>
  <!-- 此日志文档只记录info级别的 -->
  <filter class="ch.qos.logback.classic.filter.LevelFilter">
  <level>info</level>
  <onMatch>ACCEPT</onMatch>
  <onMismatch>DENY</onMismatch>
</filter>
</appender>
  <!-- 2.3 level为 WARN 日志,时间滚动输出  -->
  <appender name="WARN_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <!-- 正在记录的日志文档的路径及文档名 -->
  <file>${log.path}/warn/warn.log</file>
  <!--日志文档输出格式-->
  <encoder>
  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  <charset>UTF-8</charset> <!-- 此处设置字符集 -->
</encoder>
  <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  <fileNamePattern>${log.path}/warn/warn-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  <maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
  <!--日志文档保留天数-->
  <maxHistory>15</maxHistory>
</rollingPolicy>
  <!-- 此日志文档只记录warn级别的 -->
  <filter class="ch.qos.logback.classic.filter.LevelFilter">
  <level>warn</level>
  <onMatch>ACCEPT</onMatch>
  <onMismatch>DENY</onMismatch>
</filter>
</appender>
  <!-- 2.4 level为 ERROR 日志,时间滚动输出  -->
  <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
  <!-- 正在记录的日志文档的路径及文档名 -->
  <file>${log.path}/error/error.log</file>
  <!--日志文档输出格式-->
  <encoder>
  <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
  <charset>UTF-8</charset> <!-- 此处设置字符集 -->
</encoder>
  <!-- 日志记录器的滚动策略,按日期,按大小记录 -->
  <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
  <fileNamePattern>${log.path}/error/error-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
  <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
  <maxFileSize>100MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
  <!--日志文档保留天数-->
  <maxHistory>15</maxHistory>
</rollingPolicy>
  <!-- 此日志文档只记录ERROR级别的 -->
  <filter class="ch.qos.logback.classic.filter.LevelFilter">
  <level>ERROR</level>
  <onMatch>ACCEPT</onMatch>
  <onMismatch>DENY</onMismatch>
</filter>
</appender>
  <!-- 4. 最终的策略 -->
  <!-- 4.1 开发环境:打印控制台-->
  <springProfile name="dev">
  <logger name="com.sdcm.pmp" level="debug"/>
</springProfile>
  <root level="info">
  <appender-ref ref="CONSOLE"/>
  <appender-ref ref="DEBUG_FILE"/>
  <appender-ref ref="INFO_FILE"/>
  <appender-ref ref="WARN_FILE"/>
  <appender-ref ref="ERROR_FILE"/>
</root>
</configuration>

4、运行项目,可以看到运行了两个服务,log文件打出来也是按照各服务名称来区分目录的:


相关实践学习
【涂鸦即艺术】基于云应用开发平台CAP部署AI实时生图绘板
【涂鸦即艺术】基于云应用开发平台CAP部署AI实时生图绘板
目录
相关文章
|
1月前
|
监控 安全 程序员
Python日志模块配置:从print到logging的优雅升级指南
从 `print` 到 `logging` 是 Python 开发的必经之路。`print` 调试简单却难维护,日志混乱、无法分级、缺乏上下文;而 `logging` 支持级别控制、多输出、结构化记录,助力项目可维护性升级。本文详解痛点、优势、迁移方案与最佳实践,助你构建专业日志系统,让程序“有记忆”。
215 0
|
2月前
|
缓存 Java 应用服务中间件
Spring Boot配置优化:Tomcat+数据库+缓存+日志,全场景教程
本文详解Spring Boot十大核心配置优化技巧,涵盖Tomcat连接池、数据库连接池、Jackson时区、日志管理、缓存策略、异步线程池等关键配置,结合代码示例与通俗解释,助你轻松掌握高并发场景下的性能调优方法,适用于实际项目落地。
532 5
|
安全 BI 网络安全
EventLog Analyzer 如何满足等保合规要求?密码有效期、产品日志保留、配置备份三大核心问题全面解答
EventLog Analyzer(ELA)助力企业满足网络安全等级保护要求,支持配置自动/手动备份、日志180天留存及密码策略管理,提升合规性与安全运营效率。
|
4月前
|
JSON 分布式计算 大数据
springboot项目集成大数据第三方dolphinscheduler调度器
springboot项目集成大数据第三方dolphinscheduler调度器
275 3
|
4月前
|
Java 关系型数据库 数据库连接
Spring Boot项目集成MyBatis Plus操作PostgreSQL全解析
集成 Spring Boot、PostgreSQL 和 MyBatis Plus 的步骤与 MyBatis 类似,只不过在 MyBatis Plus 中提供了更多的便利功能,如自动生成 SQL、分页查询、Wrapper 查询等。
406 3
|
4月前
|
Java 测试技术 Spring
简单学Spring Boot | 博客项目的测试
本内容介绍了基于Spring Boot的博客项目测试实践,重点在于通过测试驱动开发(TDD)优化服务层代码,提升代码质量和功能可靠性。案例详细展示了如何为PostService类编写测试用例、运行测试并根据反馈优化功能代码,包括两次优化过程。通过TDD流程,确保每项功能经过严格验证,增强代码可维护性与系统稳定性。
234 0
|
4月前
|
存储 Java 数据库连接
简单学Spring Boot | 博客项目的三层架构重构
本案例通过采用三层架构(数据访问层、业务逻辑层、表现层)重构项目,解决了集中式开发导致的代码臃肿问题。各层职责清晰,结合依赖注入实现解耦,提升了系统的可维护性、可测试性和可扩展性,为后续接入真实数据库奠定基础。
410 0
|
Java Maven Docker
gitlab-ci 集成 k3s 部署spring boot 应用
gitlab-ci 集成 k3s 部署spring boot 应用
|
12月前
|
消息中间件 监控 Java
您是否已集成 Spring Boot 与 ActiveMQ?
您是否已集成 Spring Boot 与 ActiveMQ?
373 0
|
监控 druid Java
spring boot 集成配置阿里 Druid监控配置
spring boot 集成配置阿里 Druid监控配置
1131 6

热门文章

最新文章

下一篇
oss云网关配置