log4net是Apache log4j的.net版,是一套XML配置型的日誌引擎,剛好最近有個程式需要日誌系統,為了整合方便,就決定研究一下。感謝郝偉推薦。
log4net系統分割了7個日誌等級,例如設定為"WARN",則DEBUG,INFO不會被記錄。如下:
1. ALL
2. DEBUG
3. INFO
4. WARN
5. ERROR
6. FATAL
7. OFF
Creating the Sample Application
Step 1: 下載log4net
去logging.apache.org/log4net,來取得他們的最近版,在範例裡我用的是incubating-log4net-1.2.9-beta.zip,期待正式版。
Step 2: 建立ASP.NET Web 應用程式
建立這個就不多說了,在log4net-1.2.0-beta8binnet如圖。找到對應的dll,加入到引用裡。有的版本沒有編譯好的dll,那就自己編一下吧,用.NET V1.0的版本轉換成1.1或2.0的版本。我覺得這不是工作失誤,是故意的。他們玩java玩慣了的人好多都是這樣。
Configuring the Sample Application
Step 3: 新增Assembly資訊
開啟AssemblyInfo.cs文件,新增:
[assembly: log4net.Config.DOMConfigurator()]
這句話的意思是log4net系統會自動尋找設定檔Web.config而取得並載入其中的設定資訊。如果想log4net隨時監視設定檔以便重新載入的話就稍微麻煩點了要這樣寫:
[assembly:log4net.Config.DOMConfigurator(ConfigFile="filename",ConfigFileExtension="log4net",Watch=true)]
Step 4: 新增設定資訊
要編輯Web.config檔了,真是每次看見它都有驚喜啊。找到configuration標籤,configSections要緊挨著寫到它下面(一點都不替別人考慮,要在有一個也跟他一樣霸道怎麼辦?那就單寫個它的日誌配置文件吧!我估計APACHE他們就是這麼想的)。看看例子:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="log4net"
type="log4net.Config.Log4NetConfigurationSectionHandler, log4net-net-1.0"
/>
</configSections >
<!-- This section contains the log4net configuration settings -->
<log4net>
<!-- Define some output appenders -->
<appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
<layout type=" log4net.Layout.PatternLayout">
<param name="ConversionPattern" value="%d [%t] %-5p %c [%x] <%X{auth}> - %m%n" />
< /layout>
</appender>
<!-- RollingFileAppender looks after rolling over files by size or date -->
<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
<param name="File" value= "C:\log\RollingLogHelloWorld.log" />
<param name="AppendToFile" value="true" />
<param name="MaxSizeRollBackups" value="10" />
<param name="MaximumFileSize" value ="1000" />
<param name="RollingStyle" value="Size" />
<param name="StaticLogFileName" value="true" />
<layout type="log4net.Layout.PatternLayout">
<param name= "ConversionPattern" value="%d [%t] %-5p %-45c [%x] - %m%n" />
</layout>
</appender>
<!-- FileAppender appends to a log and it is manually managed or size -->
<appender name="FileAppender" type="log4net.Appender.FileAppender">
<param name="File" value="LogHelloWorld.log" />
<!-- Example using environment variables in params -->
<!-- <param name="File" value="${TMP}\ApplicationKit.log" /> -->
<param name="AppendToFile" value="true" />
<layout type= "log4net.Layout.PatternLayout">
<param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
</layout>
</appender>
< !-- Setup the root category, add the appenders and set the default level -->
<root>
<level value="INFO" />
<appender-ref ref="ConsoleAppender" />
</root>
<!-- ApplicationKit category - the presentation UI -->
<logger name="WebForm1">
<level value="INFO" />
<appender-ref ref="FileAppender" />
</logger>
</log4net>
</configuration>
注意Logger節點的NAME屬性設的是WebForm1,這裡指的是類別名稱。要為每一個需要新增LOG的類別都新增一個這樣的節點。想起了OSWORKFLOW工作流程了,靈活與方便實用往往不可兼得。這裡的等級是INFO,也就是說,INFO以下的不會被記錄。
Running the Sample Application
Step 5: 添加一個Log 類別
首先是添加引用
using log4net;using log4net.Config; //然後是實例化如果認真研究了配置文件,那麼這個聲明方式就很好理解了:private static readonly ILog log = LogManager. GetLogger("WebForm1");
Step 6: 使用Log物件
到了現在,所有的設定工作都已經完成了,接下來的工作就是測試一下,把他和應用層連起來。隨便加一個按鈕在回應事件Button1_Click event handler.中加入
log.Info("Hello World, I am a logger");
Step 7: Run the Application
現在可以運作了,應該是這樣子的:
這樣每次點擊按鈕,在日至檔案中就會出現
2006-02-13 10:12:30,671 [1228] INFO WebForm1 [] - Hello World, I am a logger這樣一筆記錄。
總結:
簡單易用,過一陣再研究SQL日誌吧,DB才素王道,呵呵。
更多資訊請見http://logging.apache.org/log4net/