我们在进行项目开发时,无论是前端还是后端,都必须进行日志的记录。通过日志,来记录项目开发、运行时产生的各种异常信息和重要数据。这样我们才能对项目的异常进行定位,对项目的后期运营提供数据支撑。
但我们该如何进行日志记录呢?又有哪些手段可以实现日志功能呢?请跟着壹哥今天的这篇教程,来学习项目中的日志记录功能吧。
我们在项目开发中经常需要打印日志,输出一些调试信息,对于简单的小案例,可能就直接使用Java自带的System.out.println语句进行输出就可以了。那有的朋友可能会问,既然已经有这样的输出语句了,为什么Java中还有大量的专业日志框架呢?
我们可以仔细想想,如果项目非常大,很多地方都需要打印日志,这样就会带来一个非常麻烦的问题:
这样不是太麻烦吗?
Log4J是Apache的一个开源项目,通过使用Log4J,我们可以控制日志信息是输送到控制台还是文本文件等我们期望输出到的地方,另外我们也可以控制每一条日志的输出格式。并且可以通过定义每一条日志信息的级别,能够更加细致地控制日志的生成过程。
我们可以通过一个配置文件来灵活地进行上面的配置,而不需要修改应用的代码。Log4J作为前几年比较流行的日志框架,给我们应用开发和维护带来了很大的便捷。
但是现在log4j已经逐渐被Logback取代了,因为Logback相对log4j更具优势。
那Sl4J又是什么呢?
即面向Java的简单日志门面框架。简答讲slf4j是一系列的日志接口,slf4j是作为一个抽象的日志框架,但是并没有提供真正的实现。slf4j为各种日志框架提供了一个统一的入口,使用户可以用统一的接口来输出日志,动态地决定要使用的具体的实现框架,比如Logback,Log4j,common-logging等框架都实现了这些接口。
在SpringBoot内部中,默认就集成了LogBack的日志依赖,所以我们其实在实际开发中不需要直接添加该依赖。
你会发现spring-boot-starter其中包含了 spring-boot-starter-logging,Spring Boot为我们提供了很多默认的日志配置,所以,只要将spring-boot-starter-logging作为依赖加入到当前应用的classpath,则“开箱即用”。
SpringBoot默认使用LogBack来记录日志信息,默认根据base.xml中的配置内容来输出到控制台和文件之中。
我们可以通过查看spring-boot-starter-parent依赖关系:
spring-boot-starter-parent的父级依赖。
再查看上级依赖包,会发现一个关于logging的依赖包:
再往上查看,会发现内部自带的日志依赖包。
在SpringBoot中整合日志其实非常简单,过程如下。
我们按照之前的经验,创建一个web程序,并将之改造成Spring Boot项目,具体过程略。
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-starter-test
test
org.projectlombok
lombok
复制代码
日志级别从低到高分为:
TRACE < DEBUG < INFO < WARN < ERROR < FATAL
SpringBoot的日志是根据level来控制的,根据不同的level来显示不同的日志内容。那么在哪里控制日志level呢?一般我们要在resources目录下配置spring-logback.xml文件来控制,如果我们什么配置都没写,那么Springboot会采用默认的配置。
这里就是Springboot对logback配置的地方,base.xml里,可以看到root level=INFO,这个代表该项目默认是输出最低为info级别的日志。然后看到有两个append-ref,分别为console何file,这两个分别对应上面引用的两个include resource里的xml,每个名字对应一个处理类。
ConsoleAppender和FixedWindowRollingPolicy都是logback提供的两个Appender处理类,Appender类代表了对日志的处理方法,这个可以自定义。系统提供了很多个Appender,基本满足了大部分场景的需求,像Console就是输出到控制台的,System.out.print之类的,而File的就是输出到日志文件的。
魔力小佳佳
//xxxx
//xxxx
//xxxx
复制代码
这个文件在springboot中默认叫做logback-spring.xml,我们只要新建一个同名文件放在resources下面,配置即可生效。
每个logger都关联到logger上下文,默认上下文名称为“default”。但可以使用contextName标签设置成其他名字,用于区分不同应用程序的记录。
用来定义变量值的标签,property标签有两个属性,name和value;其中name的值是变量的名称,value的值时变量定义的值。通过property定义的值会被插入到logger上下文中。定义变量后,可以使“${name}”来使用变量。如上面的xml所示。
用来设置某一个包或者具体的某一个类的日志打印级别以及指定appender。
根logger,也是一种logger,且只有一个level属性。
负责日志的组件。
filter其实是appender里的子元素,它作为过滤器存在,执行一个过滤器会有返回DENY,NEUTRAL,ACCEPT三个枚举值中的一个。
INFO
复制代码
INFO
ACCEPT
DENY
复制代码
我们可以在resource目录下创建一个命名为logback-spring.xml的配置文件。
<?xml version="1.0" encoding="UTF-8"?>
logback
debug
${CONSOLE_LOG_PATTERN}
UTF-8
${log.path}/log_debug.log
%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n
UTF-8
${log.path}/debug/log-debug-%d{yyyy-MM-dd}.%i.log
100MB
15
debug
ACCEPT
DENY
${log.path}/log_info.log
%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n
UTF-8
${log.path}/info/log-info-%d{yyyy-MM-dd}.%i.log
100MB
15
info
ACCEPT
DENY
${log.path}/log_warn.log
%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n
UTF-8
${log.path}/warn/log-warn-%d{yyyy-MM-dd}.%i.log
100MB
15
warn
ACCEPT
DENY
${log.path}/log_error.log
%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n
UTF-8
${log.path}/error/log-error-%d{yyyy-MM-dd}.%i.log
100MB
15
ERROR
ACCEPT
DENY
复制代码
root节点是必选节点,用来指定最基础的日志输出级别,只有一个level属性,不区分大小写,默认是DEBUG。
上图的节点好比一个方法,这个方法的意思是全局打印等级为INFO,而且四个变量都执行,即正常的控制台输出和warn、info、error的三个文件输出,可以到对应的控制台和日志文件里面看到的确有日志。
反之倘若我们level定为Debug,或者去除name为“WARN”的则是输出Debug以上等级的日志,WARN.log日志文件也不会再有日志打印进去。
我们可以在类上添加Lombok插件中的@Slf4j注解,在需要打印的类名上加上该注解即可,用来替代下面语句的编写:
private Loggerlogger = LoggerFactory.getLogger(this.getClass());
复制代码
日志类:
package com.yyg.boot.web;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* @Author 一一哥Sun
* @Date Created in 2020/5/14
* @Description Description
*/
@Slf4j
@RestController
public class LogController {
@GetMapping("/log")
public String showLog(){
log.debug("debug级别的日志信息...");
log.info("info级别的日志信息...");
log.warn("warn级别的日志信息...");
log.error("error级别的日志信息...");
return "ok";
}
}
复制代码
在这个application.yml配置文件中,可以在这里设置log的级别。
server:
port: 8080
spring:
application:
name: log-demo
#设置log级别
logging:
level:
root: debug
#设置存储位置
#path: ./logs
#设置配置文件的名称位置
#config: classpath:/logback-dev.xml
复制代码
package com.yyg.boot;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
* @Author 一一哥Sun
* @Date Created in 2020/5/14
* @Description Description
*/
@SpringBootApplication
public class LogApplication {
public static void main(String[] args){
SpringApplication.run(LogApplication.class,args);
}
}
复制代码
并且在我们的磁盘中也可以看到输出了日志文件。
如果我们在项目中需要屏蔽某个或者多个包中不需要输出日志的类,那么我们可以修改application.yml添加对应配置:
Log2Controller类内容如下:
可以看到此时控制台没有对应的日志信息输出。
我们开发中会有不同的环境,我们可以根据不同的环境(prod:生产环境,test:测试环境,dev:开发环境)来定义不同的日志输出,可以在logback-spring.xml中使用 springProfile节点来定义,方法如下:
我们可以在启动服务的时候通过指定 profile(如不指定使用默认),如指定prod 的方式为:
java -jar xxx.jar –spring.profiles.active=dev
复制代码
来加载不同环境下的日志配置。
另外在application.yml配置文件中,也有对应的profiles.active属性来控制。
至此,我们就实现了多环境下的日志记录功能,你有没有搞明白今天的内容呢?请给壹哥留言,说说你今天的收获吧。
页面更新:2024-05-02
本站资料均由网友自行发布提供,仅用于学习交流。如有版权问题,请与我联系,QQ:4156828
© CopyRight 2020-2024 All Rights Reserved. Powered By 71396.com 闽ICP备11008920号-4
闽公网安备35020302034903号