Java日志之Logback

tech2024-05-21  70

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文件
最新回复(0)