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文件