前言

log4net是.Net下一個非常優(yōu)秀的開源日志記錄組件。log4net記錄日志的功能非常強(qiáng)大。它可以將日志分不同的等級，以不同的格式，輸出到不同的媒介。本文主要是簡單的介紹如何在Visual Studio2010(Asp.Net Mvc3.0)中使用log4net快速創(chuàng)建系統(tǒng)日志，如何擴(kuò)展以輸出自定義字段。

用戶可以從http://logging.apache.org/log4net/下載log4net的源代碼。解壓軟件包后，在解壓的src目錄下將log4net.sln載入Visual Studio .NET，編譯后可以得到log4net.dll。用戶要在自己的程序里加入日志功能，只需將log4net.dll引入工程即可。

在項(xiàng)目中配置

第一步：首先在項(xiàng)目中引用log4net.dll文件。

第二步：在Web.config文件中進(jìn)行添加configSections的節(jié)點(diǎn)

  <configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
    <!--配置一個結(jié)點(diǎn) 名稱為log4net-->
  </configSections>

第三步：添加log4net配置節(jié)點(diǎn)

<log4net debug="true">
</log4net>

然后在log4net節(jié)點(diǎn)下添加

寫入本地文本文件中的配置

 

         <appender name="LogFileAppender" type="log4net.Appender.FileAppender" >
             <!--定義的是日志記錄到文件的附著器 name表示該附著器的名稱-->         
             <!--在log4net中還有一個附著器RollingFileAppender 它表示會循環(huán)生成很多文件，舉例來說，就是設(shè)置一共可以生成20個文件，每個文件的大小為2K，那么如果第一個、-->          
             <!--文件的大小超過2K，就會自動創(chuàng)建一個按順序命名的文件-->
             <param name="File" value="c:\Log\DBLog.txt" /> <!--日志記錄的存在路徑-->
             <param name="AppendToFile" value="true" /><!--為true就表示日志會附加到文件，為false，則會重新創(chuàng)建一個新文件-->
             <layout type="log4net.Layout.PatternLayout">
               <!--輸出內(nèi)容控制-->
               <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
             </layout>     
         </appender>

 

注釋很清楚，就不解釋了。

寫入指定郵箱的配置

 

        <appender name="SmtpAppender" type="log4net.Appender.SmtpAppender">
        <!--設(shè)置發(fā)送電子郵件的附著器-->
            <authentication value="Basic" />
            <to value="[email protected]" />
            <from value="[email protected]" />
            <username value="帳號" />
            <password value="密碼" />
            <subject value="程序異常日志記錄郵件發(fā)送" />
            <smtpHost value="smtp.163.com" />
            <bufferSize value="512" />
            <lossy value="true" />
            <evaluator type="log4net.Core.LevelEvaluator">
               <threshold value="debug"/>  
            </evaluator>
            <layout type="log4net.Layout.PatternLayout">
                 <conversionPattern value="%newline%date [%thread] %-5level %logger [%property{NDC}] - %message%newline%newline%newline" />    
            </layout>
        </appender>

 

通過的是163郵箱服務(wù)器發(fā)送

將日志寫入數(shù)據(jù)庫的相關(guān)配置，還要建立一張對應(yīng)的數(shù)據(jù)庫表

 

         <appender name="ADONetAppender" type="log4net.Appender.ADONetAppender">
             <!--存儲到數(shù)據(jù)庫的操作-->
             <bufferSize value="10"/>
             <connectionType value="System.Data.SqlClient.SqlConnection, System.Data, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
             <connectionString value="server=.;database=Log4Net;user id=sa;password=saa"/>
             <commandText value="INSERT INTO _Log ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date,                                @log_thread, @log_level, @log_logger, @log_message, @log_exception)"/>
             <parameter>
                 <parameterName value="@log_date"/>
                 <dbType value="DateTime"/>
                 <layout type="log4net.Layout.RawTimeStampLayout"/><!--可以認(rèn)為是記錄日志的時間-->
             </parameter>
             <parameter>
                 <parameterName value="@log_thread"/>
                 <dbType value="String"/>
                 <size value="255"/>
                 <layout type="log4net.Layout.PatternLayout">
                    <conversionPattern value="%thread"/><!--記錄日志時的線程號--> 
                </layout>  
             </parameter>
             <parameter>
                 <parameterName value="@log_level"/>
                 <dbType value="String"/>
                 <size value="50"/>
                 <layout type="log4net.Layout.PatternLayout">
                    <conversionPattern value="%level"/><!--日志級別-->
                 </layout>
             </parameter>
             <parameter>
                 <parameterName value="@log_logger"/>
                 <dbType value="String"/>
                 <size value="255"/>
                 <layout type="log4net.Layout.PatternLayout">
                     <conversionPattern value="%logger"/><!--哪個記錄器存儲的該日志-->
                 </layout>
             </parameter>
             <parameter>
                 <parameterName value="@log_message"/>
                 <dbType value="String"/>
                 <size value="4000"/>
                 <layout type="log4net.Layout.PatternLayout">
                     <conversionPattern value="%message"/><!--日志信息-->
                 </layout>
             </parameter>
             <parameter>
                 <parameterName value="@log_exception"/>
                 <dbType value="String"/>
                 <size value="255"/>
                 <layout type="log4net.Layout.ExceptionLayout"/><!--異常信息-->
             </parameter>  
         </appender>

 

