上文讲了 类型安全配置属性

本篇来讲一下 Spring boot 的默认日志相关

Logging

• 🍑 概述
• 🍏 日志格式
• 🍐 控制台输出
• 🥥 文件输出
• 🥝 文件轮换
• 🍒 文件级别

  🍑 概述

  ---

    Spring Boot在所有内部日志中使用Commons Logging，但也保留默认配置对常用日志的支持，如：Java Util Logging，Log4J, Log4J2， SLF4J 和Logback。每种Logger都可以通过配置使用控制台或者文件输出日志内容。默认情况下，如果您使用“Starters”，会使用Logback来实现日志管理。

    Logback是log4j框架的作者开发的新一代日志框架，它效率更高、能够适应诸多的运行环境，同时天然支持SLF4J。

  

     上图明确的告诉了我们Slf4j 就是简单的外观或抽象，它允许最终用户在部署时插入所需的日志框架 。因此，我们没必要纠结使用默认的Logback还是Log4j，直接用Slf4j 即可。至于这个日志具体是如何写到控制台或者文件的，则由Spring Boot项目中引入了什么具体的日志框架决定，默认情况下就是Logback。

  🍏 日志格式

  ---

  

  由上图可知，日志输出的主要元素如下：

  • 日期和时间：毫秒精度且易于排序。
  • 日志级别：ERROR、WARN、INFO、DEBUG、 或TRACE。
  • 进程 ID。
  • 分隔符 --- 用于区分实际日志消息的开始。
  • 线程名称：用方括号括起来（可能会截断控制台输出）。
  • Logger 名称：这通常使用源代码的类名（通常是缩写）。
  • 日志内容。

    🍐 控制台输出

    ---

    日志级别：

      日志级别从低到高分为TRACE < DEBUG < INFO < WARN < ERROR < FATAL，如果设置为WARN，则低于WARN的信息都不会输出。

      Spring Boot中默认配置ERROR、WARN和INFO级别的日志输出到控制台。

    开启DEBUG日志：

    1：在运行命令后加入-- debug 标志，如：$ java -jar myapp.jar --debug

    2：在配置文件application.properties 中配置 debug=true

    启用调试模式时，会配置一系列核心记录器（嵌入式容器、Hibernate和Spring Boot）以输出更多信息。但是你自己应用的日志并不会输出为DEBUG级别。

    开启TRACE日志：

    1：在运行命令后加入--trace 标志

    2：在配置文件application.properties 中配置 trace=true

      启动应用程序来启用“跟踪”模式。这样做可以为一系列核心记录器（嵌入式容器、Hibernate架构生成和整个Spring产品组合）启用跟踪日志记录。

    颜色编码输出:

      如果您的终端支持 ANSI，设置颜色输出可以提高日志的可读性。您可以设置spring.output.ansi.enabled 来覆盖自动检测。

    spring.output.ansi.enabled 支持的值为以下三项：

    参数	说明
    ALWAYS	启用 ANSI 彩色输出。
    DETECT	尝试检测ANSI着色功能是否可用。
    NEVER	禁用 ANSI 颜色输出。

      颜色编码是通过使用%clr 转换字来配置的。在最简单的形式中，转换器根据日志级别对输出进行着色，示例如下：

    %clr(%5p)
    

    日志级别到颜色的映射:

    级别	颜色
    FATAL	红色
    ERROR	红色
    WARN	黄色
    INFO	绿色
    DEBUG	绿色
    TRACE	绿色

      或者，您可以指定应该使用的颜色或样式，方法是将其提供为转换的选项。例如，要使文本变为黄色，示例如下：

    %clr(%d{yyyy-MM-dd'T'HH:mm:ss.SSSXXX}){yellow}
    

    支持以下颜色和样式：

    • blue
    • cyan
    • faint
    • green
    • magenta
    • red
    • yellow

      🥥 文件输出

      ---

        默认情况下，Spring Boot只将日志输出到控制台，而不会写到日志文件。如果除了控制台输出之外还想写入日志文件，则需在application.properties中设置logging.file或logging.path属性。

      • logging.file，设置文件，可以是绝对路径，也可以是相对路径。如：logging.file=my.log
      • logging.path，设置目录，会在该目录下创建spring.log文件，并写入日志内容，如：logging.path=/var/log

          如果只配置 logging.file，会在项目的当前路径下生成一个 xxx.log 日志文件。

          如果只配置 logging.path，在 /var/log文件夹生成一个日志文件为 spring.log

          默认情况下，日志文件的大小达到10MB时会切分一次，产生新的日志文件，默认级别为：ERROR、WARN、INFO

        注：二者不能同时使用，如若同时使用，则只有logging.file生效

        提示：

          日志记录属性独立于实际的日志记录基础结构。因此，特定的配置密钥（如logback的logback.configurationFile）不由spring Boot管理。

        🥝 文件轮换

        ---

          如果使用 Logback，则可以使用application.properties 或application.yaml 文件微调日志轮换设置。对于所有其他日志系统，需要自己直接配置轮换设置（例如，如果使用 Log4j2，则可以添加log4j2.xml或log4j2-spring.xml文件）。

        轮换策略属性如下:

        参数	说明
        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.total-size-cap
        logging.logback.rollingpolicy.max-history	要保留的归档日志文件的最大数量（默认为 7）。

        🍒 文件级别

        ---

          所有支持的日志记录系统都可以在Spring环境中设置记录级别（例如在application.properties中）格式为：’logging.level.* = LEVEL’ 。根日志记录程序可以使用logging_level.root进行配置。

        - logging.level：日志级别控制前缀，*为包名或Logger名

        • LEVEL：选项TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF

          示例如下：

          logging.level.root=warn   // root日志以WARN级别输出
          logging.level.org.springframework.web=debug // 包下所有class以DEBUG级别输出
          logging.level.org.hibernate=error //  包下所有class以error级别输出
          

          还可以使用环境变量设置日志记录级别。例如，

          LOGGING_LEVEL_ORG_SPRINGFRAMEWORK_WEB=DEBUG  // 将ORG.SPRINGFRAMEWORK.WEB 设置为`DEBUG`。
          

          提示：

            上述方法仅适用于包级别的日志记录。由于松弛绑定总是将环境变量转换为小写，因此不可能以这种方式为单个类配置日志记录。如果需要为类配置日志记录，可以使用SPRING_APPLICATION_JSON变量。

          

            如果喜欢的话，欢迎 🤞关注 👍点赞 💬评论 🤝收藏  🙌一起讨论
            你的支持就是我✍️创作的动力！					  💞💞💞
          

          参考资料

          Spring Boot 日志官方文档

           
           青岛建站公司  第三方交易平台的建立与操作  汕头本地网站  河北网站建设公司  舆情监测  企业网络推广方案