logback logback.xml 常用配置詳解
閱讀背景: 您可能需要對log4j,sl4j 有一些初步的了解。
閱讀目的:深刻的理解logback的常用配置<Configuration> AND <logger>
1 : 根節(jié)點(diǎn)<Configuration>包含的屬性
一:<Configuration >包含的屬性
scan:
當(dāng)此屬性設(shè)置為true時(shí),配置文件如果發(fā)生改變,將會(huì)被重新加載,默認(rèn)值為true。
scanPeriod:
設(shè)置監(jiān)測配置文件是否有修改的時(shí)間間隔,如果沒有給出時(shí)間單位,默認(rèn)單位是毫秒。當(dāng)scan為true時(shí),此屬性生效。默認(rèn)的時(shí)間間隔為1分鐘。
debug:
當(dāng)此屬性設(shè)置為true時(shí),將打印出logback內(nèi)部日志信息,實(shí)時(shí)查看logback運(yùn)行狀態(tài)。默認(rèn)值為false。
1 2 3 | < configuration scan = "true" scanPeriod = "60 seconds" debug = "false" > <!-- 其他配置省略--> </ configuration > |
2.2設(shè)置變量: <property>
用來定義變量值的標(biāo)簽,<property> 有兩個(gè)屬性,name和value;其中name的值是變量的名稱,value的值時(shí)變量定義的值。通過<property>定義的值會(huì)被插入到logger上下文中。定義變量后,可以使“${}”來使用變量。
例如使用<property>定義上下文名稱,然后在<contentName>設(shè)置logger上下文時(shí)使用。
1 2 3 4 5 | < configuration scan = "true" scanPeriod = "60 seconds" debug = "false" > < property name = "APP_Name" value = "myAppName" /> < contextName >${APP_Name}</ contextName > <!-- 其他配置省略--> </ configuration > |
2.3 獲取時(shí)間撮字符串
兩個(gè)屬性 key:標(biāo)識(shí)此<timestamp> 的名字;datePattern:設(shè)置將當(dāng)前時(shí)間(解析配置文件的時(shí)間)轉(zhuǎn)換為字符串的模式,遵循java.txt.SimpleDateFormat的格式。
例如將解析配置文件的時(shí)間作為上下文名稱:
1 2 3 4 5 | < configuration scan = "true" scanPeriod = "60 seconds" debug = "false" > < timestamp key = "bySecond" datePattern = "yyyyMMdd'T'HHmmss" /> < contextName >${bySecond}</ contextName > <!-- 其他配置省略--> </ configuration > |
2.4設(shè)置loger:
<loger>
用來設(shè)置某一個(gè)包或者具體的某一個(gè)類的日志打印級別、以及指定<appender>。<loger>僅有一個(gè)name屬性,一個(gè)可選的level和一個(gè)可選的addtivity屬性。
name:
用來指定受此loger約束的某一個(gè)包或者具體的某一個(gè)類。
level:
用來設(shè)置打印級別,大小寫無關(guān):TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,還有一個(gè)特俗值INHERITED或者同義詞NULL,代表強(qiáng)制執(zhí)行上級的級別。
如果未設(shè)置此屬性,那么當(dāng)前l(fā)oger將會(huì)繼承上級的級別。
addtivity:
是否向上級loger傳遞打印信息。默認(rèn)是true。
<loger>可以包含零個(gè)或多個(gè)<appender-ref>元素,標(biāo)識(shí)這個(gè)appender將會(huì)添加到這個(gè)loger。
<root>
也是<loger>元素,但是它是根loger。只有一個(gè)level屬性,應(yīng)為已經(jīng)被命名為"root".
level:
用來設(shè)置打印級別,大小寫無關(guān):TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF,不能設(shè)置為INHERITED或者同義詞NULL。
默認(rèn)是DEBUG。
<root>可以包含零個(gè)或多個(gè)<appender-ref>元素,標(biāo)識(shí)這個(gè)appender將會(huì)添加到這個(gè)loger。
logback.xml配置文件
第1種:只配置root
<configuration>
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!-- encoder 默認(rèn)配置為PatternLayoutEncoder -->
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<root level="INFO">
<appender-ref ref="STDOUT" />
</root>
</configuration>
其中appender的配置表示打印到控制臺(tái)(稍后詳細(xì)講解appender );
<root level="INFO">將root的打印級別設(shè)置為“INFO”,指定了名字為“STDOUT”的appender。
當(dāng)執(zhí)行l(wèi)ogback.LogbackDemo類的main方法時(shí),root將級別為“INFO”及大于“INFO”的日志信息交給已經(jīng)配置好的名為“STDOUT”的appender處理,“STDOUT”appender將信息打印到控制臺(tái);
打印結(jié)果如下:
13:30:38.484 [main] INFO logback.LogbackDemo - ======info
13:30:38.500 [main] WARN logback.LogbackDemo - ======warn
13:30:38.500 [main] ERROR logback.LogbackDemo - ======error
第2種:帶有l(wèi)oger的配置,不指定級別,不指定appender,
<configuration>
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!-- encoder 默認(rèn)配置為PatternLayoutEncoder -->
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<!-- logback為java中的包 -->
<logger name="logback"/>
<root level="DEBUG">
<appender-ref ref="STDOUT" />
</root>
</configuration>
其中appender的配置表示打印到控制臺(tái)(稍后詳細(xì)講解appender );
<logger name="logback" />將控制logback包下的所有類的日志的打印,但是并沒用設(shè)置打印級別,所以繼承他的上級<root>的日志級別“DEBUG”;
沒有設(shè)置addtivity,默認(rèn)為true,將此loger的打印信息向上級傳遞;
沒有設(shè)置appender,此loger本身不打印任何信息。
<root level="DEBUG">將root的打印級別設(shè)置為“DEBUG”,指定了名字為“STDOUT”的appender。
當(dāng)執(zhí)行l(wèi)ogback.LogbackDemo類的main方法時(shí),因?yàn)長ogbackDemo 在包logback中,所以首先執(zhí)行<logger name="logback" />,將級別為“DEBUG”及大于“DEBUG”的日志信息傳遞給root,本身并不打??;
root接到下級傳遞的信息,交給已經(jīng)配置好的名為“STDOUT”的appender處理,“STDOUT”appender將信息打印到控制臺(tái);
打印結(jié)果如下:
13:19:15.406 [main] DEBUG logback.LogbackDemo - ======debug
13:19:15.406 [main] INFO logback.LogbackDemo - ======info
13:19:15.406 [main] WARN logback.LogbackDemo - ======warn
13:19:15.406 [main] ERROR logback.LogbackDemo - ======error
第3種:帶有多個(gè)loger的配置,指定級別,指定appender
<configuration>
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!-- encoder 默認(rèn)配置為PatternLayoutEncoder -->
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<!-- logback為java中的包 -->
<logger name="logback"/>
<!--logback.LogbackDemo:類的全路徑 -->
<logger name="logback.LogbackDemo" level="INFO" additivity="false">
<appender-ref ref="STDOUT"/>
</logger>
<root level="ERROR">
<appender-ref ref="STDOUT" />
</root>
</configuration>
其中appender的配置表示打印到控制臺(tái)(稍后詳細(xì)講解appender );
<logger name="logback" />將控制logback包下的所有類的日志的打印,但是并沒用設(shè)置打印級別,所以繼承他的上級<root>的日志級別“DEBUG”;
沒有設(shè)置addtivity,默認(rèn)為true,將此loger的打印信息向上級傳遞;
沒有設(shè)置appender,此loger本身不打印任何信息。
<logger name="logback.LogbackDemo" level="INFO" additivity="false">控制logback.LogbackDemo類的日志打印,打印級別為“INFO”;
additivity屬性為false,表示此loger的打印信息不再向上級傳遞,
指定了名字為“STDOUT”的appender。
<root level="ERROR">將root的打印級別設(shè)置為“ERROR”,指定了名字為“STDOUT”的appender。
當(dāng)執(zhí)行l(wèi)ogback.LogbackDemo類的main方法時(shí),先執(zhí)行<logger name="logback.LogbackDemo" level="INFO" additivity="false">,將級別為“INFO”及大于“INFO”的日志信息交給此loger指定的名為“STDOUT”的appender處理,在控制臺(tái)中打出日志,不再向次loger的上級 <logger name="logback"/> 傳遞打印信息;
<logger name="logback"/>未接到任何打印信息,當(dāng)然也不會(huì)給它的上級root傳遞任何打印信息;
打印結(jié)果如下:
14:05:35.937 [main] INFO logback.LogbackDemo - ======info
14:05:35.937 [main] WARN logback.LogbackDemo - ======warn
14:05:35.937 [main] ERROR logback.LogbackDemo - ======error
如果將<logger name="logback.LogbackDemo" level="INFO" additivity="false">修改為 <logger name="logback.LogbackDemo" level="INFO" additivity="true">那打印結(jié)果將是什么呢?
沒錯(cuò),日志打印了兩次,想必大家都知道原因了,因?yàn)榇蛴⌒畔⑾蛏霞墏鬟f,logger本身打印一次,root接到后又打印一次
打印結(jié)果如下:
14:09:01.531 [main] INFO logback.LogbackDemo - ======info
14:09:01.531 [main] INFO logback.LogbackDemo - ======info
14:09:01.531 [main] WARN logback.LogbackDemo - ======warn
14:09:01.531 [main] WARN logback.LogbackDemo - ======warn
14:09:01.531 [main] ERROR logback.LogbackDemo - ======error
14:09:01.531 [main] ERROR logback.LogbackDemo - ======error
posted on 2014-09-11 08:53 paulwong 閱讀(3475) 評論(0) 編輯 收藏 所屬分類: LOGBACK