ASP.NET中使用Apache log4net

 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-beta8\bin\net。找到對應的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] &lt;%X{auth}&gt; - %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/