# 26.5. 自定義日志配置 ### 26.5. 自定義日志配置 通過將相應的庫添加到classpath可以激活各種日志系統，然后在classpath根目錄下提供合適的配置文件可以進一步定制日志系統，配置文件也可以通過Spring `Environment`的`logging.config`屬性指定。 使用`org.springframework.boot.logging.LoggingSystem`系統屬性可以強制Spring Boot使用指定的日志系統，該屬性值需要是`LoggingSystem`實現類的全限定名，如果值為`none`，則徹底禁用Spring Boot的日志配置。 **注** 由于日志初始化早于`ApplicationContext`的創建，所以不可能通過`@PropertySources`指定的Spring `@Configuration`文件控制日志，系統屬性和Spring Boot外部化配置可以正常工作。 以下文件會根據你選擇的日志系統進行加載： 日志系統定制配置Logback`logback-spring.xml`,`logback-spring.groovy`,`logback.xml`或`logback.groovy`Log4j`log4j.properties`或`log4j.xml`Log4j2`log4j2-spring.xml`或`log4j2.xml`JDK (Java Util Logging)`logging.properties`**注** 如果可能的話，建議你使用`-spring`變種形式定義日志配置（例如，使用`logback-spring.xml`而不是`logback.xml`）。如果你使用標準的配置路徑，Spring可能不能夠完全控制日志初始化。 **注** Java Util Logging從可執行jar運行時會導致一些已知的類加載問題，我們建議盡可能不使用它。 以下是從Spring `Envrionment`轉換為System properties的一些有助于定制的配置屬性： Spring EnvironmentSystem PropertyComments`logging.exception-conversion-word``LOG_EXCEPTION_CONVERSION_WORD`記錄異常使用的關鍵字`logging.file``LOG_FILE`如果指定就會在默認的日志配置中使用`logging.path``LOG_PATH`如果指定就會在默認的日志配置中使用`logging.pattern.console``CONSOLE_LOG_PATTERN`日志輸出到控制臺（stdout）時使用的模式（只支持默認的logback設置）`logging.pattern.file``FILE_LOG_PATTERN`日志輸出到文件時使用的模式（如果LOG\_FILE啟用，只支持默認的logback設置）`logging.pattern.level``LOG_LEVEL_PATTERN`用來渲染日志級別的格式（默認`%5p`，只支持默認的logback設置）`PID``PID`當前的處理進程(process)ID（能夠找到，且還沒有用作OS環境變量）所有支持的日志系統在解析配置文件時都能獲取系統屬性的值，具體可以參考`spring-boot.jar`中的默認配置。 **注** 如果想在日志屬性中使用占位符，你需要使用[Spring Boot的語法](http://docs.spring.io/spring-boot/docs/1.4.1.RELEASE/reference/htmlsingle/#boot-features-external-config-placeholders-in-properties)，而不是底層框架的語法。尤其是使用Logback時，你需要使用`:`作為屬性名和默認值的分隔符，而不是`:-`。 **注** 通過覆蓋`LOG_LEVEL_PATTERN`（Logback對應`logging.pattern.level`），你可以向日志中添加MDC和其他ad-hoc的內容。例如，將該值設置為`logging.pattern.level=user:%X{user} %5p`，則默認日志格式將包含一個"user"的MDC實體，如果存在的話，比如： ``` 2015-09-30 12:30:04.031 user:juergen INFO 22174 --- [ nio-8080-exec-0] demo.Controller Handling authenticated request ```