依赖引入
<dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.1.7</version>
</dependency>
使用logback日志框架只需要引入以上即可,(我们平时使用较多的@Slf4j注解是另外的机制触发)后续会谈到
查看以上的maven依赖项引入如下:
该依赖项引入了:
slf4j-api
logback-core
logback-classic
配置项样列
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false"><property name="LOG_HOME" value="./logs"/><!-- 控制台输出 --><appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"><encoderclass="ch.qos.logback.classic.encoder.PatternLayoutEncoder"><!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度%msg:日志消息,%n是换行符 --><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{5}: - %m%n</pattern>
<!-- <pattern>${COLOR_PATTERN}</pattern>--></encoder></appender><!-- 按照每天生成日志文件 --><appender name="LOGFILE"class="ch.qos.logback.core.rolling.RollingFileAppender"><rollingPolicyclass="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><!--日志文件输出的文件名 --><FileNamePattern>${LOG_HOME}/performance-batch.%d{yyyy-MM-dd}.log</FileNamePattern><!--日志文件保留天数 --><MaxHistory>30</MaxHistory></rollingPolicy><encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder"><!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度%msg:日志消息,%n是换行符 --><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50}: - %msg%n</pattern></encoder></appender><!--此日志文件只包含错误日志--><appender name="ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender"><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><fileNamePattern>${LOG_HOME}/performance-batch-error.%d{yyyy-MM-dd}.log</fileNamePattern></rollingPolicy><!-- 追加方式记录日志 --><append>true</append><!-- 日志文件的格式 --><encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder"><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{3}: - %msg%n</pattern><charset>utf-8</charset></encoder><!-- 此日志文件只记录error级别的 --><filter class="ch.qos.logback.classic.filter.LevelFilter"><level>error</level><onMatch>ACCEPT</onMatch><onMismatch>DENY</onMismatch></filter></appender><appender name="LOGFILE_ASYNC" class="ch.qos.logback.classic.AsyncAppender"><appender-ref ref="LOGFILE"/></appender><appender name="LOG_ERROR_FILE_ASYNC" class="ch.qos.logback.classic.AsyncAppender"><appender-ref ref="ERROR"/></appender><logger name="HuaweiCloud-SDK-Access" level="OFF"/><!-- 日志输出级别 --><root level="info"><appender-ref ref="STDOUT"/><appender-ref ref="LOGFILE_ASYNC"/><appender-ref ref="LOG_ERROR_FILE_ASYNC"/></root></configuration>
常用占位符含义
%C = %class【等价】打印全类名 ---不推荐,耗性能
%d = %date【等价】 日期格式可以在后面用{}表示
%F = %file 【等价】 发出日志请求的java源文件名字 ---不推荐,耗性能
%L = %line 【等价】 java文件中请求的行号 ---不推荐,耗性能
%m = %msg = %message 日志正文信息
%M = %method 日志请求发出的方法的方法名----不推荐,耗性能
%n 换行符
%p = %le = %level【等价】 日志级别 %-5p 表示打印日志级别,且左对齐5个字符的距离
%t = %thread 线程名称
%i 文件序号,在单条日志中不支持,在文件名称处支持
源码浅析
从结构上看,logback的配置解析是从<configuration debug="false">标签开始的,从代码上看入口是:
org.slf4j.impl.StaticLoggerBinder的静态代码块开始的。
从代码上看logback配置文件的优先级如下:
最终会把xml配置内容解析成一个LoggerContext对象,其中的结构关系如下:
每个Logger包含的元素有:名称、日志级别、生效的日志级别、父Logger、子logger列表、一组Appender列表...
未在xml中明确定义的logger的日志输出相关的所有限制继承父类,所有logger的父类是Root