Logback简介
Logback也是SLF4J的一个实现,Log4J的作者因为不满意Log4J的效率,于是又推出了Logback。
logback当前分成三个模块:
logback-core:核心模块,也是其它两个模块的基础模块
logback- classic:log4j的一个改良版本
logback-access:可以与容器结合,实现日志在线访问服务
配置加载
-
从classpath里寻找logback-test.xml
-
如果没找到,则尝试在classpath里寻找logback.groovy
-
如果没找到,则在classpath里寻找logback.xml
- 如果没找到,则使用SPI机制ServiceLoader加载
com.qos.logback.classic.spi.Configurator的实现
- 如果上面的都没成功,则使用
BasicConfigurator输出到控制台
输出格式
Logback默认使用PatternLayout来输出日志,可以自定义格式,详情见官网
部分Pattern说明如下:
%m | 输出代码中指定的消息 |
%p | 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL |
%r | 输出自应用启动到输出该log信息耗费的毫秒数 |
%c | 输出所属的类目,通常就是所在类的全名 |
%t | 输出产生该日志事件的线程名 |
%n | 输出一个回车换行符,Windows平台为“\r\n”,Unix平台为“\n” |
%d | 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS}, 输出类似:2002年10月18日 22:10:28,921 |
%l | 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog.main(TestLog.java:10) |
<?xml version="1.0" encoding="UTF-8"?>
<!-- 级别从高到低 OFF 、 FATAL 、 ERROR 、 WARN 、 INFO 、 DEBUG 、 TRACE 、 ALL -->
<!-- 日志输出规则 根据当前ROOT 级别,日志输出时,级别高于root默认的级别时 会输出 -->
<!-- 以下 每个配置的 filter 是过滤掉输出文件里面,会出现高级别文件,依然出现低级别的日志信息,通过filter 过滤只记录本级别的日志 -->
<!-- scan 当此属性设置为true时,配置文件如果发生改变,将会被重新加载,默认值为true。 -->
<!-- scanPeriod 设置监测配置文件是否有修改的时间间隔,如果没有给出时间单位,默认单位是毫秒。当scan为true时,此属性生效。默认的时间间隔为1分钟。 -->
<configuration scan="true" scanPeriod="60000">
<!-- 定义日志文件 输出位置 -->
<property name="log.home_dir" value="F:\log"/>
<property name="log.appName" value="logback-demo"/>
<!-- 日志最大的历史 30天 -->
<property name="log.maxHistory" value="30"/>
<property name="log.maxSize" value="5MB" />
<contextName>${log.appName}</contextName>
<!-- 输出到控制台 -->
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%-5level] %logger - %msg%n</pattern>
</encoder>
</appender>
<!-- 输出到固定文件 -->
<appender name="FILE" class="ch.qos.logback.core.FileAppender">
<file>${log.home_dir}\testFile.log</file>
<append>true</append>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%-5level] %logger - %msg%n</pattern>
</encoder>
<!-- 此日志文件只记录info级别的 -->
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>info</level>
<onMatch>ACCEPT</onMatch>
<onMismatch>DENY</onMismatch>
</filter>
</appender>
<!-- 按日期生成文件 -->
<appender name="TIME_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>logFile.%d{yyyy-MM-dd}.log</fileNamePattern>
<maxHistory>${log.maxHistory}</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%-5level] %logger - %msg%n</pattern>
</encoder>
</appender>
<appender name="TIME_SIZE_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<!-- 最常用的滚动策略,它根据时间来制定滚动策略.既负责滚动也负责触发滚动 -->
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<!--日志输出位置 可相对、和绝对路径 -->
<fileNamePattern>
${log.home_dir}/error/%d{yyyy-MM-dd}/${log.appName}-%i.log
</fileNamePattern>
<!-- 可选节点,控制保留的归档文件的最大数量,超出数量就删除旧文件,假设设置每个月滚动,且<maxHistory>是6,
则只保存最近6个月的文件,删除之前的旧文件。注意,删除旧文件时,那些为了归档而创建的目录也会被删除 -->
<maxHistory>${log.maxHistory}</maxHistory>
<!--日志文件最大的大小-->
<maxFileSize>${log.maxSize}</maxFileSize>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%-5level] %logger - %msg%n</pattern>
</encoder>
</appender>
<!-- root是一个特殊的logger -->
<root level="INFO">
<appender-ref ref="CONSOLE" />
<appender-ref ref="FILE" />
</root>
<logger name="com.im.email" level="INFO">
<appender-ref ref="TIME_SIZE_FILE" />
</logger>
</configuration>
Spring Boot 2
SpringBoot 默认使用Logback,并且因为引入了spring-boot-starter-web这个启动器,Logback被默认引入。
在SpringBoot 项目中可以使用logback.xml配置文件,或者,如果想使用spring对logback的扩展的话,使用logback-spring.xml来命名文件。
一个典型的logback-spring.xml:
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<include resource="org/springframework/boot/logging/logback/defaults.xml"/>
<!-- console-appender.xml中定义了一个叫CONSOLE的appender日志输出到控制台 -->
<include resource="org/springframework/boot/logging/logback/console-appender.xml" />
<!-- file-appender.xml中定义了一个叫FILE的appender把日志输出到文件 -->
<include resource="org/springframework/boot/logging/logback/file-appender.xml" />
<root level="INFO">
<appender-ref ref="CONSOLE" />
<appender-ref ref="FILE" />
</root>
<!-- <logger name="org.springframework.web" level="DEBUG"/> -->
</configuration>
然后我们可以在SpringBoot配置文件中配置:
logging.file.name=F:/log/im.log
logging.file.max-size=10MB
logging.file.max-history=30
注意:
- logging.file.name和logging.file.path只需要配置一个即可,且必须使用“/”,使用“\”会导致路径错误
- logging.file.name的值可以是相对路径(日志文件会生成在当前项目路径下)也可以是绝对路径
- logging.file.path只配置路径,会在该路径下生成spring.log文件