springboot有不少starter(參考starter)方便快速構建項目依賴組件,logback是springboot默認的日誌組件,啓動便可看到打印在控制檯輸出的info級別的日誌:html
2018-01-14 20:17:19.831 INFO 32976 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity<java.util.Map<java.lang.String, java.lang.Object>> org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest)
2018-01-14 20:17:19.832 INFO 32976 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error],produces=[text/html]}" onto public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)
2018-01-14 20:17:19.862 INFO 32976 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2018-01-14 20:17:19.862 INFO 32976 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2018-01-14 20:17:19.919 INFO 32976 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2018-01-14 20:17:20.166 INFO 32976 --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Registering beans for JMX exposure on startup
2018-01-14 20:17:20.747 INFO 32976 --- [ main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8082 (http)
2018-01-14 20:17:20.754 INFO 32976 --- [ main] springboot.log.demo.LogMainApplication : Started LogMainApplication in 4.484 seconds (JVM running for 5.077)java
從打印出的日誌能夠看到,日誌輸出內容元素具體以下:git
springboot的log通常會包含在其餘starter裏,但也有日誌starter,本例包含在github
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
日誌級別從高到低:TRACE
< DEBUG
< INFO
< WARN
< ERROR
< FATAL
web
若是設置爲 WARN
,則低於 WARN
的信息都不會輸出。spring
Spring Boot
中默認配置ERROR
、WARN
和INFO
級別的日誌輸出到控制檯。 sql
您還能夠經過啓動您的應用程序 --debug
標誌來啓用「調試」模式(開發的時候推薦開啓),如下兩種方式皆可:tomcat
--debug
標誌,如:$ java -jar springTest.jar --debug
application.properties
中配置debug=true
,該屬性置爲true
的時候,核心Logger
(包含嵌入式容器、hibernate、spring)會輸出更多內容,可是你本身應用的日誌並不會輸出爲DEBUG
級別。使用lombok簡化日誌logger:springboot
@Slf4j @RestController @RequestMapping("/log") public class LogController { @RequestMapping("/demo1") public void demo1() { log.info("測試{},輸出{}", "demo1", "info level log"); } }
能夠用{}佔位符來拼接字符串,免去了用"+"拼接字符串。輸出結果:mybatis
2018-01-14 20:37:57.043 INFO 9020 --- [nio-8082-exec-3] s.log.demo.controller.LogController : 測試demo1,輸出info level log
(<configuration scan="true" scanPeriod="60 seconds" debug="false">)
true
時,配置文件若是發生改變,將會被從新加載,默認值爲true
。scan
爲true
時,此屬性生效。默認的時間間隔爲1分鐘。true
時,將打印出logback
內部日誌信息,實時查看logback
運行狀態。默認值爲false
。root
:root節點是必選節點,用來指定最基礎的日誌輸出級別,只有一個level屬性。
level:用來設置打印級別,大小寫無關:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能設置爲INHERITED或者同義詞NULL。默認是DEBUG。
能夠包含零個或多個元素,標識這個appender將會添加到這個loger。
<!--指定最基礎的日誌輸出級別--> <root level="INFO"> <!--appender將會添加到這個loger--> <appender-ref ref="consoleLog1"/> <appender-ref ref="consoleLog2"/> </root>
contextName
:設置上下文名稱每一個logger都關聯到logger上下文,默認上下文名稱爲「default」。但可使用設置成其餘名字,用於區分不一樣應用程序的記錄。一旦設置,不能修改,能夠經過%contextName
來打印日誌上下文名稱,通常來講咱們不用這個屬性,無關緊要。
<contextName>logbackdemo</contextName>
property
:設置上下文名稱用來定義變量值的標籤, 有兩個屬性,name和value;其中name的值是變量的名稱,value的值是變量定義的值。經過定義的值會被插入到logger上下文中。定義變量後,可使「${}」來使用變量。
appender用來格式化日誌輸出節點,有倆個屬性name和class,class用來指定哪一種輸出策略,經常使用就是控制檯輸出策略和文件輸出策略。
<?xml version="1.0" encoding="UTF-8"?> <configuration scan="true" scanPeriod="60 seconds" debug="false"> <contextName>logbackdemo</contextName> <!--輸出到控制檯 ConsoleAppender--> <appender name="consoleLog1" class="ch.qos.logback.core.ConsoleAppender"> <!--展現格式 layout--> <layout class="ch.qos.logback.classic.PatternLayout"> <pattern>%d -1 %msg%n</pattern> </layout> </appender> <!--輸出到控制檯 ConsoleAppender--> <appender name="consoleLog2" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <pattern>%d -2 %msg%n</pattern> </encoder> </appender> <!--指定最基礎的日誌輸出級別--> <root level="INFO"> <!--appender將會添加到這個loger--> <appender-ref ref="consoleLog1"/> <appender-ref ref="consoleLog2"/> </root> </configuration>
控制檯輸出日誌:
2018-01-14 21:58:00,800 -1 測試demo1,輸出info level log
2018-01-14 21:58:00,800 -2 測試demo1,輸出info level log
能夠看到layout
和encoder
,均可以將事件轉換爲格式化後的日誌記錄,可是控制檯輸出使用layout
,文件輸出使用encoder
,具體緣由能夠看http://blog.csdn.net/cw_hello1/article/details/51969554
<?xml version="1.0" encoding="UTF-8"?> <configuration scan="true" scanPeriod="60 seconds" debug="false"> <contextName>logbackdemo</contextName> <!--輸出到控制檯 ConsoleAppender--> <appender name="consoleLog1" class="ch.qos.logback.core.ConsoleAppender"> <!--展現格式 layout--> <layout class="ch.qos.logback.classic.PatternLayout"> <pattern> <pattern>%d{HH:mm:ss.SSS} %contextName [%thread] %-5level %logger{36} - %msg%n</pattern> </pattern> </layout> <!-- 過濾掉Error級別的日誌,此appender僅篩選Error級別日誌並輸出到控制檯 <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>ERROR</level> </filter> --> </appender> <!--指定最基礎的日誌輸出級別--> <root level="INFO"> <!--appender將會添加到這個loger--> <appender-ref ref="consoleLog1"/> </root> </configuration>
控制檯輸出日誌:
22:04:41.276 logbackdemo [http-nio-8082-exec-4] INFO s.log.demo.controller.LogController - 測試demo1,輸出info level log
<encoder>
表示對日誌進行編碼:
RollingFileAppender
):另外一種常見的日誌輸出到文件,隨着應用的運行時間愈來愈長,日誌也會增加的愈來愈多,將他們輸出到同一個文件並不是一個好辦法。RollingFileAppender
用於切分文件日誌:
<?xml version="1.0" encoding="UTF-8"?> <configuration scan="true" scanPeriod="60 seconds" debug="false"> <contextName>logbackdemo</contextName> <property name="logback.logdir" value="I:\\xxx\\xxx\\logs"/> <property name="logback.appname" value="logDemo"/> <appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!--若是隻是想要 Info 級別的日誌,只是過濾 info 仍是會輸出 Error 日誌,由於 Error 的級別高, 因此咱們使用下面的策略,能夠避免輸出 Error 的日誌--> <filter class="ch.qos.logback.classic.filter.LevelFilter"> <!--過濾 Error--> <level>ERROR</level> <!--匹配到就禁止--> <onMatch>DENY</onMatch> <!--沒有匹配到就容許--> <onMismatch>ACCEPT</onMismatch> </filter> <!--日誌名稱,若是沒有File 屬性,那麼只會使用FileNamePattern的文件路徑規則 若是同時有<File>和<FileNamePattern>,那麼當天日誌是<File>,明天會自動把今天 的日誌更名爲今天的日期。即,<File> 的日誌都是當天的。 --> <File>${logback.logdir}/info.${logback.appname}.log</File> <!--滾動策略,按照時間滾動 TimeBasedRollingPolicy--> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!--文件路徑,定義了日誌的切分方式——把每一天的日誌歸檔到一個文件中,以防止日誌填滿整個磁盤空間--> <FileNamePattern>${logback.logdir}/info.${logback.appname}.%d{yyyy-MM-dd}.log</FileNamePattern> <!--只保留最近90天的日誌--> <maxHistory>90</maxHistory> <!--用來指定日誌文件的上限大小,那麼到了這個值,就會刪除舊的日誌--> <!--<totalSizeCap>1GB</totalSizeCap>--> </rollingPolicy> <!--日誌輸出編碼格式化--> <encoder> <charset>UTF-8</charset> <pattern>%d [%thread] %-5level %logger{36} %line - %msg%n</pattern> </encoder> </appender> <appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender"> <!--若是隻是想要 Error 級別的日誌,那麼須要過濾一下,默認是 info 級別的,ThresholdFilter--> <filter class="ch.qos.logback.classic.filter.ThresholdFilter"> <level>Error</level> </filter> <!--日誌名稱,若是沒有File 屬性,那麼只會使用FileNamePattern的文件路徑規則 若是同時有<File>和<FileNamePattern>,那麼當天日誌是<File>,明天會自動把今天 的日誌更名爲今天的日期。即,<File> 的日誌都是當天的。 --> <File>${logback.logdir}/error.${logback.appname}.log</File> <!--滾動策略,按照時間滾動 TimeBasedRollingPolicy--> <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> <!--文件路徑,定義了日誌的切分方式——把每一天的日誌歸檔到一個文件中,以防止日誌填滿整個磁盤空間--> <FileNamePattern>${logback.logdir}/error.${logback.appname}.%d{yyyy-MM-dd}.log</FileNamePattern> <!--只保留最近90天的日誌--> <maxHistory>90</maxHistory> <!--用來指定日誌文件的上限大小,那麼到了這個值,就會刪除舊的日誌--> <!--<totalSizeCap>1GB</totalSizeCap>--> </rollingPolicy> <!--日誌輸出編碼格式化--> <encoder> <charset>UTF-8</charset> <pattern>%d [%thread] %-5level %logger{36} %line - %msg%n</pattern> </encoder> </appender> <!--指定最基礎的日誌輸出級別--> <root level="INFO"> <!--appender將會添加到這個loger--> <appender-ref ref="fileInfoLog"/> <appender-ref ref="fileErrorLog"/> </root> </configuration>
測試log:
@Slf4j
@RestController
@RequestMapping("/log") public class LogController { @RequestMapping("/demo1") public void demo1() { log.info("測試{},日誌級別{},輸出{}", "demo1", "info", "info level log"); log.error("測試{},日誌級別{},輸出{}", "error", "error", "error level log"); } }
能夠看到控制檯不輸出任何log,而且在指定的路徑 logback.logdir 下生成了兩個文件:
error.logDemo.log
info.logDemo.log
error級別的日誌:
2018-01-14 22:25:40,921 [http-nio-8082-exec-1] ERROR s.log.demo.controller.LogController 18 - 測試error,日誌級別error,輸出error level log
info級別日誌:
2018-01-14 22:25:29,041 [main] INFO o.a.coyote.http11.Http11NioProtocol 179 - Initializing ProtocolHandler ["http-nio-8082"]
2018-01-14 22:25:29,057 [main] INFO o.a.coyote.http11.Http11NioProtocol 179 - Starting ProtocolHandler ["http-nio-8082"]
2018-01-14 22:25:29,282 [main] INFO o.a.tomcat.util.net.NioSelectorPool 179 - Using a shared selector for servlet write/read
2018-01-14 22:25:29,653 [main] INFO o.s.b.c.e.t.TomcatEmbeddedServletContainer 198 - Tomcat started on port(s): 8082 (http)
2018-01-14 22:25:29,661 [main] INFO s.log.demo.LogMainApplication 57 - Started LogMainApplication in 4.743 seconds (JVM running for 5.28)
2018-01-14 22:25:40,870 [http-nio-8082-exec-1] INFO o.a.c.c.C.[Tomcat].[localhost].[/] 179 - Initializing Spring FrameworkServlet 'dispatcherServlet'
2018-01-14 22:25:40,871 [http-nio-8082-exec-1] INFO o.s.web.servlet.DispatcherServlet 489 - FrameworkServlet 'dispatcherServlet': initialization started
2018-01-14 22:25:40,892 [http-nio-8082-exec-1] INFO o.s.web.servlet.DispatcherServlet 508 - FrameworkServlet 'dispatcherServlet': initialization completed in 21 ms
2018-01-14 22:25:40,921 [http-nio-8082-exec-1] INFO s.log.demo.controller.LogController 16 - 測試demo1,日誌級別info,輸出info level log
經過配置 fileInfoLog 與 fileErrorLog 能夠實現info級別日誌與error級別日誌分開記錄。
將本機時間調到明天,再次執行程序:
info已經歸檔了(日誌配置的info級別的歸檔),info.logDemo.log的永遠是當天的日誌文件。
<logger>
用來設置某一個包或者具體的某一個類的日誌打印級別、以及指定<appender>
。<logger>
僅有一個name
屬性,一個可選的level
和一個可選的addtivity
屬性。
name
:用來指定受此loger約束的某一個包或者具體的某一個類。level
:用來設置打印級別,大小寫無關:TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,還有一個特俗值INHERITED或者同義詞NULL,表明強制執行上級的級別。若是未設置此屬性,那麼當前loger將會繼承上級的級別。addtivity
:是否向上級logger傳遞打印信息。默認是true(當爲true時,還會被匹配到的root再次輸出一次log)。示例記錄了trace、debug、info、warn、error級別日誌:
@Slf4j @RestController @RequestMapping("/log") public class LogController { @RequestMapping("/demo1") public void demo1() { //日誌級別從低到高分爲TRACE < DEBUG < INFO < WARN < ERROR < FATAL,若是設置爲WARN,則低於WARN的信息都不會輸出。 log.trace("測試{},日誌級別{},輸出{}", "demo1", "trace", "trace level log"); log.debug("測試{},日誌級別{},輸出{}", "demo1", "debug", "debug level log"); log.info("測試{},日誌級別{},輸出{}", "demo1", "info", "info level log"); log.warn("測試{},日誌級別{},輸出{}", "demo1", "warn", "warn level log"); log.error("測試{},日誌級別{},輸出{}", "demo1", "error", "error level log"); } }
<?xml version="1.0" encoding="UTF-8"?> <configuration scan="true" scanPeriod="60 seconds" debug="false"> <contextName>logbackdemo</contextName> <!--輸出到控制檯 ConsoleAppender--> <appender name="consoleLog1" class="ch.qos.logback.core.ConsoleAppender"> <!--展現格式 layout--> <layout class="ch.qos.logback.classic.PatternLayout"> <pattern> <pattern>%d{HH:mm:ss.SSS} %contextName [%thread] %-5level %logger{36} - %msg%n</pattern> </pattern> </layout> </appender> <logger name="springboot.log.demo.controller.LogController" /> <!--指定最基礎的日誌輸出級別--> <root level="INFO"> <!--appender將會添加到這個loger--> <appender-ref ref="consoleLog1"/> </root> </configuration>
<logger name="springboot.log.demo.controller.LogController" /> 將控制 LogController 包下的全部類的日誌的打印,可是並沒用設置打印級別,因此繼承他的上級的日誌級別; 「info」
沒有設置addtivity
,默認爲true,將此loger
的打印信息向上級傳遞;
沒有設置appender
,此logger
自己不打印任何信息。運行程序時,
LogController 的log會將默認級別爲log或大於log級別的日誌信息傳遞給root,root接收到log後傳遞給配置好的 consoleLog1 處理 consoleLog1 的appender將日誌格式化輸出到控制檯。輸出日誌:
22:58:05.047 logbackdemo [http-nio-8082-exec-1] INFO s.log.demo.controller.LogController - 測試demo1,日誌級別info,輸出info level log
22:58:05.047 logbackdemo [http-nio-8082-exec-1] WARN s.log.demo.controller.LogController - 測試demo1,日誌級別warn,輸出warn level log
22:58:05.047 logbackdemo [http-nio-8082-exec-1] ERROR s.log.demo.controller.LogController - 測試demo1,日誌級別error,輸出error level log
<?xml version="1.0" encoding="UTF-8"?> <configuration scan="true" scanPeriod="60 seconds" debug="false"> <contextName>logbackdemo</contextName> <!--輸出到控制檯 ConsoleAppender--> <appender name="consoleLog1" class="ch.qos.logback.core.ConsoleAppender"> <!--展現格式 layout--> <layout class="ch.qos.logback.classic.PatternLayout"> <pattern> <pattern>%d{HH:mm:ss.SSS} %contextName [%thread] %-5level %logger{36} - %msg%n</pattern> </pattern> </layout> </appender> <!--輸出到控制檯 ConsoleAppender--> <appender name="consoleLog2" class="ch.qos.logback.core.ConsoleAppender"> <!--展現格式 layout--> <layout class="ch.qos.logback.classic.PatternLayout"> <pattern> <pattern>%d{HH:mm:ss.SSS} %-5level %logger{36} - %msg%n</pattern> </pattern> </layout> </appender> <!--<logger name="springboot.log.demo.controller.LogController" />--> <!-- 類的全路徑 --> <logger name="springboot.log.demo.controller.LogController" level="WARN" additivity="false"> <appender-ref ref="consoleLog2"/> </logger> <!--指定最基礎的日誌輸出級別--> <root level="INFO"> <!--appender將會添加到這個loger--> <appender-ref ref="consoleLog1"/> </root> </configuration>
運行程序時,LogController 將log級別大於等於WARN的日誌交給logger指定的名爲consoleLog2的appender來處理。而且配置了additivity=false,日誌再也不向上級傳遞,打印結果:
23:11:20.576 WARN s.log.demo.controller.LogController - 測試demo1,日誌級別warn,輸出warn level log
23:11:20.577 ERROR s.log.demo.controller.LogController - 測試demo1,日誌級別error,輸出error level log
固然若是你把additivity="false"
改爲additivity="true"
的話,就會打印兩次,由於打印信息向上級傳遞,logger自己打印一次,root接到後又打印一次。
不要配置多個相同的logger。若是配置多個logger,範圍小的有效:
<logger name="springboot.log.demo.controller.LogController" /> <!-- 類的全路徑 --> <logger name="springboot.log.demo.controller.LogController" level="DEBUG" additivity="false"> <appender-ref ref="consoleLog2"/> </logger>
控制檯輸出:
23:17:00.100 DEBUG s.log.demo.controller.LogController - 測試demo1,日誌級別debug,輸出debug level log
23:17:00.100 INFO s.log.demo.controller.LogController - 測試demo1,日誌級別info,輸出info level log
23:17:00.100 WARN s.log.demo.controller.LogController - 測試demo1,日誌級別warn,輸出warn level log
23:17:00.100 ERROR s.log.demo.controller.LogController - 測試demo1,日誌級別error,輸出error level log
<configuration> ... <!-- 測試環境+開發環境. 多個使用逗號隔開. --> <springProfile name="test,dev"> <logger name="springboot.log.demo.controller" level="DEBUG" additivity="false"> <appender-ref ref="consoleLog"/> </logger> </springProfile> <!-- 生產環境. --> <springProfile name="prod"> <logger name="springboot.log.demo.controller" level="INFO" additivity="false"> <appender-ref ref="consoleLog"/> </logger> </springProfile> </configuration>
當application.yml設置環境爲test時,激活log爲test配置;設置爲prod時,激活log配置爲prod配置:
spring:
profiles:
active: test
開發調試中輸出到控制檯能夠利於排錯和調試,可是測試環境和生產環境要查看日誌就須要保留日誌到指定存儲的地方,這時候就須要使用自定義日誌輸出格式和保存路徑了。
根據不一樣的日誌系統,你能夠按以下規則組織配置文件名,就能被正確加載:
logback-spring.xml, logback-spring.groovy, logback.xml, logback.groovy
log4j-spring.properties, log4j-spring.xml, log4j.properties, log4j.xml
log4j2-spring.xml, log4j2.xml
logging.properties
Spring Boot
官方推薦優先使用帶有-spring
的文件名做爲你的日誌配置(如使用logback-spring.xml
,而不是logback.xml
),命名爲logback-spring.xml
的日誌配置文件,spring boot
能夠爲它添加一些spring boot
特有的配置項。
默認的命名規則,而且放在 src/main/resources
下面便可。若是你即想徹底掌控日誌配置,但又不想用logback.xml
做爲Logback
配置的名字,application.yml
能夠經過logging.config
屬性指定自定義的名字:
logging.config=classpath:logging-config.xml
開發中經常須要將mybatis執行的sql輸出到控制檯,但mybatis的sql輸出級別是debug,能夠利用logger的屬性針對mapper包設置輸出log級別,以下所示:
<springProfile name="dev"> <root> <level value="info"/> <appender-ref ref="STDOUT"/> </root> <logger name="com.demo.mapper" level="DEBUG" additivity="false"> <appender-ref ref="STDOUT" /> </logger> </springProfile>
http://blog.csdn.net/inke88/article/details/75007649
http://blog.csdn.net/vitech/article/details/53812137
https://juejin.im/post/58f86981b123db0062363203