9. Spring Boot 日志文件

本篇文章源码位置延续上个章节：SpringBoot_demo

本篇文章内容源码位于上述地址的com/chenshu/springboot_demo/logging包下

1. 日志的作用

发现和定位问题： 日志是程序的重要组成部分，它在系统、程序出现错误或异常时提供诊断和解决问题的线索，从而定位问题；只有定位到了问题的位置，程序员才可以对症下药，从而解决问题。

除了发现和定位问题，我们还可以通过日志实现其他功能，比如：

  • 记录用户登录日志，用于分析用户是正常登录还是恶意破解登录；
  • 记录系统的操作日志，方便回复数据和定位操作人；

2. Spring Boot 日志概述

其实所谓日志我们也不是第一次接触了，在Spring Boot这个框架中集成了日志框架，我们在启动项目时在console中所打印的信息其实就是日志。

并且每一条日志记录都默认包含了这些信息：日志打印时间、日志打印级别、线程ID、线程名称、打印日志的类名、日志信息

image.png

以上内容就是Spring Boot 输出的控制台日志信息。

通过上述日志信息我们能引出下面几个问题：

  1. Spring Boot是因为内置了日志框架才能打印日志信息的，那么Spring Boot 内置的日志框架是什么呢？
  2. 打印日志是需要开销的，程序在不同的环境需要打印不同级别的日志信息，如何通过日志的级别来筛选所需打印日志的内容呢？
  3. 除了发现和定位问题，我们还想通过日志实现其他功能，那么开发者如何在程序中自定义打印日志呢？
  4. 开发环境中我们可以根据控制台打印的日志信息排查问题，那如果是生产环境总不能24小时盯着控制台信息找问题吧，这时候我们就要讲日志信息持久化保存，那么如何将日志信息持久化保存呢？

我们接下来要讲的内容就是针对上述问题。

3. Spring Boot 的内置日志框架【了解】

Spring Boot中内置的日志门面是SLF4J，而具体的日志实现是logback，日志门面是什么？日志实现又是什么？下面给大家简单说说。

3.1 门面模式

门面模式的核心为： 外部与一个子系统的通信必须通过一个统一的外观对象进行，使得子系统更易于使用。

解释： 其实门面模式就相当于给各式各样的实现封装了一层统一的外观，对于用户来说不用关心市面上提供的各种各样的具体实现的api是什么，只需要通过门面所提供的统一的api来使用。

3.2 日志实现

市面上有许多日志实现，如：

  • Java原生的JUL（Java Util Logging）
  • log4j 1/2
  • logback

不同的日志实现，它们的api写法都有所不同，但凡你想去更改一种日志实现，都需要去更改每一处日志代码。

3.3 日志门面(Logging Facade)

为了解决上述问题，引入了日志门面，而SLF4j就是一种日志门面，通过SLF4J，我们可以随意换另外一个日志框架，应用程序不需要修改任意一行代码，就可以直接上线。

门面模式下的用户视角图示：

Untitled Diagram.drawio-4.png

4. 自定义日志打印

自定义打印日志的步骤大概分为下面两步：

  • 在程序中得到日志对象；
  • 使用日志相关语法输出要打印的内容；

4.1 得到日志对象

由于Spring Boot中内置的是slf4j的框架，这里我们要选择用org.slf4j包下的Logger接口：

image.png

使用LoggerFactory中的getLogger()方法，需要传一个参数来指定打印日志的类：

private static Logger log = LoggerFactory.getLogger(TestController.class);

4.2 通过日志对象打印信息

在LoggingController里创建一个日志的测试方法，通过日志对象来调用方法，方法名称代表了日志级别，日志级别及使用会在后面说到。

image.png

这里我们使用info方法来测试：

@RestController
public class LoggingController {private static Logger log = LoggerFactory.getLogger(LoggingController.class);@RequestMapping("loggingtest1")public void loggingTest1() {log.info("This is my first Spring Boot Log.");}
}

