制作企业网站页面多少钱,wordpress js 调用图片,网站支付页面设计,重庆做网站建设哪家好SpringBoot集成Logback日志 文章目录 SpringBoot集成Logback日志一、什么是日志二、Logback简单介绍三、SpringBoot项目中使用Logback四、概念介绍一、日志记录器Logger1.1、日志记录器对象生成1.2、记录器的层级结构1.3、过滤器1.4、logger设置日志级别1.5、java代码演示1.6、…SpringBoot集成Logback日志 文章目录 SpringBoot集成Logback日志一、什么是日志二、Logback简单介绍三、SpringBoot项目中使用Logback四、概念介绍一、日志记录器Logger1.1、日志记录器对象生成1.2、记录器的层级结构1.3、过滤器1.4、logger设置日志级别1.5、java代码演示1.6、使用配置文件演示 二、附加器2.1、什么是附加器2.2、附加器使用方式2.3、输出格式2.4、记录器的可加性问题产生解决方法 五、SpringBoot中使用Logback日志5.1、日志文件命名和位置5.2、logback.xml中使用环境变量信息 六、日志记录中的一些坑6.1、情景一6.2、情景二6.3、情景三6.4、情景四6.5、情景五日志无法删除情况 七、SpringBoot中切换日志八、阿里巴巴日志规约 一、什么是日志
日志的作用是用来追踪和记录我们的程序运行中的信息我们可以利用日志很快定位问题追踪分析。
如果没有日志程序一旦出现问题很难一下子就能定位问题。尤其是访问第三方接口、随机或偶尔出现的问题、很难再现的问题。
之前听说过一句话“只有在程序出问题以后才会知道打一个好的日志有多么重要。”
二、Logback简单介绍
目前比较常用的Java日志框架 Logback、log4j、log4j2、JUL等等。
Logback是在log4j 的基础上重新开发的一套日志框架是完全实现SLF4J接口API(也叫日志门面)。
Logback 的架构非常通用可以应用于不同的环境。目前logback分为三个模块logback-core、logback-classic和logback-access。logback-core 模块为其他两个模块奠定了基础。logback-classic模块原生实现了SLF4J API因此您可以轻松地在 logback 和其他日志记录框架例如 log4j 1.x 或 java.util.logging (JUL)之间来回切换。
logback-access 模块与 Tomcat 和 Jetty 等 Servlet 容器集成以提供 HTTP 访问日志功能。请注意您可以轻松地在 logback-core 之上构建自己的模块。
三、SpringBoot项目中使用Logback
logback是springboot-web自带的无需引入外部依赖即可使用。可以来看下对应的依赖 四、概念介绍
一、日志记录器Logger
日志记录器(Logger)控制要输出哪些日志记录语句对日志信息进行级别限制。
1.1、日志记录器对象生成
如何生成记录器 final static Logger logger LoggerFactory.getLogger(“名称”);这里有两个点需要说明的是
1、日志记录器是单例的。也就是说第一次发现是没有的那么创建第二次直接拿到日志记录器进行使用即可
2、括号中的无论是字符串还是对应的class类型最终都会打印成当前的类的全限定类名正常逻辑
如下所示
private static Logger logger LoggerFactory.getLogger(UserController.class);private static Logger logger LoggerFactory.getLogger(com.guang.springbootlogback.user.controller.UserController);上面二者相同如果传递的是Class那么最终也会调用getName来获取得到最终的值。
1.2、记录器的层级结构
类似于java中的体系结构记录器也是有对应的层级结构的 根记录器是logback自带的本身就已经存在。而对于记录器A、B、C来说根记录器是其父类对于记录器D来说是其祖先记录器。
如果对于记录器ABCD都没有设置自身的日志级别的话那么默认都是继承了根记录器的日志级别。
如果任意一个子记录器设置了自己的日志级别那么子记录器就可以使用使用对应级别的打印输出内容了。
比如记录器A继承了根记录器默认是DEBUG如果记录器A设置了日志级别为INFO如果记录器D没有设置的话将会来继承记录器A的日志级别。
那么分别来创建几个记录器 private static final Logger logger LoggerFactory.getLogger(com.guang.logback.demo1.LogbackTestOne);private static final Logger logger1 LoggerFactory.getLogger(com.guang.logback);private static final Logger logger2 LoggerFactory.getLogger(com.guang);private static final Logger logger3 LoggerFactory.getLogger(com);说明
1、上面创建了四个记录器对于logger、logger1、logger2来说都是继承于logger3的因为记录器的层级关系是通过包名来进行设置的。
2、对于记录器logger来说它会创建出来一个具备这层级关系的记录器
3、对于记录器logger3来说是继承于根记录器的
对应图如下所示 1.3、过滤器
filter中最重要的两个过滤器为LevelFilter、ThresholdFilter。
LevelFilter根据精确的级别匹配过滤事件。如果事件的级别等于配置的级别则筛选器接受或拒绝该事件具体取决于onMatch和onMismatch属性的配置。
例如下面配置将只打印INFO级别的日志其余的全部禁止打印输出
configurationappender nameCONSOLE classch.qos.logback.core.ConsoleAppenderfilter classch.qos.logback.classic.filter.LevelFilterlevelINFO/levelonMatchACCEPT/onMatchonMismatchDENY/onMismatch/filterencoderpattern%-4relative [%thread] %-5level %logger{30} - %msg%n/pattern/encoder/appenderroot levelDEBUGappender-ref refCONSOLE //root
/configurationThresholdFilter过滤低于指定阈值的事件。 对于等于或高于阈值的事件ThresholdFilter将在调用其decision()方法时响应NEUTRAL。
但是将拒绝级别低于阈值的事件例如下面的配置将拒绝所有低于INFO级别的日志只输出INFO以及以上级别的日志
configurationappender nameCONSOLEclassch.qos.logback.core.ConsoleAppender!-- deny all events with a level below INFO, that is TRACE and DEBUG --filter classch.qos.logback.classic.filter.ThresholdFilterlevelINFO/level/filterencoderpattern%-4relative [%thread] %-5level %logger{30} - %msg%n/pattern/encoder/appenderroot levelDEBUGappender-ref refCONSOLE //root
/configuration1.4、logger设置日志级别
在logback中有五大日志级别按照从小到大的顺序进行排列TRACE DEBUG INFO WARN ERROR
如果设置的级别是DEBUG那么在程序打印出来的级别只能够大于等于DEBUG的而不会打印TRACE。
那么logback中默认日志级别是DEBUG
首先需要明确的是对于每个记录器来说都有日志记录器的名称、级别和获取得到日志级别的方法。
1、name:记录器的名称2、level日志记录器的级别也是日志的级别。五个日志级别TRACE DEBUG INFO WARN ERROR设置的时候可以通过配置文件也可以通过代码来进行设置。如果没有设置级别那么将会从父记录器或者是祖先记录器中来进行继承日志级别3、获取得到级别的方法logger.setLevel():设置的级别只会对这个级别及其之上的起作用logger.getLevel()获取得到设置的级别logger.getEffectiveLevel()和getLevel相同additivity是否允许叠加打印日志,true或者是false。也就是子记录器和父记录器进行叠加打印可以理解成是重复打印问题。后续会来解决这个问题1.5、java代码演示
来利用java代码来设置日志级别做一个案例演示
public static void main(String[] args) {// 不能够使用接口因为接口中没有这个方法需要找到具体的实现类ch.qos.logback.classic.Logger logger (ch.qos.logback.classic.Logger) LoggerFactory.getLogger(LogbackTestThree.class);// 在设置之前看下本身的日志级别 为什么因为直接继承了父记录器都没有设置那么最终都将会继承根记录器因为根记录器设置 // 的日志级别是DEBUG所以默认级别是DEBUGSystem.out.println(默认的记录器级别logger.getEffectiveLevel());// 可以修改父记录器的级别然后让子记录器来进行继承子记录器打印的是父记录器的级别logger.setLevel(Level.INFO);// 当前级别logger.info(hello,world);// 输出更高级别logger.error(hello,world);// 输出比当前级别低的 不会来打印logger.debug(hello,logback---debug);
}1.6、使用配置文件演示
使用java代码来设置日志级别是不方便的所以最方便的使用方式是使用配置文件来进行输出
这里需要使用到附加器的内容所以看完附加器再来看这个
?xml version1.0 encodingUTF-8?
!-- 日志级别从低到高分为TRACE DEBUG INFO WARN ERROR FATAL如果设置为WARN则低于WARN的信息都不会输出 --
!-- scan:当此属性设置为true时配置文件如果发生改变将会被重新加载默认值为true --
!-- scanPeriod:设置监测配置文件是否有修改的时间间隔如果没有给出时间单位默认单位是毫秒。当scan为true时此属性生效。默认的时间间隔为1分钟。 --
!-- debug:当此属性设置为true时将打印出logback内部日志信息实时查看logback运行状态。默认值为false。 --
!--configuration scantrue scanPeriod10 seconds--
configuration!--滚动文件附加器--appender nameFile classch.qos.logback.core.rolling.RollingFileAppender!--日志名,指定最新的文件名其他文件名使用FileNamePattern --!--也就是说当out.log文件超过了rollingPolicy中的配置信息那么将会命名成FileNamePattern中的格式--FileC:\\Users\\lig\\Desktop\\log\\out.log/Fileappendtrue/append!--文件生成策略生成文件的文件名称以及什么时候生成文件--!--滚动文件可以按照天、月、日来进行生成也可以按照大小来生成对应的文件--rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy!--日志文件输出的文件名,可设置文件类型为gz,开启文件压缩--!-- 按天生成--FileNamePatternlog_/date-%d{yyyy-MM-dd HH-mm-ss}-%i.log/FileNamePattern!--只保证最近的30个文件--MaxHistory30/MaxHistory!--所有的log文件不能够超过3MB如果超过了将会来进行删除--totalSizeCap3MB/totalSizeCap!--所有文件的总大小如果超过500MB也会来进行删除--!--文件超过500MB会将其归档成为一个上面设置格式的一个文件--maxFileSize500MB/maxFileSize/rollingPolicy!--编码器 输出格式--encoder classch.qos.logback.classic.encoder.PatternLayoutEncoder!--格式化输出%d表示日期%thread表示线程名%-5level级别从左显示5个字符宽度%msg日志消息%n是换行符--pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{60} - %msg%n/pattern!--设置编码--charsetUTF-8/charset/encoder/appender!--这里就相当于是利用java代码来创建一个记录器--logger namecom.guang.logback.demo2appender-ref refFile//logger!--根记录器中引入附加器将附加器中的信息输出到日志中来--root levelinfo//configuration二、附加器
2.1、什么是附加器
记录器会将输出日志的任务交给附加器完成不同的附加器会将日志记录器中记录的信息输出到不同的地方。比如控制台附加器、文件附加器、网络附加器等等。
不同的附加器会将logger.info(“xxx”)中的输出信息输出到不同的地方中去
常用的附加器控制台附加器
附加器实现类说明作用ch.qos.logback.core.ConsoleAppender控制台附加器将输出信息输出到控制台ch.qos.logback.core.FileAppender文件附加器将输出信息输出到文件中去文件只有一个ch.qos.logback.core.rolling.RollingFileAppender滚动文件附加器是文件附加器的子类将输出信息输出到文件中去可以输出到不同文件中去
也就是说将日志输出在哪里是由附加器来进行完成的
2.2、附加器使用方式
附加器就是将信息输出到哪里但是需要得到日志记录器的支持。所以二者要联合来进行使用。
?xml version1.0 encodingUTF-8?
configuration debugtrue!-- appender是configuration的子节点是负责写日志的组件。 --!-- ConsoleAppender把日志输出到控制台 --appender nameSTDOUT classch.qos.logback.core.ConsoleAppender!-- 默认情况下每个日志事件都会立即刷新到基础输出流。 这种默认方法更安全因为如果应用程序在没有正确关闭appender的情况下退出则日志事件不会丢失。但是为了显着增加日志记录吞吐量您可能希望将immediateFlush属性设置为false--!--immediateFlushtrue/immediateFlush--encoder!-- %37():如果字符没有37个字符长度,则左侧用空格补齐 --!-- %-37():如果字符没有37个字符长度,则右侧用空格补齐 --!-- %15.15():如果记录的线程字符长度小于15(第一个)则用空格在左侧补齐,如果字符长度大于15(第二个),则从开头开始截断多余的字符 --!-- %-40.40():如果记录的logger字符长度小于40(第一个)则用空格在右侧补齐,如果字符长度大于40(第二个),则从开头开始截断多余的字符 --!-- %msg日志打印详情 --!-- %n:换行符 --!-- %highlight():转换说明符以粗体红色显示其级别为ERROR的事件红色为WARNBLUE为INFO以及其他级别的默认颜色。 --pattern%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5level) --- [%15.15(%thread)] %cyan(%-40.40(%logger{40})) : %msg%n/pattern!-- 控制台也要使用UTF-8不要使用GBK否则会中文乱码 --charsetUTF-8/charset/encoder/appender!-- info 日志--!-- RollingFileAppender滚动记录文件先将日志记录到指定文件当符合某个条件时将日志记录到其他文件 --!-- 以下的大概意思是1.先按日期存日志日期变了将前一天的日志文件名重命名为XXX%日期%索引新的日志仍然是project_info.log --!-- 2.如果日期没有发生变化但是当前日志的文件大小超过10MB时对当前日志进行分割 重命名--appender nameinfo_log classch.qos.logback.core.rolling.RollingFileAppender!--日志文件路径和名称--Filelogs/project_info.log/File!--是否追加到文件末尾,默认为true--appendtrue/appendfilter classch.qos.logback.classic.filter.LevelFilterlevelERROR/level!-- 如果命中ERROR就禁止这条日志 --onMatchDENY/onMatch!-- 如果没有命中就使用这条规则 --onMismatchACCEPT/onMismatch/filter!--有两个与RollingFileAppender交互的重要子组件。 第一个RollingFileAppender子组件即RollingPolicy:负责执行翻转所需的操作。RollingFileAppender的第二个子组件即TriggeringPolicy:将确定是否以及何时发生翻转。 因此RollingPolicy负责什么和TriggeringPolicy负责什么时候.作为任何用途RollingFileAppender必须同时设置RollingPolicy和TriggeringPolicy.但是如果其RollingPolicy也实现了TriggeringPolicy接口则只需要显式指定前者。--rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy!-- 日志文件的名字会根据fileNamePattern的值每隔一段时间改变一次 --!-- 文件名logs/project_info.2017-12-05.0.log --!-- 注意SizeAndTimeBasedRollingPolicy中 i和d令牌都是强制性的必须存在要不会报错 --fileNamePatternlogs/project_info.%d.%i.log/fileNamePattern!-- 每产生一个日志文件该日志文件的保存期限为30天, ps:maxHistory的单位是根据fileNamePattern中的翻转策略自动推算出来的。例如上面选用了yyyy-MM-dd,则单位为天如果上面选用了yyyy-MM,则单位为月,另外上面的单位默认为yyyy-MM-dd--maxHistory30/maxHistory!-- 每个日志文件到10mb的时候开始切分最多保留30天但最大到20GB哪怕没到30天也要删除多余的日志 --totalSizeCap20GB/totalSizeCap!-- maxFileSize:这是活动文件的大小默认值是10MB测试时可改成5KB看效果 --maxFileSize10MB/maxFileSize/rollingPolicy!--编码器--encoder!-- pattern节点用来设置日志的输入格式 ps:日志文件中没有设置颜色,否则颜色部分会有ESC[0:39em等乱码--pattern%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level --- [%15.15(%thread)] %-40.40(%logger{40}) : %msg%n/pattern!-- 记录日志的编码:此处设置字符集 - --charsetUTF-8/charset/encoder/appender!-- error 日志--!-- RollingFileAppender滚动记录文件先将日志记录到指定文件当符合某个条件时将日志记录到其他文件 --!-- 以下的大概意思是1.先按日期存日志日期变了将前一天的日志文件名重命名为XXX%日期%索引新的日志仍然是project_error.log --!-- 2.如果日期没有发生变化但是当前日志的文件大小超过10MB时对当前日志进行分割 重命名--appender nameerror_log classch.qos.logback.core.rolling.RollingFileAppender!--日志文件路径和名称--Filelogs/project_error.log/File!--是否追加到文件末尾,默认为true--appendtrue/append!-- ThresholdFilter过滤低于指定阈值的事件。 对于等于或高于阈值的事件ThresholdFilter将在调用其decision方法时响应NEUTRAL。 但是将拒绝级别低于阈值的事件 --filter classch.qos.logback.classic.filter.ThresholdFilterlevelERROR/level!-- 低于ERROR级别的日志debug,info将被拒绝等于或者高于ERROR的级别将相应NEUTRAL --/filter!--有两个与RollingFileAppender交互的重要子组件。 第一个RollingFileAppender子组件即RollingPolicy:负责执行翻转所需的操作。RollingFileAppender的第二个子组件即TriggeringPolicy:将确定是否以及何时发生翻转。 因此RollingPolicy负责什么和TriggeringPolicy负责什么时候.作为任何用途RollingFileAppender必须同时设置RollingPolicy和TriggeringPolicy,但是如果其RollingPolicy也实现了TriggeringPolicy接口则只需要显式指定前者。--rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy!-- 活动文件的名字会根据fileNamePattern的值每隔一段时间改变一次 --!-- 文件名logs/project_error.2017-12-05.0.log --!-- 注意SizeAndTimeBasedRollingPolicy中 i和d令牌都是强制性的必须存在要不会报错 --fileNamePatternlogs/project_error.%d.%i.log/fileNamePattern!-- 每产生一个日志文件该日志文件的保存期限为30天, ps:maxHistory的单位是根据fileNamePattern中的翻转策略自动推算出来的,例如上面选用了yyyy-MM-dd,则单位为天如果上面选用了yyyy-MM,则单位为月,另外上面的单位默认为yyyy-MM-dd--maxHistory30/maxHistory!-- 每个日志文件到10mb的时候开始切分最多保留30天但最大到20GB哪怕没到30天也要删除多余的日志 --totalSizeCap20GB/totalSizeCap!-- maxFileSize:这是活动文件的大小默认值是10MB测试时可改成5KB看效果 --maxFileSize10MB/maxFileSize/rollingPolicy!--编码器--encoder!-- pattern节点用来设置日志的输入格式 ps:日志文件中没有设置颜色,否则颜色部分会有ESC[0:39em等乱码--pattern%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level --- [%15.15(%thread)] %-40.40(%logger{40}) : %msg%n/pattern!-- 记录日志的编码:此处设置字符集 - --charsetUTF-8/charset/encoder/appender!--给定记录器的每个启用的日志记录请求都将转发到该记录器中的所有appender以及层次结构中较高的appender不用在意level值。换句话说appender是从记录器层次结构中附加地继承的。例如如果将控制台appender添加到根记录器则所有启用的日志记录请求将至少在控制台上打印。如果另外将文件追加器添加到记录器例如L则对L和L子项启用的记录请求将打印在文件和控制台上。通过将记录器的additivity标志设置为false可以覆盖此默认行为以便不再添加appender累积--!-- configuration中最多允许一个root别的logger如果没有设置级别则从父级别root继承 --root levelINFOappender-ref refSTDOUT //root!-- 指定项目中某个包当有日志操作行为时的日志记录级别 --!-- 级别依次为【从高到低】FATAL ERROR WARN INFO DEBUG TRACE --logger namecom.sailing.springbootmybatis levelINFOappender-ref refinfo_log /appender-ref referror_log //logger!-- 利用logback输入mybatis的sql日志注意如果不加 additivityfalse 则此logger会将输出转发到自身以及祖先的logger中就会出现日志文件中sql重复打印--logger namecom.sailing.springbootmybatis.mapper levelDEBUG additivityfalseappender-ref refinfo_log /appender-ref referror_log //logger!-- additivityfalse代表禁止默认累计的行为即com.atomikos中的日志只会记录到日志文件中不会输出层次级别更高的任何appender--logger namecom.atomikos levelINFO additivityfalseappender-ref refinfo_log /appender-ref referror_log //logger/configuration2.3、输出格式
如果将输出设置的单调那么将无法来进行定位问题所以需要对日志产生的时间、位置、进程名称、日志级别等等信息进行打印方便我们来定位问题。我们可以指定输出信息的模板将输出信息进行模板格式化而Pattern标签就是用来做这个事情的
Pattern由文字文本和转换说明符的格式控制表达式组成 。您可以在其中自由插入任何文字文本。每个转换说明符都以百分号 ‘%’ 后跟可选的 格式修饰符、转换字和大括号之间的可选参数。转换字控制要转换的数据字段例如记录器名称、级别、日期或线程名称。格式修饰符控制字段宽度、填充以及左对齐或右对齐。
常见的有如下所示 2.4、记录器的可加性
之前还有一个属性没有来得及进行介绍这里也来介绍下记录器的可加性指的就是日志的重复输出问题。
问题产生
分别看下对应的问题和解决方式
?xml version1.0 encodingUTF-8?
configuration scantrue scanPeriod10 seconds!--输出到控制台--appender nameSTOUT classch.qos.logback.core.ConsoleAppender!--输出格式--encoderpattern%10date %level [%thread] %logger{60} %line %msg %n/pattern/encoder/appender!--可加性 不设置默认为true--logger namecom.guang.springbootlogback.controller leveldebugappender-ref refSTOUT//loggerroot levelinfoappender-ref refSTOUT//root
/configuration对应的案例 RequestMapping(deleteUser)public String deleteUser(){logger.info(hello,world);return hello,logback;}访问的时候会打印两次根记录器和父记录器分别户打印一次
2022-04-20 11:54:59,543 INFO [http-nio-8080-exec-1] com.guang.springbootlogback.user.controller.UserController 32 hello,world
2022-04-20 11:54:59,543 INFO [http-nio-8080-exec-1] com.guang.springbootlogback.user.controller.UserController 32 hello,world 查看一下对应的记录器树层次结构 产生原因解释如果子记录器中的附加器来进行打印的时候父类记录器中的附加器也会打印日志直到根记录器中的附加器也会来打印
解决方法
那么为了防止这种重复打印的情况直接建议使用下面这种方式
来自阿里巴巴规范中
【强制】避免重复打印日志浪费磁盘空间务必在 log4j.xml 中设置 additivityfalse。
正例logger namecom.taobao.dubbo.config additivityfalse直接设置只有当前记录器可输出
?xml version1.0 encodingUTF-8?
configuration scantrue scanPeriod10 seconds!--输出到控制台--appender nameSTOUT classch.qos.logback.core.ConsoleAppender!--输出格式--encoderpattern%10date %level [%thread] %logger{60} %line %msg %n/pattern/encoder/appender!--可加性 不设置默认为true。设置为false之后表示的是只有当前的记录器才会来打印其他的记录器不会打印 --logger namecom.guang.springbootlogback leveldebug additivityfalseappender-ref refSTOUT//loggerroot levelinfoappender-ref refSTOUT//root
/configuration五、SpringBoot中使用Logback日志
直接参考官方文档https://docs.spring.io/spring-boot/docs/2.5.14/reference/html/features.html#features.logging
5.1、日志文件命名和位置
Spring Boot官方推荐优先使用带有-spring的文件名作为你的日志配置如使用logback-spring.xml而不是logback.xml命名为logback-spring.xml的日志配置文件将xml放至 src/main/resource下面。
也可以使用自定义的名称比如logback-config.xml只需要在application.properties文件中使用logging.configclasspath:logback-config.xml指定即可。
5.2、logback.xml中使用环境变量信息
springProfile namestaging!-- configuration to be enabled when the staging profile is active --
/springProfilespringProfile namedev | staging!-- configuration to be enabled when the dev or staging profiles are active --
/springProfilespringProfile name!production!-- configuration to be enabled when the production profile is not active --
/springProfile
springProperty scopecontext namefluentHost sourcemyapp.fluentd.hostdefaultValuelocalhost/
appender nameFLUENT classch.qos.logback.more.appenders.DataFluentAppenderremoteHost${fluentHost}/remoteHost...
/appender
六、日志记录中的一些坑
6.1、情景一
这里再说下log日志输出代码一般有人可能在代码中使用如下方式输出
Object entry new SomeObject();
logger.debug(The entry is entry);上面看起来没什么问题但是会存在两个问题
1、构造消息参数的成本即将entry转换成字符串相加
2、无论是否记录消息都是如此即那怕日志级别为INFO也会执行括号里面的操作但是日志不会输出下面是优化后的写法
if(logger.isDebugEnabled()) { Object entry new SomeObject(); logger.debug(The entry is entry);
}6.2、情景二
针对上面的写法首先对设置的日志级别进行了判断如果为debug模式才进行参数的构造对第一种写法进行了改善。
不过还有最好的写法使用占位符
Object entry new SomeObject();
logger.debug(The entry is {}., entry);只有在评估是否记录之后并且只有在决策是肯定的情况下记录器实现才会格式化消息并将“{}”对替换为条目的字符串值。 换句话说当禁用日志语句时此表单不会产生参数构造的成本。 logback作者进行测试得出第一种和第三种写法将产生完全相同的输出。 但是在禁用日志记录语句的情况下第三个变体将比第一个变体优于至少30倍。 6.3、情景三
如果有多个参数写法如下
logger.debug(The new entry is {}. It replaces {}., entry, oldEntry);如果需要传递三个或更多参数则还可以使用Object []变体
Object[] paramArray {newVal, below, above};
logger.debug(Value {} was inserted between {} and {}., paramArray);6.4、情景四
记录日志的时候我们可能需要在文件中记录下异常的堆栈信息经过测试logger.error(e) 不会打印出堆栈信息正确的写法是
logger.error(程序异常, 详细信息:{}, e.getLocalizedMessage() , e);6.5、情景五日志无法删除情况
看下下面的情况
!--基于时间和空间的滚动日志单个文件最大10MB保留天数最大30天所以日志保留最大空间是20GB --
rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicyfileNamePattern/root/demo/logs/hornet_%d{yyyyMMdd}.%i.log/fileNamePatternmaxFileSize10mb/maxFileSizemaxHistory30/maxHistorytotalSizeCap20GB/totalSizeCap
/rollingPolicy从配置可以看出可以从 SizeAndTimeBasedRollingPolicy.class 着手
public class SizeAndTimeBasedRollingPolicyE extends TimeBasedRollingPolicyE {FileSize maxFileSize;Overridepublic void start() {SizeAndTimeBasedFNATPE sizeAndTimeBasedFNATP new SizeAndTimeBasedFNATPE(Usage.EMBEDDED); if(maxFileSize null) {addError(maxFileSize property is mandatory.);return;} else {// 每个文件大小限制在maxFileSize大小addInfo(Archive files will be limited to [maxFileSize] each.);}sizeAndTimeBasedFNATP.setMaxFileSize(maxFileSize);timeBasedFileNamingAndTriggeringPolicy sizeAndTimeBasedFNATP;// 1、totalSizeCap不能为0// 2、如果总大小小于其中一个文件大小抛出异常if(!isUnboundedTotalSizeCap() totalSizeCap.getSize() maxFileSize.getSize()) {addError(totalSizeCap of [totalSizeCap] is smaller than maxFileSize [maxFileSize] which is non-sensical);return;}// most work is done by the parent// 执行父类中的方法super.start();}// ....
}然后执行父类中的方法:ch.qos.logback.core.rolling.TimeBasedRollingPolicy#start
public void start() {// set the LR for our utility objectrenameUtil.setContext(this.context);// find out period from the filename patternif (fileNamePatternStr ! null) {fileNamePattern new FileNamePattern(fileNamePatternStr, this.context);determineCompressionMode();} else {addWarn(FNP_NOT_SET);addWarn(CoreConstants.SEE_FNP_NOT_SET);throw new IllegalStateException(FNP_NOT_SET CoreConstants.SEE_FNP_NOT_SET);}compressor new Compressor(compressionMode);compressor.setContext(context);// wcs : without compression suffixfileNamePatternWithoutCompSuffix new FileNamePattern(Compressor.computeFileNameStrWithoutCompSuffix(fileNamePatternStr, compressionMode), this.context);addInfo(Will use the pattern fileNamePatternWithoutCompSuffix for the active file);if (compressionMode CompressionMode.ZIP) {String zipEntryFileNamePatternStr transformFileNamePattern2ZipEntry(fileNamePatternStr);zipEntryFileNamePattern new FileNamePattern(zipEntryFileNamePatternStr, context);}if (timeBasedFileNamingAndTriggeringPolicy null) {timeBasedFileNamingAndTriggeringPolicy new DefaultTimeBasedFileNamingAndTriggeringPolicyE();}timeBasedFileNamingAndTriggeringPolicy.setContext(context);timeBasedFileNamingAndTriggeringPolicy.setTimeBasedRollingPolicy(this);timeBasedFileNamingAndTriggeringPolicy.start();if (!timeBasedFileNamingAndTriggeringPolicy.isStarted()) {addWarn(Subcomponent did not start. TimeBasedRollingPolicy will not start.);return;}//*********** 可以看到这里有 maxHistory也就是最大保留天数//*********** 可以看到这里有 maxHistory也就是最大保留天数//*********** 可以看到这里有 maxHistory也就是最大保留天数//*********** 大概意思就是判断是否初始化然后把参数设置到archiveRemover中//*********** 后面调用archiveRemover.cleanAsynchronously方法进行清理 // the maxHistory property is given to TimeBasedRollingPolicy instead of to// the TimeBasedFileNamingAndTriggeringPolicy. This makes it more convenient// for the user at the cost of inconsistency here.if (maxHistory ! UNBOUND_HISTORY) {archiveRemover timeBasedFileNamingAndTriggeringPolicy.getArchiveRemover();archiveRemover.setMaxHistory(maxHistory);archiveRemover.setTotalSizeCap(totalSizeCap.getSize());if (cleanHistoryOnStart) {addInfo(Cleaning on start up);Date now new Date(timeBasedFileNamingAndTriggeringPolicy.getCurrentTime());cleanUpFuture archiveRemover.cleanAsynchronously(now);}} else if (!isUnboundedTotalSizeCap()) {addWarn(maxHistory is not set, ignoring totalSizeCap option with value [totalSizeCap]);}super.start();
}
进入 TimeBasedArchiveRemover.class,可以看到这是一个异步任务重点在 clean()
public Future? cleanAsynchronously(Date now) {ArhiveRemoverRunnable runnable new ArhiveRemoverRunnable(now);ExecutorService executorService context.getScheduledExecutorService();Future? future executorService.submit(runnable);return future;
}public class ArhiveRemoverRunnable implements Runnable {Date now;ArhiveRemoverRunnable(Date now) {this.now now;}Overridepublic void run() {clean(now);if (totalSizeCap ! UNBOUNDED_TOTAL_SIZE_CAP totalSizeCap 0) {capTotalSize(now);}}
}重点在 clean() 清理得到 periodsElapsed 天数然后遍历清理 (-maxHistory1)i 天
public void clean(Date now) {// 获取得到现在的时间long nowInMillis now.getTime();// for a live appender periodsElapsed is expected to be 1// 如何进行计算的int periodsElapsed computeElapsedPeriodsSinceLastClean(nowInMillis);lastHeartBeat nowInMillis;if (periodsElapsed 1) {addInfo(Multiple periods, i.e. periodsElapsed periods, seem to have elapsed. This is expected at application start.);}for (int i 0; i periodsElapsed; i) {int offset getPeriodOffsetForDeletionTarget() - i;// 获取需要删除的日志日期 如今天是2022-09-15 maxHistory为30 // 则dateOfPeriodToClean是从2022-08-15到2022-07-15 过早的日志则需要手动删除Date dateOfPeriodToClean rc.getEndOfNextNthPeriod(now, offset);cleanPeriod(dateOfPeriodToClean);}
}重要 computeElapsedPeriodsSinceLastClean() 计算 periodsElapsed 天数
int computeElapsedPeriodsSinceLastClean(long nowInMillis) {long periodsElapsed 0;// UNINITIALIZED判断是否没有进行初始化if (lastHeartBeat UNINITIALIZED) {addInfo(first clean up after appender initialization);// periodBarriersCrossed 计算过期出天数// 默认32天periodsElapsed rc.periodBarriersCrossed(nowInMillis, nowInMillis INACTIVITY_TOLERANCE_IN_MILLIS);periodsElapsed Math.min(periodsElapsed, MAX_VALUE_FOR_INACTIVITY_PERIODS);} else {periodsElapsed rc.periodBarriersCrossed(lastHeartBeat, nowInMillis);// periodsElapsed of zero is possible for size and time based policies}return (int) periodsElapsed;
}结论
如果要在项目启动时就删除历史日志文件需要在logback-spring.xml中添加true。
另外过于古老的日志是无法自动清除的。logback只能删除最近maxHistory天到maxHistory-32天的日志文件。
如今天是2022-09-15 maxHistory为30 则日志删除的范围是从 2022-07-15 到 2022-08-15 过早的日志则需要手动删除
七、SpringBoot中切换日志
因为SpringBoot默认的Logback在springboot中默认在spring-boot-starter-web中自动引入了spring-boot-starter-logging
如果想要切换到log4j2那么只需要在spring-boot-starter-web排除掉spring-boot-starter-logging然后引入新的日志框架对应的坐标。
dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactIdexclusionsexclusiongroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-logging/artifactId/exclusion/exclusions
/dependency
dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-log4j2/artifactId
/dependency这里涉及到的步骤有如下所示
1、在依赖中先从spring-boot-starter-web中点进去找到spring-boot-starter
2、再从spring-boot-starter中点进去找到spring-boot-starter-logging
3、然后在spring-boot-starter-web下写下排除的坐标直接从第二步中拷贝下来
八、阿里巴巴日志规约
1、【强制】应用中不可直接使用日志系统Log4j、Logback中的 API而应依赖使用日志框架 SLF4J、JCL–Jakarta Commons Logging中的 API使用门面模式的日志框架有利于维护和各个类的日志处理方式统一。 说明日志框架SLF4J、JCL–Jakarta Commons Logging的使用方式推荐使用 SLF4J
使用 SLF4J
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
private static final Logger logger LoggerFactory.getLogger(Test.class);使用 JCL
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
private static final Log log LogFactory.getLog(Test.class);2、【强制】所有日志文件至少保存 15 天因为有些异常具备以“周”为频次发生的特点。对于当天日志以“应用名.log”来保存保存在/home/admin/应用名/logs/目录下过往日志格式为: {logname}.log.{保存日期}日期格式yyyy-MM-dd 说明以 mppserver 应用为例日志保存在/home/admin/mppserver/logs/mppserver.log历史日志名称为 mppserver.log.2016-08-01
3、【强制】在日志输出时字符串变量之间的拼接使用占位符的方式。 说明因为 String 字符串的拼接会使用 StringBuilder 的 append()方式有一定的性能损耗。使用占位符仅是替换动作可以有效提升性能。 正例logger.debug(“Processing trade with id: {} and symbol: {}”, id, symbol);
4、【强制】对于 trace/debug/info 级别的日志输出必须进行日志级别的开关判断。 说明虽然在 debug(参数)的方法体内第一行代码 isDisabled(Level.DEBUG_INT)为真时Slf4j 的常见实现Log4j 和 Logback就直接 return但是参数可能会进行字符串拼接运算。此外如果 debug(getName())这种参数内有 getName()方法调用无谓浪费方法调用的开销。 正例 // 如果判断为真那么可以输出 trace 和 debug 级别的日志 if (logger.isDebugEnabled()) { logger.debug(“Current ID is: {} and name is: {}”, id, getName()); }
5、【强制】避免重复打印日志浪费磁盘空间务必在 log4j.xml 中设置 additivityfalse。 正例
6、【强制】生产环境禁止直接使用 System.out 或 System.err 输出日志或使用e.printStackTrace()打印异常堆栈。 说明标准日志输出与标准错误输出文件每次 Jboss 重启时才滚动如果大量输出送往这两个文件容易造成文件大小超过操作系统大小限制。
7、【强制】异常信息应该包括两类信息案发现场信息和异常堆栈信息。如果不处理那么通过关键字 throws 往上抛出。 正例logger.error(各类参数或者对象 toString() “_” e.getMessage(), e);
8、【强制】日志打印时禁止直接用 JSON 工具将对象转换成 String。 说明如果对象里某些 get 方法被重写存在抛出异常的情况则可能会因为打印日志而影响正常业务流程的执行。 正例打印日志时仅打印出业务相关属性值或者调用其对象的 toString()方法。
9、【推荐】谨慎地记录日志。生产环境禁止输出 debug 日志有选择地输出 info 日志如果使用 warn 来记录刚上线时的业务行为信息一定要注意日志输出量的问题避免把服务器磁盘撑爆并记得及时删除这些观察日志。 说明大量地输出无效日志不利于系统性能提升也不利于快速定位错误点。
记录日志时请思考这些日志真的有人看吗看到这条日志你能做什么能不能给问题排查带来好处
10、【推荐】可以使用 warn 日志级别来记录用户输入参数错误的情况避免用户投诉时无所适从。如非必要请不要在此场景打出 error 级别避免频繁报警。 说明注意日志输出的级别error 级别只记录系统逻辑出错、异常或者重要的错误信息。
