【JavaEE】Spring Boot 日志
目录
一、日志概述
⽇志主要是为了发现问题, 分析问题, 定位问题的, 但除此之外, ⽇志还有很多⽤途，像监控程序，当程序出现什么问题时，在日志中反应为相对应的日志，然后可以提醒程序猿。日志还可以记录数据，用于分析等等。
二、使用日志
我们先简单看一下一个Spring的日志包含的内容：
2.1 打印日志
我们在程序中打印SpringBoot的日志，我们先要拿到日志对象，在import org.slf4j包下的Logger对象。在从这个包下的静态类日志工厂 LoggerFactor拿到实例 。
privateLogger logger =LoggerFactory.getLogger(LogController.class);在通过Logger类中的info方法打印日志。
packagecom.example.captcha.Controller;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.bind.annotation.RestController;@RequestMapping("/log")@RestControllerpublicclassLogController{privatefinalstaticLoggerLOGGER=LoggerFactory.getLogger(LogController.class);@RequestMapping("/print")publicStringprint(){LOGGER.info("日志");return"日志";}}得到的日志：
2.2 日志框架
在我们使用Logger类的时候，会有很多包。
这几个包的关系如下：
以电视机和遥控器来举例子，日志实现就相当于不同品牌的电视，而日志门面就相当于一个 通用的遥控器。
2.2.1 门面 / 外观 模式
门面模式：
⻔⾯模式（Facade Pattern）⼜称为外观模式, 提供了⼀个统⼀的接⼝, ⽤来访问⼦系统中的⼀群接口. 其主要特征是定义了⼀个⾼层接⼝, 让⼦系统更容易使⽤.
⻔⾯模式主要包含2种⻆⾊:
外观⻆⾊(Facade): 也称⻔⾯⻆⾊，系统对外的统⼀接⼝.
⼦系统⻆⾊(SubSystem): 可以同时有⼀个或多个 SubSystem. 每个 SubSytem都不是⼀个单独的类, ⽽是⼀个类的集合. SubSystem 并不知道 Facade的存在, 对于 SubSystem ⽽⾔, Facade 只是另⼀个客⼾端⽽已(即 Facade 对 SubSystem 透明)
2.3 日志级别
2.3.1 六大分类
⽇志的级别从⾼到低依次为: FATAL、ERROR、WARN、INFO、DEBUG、TRACE
FATAL: 致命信息，表⽰需要⽴即被处理的系统级错误.ERROR: 错误信息, 级别较⾼的错误⽇志信息, 但仍然不影响系统的继续运⾏.WARN: 警告信息, 不影响使⽤, 但需要注意的问题INFO: 普通信息, ⽤于记录应⽤程序正常运⾏时的⼀些信息,例如系统启动完成、请求处理完成等.DEBUG: 调试信息, 需要调试时候的关键信息打印.TRACE: 追踪信息, ⽐DEBUG更细粒度的信息事件(除⾮有特殊⽤意，否则请使⽤DEBUG级别替代)
2.3.2 使用
对于不同级别的日志，SpringBoot的Logger类下面有对应名字的方法（FATAl）除外。
SpringBoot 默认的⽇志框架是Logback, Logback没有 FATAL 级别, 它被映射到 ERROR .出现fatal⽇志，表⽰服务已经出现了某种程度的不可⽤, 需要需要系统管理员紧急介⼊处理. 通常情况下, ⼀个进程⽣命周期中应该最多只有⼀次FATAL记录.
packagecom.example.captcha.Controller;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.bind.annotation.RestController;@RequestMapping("/log")@RestControllerpublicclassLogController{privatefinalstaticLoggerLOGGER=LoggerFactory.getLogger(LogController.class);@RequestMapping("/print")publicStringprint(){//LOGGER.info("日志");LOGGER.trace("trace级别日志");LOGGER.debug("debug级别日志");LOGGER.info("info级别日志");LOGGER.warn("ware级别日志");LOGGER.error("error级别日志");return"日志";}}上诉代码的结果如下：
只会显示info级别及其以上级别的日志，这是因为Spring在默认的配置下是显示info级以上级别日志。
2.4 日志级别配置
我们只需要在配置文件加上：logging.level.目录就可以配置相对应目录下的日志显示级别。
如果我们在配置文件中加上这样的配置信息
logging: level: com: example: captcha:Controller: trace 那么我们打印的日志就会变成下面的这样：
2.5 日志的持久化
日志如果不进行配置，默认⽇志都是输出在控制台上的, 然⽽在线上环境中, 我们需要把⽇志保存下来, 以便出现问题之后追溯问题.把⽇志保存下来就叫持久化。
我们就可以将日志写入文件。
Spring中有以下两个配置项，来配置日志写入的文件。
- logging.file.name配置项，可以包含文件的路径和文件名。
- logging.file.path配置项，只能包含文件路径。
- 当两个配置项同时存在的时候，只有logging.file.name会有作用。
我们进行如下配置：
logging: file: name: logger/log.log path: all 得到如下结果：
2.6 日志文件分割
日志文件分割有以下两个相关的配置项：
- logging.logback. rolling policy.max-file-size配置项，用于配置每个文件的大小。
- logging.logback. rolling policy.file-name-pattern配置项，用于配置每个文件的名字及其格式。
我们写下如下配置：
logging: logback: rolling policy: max-file-size:1KB file-name-pattern: ${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz 结果就如下：
注意事项：
- logging.logback. rolling policy.max-file-size配置项，并不是严格的每个文件都不会超过配置的大小，而是按照必须将当前的日志行写完才分割。
logging.logback. rolling policy.file-name-pattern配置项，默认格式${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz
2.7 日志文件格式
日志文件格式分割有以下两个相关的配置项：
| 配置项 | 说明 |
|---|---|
| logging.pattern.console | 控制台⽇志格式 |
| logging.pattern.file | ⽇志⽂件的⽇志格式 |
配置项说明:
- %clr(表达式){颜⾊}设置输⼊⽇志的颜⾊。支持blue cyan faint green magenta red yellow
- %d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd’T’HH:mm:ss.SSSXXX}} ⽇期和时间–精确到毫秒
- %5p 显⽰⽇志级别ERROR，MARN，INFO，DEBUG，TRACE.
- %t 线程名.
- %c 类的全限定名.
- %M method.
- %L 为⾏号.
- %thread 线程名称.
- %m 或者%msg 显⽰输出消息.
- %n 换⾏符
- %5 若字符⻓度⼩于5，则右边⽤空格填充.
- %-5 若字符⻓度⼩于5，则左边⽤空格填充.
- %.15 若字符⻓度超过15，截去多余字符.
- %15.15 若字符⻓度⼩于15，则右边⽤空格填充.若字符⻓度超过15，截去多余字符
2.8 @Slf4j 简单打印日志
我们可以使用lombok提供的@Slf4j注解来打印日志，这个注解的作用相当于就是sping帮我们创建Logger对象，对象名为log。
例如下面代码：
packagecom.example.captcha.Controller;importlombok.extern.slf4j.Slf4j;importorg.slf4j.Logger;importorg.slf4j.LoggerFactory;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.bind.annotation.RestController;@RequestMapping("/log")@RestController@Slf4jpublicclassLogController{@RequestMapping("/print")publicStringprint(){//LOGGER.info("日志"); log.trace("trace级别日志"); log.debug("debug级别日志"); log.info("info级别日志"); log.warn("ware级别日志"); log.error("error级别日志");return"日志";}}结果如下：