成功打印出下面日志信息：

2024-04-07 21:23:34.681  INFO 14515 --- [nio-8001-exec-1] c.c.s.config.controller.TestController   : This is my first Spring Boot Log.

5. 日志持久化

a) 通过日志的保存名称持久化

在application.yml中通过配置日志的名称完成持久化：

# 日志的保存名称
logging:file:name: logging_demo.log

只设置名称会将日志默认保存在工作目录下：

image.png

点开查看一下：

image.png

还可以设置在指定路径下：

logging:file:name: /Users/chenshu/Documents/logging/logging_demo.log

b) 通过日志的保存目录持久化

在application.yml中通过配置日志的名称完成持久化：

# 日志的保存路径
logging:file:path: /Users/chenshu/Documents/logging

这样的设置会将日志保存在指定的路径下：

image.png

特性：

  1. 日志不会随着项目重新启动而去覆盖，会一直追加
  2. 当日志比较大的时候，会自动分割成多个文件，名称为原文件名+日期+.gz

6. 日志级别

不同的开发环境需要不同的日志级别

  • 测试环境下，我们不怎么考虑系统的开销，而是想要看到更多的日志信息，这时候我们就可以用开销来换取更多日志信息；
  • 开发环境下，我们也不怎么需要考虑系统的开销，但又想过滤掉一些不怎么需要的信息，以免影响查看日志；
  • 生产环境下，产品是要交付给用户进行使用的，使用的时候需要更多的考虑系统的开销，这时我们就可以只筛选一些重要的日志信息来节省开销；

6.1 六种日志级别

日志级别从低到高分别为：trace、debug、info、warn、error、fatal

  • trace: 追溯的意思，级别最低；
  • debug：需要调试时候的关键信息打印；
  • info：普通的打印信息（默认级别）；
  • warn：警告，不影响程序运行，但需要注意的问题；
  • error：错误信息，级别较高的错误日志信息；
  • fatal：致命的，因为代码异常导致程序退出执行的事件；

由于fatal只会打印代码异常导致程序退出执行的事件，所以Logger对象提供了除了fatal事件的对应api：

@RequestMapping("loggingtest2")
public void loggingTest2() {//追溯log.trace("log level: trace");//调试log.debug("log level: debug");//信息log.info("log level: info");//警告log.warn("log level: warn");//错误log.error("log level: error");
}

访问对应路由后，发现控制台只打印了info、warn、error的日志：

2024-04-07 23:22:21.124  INFO 14925 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: info
2024-04-07 23:22:21.124  WARN 14925 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: warn
2024-04-07 23:22:21.124 ERROR 14925 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: error

这是因为Spring Boot的日志级别默认是info，因此只会显示trace及以上的信息，接下来我来演示一下如何在不同环境的配置文件中设置不同的日志默认级别。

6.2 设置日志级别

日志级别的配置只需要在配置文件中设置"logging.level"配置项即可，我在前面配置的基础上进行修改：

logging:file:path: /Users/chenshu/Documents/logginglevel:root: debug

上面的root表示的是根路径，也就是所有信息的级别都为debug

重新访问路由方法后，打印了下面信息，证明我们确实把默认级别设置为debug：

2024-04-07 23:56:38.246 DEBUG 15035 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: debug
2024-04-07 23:56:38.246  INFO 15035 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: info
2024-04-07 23:56:38.246  WARN 15035 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: warn
2024-04-07 23:56:38.246 ERROR 15035 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: error

上面那样配置会打印所有类中的debug及以上级别的日志信息，看起来非常眼花缭乱：

image.png

更精细化的日志级别设置

除了root根路径级别的设置，我们还可以精细化到自己的某个包中的级别，像下面这样，将com/chenshu/springboot_demo包下的类级别设置为debug，其他的类中的信息全都设置为warn：

logging:file:path: /Users/chenshu/Documents/logginglevel:root: debugcom:chenshu:springboot_demo: warn

