当前位置 : 主页 > 编程语言 > java >

SpringBoot统一日志管理

来源:互联网 收集:自由互联 发布时间:2023-02-04
Springboot中统一日志管理 一、为什么要用日志? 一般分为两个大类:操作日志和系统日志 **操作日志:**用户在操作软件时记录下来的操作步骤,便于用户自己查看。主要针对的是用户

Springboot中统一日志管理

一、为什么要用日志?

一般分为两个大类:操作日志和系统日志

**操作日志:**用户在操作软件时记录下来的操作步骤,便于用户自己查看。主要针对的是用户。

**系统日志:**系统日志是记录系统中硬件、软件和系统问题的信息,同时还可以监视系统中发生的事件。用户可以通过它来检查错误发生的原因,或者寻找受到gongji时gongji者留下的痕迹。系统日志包括系统日志、应用程序日志和安全日志。主要针对的是软件开发人员(包括测试、维护人员)。

日志的作用:

日志是系统运行的“照妖镜”,通过它能够实时反映系统的运行状态;

良好的日志便于后期运维和开发人员迅速定位线上问题,加快止损速度,减少系统故障带来的损失;

日志能够无缝与监控系统结合,通过监控系统进行日志采集,拿到系统运行的相关性能指标,有利于分析系统的性能瓶颈、提前规避风险;

便于统计与业务相关的指标数据,进行相关业务分析和功能优化.

二、日志级别

使用日志级别的好处在于,调整级别,就可以屏蔽掉很多调试相关的日志输出。不同的日志框架定义的日志级别不太一样,不过也都大同小异。

ALL 最低等级的,用于打开所有日志记录。

TRACE 很低的日志级别,一般不会使用。

DEBUG 指出细粒度信息事件对调试应用程序是非常有帮助的,主要用于开发过程中打印一些运行信息。比如函数里的输入输出。

INFO 消息在粗粒度级别上突出强调应用程序的运行过程。打印一些你感兴趣的或者重要的信息,这个可以用于生产环境中输出程序运行的一些重要信息,但是不能滥用,避免打印过多的日志。

WARN 表明会出现潜在错误的情形,有些信息不是错误信息,但是也要给程序员的一些提示。

ERROR 指出虽然发生错误事件,但仍然不影响系统的继续运行。打印错误和异常信息,如果不想输出太多的日志,可以使用这个级别。

FATAL 指出每个严重的错误事件将会导致应用程序的退出。这个级别比较高了。重大错误,这种级别你可以直接停止程序了。

OFF 最高等级的,用于关闭所有日志记录。

如果将log level设置在某一个级别上,在你的系统中如果开启了某一级别的日志后,就不会打印比它级别低的日志,只打印比此级别优先级高的log。例如,如果设置优先级为WARN,那么OFF、FATAL、ERROR、WARN 4个级别的log能正常输出,而INFO、DEBUG、TRACE、 ALL级别的log则会被忽略。Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。

三、什么时候打印什么级别的日志

我们之前讲Mybatis时也打印过日志,比如打印一下sql,但现在看来只是打印Sql是不够的,那么我们应该在哪些地方打印,打印哪些东西,打印什么级别的呢?

3.1 在哪些地方需要打印日志?

1、调用第三方接口时会打印日志,比如具体的Request和Response2、状态变化3、重要方法的输入和输出4、业务异常5、非预期执行(比如删除一条数据,可能成功可能数据本身不存在)6、很少出现的else情况7、程序运行时间8、大批量数据的执行进度

3.2 打印哪些内容?

打印的内容一定要从实际出发。也就是说如果在实际的生产环境中,你的用户量很大,日志在不停地刷新,如何定位某个用户的整个登录以及后续的操作呢?当然就是根据用户名来跟踪。所以打印内容的第一要素就是要能便于定位;定位过后也许用户在好几个模板中进行操作,还是定位,这个时候定的是模块的位;还有一点当然就是用户操作时的具体参数;最后一点就是用户干了什么。

总结就是,[id, module, params, content](关键字,模块,参数,内容)。

比如:

log.error("{}|ReqId={}|ID={}|业务执行异常|参数={}|e={}",EVENT_NAME, ReqId, ID, param, e.toString(), e);log.debug("开始获取员工[{}] [{}]年基本薪资",employee,year);

3.3 打印什么级别?

ERROR级别:

