Spring Logging

日誌級別 (Logging Level)

由低到高：trace < debug < info < warn < error
trace: 詳細的流程細節，用於追蹤 Bug。
debug: 效能分析、執行時間。
info: 服務啟動狀態、核心交易結果。
warn: 可預期的錯誤（如網路暫時中斷）。
error: 影響功能的嚴重錯誤（如資料庫連線失敗）。

設定範例 (application.yml)

logging:
  config: classpath:logback-spring.xml
  level:
    root: info
    com.lex: debug

logback-spring.xml 結構

核心模組

logback-core: 基礎元件（Appender, Layout）。
logback-classic: log4j 改良版，實作 Slf4j API。
logback-access: 與 Servlet 容器整合，用於 HTTP 請求日誌。

結構概覽

常用 Appender 配置

1. 控制台輸出 (Console)

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{50} - %msg%n</pattern>
    </encoder>
</appender>

2. 滾動檔案紀錄 (Rolling File)

INFO 級別日誌

<appender name="INFO_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>${LOG_PATH}/info-%d{yyyy-MM-dd}.%i.log</fileNamePattern>
        <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
            <maxFileSize>10MB</maxFileSize>
        </timeBasedFileNamingAndTriggeringPolicy>
        <maxHistory>30</maxHistory>
    </rollingPolicy>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
        <level>INFO</level>
        <onMatch>ACCEPT</onMatch>
        <onMismatch>DENY</onMismatch>
    </filter>
</appender>

3. 分離日誌 (Sifting Appender)

用於根據特定條件（如任務 ID 或執行緒）將日誌寫入不同檔案。

<appender name="SIFT" class="ch.qos.logback.classic.sift.SiftingAppender">
    <discriminator>
        <key>taskId</key>
        <defaultValue>default</defaultValue>
    </discriminator>
    <sift>
        <appender name="File-${taskId}" class="ch.qos.logback.core.FileAppender">
            <file>${LOG_PATH}/${taskId}.log</file>
            <encoder>
                <pattern>%d [%thread] %msg%n</pattern>
            </encoder>
        </appender>
    </sift>
</appender>

根日誌配置 (Root)

<root level="INFO">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="INFO_FILE" />
</root>

Spring Boot Application Internally Works Spring Profiles