常用日志框架:
jul (java.util.logging): jdk官方日志框架
jboss-logging:
log4j:基于淘汰,没有更新了
log4j2(Apatch):性能优于log4j
logback:性能优于log4j
PS:小项目jul够用,但是企业级开发还是建议log4j2和logback
(log4j和log4j2不是一个作者)
常用日志门面:
(概念:不实现日志功能,整合日志的)
JCL (jakarta commons logging官方):
(1)JCL 会通过classLoader会找存在的日志实现,如果找到了jul,就会使用jul。但是有三个缺点:<1>效率低<2>容易引发混乱<3>当我们使用自定义类加载器的时候,就可能造成内存泄露。
(2)JCL动态查找机制进行日志实例化,执行顺序为:commons-logging.properties ----> 系统环境变量---->log4j---->jul---->simplelog---->nooplog,所以如果存在log4j的maven依赖,那么JCL会先找到log4j,而不是jul。可以通过配置文件,让JCL指定实现框架,如图,图中所示为指定jul。
slf4j(开源社区):通过桥接器找对应的日志实现,性能高于JCL,与logback日志框架源自一个作者。
PS:流行log4j2 + slf4j 或 logback + slf4j(开销最小,最优)
适配器:
(概念:当项目使用了两种日志框架,可以使用适配器进行统一)
例:一个项目同时使用了jul+JCL和 log4j+slf4j的日志框架,现在需要统一,即可以将jul或者JCL通过导入适配器依赖的形式,整合到slf4j上面来实现。
桥接器:
(概念:日志框架要在日志门面使用的桥梁)
也就是说,当引入了logback日志框架和slf4j日志门面的maven依赖后,还需要引入对应的桥接器依赖,才能使日志运行。
桥接器只能有一个(slf4j只能运行一个)。
下图为slf4j的桥接器:
下面展示上述框架的核心依赖:
<!--log4j核心依赖-->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.20</version>
</dependency>
<!--slf4j门面核心依赖-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.30</version>
</dependency>
<!--slf4j - log4j桥接器-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.30</version>
</dependency>
<!--JCL门面依赖-->
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>1.2</version>
</dependency>
<!--日志统一,将JCL转到slf4j,添加JCL-slf4j适配器-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jcl-over-slf4j</artifactId>
<version>1.7.30</version>
</dependency>
<!--日志统一,将jul转到slf4j,添加jul-slf4j适配器-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jul-to-slf4j</artifactId>
<version>1.7.30</version>
</dependency>
<!--log4j2场景启动器-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
springboot 自带的log依赖
1.springboot底层也是使用了slf4j+logback的方式进行日志记录:
a.logback桥接器:logback-classic(核心实现是logback-core)
2.springboot也把其他的日志都替换成了slf4j:
a.log4j适配器:log4j-over-slf4j
b.jul适配器jul-to-slf4j
日志展示级别(默认为info):trace<debug<info<warn<error<fatal
日志输出信息:
下图对应的是日期,日志级别,进行id,分离器"—",线程名称,记录日志的类,日志信息。
可以使用logging.pattern.console来修改日志格式,默认为:
%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}
解释:
%clr {faint}表示使用颜色
${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}如果LOG_DATEFORMAT_PATTERN(可配置)为null,则使用后面的-yyyy-MM-dd HH:mm:ss.SSS,可以通过logging.pattern.dateformat来配置
%d{} logback日期显示方式,{}为显示方式
%5 代表当前内容所占字符长度
p 代表输出日志级别
%{PID:-}springboot占位符+null条件表达式,但是这个是进程id,由系统分配,不能修改
日志输出到文件:
1.logging.file.name:指定文件名字,若没有路径,则输出到项目相对路径。
2.logging.file.path:指定目录,默认用spring.log名称。
logging:
level:
root: info
file:
#name: D:/sr.log
path: D:/
如果要使用更高级的功能,可以写一个log的配置文件,例如logback.xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
<!--定义日志文件的存储地址 勿在 LogBack 的配置中使用相对路径-->
<property name="LOG_HOME" value="D:/" />
<property name="APP_NAME" value="sr" />
<!--appender 追加器 日志以哪种方式进行输出
name 取个名字
class 不同的实现类会输出到不同的地方
ch.qos.logback.core.ConsoleAppender 输出到控制台
-->
<!--控制台日志, 控制台输出 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度,%msg:日志消息,%n是换行符-->
<!--springProfile application.yml中配置spring.profiles.active ,若为dev,则用第一个-->
<springProfile name="dev">
<pattern>%d{yyyy-MM-dd} [%thread] %-5level %logger{50} - %msg%n</pattern>
</springProfile>
<springProfile name="!dev">
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{100} - %msg%n</pattern>
</springProfile>
</encoder>
</appender>
<!--文件日志, 按照每天生成日志文件 -->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<!--日志文件输出的文件名-->
<FileNamePattern>${LOG_HOME}/${APP_NAME}-%d{yyyy-MM-dd}.%i.log</FileNamePattern>
<!--日志文件最大的大小-->
<maxFileSize>5KB</maxFileSize>
<!--日志文件保留天数-->
<MaxHistory>30</MaxHistory>
<!--日志文件总大小,如果超出,会用直接覆盖-->
<totalSizeCap>500MB</totalSizeCap>
</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{100} - %msg%n</pattern>
</encoder>
<!--日志文件最大的大小-->
</appender>
<!-- 控制更细粒度的日志级别, 包/类 -->
<!-- <Logger name="com.example.demo" level="trace"></Logger>-->
<!-- 日志输出级别 -->
<root level="INFO">
<!-- 将当前日志级别输出到哪个追加器上面 -->
<appender-ref ref="STDOUT" />
<appender-ref ref="FILE" />
</root>
</configuration>
存储结果图如下:
还可以异步输出日志:
<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true">
<!--日志格式-->
<property name="pattern" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %t %X{traceId} [%p] %c{0} %m %n"/>
<!--控制台输出-->
<appender name="Console" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>${pattern}</pattern>
</encoder>
</appender>
<!--文本输出-->
<appender name="FileAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
<File>/var/log/ejlerp/dts-item.log</File>
<encoder>
<pattern>${pattern}</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>/var/log/ejlerp/dts-item.log%d{yyyy-MM-dd}.%i.log</fileNamePattern>
<maxHistory>15</maxHistory>
<maxFileSize>2048MB</maxFileSize>
</rollingPolicy>
</appender>
<!-- 日志文件异步输出 -->
<appender name="ASYNC_FILE" class="ch.qos.logback.classic.AsyncAppender">
<!-- 队列的最大容量,该值会影响性能.默认值为256 -->
<queueSize>2048</queueSize>
<!-- 队列剩余容量小于discardingThreshold,则会丢弃TRACT、DEBUG、INFO级别的日志;默认值-1,为queueSize的20%;0不丢失日志 -->
<discardingThreshold>0</discardingThreshold>
<!--是否提取调用者数据-->
<includeCallerData>false</includeCallerData>
<!--如果为false(默认值),则追加程序将阻止追加到完整队列,而不是丢失消息。
设置为true时,附加程序只会丢弃消息,不会阻止您的应用程序-->
<neverBlock>true</neverBlock>
<!-- 添加附加的appender,最多只能添加一个 -->
<appender-ref ref="FileAppender"/>
</appender>
<root level="INFO">
<appender-ref ref="Console" />
<appender-ref ref="ASYNC_FILE" />
</root>
</configuration>
写日志的方式:
1.日志记录器
Logger logger = LoggerFactory.getLogger(类名.class)
2.@Slf4j注解(基于Lombok,需要添加依赖和添加插件)
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.20</version>
</dependency>