springboot 日志相关规约

1. 除非很必要的情况，否则不得使用自定义日志配置文件

1）springboot 默认的日志输出是很美观的，不必要重写

2）基本上很多需要重写的部分都可以用配置来解决

2. 不得采用自带的打印方法输出日志，日志文件是无法记录的，所有输出必须采用日志门面的输出方式

3. springboot admin client需要用到在线日志查看功能时，务必配置日志文件地址

1）springboot 2.1.x以及之前，logging.file

2）springboot 2.2.x，logging.file.path

4. 日志文件输出地址只需要配置文件夹即可，不需要配置成 D:\logs\quick-start\demo.log 这样的，正确的配置是D:\logs\quick-start\

1）spring的代码其实是风格很统一的，配置的规则都是有迹可循的。logging.file，日志文件；logging.file.path，日志文件路径

附录

springboot日志源码路径：

logback 默认配置

<configuration  scan="true" scanPeriod="60 seconds" debug="false">
    <contextName>defaultcontextName>
    <conversionRule conversionWord="clr" converterClass="org.springframework.boot.logging.logback.ColorConverter" />
    <conversionRule conversionWord="wex" converterClass="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
    <conversionRule conversionWord="wEx" converterClass="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
    <property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
    <property name="FILE_LOG_PATTERN" value="${FILE_LOG_PATTERN:-%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
    <property name="LOG_FILE" value="${LOG_FILE:-${LOG_PATH:-${LOG_TEMP:-${java.io.tmpdir:-/tmp}}}/spring.log}"/>
    <springProperty scope="context" name="logLevel" source="logging.level.root"/>
    <springProperty scope="context" name="APPLICATION_NAME" source="spring.application.name"/>
    
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>${logLevel}level>
        filter>
        <encoder>
            <pattern>${CONSOLE_LOG_PATTERN}pattern>
        encoder>
    appender>
    
    <appender name="FILE"
              class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder>
            <pattern>${FILE_LOG_PATTERN}pattern>
        encoder>
        <file>${LOG_FILE}file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <cleanHistoryOnStart>${LOG_FILE_CLEAN_HISTORY_ON_START:-false}cleanHistoryOnStart>
            <fileNamePattern>${ROLLING_FILE_NAME_PATTERN:-${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz}fileNamePattern>
            <maxFileSize>${LOG_FILE_MAX_SIZE:-10MB}maxFileSize>
            <maxHistory>${LOG_FILE_MAX_HISTORY:-7}maxHistory>
            <totalSizeCap>${LOG_FILE_TOTAL_SIZE_CAP:-0}totalSizeCap>
        rollingPolicy>
    appender>

    <root level="${logLevel}">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
    root>
    <logger name="org.apache.catalina.startup.DigesterFactory" level="ERROR"/>
    <logger name="org.apache.catalina.util.LifecycleBase" level="ERROR"/>
    <logger name="org.apache.coyote.http11.Http11NioProtocol" level="WARN"/>
    <logger name="org.apache.sshd.common.util.SecurityUtils" level="WARN"/>
    <logger name="org.apache.tomcat.util.net.NioSelectorPool" level="WARN"/>
    <logger name="org.eclipse.jetty.util.component.AbstractLifeCycle" level="ERROR"/>
    <logger name="org.hibernate.validator.internal.util.Version" level="WARN"/>
configuration>