这样的一番操作，相当于给com/chenshu/springboot_demo包下的类开了一个白名单，原先的一堆系统的日志信息都被过滤掉了，只剩下了我需要的重要日志信息：

2024-04-08 00:07:01.232  INFO 15095 --- [           main] c.c.s.SpringBootDemoApplication          : Starting SpringBootDemoApplication using Java 1.8.0_381 on chenshudeAir with PID 15095 (/Users/chenshu/Code/classcode_java/blog-demo/SpringBoot_demo/target/classes started by chenshu in /Users/chenshu/Code/classcode_java/blog-demo/SpringBoot_demo)
2024-04-08 00:07:01.234 DEBUG 15095 --- [           main] c.c.s.SpringBootDemoApplication          : Running with Spring Boot v2.7.6, Spring v5.3.24
2024-04-08 00:07:01.234  INFO 15095 --- [           main] c.c.s.SpringBootDemoApplication          : The following 1 profile is active: "dev"
2024-04-08 00:07:02.264  INFO 15095 --- [           main] c.c.s.SpringBootDemoApplication          : Started SpringBootDemoApplication in 1.353 seconds (JVM running for 1.892)
2024-04-08 00:07:23.780 DEBUG 15095 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: debug
2024-04-08 00:07:23.780  INFO 15095 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: info
2024-04-08 00:07:23.780  WARN 15095 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: warn
2024-04-08 00:07:23.780 ERROR 15095 --- [nio-8001-exec-1] c.c.s.logging.LoggingController          : log level: error

6.3 不同生产环境的日志级别设置

对多环境配置文件设置不熟悉的小伙伴可以点击这里：多环境的配置文件设置

需求：将测试环境、开发环境、生产环境的日志分别存储在同一个目录下但命名不同的三个文件中，并且设置测试环境中的日志级别为trace、开发环境中为debug、生产环境中为warn

application-test.yml:

logging:file:name: /Users/chenshu/Documents/logging/prod_logging.loglevel:root: warn

application-dev.yml:

logging:file:name: /Users/chenshu/Documents/logging/dev_logging.loglevel:root: debug

application-prod.yml:

logging:file:name: /Users/chenshu/Documents/logging/prod_logging.loglevel:root: warn

在上述三个环境的配置文件中添加了日志打印级别以及持久化路径后，在主配置文件application.yml中分别设置spring.profiles.active为test、dev、prod，并启动项目。

application.yml:

# 运行环境设置
spring:profiles:active: test

分别运行后发现，指定路径确实出现了三个日志文件，并且由于test环境中的日志级别最低，因此文件最大；其次是dev环境；由于没有打印warn级别以上的日志信息，因此prod环境的日志为0bytes

image.png

7. 更简单的得到日志对象 —— lombok

7.1 通过lombok得到日志对象

上一篇文章提到过lombok的作用是利用注解来省略Java中冗余的代码，先前我们就使用过了@Data注解省略model对象的getter()、setter()、toString()等方法，此处我们也可以通过lombok更简单地得到日志对象

在启动项目前我就已经添加了lombok框架的依赖：

<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional>
</dependency>

导入相应的注解import lombok.extern.slf4j.Slf4j，在需要使用日志对象的类上添加@Slf4j的注解：