另外一種寫入文件的方式配置

         <appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
             <!--這個就是我在上面提到的RollingFileAppender-->
             <file value="example.log" /><!--文件名稱-->
             <appendToFile value="false" /><!--會創(chuàng)建新文件，一般設(shè)置為true，這里設(shè)置為false，是為了看到創(chuàng)建的文件-->
             <maximumFileSize value="1KB" /><!--文件大小-->
             <maxSizeRollBackups value="20" /><!--創(chuàng)建最大文件數(shù)-->
             <layout type="log4net.Layout.PatternLayout">
                <conversionPattern value="%level %thread %logger - %message%newline" />
             </layout>
         </appender>

 

在log4net節(jié)點(diǎn)中還有兩個節(jié)點(diǎn)

 

      <logger name="Loggering">
        <level value="Warn"/>
        <appender-ref ref="ADONetAppender"/>
      </logger>
      <root>
        <level value="info" />
          <!--<appender-ref ref="ADONetAppender" />-->
          <appender-ref ref="SmtpAppender"/>
          <!--<appender-ref ref="LogFileAppender"/>
          <appender-ref ref="ColoredConsoleAppender"/>
          <appender-ref ref="EventLogAppender"/>
          <append-ref ref="NetSendAppender"/>
          <appender-ref ref="RollingFile"/>-->
      </root>

 

在框架的體系里，所有的日志對象都是根日志(root logger)的后代。 因此如果一個日志對象沒有在配置文件里顯式定義，則框架使用根日志中定義的屬性。在<root>標(biāo)簽里，可以定義level級別值和Appender的列表。如果沒有定義LEVEL的值，則缺省為DEBUG。可以通過<appender-ref>標(biāo)簽定義日志對象使用的Appender對象。<appender-ref>聲明了在其他地方定義的Appender對象的一個引用。在一個logger對象中的設(shè)置會覆蓋根日志的設(shè)置。而對Appender屬性來說，子日志對象則會繼承父日志對象的Appender列表。這種缺省的行為方式也可以通過顯式地設(shè)定<logger>標(biāo)簽的additivity屬性為false而改變。

那么上面就會有數(shù)據(jù)庫日志的寫入和郵箱的寫入

在Global.asax文件初始化配置

 

        protected void Application_Start()
        {
            //讀取日志  如果使用log4net,應(yīng)用程序一開始的時候，都要進(jìn)行初始化配置
            log4net.Config.XmlConfigurator.Configure();
            
            AreaRegistration.RegisterAllAreas();

            RegisterGlobalFilters(GlobalFilters.Filters);
            RegisterRoutes(RouteTable.Routes);
        }

 

調(diào)用

 

        private static readonly log4net.ILog log = log4net.LogManager.GetLogger("Loggering");
        public ActionResult About()
        { 
             log.Info("log日志信息");
             log.Debug("debug信息");
             log.Error("error信息");
             log.Warn("warn信息");
             Exception ex = new Exception("測試的異常信息");
             log.Fatal("fatal信息", ex);
            return View();
        }

 

總結(jié)

Log4net中 DEBUG、INFO、WARN、ERROR 區(qū)分得很好。正常的 DEBUG、INFO 的日志， 就讓它記錄在 日志文件里面吧。

對于 WARN、ERROR 級別的日志， 記錄到日志文件的同時， 順便發(fā)送電子郵件到我的信箱里面。 這樣一來， 我也不必每天去看日志文件， 二來，出了什么問題， 能及時通過電子郵件得到通知。

示例代碼下載鏈接http://url.cn/Tz89RW

數(shù)據(jù)庫結(jié)構(gòu)

create database Log4Net
go
use Log4Net
create table _log
(
    id int identity(1,1) primary key not null,
    date datetime null,
    thread int null,
    level varchar(10) null,
    logger varchar(20) null,
    Message varchar(100) null,
    Exception varchar(100) null
)

還待優(yōu)化，有空了再來琢磨琢磨。