在項目開發中,記錄錯誤日志是一個很有必要功能。一是方便調試;二是便於發現系統運行過程中的錯誤;三是存儲業務數據,便於后期分析;
在java中,記錄日志,有很多種方式。
比如,自己實現。
自己寫類,將日志數據,以io操作方式,寫數據到文本文件。或者是寫到數據庫中。
比如,使用log4j。
log4j,這也是此文要記錄的。log4j,以前在用.Net做web form時,用log4net。平台通吃。而且,log4j可以將日志,輸出到console窗口,輸出到文本文件,輸出到數據庫等,功能還是很強大的!
比如,使用jdk自帶的logging.jar中的方法。
比如,使用slfj。
slfj,是也是一個很強大的功能。slfj旨在一統天下,也就是slfj提供了logging.jar 和 log4j的接口,可以通過slfj來調用log4j,也可以調用jdk的logging。
從需求出發,記錄log4j
1、log4j引入哪些包?
去官網看看吧
2、添加配置文件
在src下,也就是class下,把log4j的配置文件添加進去log4j.properties,標准的properties文件(Properties文件的操作,參考此文)
3、建一個類文件,建主函數,下圖為結構
4、修改配置文件,使用log4j將日志輸出到console窗口
我們經常使用System.out.println(“日志內容”),來將內容輸出。今天不用這個了。用log4j的。
log4J配置文件為:
### 設置級別和目的地(這里多個目的地) ### log4j.rootLogger = DEBUG,CONSOLE ### 這里的me是包,也就是在這個包記錄日志時,是只記錄debug及以上級別的日志 log4j.logger.me=DEBUG ### 輸出到控制台 ### log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender log4j.appender.CONSOLE.Target = System.out log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout log4j.appender.CONSOLE.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{1}:%L - %m%n main主函數調用:
mport org.apache.log4j.Logger; public class Log4jTest { public static Logger logger1 = Logger.getLogger(Log4jTest.class); public static void main(String[] args) { //logger1 logger1.trace("我是logger1,trace"); logger1.debug("我是logger1,debug"); logger1.info("我是logger1,info"); logger1.warn("我是logger1,warn"); logger1.error("我是logger1,error"); logger1.fatal("我是logger1,fatal"); } }
可以看到console中輸出內容:
16:51:16,575 DEBUG Log4jTest:15 [main:0]- 我是logger1,debug
16:51:16,578 INFO Log4jTest:16 [main:3]- 我是logger1,info
16:51:16,578 WARN Log4jTest:17 [main:3]- 我是logger1,warn
16:51:16,578 ERROR Log4jTest:18 [main:3]- 我是logger1,error
16:51:16,578 FATAL Log4jTest:19 [main:3]- 我是logger1,fatal
5、log4j將日志輸出到console窗口,說說輸出的格式
在標題4中,看到console的輸出內容,是按一定格式輸出。格式的配置還是來自於配置文件log4j.properties
log4j.appender.CONSOLE.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{1}:%L - %m%n
日志輸出格式,所用到的參數如下,按需添加:
1 %p: 輸出日志信息優先級,即DEBUG,INFO,WARN,ERROR,FATAL, 2 %d: 輸出日志時間點的日期或時間,默認格式為ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},輸出類似:2002年10月18日 22:10:28,921 3 %r: 輸出自應用啟動到輸出該log信息耗費的毫秒數 4 %c: 輸出日志信息所屬的類目,通常就是所在類的全名 5 %t: 輸出產生該日志事件的線程名 6 %l: 輸出日志事件的發生位置,相當於%C.%M(%F:%L)的組合,包括類目名、發生的線程,以及在代碼中的行數。舉例:Testlog4.main(TestLog4.java:10) 7 %x: 輸出和當前線程相關聯的NDC(嵌套診斷環境),尤其用到像java servlets這樣的多客戶多線程的應用中。 8 %%: 輸出一個”%”字符 9 %F: 輸出日志消息產生時所在的文件名稱 10 %L: 輸出代碼中的行號 11 %m: 輸出代碼中指定的消息,產生的日志具體信息 12 %n: 輸出一個回車換行符,Windows平台為”\r\n”,Unix平台為”\n”輸出日志信息換行 13 可以在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如: 14 1)%20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,默認的情況下右對齊。 15 2)%-20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,”-”號指定左對齊。 16 3)%.30c:指定輸出category的名稱,最大的寬度是30,如果category的名稱大於30的話,就會將左邊多出的字符截掉,但小於30的話也不會有空格。 17 4)%20.30c:如果category的名稱小於20就補空格,並且右對齊,如果其名稱長於30字符,就從左邊交遠銷出的字符截掉。
6、log4j將日志輸出到文本文件
log4j配置文件:
### 設置級別和目的地(這里多個目的地) ###
log4j.rootLogger = trace,CONSOLE,zhangsanLog
log4j.logger.me=DEBUG
### 輸出到控制台 ###
log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.Target = System.out
log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{1}:%L [%t:%r]- %m%n
### 輸出到日志文件 ###
log4j.appender.zhangsanLog = org.apache.log4j.DailyRollingFileAppender
log4j.appender.zhangsanLog.File =G\:\\var\\alldata\\zhenduan\\debug.log
#log4j.appender.zhangsanLog.File =/var/alldata/zhenduan/debug.log
log4j.appender.zhangsanLog.Append = true
## 只輸出DEBUG級別以上的日志
log4j.appender.zhangsanLog.Threshold = DEBUG
#'.'yyyy-MM-dd: 每天產生一個新的文件
log4j.appender.zhangsanLog.DatePattern = '.'yyyy-MM-dd
log4j.appender.zhangsanLog.layout = org.apache.log4j.PatternLayout
log4j.appender.zhangsanLog.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] [%c{1}:%L] [%M] %m%n
log4j.additivity.zhangsanLog = false
main函數調用:
public static Logger logger1 = Logger.getLogger(Log4jTest.class); public static void main(String[] args) { //logger1 logger1.trace("我是logger1,trace"); logger1.debug("我是logger1,debug"); logger1.info("我是logger1,info"); logger1.warn("我是logger1,warn"); logger1.error("我是logger1,error"); logger1.fatal("我是logger1,fatal"); }
暫時不做說明,具體配置說明,見后續文章
7、log4j將日志輸出到文本文件,並且,每一小時生成一個文件,每天一個文件,每半天一個文件
繼續使用標題6的配置,但是需要修改幾個地方。
在6中,有這句話
log4j.appender.zhangsanLog = org.apache.log4j.DailyRollingFileAppender
這句話的意思是,寫到文件中,並且追加,那么多久生成一個文件呢?
需要修改
log4j.appender.zhangsanLog.DatePattern = '.'yyyy-MM-dd
DatePattern=’.’yyyy-ww:每周滾動一次文件,即每周產生一個新的文件。當然也可以指定按月、周、天、時和分。即對應的格式如下:
1)’.’yyyy-MM: 每月
2)’.’yyyy-ww: 每周
3)’.’yyyy-MM-dd: 每天
4)’.’yyyy-MM-dd-a: 每天兩次
5)’.’yyyy-MM-dd-HH: 每小時
6)’.’yyyy-MM-dd-HH-mm: 每分鍾
8、log4j將日志輸出到文本文件,並且,每當文本文件為3KB大時,新建一個文件。
同樣使用6的代碼:
log4j.appender.zhangsanLog = org.apache.log4j.RollingFileAppender log4j.appender.zhangsanLog.File =G\:\\var\\alldata\\zhenduan\\debug.log #log4j.appender.zhangsanLog.File =/var/alldata/zhenduan/debug.log log4j.appender.zhangsanLog.Append = true ## 輸出DEBUG級別以上的日志 log4j.appender.zhangsanLog.Threshold = DEBUG #'.'yyyy-MM-dd: 每天產生一個新的文件 log4j.appender.zhangsanLog.MaxFileSize = 2KB log4j.appender.zhangsanLog.MaxBackupIndex = 5 log4j.appender.zhangsanLog.layout = org.apache.log4j.PatternLayout log4j.appender.zhangsanLog.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] [%c{1}:%L] [%M] %m%n log4j.additivity.zhangsanLog = false
這里修改的是
log4j.appender.zhangsanLog = org.apache.log4j.RollingFileAppender
MaxFileSize,當文件達到多大存儲空間時,就新建一個文件
MaxBackupIndex,最多會新建幾個文件(如果設置的小了,當文件個數較多時,后續就不再新建文件了)
9、log4j將日志輸出到數據庫
暫無
10、log4j將日志輸出到hadoop框架中的hbase上
暫無
Log4j的日志級別
(由低到高。可以聯想到windows或unix的錯誤級別,都是類似的):
trace: 是追蹤,就是程序推進以下,你就可以寫個trace輸出,所以trace應該會特別多,不過沒關系,我們可以設置最低日志級別不讓他輸出。
debug: 調試么,我一般就只用這個作為最低級別,trace壓根不用。是在沒辦法就用eclipse或者idea的debug功能就好了么。
info: 輸出一下你感興趣的或者重要的信息,這個用的最多了。
warn: 有些信息不是錯誤信息,但是也要給程序員的一些提示,類似於eclipse中代碼的驗證不是有error 和warn(不算錯誤但是也請注意,比如以下depressed的方法)。
error: 錯誤信息。用的也比較多。
fatal: 級別比較高了。重大錯誤,這種級別你可以直接停止程序了,是不應該出現的錯誤么!不用那么緊張,其實就是一個程度的問題。
log4j的配置,說明:
Log4j支持兩種配置文件格式,一種是XML格式的文件,一種是properties格式的文件。一般我常用的是properties文件
1、log4j.rootLogger = [ level ] , appenderName, appenderName, …
level:是log4j的日志級別,優先級從高到低分別是ERROR、WARN、INFO、DEBUG。
appenderName:就是指定日志信息輸出到哪個地方。可同時指定多個輸出目的地。
2、?配置日志信息輸出目的地Appender,其語法為:
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.option = valueN
其中,Log4j提供的appender有以下幾種:
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天產生一個日志文件),
org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件),
org.apache.log4j.WriterAppender(將日志信息以流格式發送到任意指定的地方)
3、設置好appender后,針對appender的配置
也就是設置好要輸出到什么地方后,其它配置選項
(1).ConsoleAppender選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
Target=System.err:默認情況下是:System.out,指定輸出控制台
(2).FileAppender 選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
(3).DailyRollingFileAppender 選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
DatePattern=’.’yyyy-ww:每周滾動一次文件,即每周產生一個新的文件。當然也可以指定按月、周、天、時和分。即對應的格式如下:
1)’.’yyyy-MM: 每月
2)’.’yyyy-ww: 每周
3)’.’yyyy-MM-dd: 每天
4)’.’yyyy-MM-dd-a: 每天兩次
5)’.’yyyy-MM-dd-HH: 每小時
6)’.’yyyy-MM-dd-HH-mm: 每分鍾
(4).RollingFileAppender 選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
MaxFileSize=100KB: 后綴可以是KB, MB 或者是 GB. 在日志文件到達該大小時,將會自動滾動,即將原來的內容移到mylog.log.1文件。
MaxBackupIndex=2:指定可以產生的滾動文件的最大數。
4. 配置日志信息的布局,其語法為:
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.option = valueN
其中,Log4j提供的layout有以下幾種:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以靈活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串),
org.apache.log4j.TTCCLayout(包含日志產生的時間、線程、類別等等信息)
關於additivity
log4j.additivity.zhangsanLog = false
這個additivity也是很有意思的選項。
它是 子Logger 是否繼承 父Logger 的 輸出源(appender) 的標志位。具體說,默認情況下子Logger會繼承父Logger的appender,也就是說子Logger會在父Logger的appender里輸出。若是additivity設為false,則子Logger只會在自己的appender里輸出,而不會在父Logger的appender里輸出。
效果如下:
log4j.rootLogger=WARN,A2,A3 log4j.logger.test=DEBUG log4j.appender.A2=org.apache.log4j.RollingFileAppender log4j.appender.A2.File=../logs/test.log log4j.appender.A2.Encoding=UTF-8 log4j.appender.A2.Append=true log4j.appender.A2.MaxFileSize=2MB log4j.appender.A2.MaxBackupIndex=5 log4j.appender.A2.layout=org.apache.log4j.PatternLayout log4j.appender.A2.layout.ConversionPattern=%-5p %d [%t] %c{3}.%M - %m%n log4j.additivity.test.xml=false log4j.logger.test.xml=DEBUG,A3 log4j.appender.A3=org.apache.log4j.RollingFileAppender log4j.appender.A3.File=../logs/test-xml.log log4j.appender.A3.Encoding=UTF-8 log4j.appender.A3.Append=true log4j.appender.A3.MaxFileSize=2MB log4j.appender.A3.MaxBackupIndex=5 log4j.appender.A3.layout=org.apache.log4j.PatternLayout log4j.appender.A3.layout.ConversionPattern=%-5p %d [%t] %c{3}.%M - %m%n
配置文件中有
log4j.logger.test=DEBUG
log4j.additivity.test.xml=false
log4j.logger.test.xml=DEBUG,A3
這個實例中,通過log4j.additivity.test.xml=false這一句取消了繼承關系,這樣XML的log就只會在A3中輸出;而不會在再
還有一個需求,
不考慮日志級別,a.java, b.java, c.java 分別調用自己的logger,將日志分別寫入到不同的文件中。
這個需求主要是在配置文件中,給appender取個名字
然后在調用時,使用名稱的方式調用,就可以了。
public static Logger loggerA = Logger.getLogger(“Alog”);
public static Logger loggerB = Logger.getLogger(“Blog”);
public static Logger loggerC = Logger.getLogger(“Clog”);
轉自:http://www.daniubiji.cn/archives/385