log4j配置文件详解---转
使用步驟注意:
1. 從http://logging.apache.org/log4j/1.2/ 下載文件
2. 在src目錄下加入log4j.properties,將jar包放入build -path,log4j.properties 編譯后位于/classes目錄下。
3. ?配置文件讀取解析:
? ???PropertyConfigurator.configure(String configFilename)---->
PropertyConfigurator.java
staticpublic void configure(String configFilename) {new PropertyConfigurator().doConfigure(configFilename,LogManager.getLoggerRepository());}--->讀取配置文件
publicvoid doConfigure(String configFileName, LoggerRepository hierarchy) {Properties props = new Properties();FileInputStream istream = null;try {istream = new FileInputStream(configFileName);props.load(istream);istream.close();}catch (Exception e) {if (e instanceof InterruptedIOException || e instanceof InterruptedException) {Thread.currentThread().interrupt();}LogLog.error("Could not read configuration file ["+configFileName+"].", e);LogLog.error("Ignoring configuration file [" + configFileName+"].");return;} finally {if(istream != null) {try {istream.close();} catch(InterruptedIOException ignore) {Thread.currentThread().interrupt();} catch(Throwable ignore) {}}}// If we reach here, then the config file is alright. doConfigure(props, hierarchy);}-->讀取配置
/**Read configuration options from <code>properties</code>.See {@link #doConfigure(String, LoggerRepository)} for the expected format.*/publicvoid doConfigure(Properties properties, LoggerRepository hierarchy) {repository = hierarchy;String value = properties.getProperty(LogLog.DEBUG_KEY);if(value == null) {value = properties.getProperty("log4j.configDebug");if(value != null) {LogLog.warn("[log4j.configDebug] is deprecated. Use [log4j.debug] instead.");}}if(value != null) {LogLog.setInternalDebugging(OptionConverter.toBoolean(value, true));}//// if log4j.reset=true then// reset hierarchyString reset = properties.getProperty(RESET_KEY);if (reset != null && OptionConverter.toBoolean(reset, false)) {hierarchy.resetConfiguration();}String thresholdStr = OptionConverter.findAndSubst(THRESHOLD_PREFIX,properties);if(thresholdStr != null) {hierarchy.setThreshold(OptionConverter.toLevel(thresholdStr,Level.ALL));LogLog.debug("Hierarchy threshold set to ["+hierarchy.getThreshold()+"].");}configureRootCategory(properties, hierarchy);configureLoggerFactory(properties);parseCatsAndRenderers(properties, hierarchy);LogLog.debug("Finished configuring.");// We don't want to hold references to appenders preventing their// garbage collection. registry.clear();}?
原文:http://zengjinliang.iteye.com/blog/171550
一:log4j配置文件基本含義說明?
log4j.properties配置文件講解如下:?
# Set root logger level to DEBUG and its only appender to A1?
#log4j中有五級logger?
#FATAL 0?
#ERROR 3?
#WARN 4?
#INFO 6?
#DEBUG 7?
配置根Logger,其語法為:?
#log4j.rootLogger = [ level ] , appenderName, appenderName, …?
log4j.rootLogger=INFO, A1 ,R?
#這一句設(shè)置以為著所有的log都輸出?
#如果為log4j.rootLogger=WARN, 則意味著只有WARN,ERROR,FATAL?
#被輸出,DEBUG,INFO將被屏蔽掉.?
# A1 is set to be a ConsoleAppender.?
#log4j中Appender有幾層如控制臺、文件、GUI組件、甚至是套接口服務(wù)器、NT的事件記錄器、UNIX Syslog守護(hù)進(jìn)程等?
#ConsoleAppender輸出到控制臺?
log4j.appender.A1=org.apache.log4j.ConsoleAppender?
# A1 使用的輸出布局,其中l(wèi)og4j提供4種布局. org.apache.log4j.HTMLLayout(以HTML表格形式布局)?
#org.apache.log4j.PatternLayout(可以靈活地指定布局模式),?
#org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串),?
#org.apache.log4j.TTCCLayout(包含日志產(chǎn)生的時間、線程、類別等等信息)?
log4j.appender.A1.layout=org.apache.log4j.PatternLayout?
#靈活定義輸出格式 具體查看log4j javadoc org.apache.log4j.PatternLayout?
#d 時間 ....?
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n?
#R 輸出到文件 RollingFileAppender的擴(kuò)展,可以提供一種日志的備份功能。?
log4j.appender.R=org.apache.log4j.RollingFileAppender?
#日志文件的名稱?
log4j.appender.R.File=log4j.log?
#日志文件的大小?
log4j.appender.R.MaxFileSize=100KB?
# 保存一個備份文件?
log4j.appender.R.MaxBackupIndex=1 log4j.appender.R.layout=org.apache.log4j.TTCCLayout?
#log4j.appender.R.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n?
配置根Logger,其語法為:?
log4j.rootLogger = [ level ] , appenderName, appenderName, ...?
level 是日志記錄的優(yōu)先級?
appenderName就是指定日志信息輸出到哪個地方。您可以同時指定多個輸出目的地。?
配置日志信息輸出目的地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(每天產(chǎn)生一個日志文件),?
org.apache.log4j.RollingFileAppender(文件大小到達(dá)指定尺寸的時候產(chǎn)生一個新的文件),?
org.apache.log4j.WriterAppender(將日志信息以流格式發(fā)送到任意指定的地方)?
配置日志信息的格式(布局),其語法為:?
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(包含日志產(chǎn)生的時間、線程、類別等等信息)?
--------------------------------------------------------------------------------?
二、Log4j日志管理系統(tǒng)簡單使用說明?
-----------------------------?
摘自:http://x.discuz.net/131976/viewspace_42754.html?
Log4j有三個主要的組件:Loggers,Appenders和Layouts,這里可簡單理解為日志類別,日志要輸出的地方和日志以何種形式輸出。綜合使用這三個組件可以輕松的記錄信息的類型和級別,并可以在運(yùn)行時控制日志輸出的樣式和位置。下面對三個組件分別進(jìn)行說明:?
1、 Loggers?
??? Loggers組件在此系統(tǒng)中被分為五個級別:DEBUG、INFO、WARN、ERROR和FATAL。這五個級別是有順序的,DEBUG < INFO < WARN < ERROR < FATAL,明白這一點(diǎn)很重要,這里L(fēng)og4j有一個規(guī)則:假設(shè)Loggers級別為P,如果在Loggers中發(fā)生了一個級別Q比P高,則可以啟動,否則屏蔽掉。?
Java程序舉例來說:?
//建立Logger的一個實(shí)例,命名為“com.foo”?
Logger? logger = Logger.getLogger("com.foo");?
//設(shè)置logger的級別。通常不在程序中設(shè)置logger的級別。一般在配置文件中設(shè)置。?
logger.setLevel(Level.INFO);?
Logger barlogger = Logger.getLogger("com.foo.Bar");?
//下面這個請求可用,因為WARN >= INFO?
logger.warn("Low fuel level.");?
//下面這個請求不可用,因為DEBUG < INFO?
logger.debug("Starting search for nearest gas station.");?
//命名為“com.foo.bar”的實(shí)例barlogger會繼承實(shí)例“com.foo”的級別。因此,下面這個請求可用,因為INFO >= INFO?
barlogger.info("Located nearest gas station.");?
//下面這個請求不可用,因為DEBUG < INFO?
barlogger.debug("Exiting gas station search");?
這里“是否可用”的意思是能否輸出Logger信息。?
??? 在對Logger實(shí)例進(jìn)行命名時,沒有限制,可以取任意自己感興趣的名字。一般情況下建議以類的所在位置來命名Logger實(shí)例,這是目前來講比較有效的Logger命名方式。這樣可以使得每個類建立自己的日志信息,便于管理。比如:?
static Logger logger = Logger.getLogger(ClientWithLog4j.class.getName());?
2、 Appenders?
??? 禁用與使用日志請求只是Log4j其中的一個小小的地方,Log4j日志系統(tǒng)允許把日志輸出到不同的地方,如控制臺(Console)、文件(Files)、根據(jù)天數(shù)或者文件大小產(chǎn)生新的文件、以流的形式發(fā)送到其它地方等等。?
其語法表示為:?
org.apache.log4j.ConsoleAppender(控制臺),?
org.apache.log4j.FileAppender(文件),?
org.apache.log4j.DailyRollingFileAppender(每天產(chǎn)生一個日志文件),org.apache.log4j.RollingFileAppender(文件大小到達(dá)指定尺寸的時候產(chǎn)生一個新的文件),?
org.apache.log4j.WriterAppender(將日志信息以流格式發(fā)送到任意指定的地方)?
配置時使用方式為:?
log4j.appender.appenderName = fully.qualified.name.of.appender.class?
log4j.appender.appenderName.option1 = value1?
…?
log4j.appender.appenderName.option = valueN?
這樣就為日志的輸出提供了相當(dāng)大的便利。?
3、 Layouts?
??? 有時用戶希望根據(jù)自己的喜好格式化自己的日志輸出。Log4j可以在Appenders的后面附加Layouts來完成這個功能。Layouts提供了四種日志輸出樣式,如根據(jù)HTML樣式、自由指定樣式、包含日志級別與信息的樣式和包含日志時間、線程、類別等信息的樣式等等。?
其語法表示為:?
org.apache.log4j.HTMLLayout(以HTML表格形式布局),?
org.apache.log4j.PatternLayout(可以靈活地指定布局模式),?
org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串),?
org.apache.log4j.TTCCLayout(包含日志產(chǎn)生的時間、線程、類別等等信息)?
配置時使用方式為:?
???? log4j.appender.appenderName.layout =?????? fully.qualified.name.of.layout.class?
???? log4j.appender.appenderName.layout.option1 = value1?
???? …?
???? log4j.appender.appenderName.layout.option = valueN?
??? 以上是從原理方面說明Log4j的使用方法,在具體Java編程使用Log4j可以參照以下示例:?
1、 建立Logger實(shí)例:?
??? 語法表示:public static Logger getLogger( String name)?
??? 實(shí)際使用:static Logger logger = Logger.getLogger?? (ServerWithLog4j.class.getName ()) ;?
2、 讀取配置文件:?
??? 獲得了Logger的實(shí)例之后,接下來將配置Log4j使用環(huán)境:?
??? 語法表示:?
??? BasicConfigurator.configure():自動快速地使用缺省Log4j環(huán)境。?
??? PropertyConfigurator.configure(String configFilename):讀取使用Java的特性文件編寫的配置文件。?
??? DOMConfigurator.configure(String filename):讀取XML形式的配置文件。?
??? 實(shí)際使用:PropertyConfigurator.configure("ServerWithLog4j.properties");?
3、 插入日志信息?
??? 完成了以上連個步驟以后,下面就可以按日志的不同級別插入到你要記錄日志的任何地方了。?
??? 語法表示:?
??? Logger.debug(Object message);?
??? Logger.info(Object message);?
??? Logger.warn(Object message);?
??? Logger.error(Object message);?
??? 實(shí)際使用:logger.info("ServerSocket before accept: " + server);?
??? 在實(shí)際編程時,要使Log4j真正在系統(tǒng)中運(yùn)行事先還要對配置文件進(jìn)行定義。定義步驟就是對Logger、Appender及Layout的分別使用,具體如下:?
1、 配置根Logger,其語法為:?
??? log4j.rootLogger = [ level ] , appenderName, appenderName, …?
這里level指Logger的優(yōu)先級,appenderName是日志信息的輸出地,可以同時指定多個輸出地。如:log4j.rootLogger= INFO,A1,A2?
2、 配置日志信息輸出目的地,其語法為:?
??? log4j.appender.appenderName = fully.qualified.name.of.appender.class?
??? 可以指定上面所述五個目的地中的一個。?
3、 配置日志信息的格式,其語法為:?
??? log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class?
??? 這里上面三個步驟是對前面Log4j組件說明的一個簡化;下面給出一個具體配置例子,在程序中可以參照執(zhí)行:?
??? log4j.rootLogger=INFO,A1?
??? log4j.appender.A1=org.apache.log4j.ConsoleAppender?
??? log4j.appender.A1.layout=org.apache.log4j.PatternLayout?
??? log4j.appender.A1.layout.ConversionPattern=?
??????????????????????????????????????? %-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n?
??? 這里需要說明的就是日志信息格式中幾個符號所代表的含義:?
??? -X號: X信息輸出時左對齊;?
??? %p: 日志信息級別?
??? %d{}: 日志信息產(chǎn)生時間?
??? %c: 日志信息所在地(類名)?
??? %m: 產(chǎn)生的日志具體信息?
??? %n: 輸出日志信息換行?
根據(jù)上面的日志格式,某一個程序的輸出結(jié)果如下:?
0??? INFO? 2003-06-13 13:23:46968 ClientWithLog4j Client socket: Socket[addr=localhost/127.0.0.1,port=8002,localport=2014]?
16?? DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server says: 'Java server with log4j, Fri Jun 13 13:23:46 CST 2003'?
16?? DEBUG 2003-06-13 13:23:46984 ClientWithLog4j GOOD?
16?? DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Command 'HELLO' not understood.'?
16?? DEBUG 2003-06-13 13:23:46984 ClientWithLog4j HELP?
16?? DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Vocabulary: HELP QUIT'?
16?? DEBUG 2003-06-13 13:23:46984 ClientWithLog4j QUIT?
--------------------------------------------------------------------------------?
三、配置Log4j?
摘自:http://x.discuz.net/131976/viewspace_42752.html?
Log4J的配置文件(Configuration File)就是用來設(shè)置記錄器的級別、存放器和布局的,它可接key=value格式的設(shè)置或xml格式的設(shè)置信息。通過配置,可以創(chuàng)建出Log4J的運(yùn)行環(huán)境。?
1. 配置文件?
Log4J配置文件的基本格式如下:?
#配置根Logger?
log4j.rootLogger? =?? [ level ]?? ,? appenderName1 ,? appenderName2 ,? …?
#配置日志信息輸出目的地Appender?
log4j.appender.appenderName? =? fully.qualified.name.of.appender.class?
log4j.appender.appenderName.option1? =? value1?
…?
log4j.appender.appenderName.optionN? =? valueN?
#配置日志信息的格式(布局)?
log4j.appender.appenderName.layout? =? fully.qualified.name.of.layout.class?
log4j.appender.appenderName.layout.option1? =? value1?
…?
log4j.appender.appenderName.layout.optionN? =? valueN??
其中 [level] 是日志輸出級別,共有5級:?
FATAL????? 0??
ERROR????? 3??
WARN?????? 4??
INFO?????? 6??
DEBUG????? 7?
Appender 為日志輸出目的地,Log4j提供的appender有以下幾種:?
org.apache.log4j.ConsoleAppender(控制臺),?
org.apache.log4j.FileAppender(文件),?
org.apache.log4j.DailyRollingFileAppender(每天產(chǎn)生一個日志文件),?
org.apache.log4j.RollingFileAppender(文件大小到達(dá)指定尺寸的時候產(chǎn)生一個新的文件),?
org.apache.log4j.WriterAppender(將日志信息以流格式發(fā)送到任意指定的地方)?
Layout:日志輸出格式,Log4j提供的layout有以下幾種:?
org.apache.log4j.HTMLLayout(以HTML表格形式布局),?
org.apache.log4j.PatternLayout(可以靈活地指定布局模式),?
org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串),?
org.apache.log4j.TTCCLayout(包含日志產(chǎn)生的時間、線程、類別等等信息)?
打印參數(shù): Log4J采用類似C語言中的printf函數(shù)的打印格式格式化日志信息,如下:?
%m?? 輸出代碼中指定的消息?
%p?? 輸出優(yōu)先級,即DEBUG,INFO,WARN,ERROR,FATAL?
%r?? 輸出自應(yīng)用啟動到輸出該log信息耗費(fèi)的毫秒數(shù)?
%c?? 輸出所屬的類目,通常就是所在類的全名?
%t?? 輸出產(chǎn)生該日志事件的線程名?
%n?? 輸出一個回車換行符,Windows平臺為“\r\n”,Unix平臺為“\n”?
%d?? 輸出日志時間點(diǎn)的日期或時間,默認(rèn)格式為ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss , SSS},輸出類似:2002年10月18日? 22 : 10 : 28 , 921??
%l?? 輸出日志事件的發(fā)生位置,包括類目名、發(fā)生的線程,以及在代碼中的行數(shù)。舉例:Testlog4.main(TestLog4.java: 10 )??
2. 在代碼中初始化Logger:?
1)在程序中調(diào)用BasicConfigurator.configure()方法:給根記錄器增加一個ConsoleAppender,輸出格式通過PatternLayout設(shè)為"%-4r [%t] %-5p %c %x - %m%n",還有根記錄器的默認(rèn)級別是Level.DEBUG.?
2)配置放在文件里,通過命令行參數(shù)傳遞文件名字,通過PropertyConfigurator.configure(args[x])解析并配置;?
3)配置放在文件里,通過環(huán)境變量傳遞文件名等信息,利用log4j默認(rèn)的初始化過程解析并配置;?
4)配置放在文件里,通過應(yīng)用服務(wù)器配置傳遞文件名等信息,利用一個特殊的servlet來完成配置。?
3. 為不同的 Appender 設(shè)置日志輸出級別:?
當(dāng)調(diào)試系統(tǒng)時,我們往往注意的只是異常級別的日志輸出,但是通常所有級別的輸出都是放在一個文件里的,如果日志輸出的級別是BUG!?那就慢慢去找吧。?
這時我們也許會想要是能把異常信息單獨(dú)輸出到一個文件里該多好啊。當(dāng)然可以,Log4j已經(jīng)提供了這樣的功能,我們只需要在配置中修改Appender的Threshold 就能實(shí)現(xiàn),比如下面的例子:?
[配置文件]?
### set log levels ###?
log4j.rootLogger = debug ,? stdout ,? D ,? E?
### 輸出到控制臺 ###?
log4j.appender.stdout = org.apache.log4j.ConsoleAppender?
log4j.appender.stdout.Target = System.out?
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout?
log4j.appender.stdout.layout.ConversionPattern =? %d{ABSOLUTE} %5p %c{ 1 }:%L - %m%n?
### 輸出到日志文件 ###?
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender?
log4j.appender.D.File = logs/log.log?
log4j.appender.D.Append = true?
log4j.appender.D.Threshold = DEBUG ## 輸出DEBUG級別以上的日志?
log4j.appender.D.layout = org.apache.log4j.PatternLayout?
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}? [ %t:%r ] - [ %p ]? %m%n?
### 保存異常信息到單獨(dú)文件 ###?
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender?
log4j.appender.D.File = logs/error.log ## 異常日志文件名?
log4j.appender.D.Append = true?
log4j.appender.D.Threshold = ERROR ## 只輸出ERROR級別以上的日志!!!?
log4j.appender.D.layout = org.apache.log4j.PatternLayout?
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}? [ %t:%r ] - [ %p ]? %m%n?
[代碼中使用]?
? public?? class? TestLog4j?? {?
???? public?? static?? void? main(String[] args)?? {?
??????? PropertyConfigurator.configure( " D:/Code/conf/log4j.properties " );?
??????? Logger logger? =? Logger.getLogger(TestLog4j. class );?
??????? logger.debug( " debug " );?
??????? logger.error( " error " );?
??? }?
}?
運(yùn)行一下,看看異常信息是不是保存在了一個單獨(dú)的文件error.log中。
?
轉(zhuǎn)載于:https://www.cnblogs.com/davidwang456/p/4104888.html
總結(jié)
以上是生活随笔為你收集整理的log4j配置文件详解---转的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 解决java.sql.SQLExcept
- 下一篇: jboss7 Java API for