logback配置文件详解

Posted 2023-02-17

参考技术A

logback日志框架由三部分组成： logback-core 、 logback-access 、 logback-classic 。使用起来也很方便需要在项目目录下增加logback.xml文件。在springboot项目，框架已经集成了logback（默认的日志框架），只需要在项目 resource 下配置 logback.xml文件 或者 logback-spring.xml 文件。这里主要记录的是logback配置文件的内容部分。

在学习logback时，我们需要了解设计者的思维方式。我们才能更好的配置出我们需要的日志策略及性能。

（1）控制台日志和写入文件日志分开
日志本身是可追加写入的，定义为 追加器 ： appender ，控制台和写入文件日志分别有 ConsleAppdender 和 FileAppender 两个追加器处理。

（2）日志打印的内容可以控制参数格式
打印出的日志一定是规整的，便于开发跟踪问题。例如：问题发生的时间，由于大部分程序都是多线程运行的，则需要知道每个业务请求的线程号，出问题的使用到的类名等等.

（3）写入文件中的日志不宜过大同时考虑时间跨天问题
考虑到将文件分开（可卷起 Rolling ），则使用升级的追加器 RollingFileAppender ，同时分开规则（ Policy ）考虑到跨天跨时间 。则在追加器中定义拆分规则： SizeAndTimeBasedRollingPolicy

（4）日志应该可以灵活指定输出级别
针对“ com.sports ”包下的日志，控制台和日志文件都使用debug级别。

（5）必须对主体日志指定输出级别
虽然我们会对不同的包或者框架下日志设置输出级别，但不可缺少主体日志输出级别： root

（6）日志可以异步写入
通常日志是和业务应用公用同一个线程，写系统日志会有 IO 开销，会损耗性能，我们应该可以异步写日志

logback框架日志格式通过 PatternLayout 方式配置，样例：

encoder作用：①把日志信息转换成字节数组；②把字节数组写入到输出流。
PatternLayoutEncoder 是唯一有用的且默认的 encoder ， encoder 下只有一个 pattern 节点。

（1） % + “转换符号”输出信息
%t ： t表示线程的转换符，打印控制台" [Thread: restartedMain]"
pattern中的转换符列表

（2）格式修饰符
与转换符共同使用，可选的格式修饰符位于“%”和转换符之间
左对齐 修饰符 ：符号是减号“-”；接着是可选的最小宽度 修饰符，用十进制数表示

（3）使用 slf4j 中的 MDC 新增线程参数
“ %X ”用于输出和当前线程相关联的 MDC (嵌套诊断环境)，格式 %Xxxx，使用 org.slf4j.MDC 添加 key/value 即可增加新值，

其中tracId是在MDC中设置进当前线程中的参数，记得在线程运行完时清除 clear 掉。