0
0

springboot系列四：集成log4j2

常见的日志框架

常见的日志框架有log4j、logback和log4j2。三者作者都是Ceki Gülcü。slf4j是The Simple Logging Facade for Java的简称，是log4j、logback和log4j2的统一开发接口封装，作为日志门面，很大程度上提高了易用性和可维护性。最早为log4j（Log for Java），再后来基于log4j开发出一套统一的接口slf4j。并在log4j和slf4j的基础上开发了logback，在性能上也做了优化。log4j2虽然与log4j有很大的相似性，但是log4j2有极大地提升了性能，并有更高的并发性，并支持异步log。
所以，无论在性能上还是并发性上，log4j2都是目前最优的日志框架。

pom依赖

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

springboot默认使用的日志框架为logback，要想使用log4j2，需要从spring-boot-starter-web中排除对spring-boot-starter-logging依赖。

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><exclusions><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-logging</artifactId></exclusion></exclusions></dependency>

然后，再引入log4j2的依赖，内部依赖了slf4j、log4j。

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

log4j2配置

<?xml version="1.0" encoding="UTF-8"?><!--日志级别从低到高优先级为：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF。--><!--status：设置 log4j2 自身内部的信息输出，可以不设置--><!--monitorInterval：监视配置文件变化间隔时间，单位秒，Log4j2 能够自动检测配置文件是否修改，同时更新配置--><configurationmonitorInterval="30"><!--定义属性，在下方方便维护引用--><properties><!--当天文件保存目录--><propertyname="logDir">./logs</property><!--历史文件保存目录--><propertyname="historyLogDir">./logs/history</property><!--如果当天日志文件大于100MB，则存档--><propertyname="splitSize">100MB</property><!--文件保存个数，这里的30说明可保留30个，即30天--><propertyname="fileCount">30</property><!--输出格式--><propertyname="logPattern">%d{yyyy-MM-dd HH:mm:ss.SSS} => [%thread] => %-5level %logger{50}:(%line) - %msg%n</property></properties><!--先定义所有的 appender 附加器--><appenders><!--控制台输出配置--><consolename="Console"target="SYSTEM_OUT"><filters><ThresholdFilterlevel="INFO"onMatch="ACCEPT"onMismatch="DENY"/></filters><!--输出日志的格式
                %d表示日期时间，
                %thread表示线程名，
                %-5level：级别从左显示5个字符宽度
                %logger{50} 表示logger名字最长50个字符，否则按照句点分割。
                %line：表示行号
                %msg：日志消息
                %n是换行符--><PatternLayoutpattern="${logPattern}"/></console><!--文件存储文件设置--><!--fileName：文件存储路径及名称，可以是绝对路径或者相对路径; 存储的永远是最新的日志信息--><!--filePattern：当 fileName 指定的文件大小超过限制，就会根据此文件名规则新建存档目录与文件，同时将 fileName 文件中的
         内容剪切到存档文件中，如下配置，会新建存档路径 logs/history/error-2023-03-26-1.log --><!--以下只保存debug信息--><RollingFilename="fileDebug"fileName="${logDir}/debug.log"filePattern="${historyLogDir}/debug-%d{yyyy-MM-dd}-%i.log"><filters><ThresholdFilterlevel="INFO"onMatch="DENY"onMismatch="NEUTRAL"/><ThresholdFilterlevel="DEBUG"onMatch="ACCEPT"onMismatch="DENY"/></filters><PatternLayoutpattern="${logPattern}"/><Policies><TimeBasedTriggeringPolicy/><!--日志文件大小超过多少时进行存档--><SizeBasedTriggeringPolicysize="${splitSize}"/></Policies><DefaultRolloverStrategymax="${fileCount}"/></RollingFile><!--以下只保存info信息--><RollingFilename="fileInfo"fileName="${logDir}/info.log"filePattern="${historyLogDir}/info-%d{yyyy-MM-dd}-%i.log"><filters><ThresholdFilterlevel="WARN"onMatch="DENY"onMismatch="NEUTRAL"/><ThresholdFilterlevel="INFO"onMatch="ACCEPT"onMismatch="DENY"/></filters><PatternLayoutpattern="${logPattern}"/><Policies><TimeBasedTriggeringPolicy/><SizeBasedTriggeringPolicysize="${splitSize}"/></Policies><DefaultRolloverStrategymax="${fileCount}"/></RollingFile><!--以下只保存warn信息--><RollingFilename="fileWarn"fileName="${logDir}/warn.log"filePattern="${historyLogDir}/warn-%d{yyyy-MM-dd}-%i.log"><filters><ThresholdFilterlevel="ERROR"onMatch="DENY"onMismatch="NEUTRAL"/><ThresholdFilterlevel="WARN"onMatch="ACCEPT"onMismatch="DENY"/></filters><PatternLayoutpattern="${logPattern}"/><Policies><TimeBasedTriggeringPolicy/><SizeBasedTriggeringPolicysize="${splitSize}"/></Policies><DefaultRolloverStrategymax="${fileCount}"/></RollingFile><!--以下只保存error信息--><RollingFilename="fileError"fileName="${logDir}/error.log"filePattern="${historyLogDir}/error-%d{yyyy-MM-dd}-%i.log"><filters><ThresholdFilterlevel="ERROR"onMatch="ACCEPT"onMismatch="DENY"/></filters><PatternLayoutpattern="${logPattern}"/><Policies><TimeBasedTriggeringPolicy/><SizeBasedTriggeringPolicysize="${splitSize}"/></Policies><DefaultRolloverStrategymax="${fileCount}"/></RollingFile><!--以下保存api请求信息--><RollingFilename="apiInfo"fileName="${logDir}/api.log"filePattern="${historyLogDir}/api-%d{yyyy-MM-dd}-%i.log"><filters><ThresholdFilterlevel="INFO"onMatch="ACCEPT"onMismatch="DENY"/></filters><PatternLayoutpattern="${logPattern}"/><Policies><TimeBasedTriggeringPolicy/><SizeBasedTriggeringPolicysize="${splitSize}"/></Policies><DefaultRolloverStrategymax="${fileCount}"/></RollingFile><!-- 整合elk --><Socketname="logstash"host="127.0.0.1"port="4560"protocol="TCP"><PatternLayoutpattern="${logPattern}"/></Socket></appenders><!--
    1、root与logger是父子关系，没有特别定义logger的都默认为root。
    2、任何一个类只会和一个logger对应，要么是定义的logger，要么是root，判断的关键在于找到这个logger，然后判断这个logger的appender和level。
    3、appender-ref 用于引用上面定义好的 appender 日志追加器，只有引用了，上面的 appender 才能生效. --><loggers><!--过滤掉 spring 和 mybatis 的一些无用的 DEBUG 信息;也可以单独指定自己的某个包--><!--以下包中ERROR级别以上日志在root中将被记录--><loggername="org.springframework"level="ERROR"></logger><loggername="org.mybatis"level="ERROR"></logger><loggername="org.hibernate"level="ERROR"></logger><loggername="org.apache"level="ERROR"></logger><loggername="com.baomidou"level="ERROR"></logger><loggername="com.zaxxer"level="ERROR"></logger><loggername="springfox.documentation"level="ERROR"></logger><!--com.yyl.system包中的DEBUG以上信息在以下的appender中输出，additivity所有日志还要向控制台和allLog中输出--><loggername="com.yyl.system"level="DEBUG"additivity="true"><appender-refref="fileDebug"/><appender-refref="fileInfo"/><appender-refref="fileWarn"/><appender-refref="fileError"/><appender-refref="apiInfo"/><appender-refref="logstash"/></logger><rootlevel="INFO"><appender-refref="Console"/></root></loggers></configuration>