@RestController
@Slf4j
public class LoggingController {

添加此注解后，就相当于在类中添加了下面的代码（同4.1）：

private static Logger log = LoggerFactory.getLogger(TestController.class);

在需要使用日志对象的时候，直接使用名为log的对象即可：

@RestController
@Slf4j
public class LoggingController {//private static Logger log = LoggerFactory.getLogger(LoggingController.class);@RequestMapping("loggingtest1")public void loggingTest1() {log.info("This is my first Spring Boot Log.");}@RequestMapping("loggingtest2")public void loggingTest2() {//追溯log.trace("log level: trace");//调试log.debug("log level: debug");//信息log.info("log level: info");//警告log.warn("log level: warn");//错误log.error("log level: error");}
}

7.2 lombok 原理解释

项目的target目录下的classes文件夹中存放了类编译后的字节码文件，找到相应目录下的字节码文件：SpringBoot_demo/target/classes/com/chenshu/springboot_demo/logging/LoggingController.class

image.png

把它拉到IDEA中打开查看字节码文件，发现直接把@Lombok注解转化为private static final Logger log = LoggerFactory.getLogger(LoggingController.class);：

@RestController
public class LoggingController {private static final Logger log = LoggerFactory.getLogger(LoggingController.class);public LoggingController() {}@RequestMapping({"loggingtest1"})public void loggingTest1() {log.info("This is my first Spring Boot Log.");}@RequestMapping({"loggingtest2"})public void loggingTest2() {log.trace("log level: trace");log.debug("log level: debug");log.info("log level: info");log.warn("log level: warn");log.error("log level: error");}
}

也就是说lombok的注解是在编译之前转化为java代码，然后被编译为.class字节码文件：

Untitled Diagram.drawio.png

7.3 lombok 更多注解说明

注解作用
@Getter修饰类，自动添加 getter 方法
@Setter修饰类，自动添加 setter 方法
@ToString修饰类，自动添加 toString 方法
@EqualAndHashCode修饰类，自动添加 equals 和 hashcode 方法
@NoArgsConstructor修饰类，自动添加无参构造方法
@AllArgsConstructor修饰类，自动添加全属性构造方法，顺序按照属性定义的顺序
@NonNull修饰属性，属性不能为NULL
@RequiredArgsConstructor修饰类，自动添加所有final或@NonNull修饰过的属性作为参数的构造方法
@Data@Getter、@Setter、@ToString、@EqualsAndHashCode 和 @RequiredArgsConstructor 注解的组合

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/621055.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

【热门话题】PyTorch：深度学习领域的强大工具

【热门话题】PyTorch：深度学习领域的强大工具

&#x1f308;个人主页: 鑫宝Code &#x1f525;热门专栏: 闲话杂谈&#xff5c; 炫酷HTML | JavaScript基础 ​&#x1f4ab;个人格言: "如无必要&#xff0c;勿增实体" 文章目录 PyTorch&#xff1a;深度学习领域的强大工具一、PyTorch概述二、PyTorch核心特性…
阅读更多...
Linux：zabbix配置网易邮箱告警（5）

Linux：zabbix配置网易邮箱告警（5）

1.开启邮箱的smtp服务 这里我使用网易邮箱&#xff0c;我需要先去开启邮箱的POP3/IMAP/SMTP/Exchange/CardDAV 服务 点击POP3/SMTP/IMAP 然后在这里开启两个服务 我这个已经去扫码添加过了&#xff0c;你点击新加授权码再去扫码发送信息&#xff0c;就可以得到一个授权密码 2.…
阅读更多...
Vue2 基础学习-案例实践

Vue2 基础学习-案例实践

数据管理信息的增删改查的实践 主要应用&#xff1a; 数据插值&#xff1a; {{xxx}}双向绑定&#xff1a;v-model点击事件函数&#xff1a;click列表xxx的增删改实现 xxx.push(row) 增加xxx.splice(id,1) 删除 一行{x,y} xxx[id]; 编辑 <!DOCTYPE html> <html la…
阅读更多...
关于AG32 MCU的一些奇思妙想

关于AG32 MCU的一些奇思妙想

1、AG32VF103的网口是100M还是10M&#xff1f; RE: 都是100M的。 2、用FPGA能不能再仿出一个网口&#xff1f;有些产品用到两个网口。 理论上可以&#xff0c;但是要考虑&#xff0c;一个是cpld实现难度&#xff0c;一个是需要的逻辑单元。因为mac逻辑多&#xff0c;内置的2KL…
阅读更多...
JavaEE企业开发新技术5

JavaEE企业开发新技术5

目录 2.18 综合应用-1 2.19 综合应用-2 2.20 综合应用-3 2.21 综合应用-4 2.22 综合应用-5 Synchronized &#xff1a; 2.18 综合应用-1 反射的高级应用 DAO开发中&#xff0c;实体类对应DAO的实现类中有很多方法的代码具有高度相似性&#xff0c;为了提供代码的复用性,降低…
阅读更多...
链表基础3——单链表的逆置

链表基础3——单链表的逆置

链表的定义 #include <stdio.h> #include <stdlib.h> typedef struct Node { int data; struct Node* next; } Node; Node* createNode(int data) { Node* newNode (Node*)malloc(sizeof(Node)); if (!newNode) { return NULL; } newNode->data …
阅读更多...
（弟弟14）递归•按顺序打印一个整数的每一位

（弟弟14）递归•按顺序打印一个整数的每一位

这里是目录哦 题目代码运行截图递归思路递归停止条件如何实现“按顺序”悟了✨加油&#x1f389; 题目 按顺序打印一个整数的每一位。 代码 #include<stdio.h> void Print(int n) {if (n > 9)//递归停止条件{Print(n / 10);//不断趋近递归停止条件}printf("%d…
阅读更多...
游戏实践：扫雷

游戏实践：扫雷

一.游戏介绍 虽然很多人玩过这个游戏&#xff0c;但还是介绍一下。在下面的格子里&#xff0c;埋的有10颗雷&#xff0c;我们通过鼠标点击的方式&#xff0c;点出你认为不是雷的地方&#xff0c;等到把所有没有雷的格子点完之后&#xff0c;及视为游戏胜利。 上面的数字的意思…
阅读更多...
python爬虫------- Selenium下篇（二十三天）

python爬虫------- Selenium下篇（二十三天）

&#x1f388;&#x1f388;作者主页&#xff1a; 喔的嘛呀&#x1f388;&#x1f388; &#x1f388;&#x1f388;所属专栏&#xff1a;python爬虫学习&#x1f388;&#x1f388; ✨✨谢谢大家捧场&#xff0c;祝屏幕前的小伙伴们每天都有好运相伴左右&#xff0c;一定要天天…
阅读更多...
【爬虫开发】爬虫从0到1全知识md笔记第5篇：Selenium课程概要,selenium的其它使用方法【附代码文档】

【爬虫开发】爬虫从0到1全知识md笔记第5篇：Selenium课程概要,selenium的其它使用方法【附代码文档】

爬虫开发从0到1全知识教程完整教程&#xff08;附代码资料&#xff09;主要内容讲述&#xff1a;爬虫课程概要&#xff0c;爬虫基础爬虫概述,,http协议复习。requests模块&#xff0c;requests模块1. requests模块介绍,2. response响应对象,3. requests模块发送请求,4. request…
阅读更多...
Python开源工具库使用之词云Wordcloud

Python开源工具库使用之词云Wordcloud

文章目录 前言一、基本使用1.1 文本生成词云1.2 配置项 二、进阶用法2.1 自定义形状2.2 自定义着色2.3 自定义词频2.4 中文 三、实际案例3.1 工作报告词云3.2 周杰伦歌词词云 四、总结4.1 优点和局限性4.2 展望未来发展 参考 前言 当我们需要将大量文本数据可视化展示时&#…
阅读更多...
【Entity Framework】你要知道EF中功能序列与值转换

【Entity Framework】你要知道EF中功能序列与值转换

【Entity Framework】你要知道EF中功能序列与值转换 文章目录 【Entity Framework】你要知道EF中功能序列与值转换一、序列1.1 基本用法1.2 配置序列设置 二、值转换2.1 配置值转换器2.2 批量配置值转换器2.3 预定义的转换2.4 ValueConverter类2.5 内置转换器 三、应用3.1 简单…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023