影响到程序正常运行、当前请求正常运行的异常情况:

  • 打开配置文件失败
  • 所有第三方对接的异常(包括第三方返回错误码)
  • 所有影响功能使用的异常,包括:SQLException和除了业务异常之外的所有异常(RuntimeException和Exception)
  • 如果进行了抛出异常操作,请不要记录error日志,由异常最终处理方进行处理,比如:

    try{ ....}catch(Exception ex){ logger.error(....); //不要在这里加error日志 ,应该在处理这个异常的类中加 throw new UserServiceException(errorMessage,ex);}

    WARN级别

    不应该出现但是不影响程序、当前请求正常运行的异常情况:

  • 有容错机制的时候出现的错误情况
  • 找不到配置文件,但是系统能自动创建配置文件
  • 即将接近临界值的时候,例如:缓存池占用达到警告线,业务异常的记录等
  • INFO级别

    系统运行信息和调用第三方接口信息

  • Service方法中对于系统/业务状态的变更
  • 主要逻辑中的分步骤
  • 客户端请求参数(REST/WS)
  • 调用第三方时的调用参数和调用结果
  • DEBUG级别

  • 可以填写所有的想知道的相关信息(但不代表可以随便写,debug信息要有意义,最好有相关参数)
  • 生产环境需要关闭DEBUG信息
  • 如果在生产情况下需要开启DEBUG,需要使用开关进行管理,不能一直开启。
  • 四、Java日志框架体系

    Java 中的日志框架主要分为两大类:日志门面和日志实现。

    日志门面

    日志门面定义了一组日志的接口规范,它并不提供底层具体的实现逻辑。Apache Commons Logging 和 Slf4j 就属于这一类。

    日志实现

    日志实现则是日志具体的实现,包括日志级别控制、日志打印格式、日志输出形式(输出到数据库、输出到文件、输出到控制台等)。Log4j、Log4j2、Logback 以及 Java Util Logging 则属于这一类。

    如图所示:

    SpringBoot统一日志管理_配置文件

    我们使用的时候一般是 ,一个"门面"搭配一个实现层使用。

    比如:Slf4j +Log4j

    Slf4j +Logback 。

    五 、SpringBoot中如何统一日志管理

    spring boot默认使用​​slf4j+logback​​作为日志框架。

    5.1 怎么导入Logback框架

    在 Spring Boot 项目中,只要添加了 web 依赖,日志依赖就自动添加进来了:

    <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId></dependency>

    并且可以在需要的位置通过下面方式来打印日志:

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

    SpringBoot统一日志管理_xml_02

    默认日志是输出在控制台的

    SpringBoot统一日志管理_配置文件_03

    5.2 application.properties中配置日志管理

    如果无需复杂的日志配置,执行简单设置日志打印级别,打印方式可直接再 application.properties中配置。

    1.设置日志打印级别

    #root表示整个项目logging.level.root=info #表示web层logging.level.org.springframework.web=debug#表示持久层logging.level.org.hibernate=error#表示具体某个包logging.level.com.test.util=debug

    2.设置日志输出到文件中

    #输出在根目录下的daimenglaoshi.loglogging.file.name=daimenglaoshi.log#输出在根目录下aaa文件夹下的daimenglaoshi.loglogging.file.name=aaa/daimenglaoshi.log

    3.如果想对输出到文件中的日志进行精细化管理,还有如下一些属性可以配置

    #日志归档的文件名,日志文件达到一定大小之后,自动进行压缩归档。logging.logback.rollingpolicy.file-name-pattern:#是否在应用启动时进行归档管理。logging.logback.rollingpolicy.clean-history-on-start:#日志文件设置上限,达到该上限后,会自动压缩logging.logback.rollingpolicy.max-file-size:#日志文件被删除之前,可以容纳的最大大小。logging.logback.rollingpolicy.total-size-cap:#日志文件保存的天数。logging.logback.rollingpolicy.max-history:

    但这些配置在Logback 配置文件中配置更方便

    5.3 Logback 配置文件中配置日志管理

    在 application.properties 中只能实现对日志一些非常简单的配置,如果想实现更加细粒度的日志配置,那就需要使用日志实现的原生配置,例如 Logback 的 classpath:logback.xml,Log4j 的 classpath:log4j.xml 等。

    使用 xml 后要将 application.properties 中的配置去掉,避免冲突.

    1.配置文件如何导入

    根据不同的日志系统,按照指定的规则组织配置文件名,并放在 resources 目录下,就能自动被 spring boot 加载:

    Logback:logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovyLog4j: log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xmlLog4j2: log4j2-spring.xml, log4j2.xmlJDK (Java Util Logging): logging.properties

    想要自定义文件名的可配置:​​logging.config​​指定配置文件名:

    logging.config=classpath:logging-config.xml

    2.logback 配置文件的组成

    根节点​​<configuration>​​有 5 个子节点,下面来进行一一介绍。

    root节点

    root 节点是必选节点,用来指定最基础的日志输出级别,只有一个 level 属性,用于设置打印级别,可选如下:​​TRACE​​,​​DEBUG​​,​​INFO​​,​​WARN​​,​​ERROR​​,​​ALL​​,​​OFF​​。

    root 节点可以包含 0 个或多个元素,将​​appender​​添加进来。如下:

    <root level="debug"> <appender-ref ref="console" /> <appender-ref ref="file" /></root>

    appender 也是子节点之一,将会在后面说明。

    contextName节点

    设置上下文名称,默认为​​default​​,可通过​​%contextName​​来打印上下文名称,一般不使用此属性。

    property节点

    用于定义变量,方便使用。有两个属性:name,value。定义变量后,可以使用​​${}​​来使用变量。如下:

    <property name="path" value="./log"/><property name="appname" value="app"/>
    appender节点

    appender 用来格式化日志输出的节点,这个最重要。有两个属性:

    • name:该 appender 命名
    • class:指定输出策略,通常有两种:控制台输出,文件输出

    下面通过例子来说明这个怎么用:

  • 输出到控制台/按时间输出日志
  • <?xml version="1.0" encoding="UTF-8"?><configuration debug="false"> <!--设置存储路径变量--> <property name="LOG_HOME" value="./aaa"/> <!--控制台输出appender--> <appender name="console" class="ch.qos.logback.core.ConsoleAppender"> <!--设置输出格式--> <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{50} - %msg%n</pattern> <!--设置编码--> <charset>UTF-8</charset> </encoder> </appender> <!--文件输出,时间窗口滚动--> <appender name="timeFileOutput" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!--日志名,指定最新的文件名,其他文件名使用FileNamePattern --> <File>${LOG_HOME}/daimenglaoshi.log</File> <!--文件滚动模式--> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!--日志文件输出的文件名,可设置文件类型为gz,开启文件压缩--> <FileNamePattern>${LOG_HOME}/info.%d{yyyy-MM-dd}.%i.log.gz</FileNamePattern> <!--日志文件保留天数--> <MaxHistory>30</MaxHistory> <!--按大小分割同一天的--> <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP"> <maxFileSize>10MB</maxFileSize> </timeBasedFileNamingAndTriggeringPolicy> </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{50} - %msg%n</pattern> <!--设置编码--> <charset>UTF-8</charset> </encoder> </appender> <!--指定基础的日志输出级别--> <root level="INFO"> <!--appender将会添加到这个loger--> <appender-ref ref="console"/> <appender-ref ref="timeFileOutput"/> </root></configuration>

    SpringBoot统一日志管理_配置文件_04

  • 设置只输出单个级别
  • 在 appender 中设置,filter 子节点,在默认级别上再此过滤,配置 onMatch,onMismatch 可实现只输出单个级别

    <appender ...> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <level>INFO</level> <!--接受匹配--> <onMatch>ACCEPT</onMatch> <!--拒绝不匹配的--> <onMismatch>DENY</onMismatch> </filter></appender>
    logger节点

    此节点用来设置一个包或具体的某一个类的日志打印级别、以及指定​​<appender>​​,有以下三个属性:

    • name: 必须。用来指定受此 loger 约束的某个包或者某个具体的类
    • level:可选。设置打印级别。默认为 root 的级别。
    • addtivity: 可选。是否向上级 loger(也就是 root 节点)传递打印信息。默认为 true。

    使用示例如下:

  • 不指定级别,不指定 appender
  • <!-- 控制com.example.service下类的打印,使用root的level和appender --><logger name="com.test.service"/>

    2.指定级别,不指定 appender

    <!-- 控制com.example.service下类的打印,使用root的appender打印warn级别日志 --><logger name="com.test.service" level="WARN"/>

    3.指定级别,指定 appender

    <!-- 控制com.example.service下类的打印,使用console打印warn级别日志 --><!-- 设置addtivity是因为这里已经指定了appender,如果再向上传递就会被root下的appender再次打印 --><logger name="com.test.service" level="WARN" addtivity="false"> <appender-ref ref="console"></logger>

    通过指定 appender 就能将指定的包下的日志打印到指定的文件中。

    多环境日志输出

    通过设置文件名为-spring 结尾,可分环境配置 logger,示例如下:

    <configuration> <!-- 测试环境+开发环境. 多个使用逗号隔开. --> <springProfile name="test,dev"> <logger name="com.example.demo.controller" level="DEBUG" additivity="false"> <appender-ref ref="console"/> </logger> </springProfile> <!-- 生产环境. --> <springProfile name="prod"> <logger name="com.example.demo" level="INFO" additivity="false"> <appender-ref ref="timeFileOutput"/> </logger> </springProfile></configuration>
    上一篇:RocketMQ各种消息的生产与消费Demo
    下一篇:没有了
    网友评论