log4j2配置文件详解

要想使log4j2配置生效，需要在resources目录下新建log4j2.xml，springboot会自动找到配置文件，并加载。

日志级别

log4j2共分8个日志级别，按从低到高排列为：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF：

  • ALL：最低等级日志级别，输出所有日志；
  • TRACE：追踪日志，如程序启动进程日志；
  • DEBUG：程序调试信息；
  • INFO：应用程序提示信息；
  • WARN：告警信息；
  • ERROR：程序报错信息；
  • FATAL：程序出错，导致应用程序退出；
  • OFF：关闭日志； 设置应用程序的日志级别后，将输出该级别及以上的日志。如，设置日志级别为INFO，那么程序会输出INFO、WARN、ERROR及FATAL日志。

monitorInterval

监视配置文件变化间隔时间。如设置为30，表示每隔30s，程序会自动检测配置文件是否修改，如果修改，就更新配置文件。

properties

定义属性，方便在配置文件中引用。我们在这配置了logDir、historyLogDir、splitSize、fileCount及logPattern属性。

  • logDir：日志输出目录；
  • historyLogDir：日志输出历史目录；
  • splitSize：日志存档临界值，如果当天日志大于临界值，则存档，在这配置为100M；
  • fileCount：存档文件个数。在这里配置为30，相当于保留最近30天的日志记录；
  • logPattern：日志输出格式；

appenders

定义一系列的日志输出，可输出至控制台或者文件中。主要有三种日志输出方式：

  • Console：定义输出至控制台的方式；
  • File：定义输出至文件的方式；
  • RollingFile：定义输出至文件的方式，但会以一定的策略删除旧日志文件，并创建新的日志文件； 三种方式有共同的子节点。

filters

定义日志输出等级。
如果想输出某个等级及其以上的日志，可做如下配置：

<filters><ThresholdFilterlevel="INFO"onMatch="ACCEPT"onMismatch="DENY"/></filters>

以上配置过滤INFO级别及其以上的日志。
如果想单独输出某个等级的日志，可做如下配置：

<filters><ThresholdFilterlevel="INFO"onMatch="DENY"onMismatch="NEUTRAL"/><ThresholdFilterlevel="DEBUG"onMatch="ACCEPT"onMismatch="DENY"/></filters>

以上配置只过滤DEBUG日志，INFO及其以上等级的日志将被拒绝。

Console日志输出

定义日志输出至控制台。主要属性有name、target、filters和PatternLayout。

  • name：自己定义；
  • target：一般配置为SYSTEM_OUT，即将日志通过System.out输出；
  • filters：定义日志输出等级，这里配置等级为INFO，即INFO及以上等级的日志输出到控制台；
  • PatternLayout：定义日志输出格式；

File日志输出

定义日志输出至文件。示例配置如下：

<Filename="fileLog"fileName="${logDir}/file.log"append="true"><filters><ThresholdFilterlevel="DEBUG"onMatch="ACCEPT"onMismatch="DENY"/></filters><PatternLayoutpattern="${logPattern}"/></File>

主要属性和子节点有name、fileName、append、filters和PatternLayout。

  • fileName：定义输出文件名；
  • append：当为true时，新增日志将被追加至文件末尾；如果为false，那么新日志将覆盖旧日志；

RollingFile日志输出

也是定义日志输出至文件，不同的是RollingFile可以定义日志文件存档策略。比如按照时间存档，每天备份一次，最大存档30天等等。

<RollingFilename="fileDebug"fileName="${logDir}/debug.log"filePattern="${historyLogDir}/debug-%d{yyyy-MM-dd}-%i.log"><filters><ThresholdFilterlevel="INFO"onMatch="DENY"onMismatch="NEUTRAL"/><ThresholdFilterlevel="DEBUG"onMatch="ACCEPT"onMismatch="DENY"/></filters><PatternLayoutpattern="${logPattern}"/><Policies><TimeBasedTriggeringPolicy/><!--日志文件大小超过多少时进行存档--><SizeBasedTriggeringPolicysize="${splitSize}"/></Policies><DefaultRolloverStrategymax="${fileCount}"/></RollingFile>

主要属性和子节点有name、fileName、filePattern、filters、PatternLayout、Policies、TimeBasedTriggeringPolicy、SizeBasedTriggeringPolicy和DefaultRolloverStrategy。

  • fileName：定义现在日志输出文件名；
  • filePattern：定义历史日志文件名格式；
  • filters：以上只输出debug日志；
  • Policies：定义日志输出策略；
  • TimeBasedTriggeringPolicy：指定多长时间触发日志备份策略，这里默认为一天。还可以设置interval和modulate属性；
  • SizeBasedTriggeringPolicy：指定日志文件多大时触发日志备份策略，这里设置为100MB。即如果当天日志一次超过100MB，备份为debug-2023-05-02-1.log。如果再次超过100MB，则备份为debug-2023-05-02-2.log；
  • DefaultRolloverStrategy：设置日志文档存档个数，max指定能保存的文件个数。超过后，之前的文件将被删除；

Socket日志输出

定义日志输出至数据库或者其它日志管理系统，如elk等。

<Socketname="logstash"host="127.0.0.1"port="4560"protocol="TCP"><PatternLayoutpattern="${logPattern}"/></Socket>

以上定义日志输出至127.0.0.1:4560服务器，也就是我本地创建的elk日志管理系统。elk的搭建将在下一章讲解。

loggers

所有在appenders里定义的appender都需要在logger下引用，否则appender的配置就不会生效。
如果要过滤掉一些debug信息，可以在logger中屏蔽掉，如下屏蔽掉org.springframework中error级别以下的日志：

<loggername="org.springframework"level="ERROR"></logger>

设置项目中的日志输出至指定的文件，并且不再在控制台中输出，配置如下：

<loggername="com.yyl.system"level="DEBUG"additivity="true"><appender-refref="fileDebug"/><appender-refref="fileInfo"/><appender-refref="fileWarn"/><appender-refref="fileError"/><appender-refref="apiInfo"/><appender-refref="logstash"/></logger>

root节点为兜底操作，所有在appenders中配置的，但没有在其它logger中输出的，都会在root的logger中输出。

标签： spring boot java log4j2
本文转载自: https://blog.csdn.net/y2010081134/article/details/129719657
版权归原作者 码上飞跃 所有， 如有侵权，请联系我们删除。
登录后发布评论

“springboot系列四：集成log4j2”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

机器人技术在安全领域的重要作用

安全学习记录——网络篇（一）

图腾柱PFC：HP1010为您的电动两轮车之旅提供绿色，高效，安全的动力

单元测试数据库回滚问题

这才是单元测试，之前我们都错了

【C语言基础】：字符函数和字符串函数

ChatGPT-Next-Web SSRF漏洞+XSS漏洞复现(CVE-2023-49785)

文章导航