碼上快樂

相關內容    簡體    繁體

Log4Net使用詳解

本文轉載自   查看原文   2015-03-06 09:06   10131    C#/ Log4Net/ 系統日志記錄/ 日志

1.Log4Net環境的搭建與基本配置

(1)Log4Net框架介紹
    Log4net 是 Apache 下一個開放源碼的項目，它是Log4j 的一個克隆版。我們可以控制日志信息的輸出目的地。Log4net中定義了多種日志信息輸出模式。它可以根據需要將日志輸出到控制台，文本文件，windows 日志事件查看器中，包括數據庫，郵件等等位置，以便我們快速跟蹤程序bug。
(2)Log4Net的環境配置以及簡單使用
    程序代碼： 
   
   
   
           
    
    
    
    
            
  1. [assembly: log4net.Config.XmlConfigurator(Watch = true)]
    2. 
    
    
    
            
  2. namespace APP02
    3. 
    
    
    
            
  3. {
    4. 
    
    
    
            
  4.  class Program
    5. 
    
    
    
            
  5.  {
    6. 
    
    
    
            
  6.  static void Main(string[] args)
    7. 
    
    
    
            
  7.  {
    8. 
    
    
    
            
  8.  ILog log = log4net.LogManager.GetLogger("Test");
    9. 
    
    
    
            
  9.  log.Error("錯誤", new Exception("發生了一個異常"));//錯誤
    10. 
    
    
    
            
  10.  log.Fatal("嚴重錯誤", new Exception("發生了一個致命錯誤"));//嚴重錯誤
    11. 
    
    
    
            
  11.  log.Info("信息"); //記錄一般信息
    12. 
    
    
    
            
  12.  log.Debug("調試信息");//記錄調試信息
    13. 
    
    
    
            
  13.  log.Warn("警告");//記錄警告信息
    14. 
    
    
    
            
  14.  Console.WriteLine("日志記錄完畢。");
    15. 
    
    
    
            
  15.  Console.Read();
    16. 
    
    
    
            
  16.  }
    17. 
    
    
    
            
  17.  }
    18. 
    
    
    
            
  18. }
    19.
    App.config文件配置： 
   
   
   
           
    
    
    
    
            
  1. <?xml version="1.0" encoding="utf-8" ?>
    2. 
    
    
    
            
  2. <configuration>
    3. 
    
    
    
            
  3.  <configSections>
    4. 
    
    
    
            
  4.  <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>
    5. 
    
    
    
            
  5.  </configSections>
    6. 
    
    
    
            
  6.  <log4net>
    7. 
    
    
    
            
  7.  <appender name="控制台輸出" type="log4net.Appender.ConsoleAppender">
    8. 
    
    
    
            
  8.  <layout type="log4net.Layout.PatternLayout">
    9. 
    
    
    
            
  9.  <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
    10. 
    
    
    
            
  10.  </layout>
    11. 
    
    
    
            
  11.  </appender>
    12. 
    
    
    
            
  12.  <logger name="Test">
    13. 
    
    
    
            
  13.  <level value="ALL"/>
    14. 
    
    
    
            
  14.  <appender-ref ref="控制台輸出" />
    15. 
    
    
    
            
  15.  </logger>
    16. 
    
    
    
            
  16.  </log4net>
    17. 
    
    
    
            
  17. </configuration>
    18.
    運行結果：

2.Log4Net結構

(1)Log4Net核心組件
    Log4net主要分為5個核心組件: Logger, Appender, Filter, Layout, Object Render。
(2)Logger介紹
    Logger是負責日志的記錄者，假設我們需要記錄一些正常的運行時日志和出現異常時的錯誤日志，那么我們可以通過在配置文件當中添加兩個Logger實現。Logger主要用於記錄日志的分類和控制日志的級別。它可以以多種格式輸出日志信息，同時它也可以控制日志的輸出級別。
    log4net使用繼承體系，也就是說假如存在兩個Logger，名字分別為a.b.c和a.b。那么a.b就是a.b.c的祖先。每個Logger都繼承了它祖先的屬性。
(3)Appender介紹
    Appender提供記錄的介質，我們可能要將日志輸出到控制台，文本文件，windows 日志事件查看器中，包括數據庫，郵件等等位置。我們可以通過Appender配置實現，而且Log4Net當中已經默認提供了一些常用的Appender，我們可以簡單地修改一些配置文件就實現同時向數據庫和同時向文件中寫入的功能。
(4)Filter介紹
    Filter就是過濾器，使用過濾器可以過濾掉Appender輸出的部分內容，只輸出感興趣的日志。
(5)Layout介紹
    Layout用於控制Appender的輸出格式，可以使線性的也可以使XML。一個Appender只能有一個Layout配置。
(6)Object Render介紹
    Object Render將告訴logger如何把一個對象轉化為一個字符串記錄到日志里。ILog中定義的記錄日志的方法接收的參數是Object，而不是String。
    例如你想把Orange對象記錄到日志中，但此時logger只會調用Orange默認的ToString方法而已。所以要定義一個OrangeRender類實現log4net.ObjectRender.IObjectRender接口，然后注冊它。這時logger就會知道如何把Orange記錄到日志中了。

3.logger節點配置詳解

(1)logger節點配置
    logger節點支持的屬性：name、additivity。
        name        必須的，logger的名稱，在代碼中得到ILog對象時用到。
        additivity  可選，取值是true或false，默認值是true。設置為false時將阻止父logger中的appender。
    logger支持的子元素：level、appender-ref、param。
        level           最多一個。在這個級別或之上的才會被記錄。OFF、FATAL、ERROR、WARN 、INFO、DEBUG、ALL
        appender-ref    0個或多個，要引用的appender的名字。
        param           0個或多個，設置一些參數。
(2)日志級別等級
    高到底分別為：OFF > FATAL > ERROR > WARN > INFO > DEBUG  > ALL
(3)ILog對象說明
    ILog是實現Logger的一個接口，ILog定義了5個方法(Debug,Inof,Warn,Error,Fatal)分別對不同的日志等級記錄日志。這5個方法都有1個重載，以Debug為例說明一下，其它的和它差不多。
    ILog中對Debug方法的定義如下：
        void Debug(object message);
        void Debug(object message, Exception exception);
    還有一個布爾屬性：
        bool IsDebugEnabled { get; }
    如果使用Debug(object message, Exception exception)則無論Layout如何配置，日志都會輸出Exception信息，包括Exception的Message和Trace。如果使用Debug(object message)，則無論Layout如何配置是不會輸出Exception信息的。
    在代碼中可以使用LogManager類來得到Logger配置下的相應的ILog對象，LogManager類用來管理所應得Logger，它的GetLogger靜態方法，可以獲得配置文件中相應的Logger，代碼如下：
        ILog log = LogManager.GetLogger("logger-name")
(4)logger配置使用示例
    使用多個appender同事到控制台與文件中輸出日志 
   
   
   
           
    
    
    
    
            
  1. <log4net>
    2. 
    
    
    
            
  2.  <logger additivity="true" name="Test">
    3. 
    
    
    
            
  3.  <level value="ALL"/>
    4. 
    
    
    
            
  4.  <appender-ref ref="控制台輸出"/>
    5. 
    
    
    
            
  5.  <appender-ref ref="文件輸出"/>
    6. 
    
    
    
            
  6.  </logger>
    7. 
    
    
    
            
  7.  <appender name="控制台輸出" type="log4net.Appender.ConsoleAppender">
    8. 
    
    
    
            
  8.  <layout type="log4net.Layout.PatternLayout">
    9. 
    
    
    
            
  9.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    10. 
    
    
    
            
  10.  </layout>
    11. 
    
    
    
            
  11.  </appender>
    12. 
    
    
    
            
  12.  <appender name="文件輸出" type="log4net.Appender.FileAppender">
    13. 
    
    
    
            
  13.  <param name="File" value="F:log-file.txt" />
    14. 
    
    
    
            
  14.  <layout type="log4net.Layout.PatternLayout">
    15. 
    
    
    
            
  15.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    16. 
    
    
    
            
  16.  </layout>
    17. 
    
    
    
            
  17.  </appender>
    18. 
    
    
    
            
  18. </log4net>
    19.
    使用logger的繼承機制 
   
   
   
           
    
    
    
    
            
  1. <log4net xmlns="urn:log4net">
    2. 
    
    
    
            
  2.  <logger xmlns="" name="Base">
    3. 
    
    
    
            
  3.  <appender-ref ref="文件輸出"/>
    4. 
    
    
    
            
  4.  </logger>
    5. 
    
    
    
            
  5.  <logger xmlns="" name="Base.Test"><!-- 繼承Base-->
    6. 
    
    
    
            
  6.  <level value="ALL"/>
    7. 
    
    
    
            
  7.  <appender-ref ref="控制台輸出"/>
    8. 
    
    
    
            
  8.  </logger>
    9. 
    
    
    
            
  9.  <appender xmlns="" name="控制台輸出" type="log4net.Appender.ConsoleAppender">
    10. 
    
    
    
            
  10.  <layout type="log4net.Layout.PatternLayout">
    11. 
    
    
    
            
  11.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    12. 
    
    
    
            
  12.  </layout>
    13. 
    
    
    
            
  13.  </appender>
    14. 
    
    
    
            
  14.  <appender xmlns="" name="文件輸出" type="log4net.Appender.FileAppender">
    15. 
    
    
    
            
  15.  <param name="File" value="F:log-file.txt" />
    16. 
    
    
    
            
  16.  <layout type="log4net.Layout.PatternLayout">
    17. 
    
    
    
            
  17.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    18. 
    
    
    
            
  18.  </layout>
    19. 
    
    
    
            
  19.  </appender>
    20. 
    
    
    
            
  20. </log4net>
    21.

4.appender節點配置詳解

(1)appender節點配置
    支持的屬性：name、type(name屬性必須唯一，type屬性必須指定)。
        name    必須的，appender對象的名稱
        type    必須的，appender對象的輸出類型
    常用的子元素：appender-ref、filter、layout、param
        appender-ref    0個或多個，允許此appender引用其他appender，並不是所以appender類型都支持。
        filter          0個或多個，定義此appender使用的過濾器。
        layout          最多一個。定義appender使用的輸出格式。
        param           0個或多個， 設置Appender類中對應的屬性的值。
(2)appender的輸出方式(type屬性)
    AdoNetAppender              將日志記錄到數據庫中。可以采用SQL和存儲過程兩種方式。
    AnsiColorTerminalAppender   將日志高亮輸出到ANSI終端。
    AspNetTraceAppender         能用asp.net中Trace的方式查看記錄的日志。
    BufferingForwardingAppender 在輸出到子Appenders之前先緩存日志事件。
    ConsoleAppender             將日志輸出到應用程序控制台。
    EventLogAppender            將日志寫到Windows Event Log。
    FileAppender                將日志輸出到文件。
    ForwardingAppender          發送日志事件到子Appenders。
    LocalSyslogAppender         將日志寫到local syslog service (僅用於UNIX環境下)。
    MemoryAppender              將日志存到內存緩沖區。
    NetSendAppender             將日志輸出到Windows Messenger service.這些日志信息將在用戶終端的對話框中顯示。
    OutputDebugStringAppender   將日志輸出到Debuger，如果程序沒有Debuger，就輸出到系統Debuger。如果系統Debuger也不可用，將忽略消息。
    RemoteSyslogAppender        通過UDP網絡協議將日志寫到Remote syslog service。
    RemotingAppender            通過.NET Remoting將日志寫到遠程接收端。
    RollingFileAppender         將日志以回滾文件的形式寫到文件中。
    SmtpAppender                將日志寫到郵件中。
    SmtpPickupDirAppender       將消息以文件的方式放入一個目錄中，像IIS SMTP agent這樣的SMTP代理就可以閱讀或發送它們。
    TelnetAppender              客戶端通過Telnet來接受日志事件。
    TraceAppender               將日志寫到.NET trace 系統。
    UdpAppender                 將日志以無連接UDP數據報的形式送到遠程宿主或用UdpClient的形式廣播。
(3)appender配置使用示例
    以回滾文件的形式記錄日志 
   
   
   
           
    
    
    
    
            
  1. <appender name="文件輸出" type="log4net.Appender.RollingFileAppender">
    2. 
    
    
    
            
  2.  <file value="F:\log\Log.txt" />
    3. 
    
    
    
            
  3.  <appendToFile value="true" />
    4. 
    
    
    
            
  4.  <rollingStyle value="Size" />
    5. 
    
    
    
            
  5.  <maxSizeRollBackups value="10" />
    6. 
    
    
    
            
  6.  <maximumFileSize value="5MB" />
    7. 
    
    
    
            
  7.  <staticLogFileName value="true" />
    8. 
    
    
    
            
  8.  <layout type="log4net.Layout.PatternLayout">
    9. 
    
    
    
            
  9.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    10. 
    
    
    
            
  10.  </layout>
    11. 
    
    
    
            
  11. </appender>
    12.
    使用過濾器記錄日志 
   
   
   
           
    
    
    
    
            
  1. <appender name="控制台輸出" type="log4net.Appender.ConsoleAppender">
    2. 
    
    
    
            
  2.  <layout type="log4net.Layout.PatternLayout">
    3. 
    
    
    
            
  3.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    4. 
    
    
    
            
  4.  </layout>
    5. 
    
    
    
            
  5.  <filter type="log4net.Filter.LevelMatchFilter">
    6. 
    
    
    
            
  6.  <levelToMatch value="FATAL"/>
    7. 
    
    
    
            
  7.  </filter>
    8. 
    
    
    
            
  8.  <filter type="log4net.Filter.DenyAllFilter" />
    9. 
    
    
    
            
  9. </appender>
    10.

5.filter節點配置詳解

(1)filter節點配置
    filter只能作為<appender>的子元素，type屬性表示Filter的類型。常用子元素<param>數量0個或多個，作用設置一些參數。
(2)filter的類型說明
    DenyAllFilter       阻止所有的日志事件被記錄
    LevelMatchFilter    只有指定等級的日志事件才被記錄
    LevelRangeFilter    日志等級在指定范圍內的事件才被記錄
    LoggerMatchFilter   Logger名稱匹配，才記錄
    PropertyFilter      消息匹配指定的屬性值時才被記錄
    StringMathFilter    消息匹配指定的字符串才被記錄
    MdcFilter
    NdcFilter
(3)filter的工作原理
    如果想使用LevelMatchFilter過濾器過濾日志信息，我們使用如下的配置： 
   
   
   
           
    
    
    
    
            
  1. <appender xmlns="" name="測試輸出" type="log4net.Appender.ConsoleAppender">
    2. 
    
    
    
            
  2.  <layout type="log4net.Layout.PatternLayout">
    3. 
    
    
    
            
  3.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    4. 
    
    
    
            
  4.  </layout>
    5. 
    
    
    
            
  5.  <filter type="log4net.Filter.LevelMatchFilter">
    6. 
    
    
    
            
  6.  <levelToMatch value="FATAL"/><!--只記錄等級為“FATAL”的日志信息-->
    7. 
    
    
    
            
  7.  </filter>
    8. 
    
    
    
            
  8. </appender>
    9.
    在控制台輸出的日志信息如下：
    此時，我們會覺得很奇怪，為什么所有等級的日志信息都輸出了呢？我們再修改一下配置： 
   
   
   
           
    
    
    
    
            
  1. <appender xmlns="" name="測試輸出" type="log4net.Appender.ConsoleAppender">
    2. 
    
    
    
            
  2.  <layout type="log4net.Layout.PatternLayout">
    3. 
    
    
    
            
  3.  <param name="ConversionPattern" value="%d %-5p %m %exception %n" />
    4. 
    
    
    
            
  4.  </layout>
    5. 
    
    
    
            
  5.  <filter type="log4net.Filter.LevelMatchFilter">
    6. 
    
    
    
            
  6.  <levelToMatch value="FATAL"/><!--只記錄等級為“FATAL”的日志信息-->
    7. 
    
    
    
            
  7.  </filter>
    8. 
    
    
    
            
  8.  <filter type="log4net.Filter.DenyAllFilter"/><!--在最后增加這個過濾器-->
    9. 
    
    
    
            
  9. </appender>
    10.
    現在，在控制台輸出的日志信息如下：
 
    現在，就得到了我們想要的輸出日志。其實filter的工作原理是這樣的：日志在被過濾器處理時，如果日志信息滿足當前過濾器的過濾條件時，該日志信息就會被輸出記錄，否則日志信息將被傳遞給下一個過濾器做同樣的處理，如果下一個過濾器不存在也會輸出日志信息。
(4)filter的使用示例
    記錄日志等級為“FATAL”和“ERROR”的日志信息： 
   
   
   
           
    
    
    
    
            
  1. <filter type="log4net.Filter.LevelMatchFilter">
    2. 
    
    
    
            
  2.  <levelToMatch value="FATAL"/>
    3. 
    
    
    
            
  3. </filter>
    4. 
    
    
    
            
  4. <filter type="log4net.Filter.LevelMatchFilter">
    5. 
    
    
    
            
  5.  <levelToMatch value="ERROR"/>
    6. 
    
    
    
            
  6. </filter>
    7. 
    
    
    
            
  7. <filter type="log4net.Filter.DenyAllFilter"/>
    8.
    記錄日志等級范圍從“ERROR”到“INFO”的日志信息： 
   
   
   
           
    
    
    
    
            
  1. <filter type="log4net.Filter.LevelRangeFilter">
    2. 
    
    
    
            
  2.  <levelMax value="ERROR"/>
    3. 
    
    
    
            
  3.  <levelMin value="INFO"/>
    4. 
    
    
    
            
  4. </filter>
    5. 
    
    
    
            
  5. <filter type="log4net.Filter.DenyAllFilter"/><!--不加這個過濾器也可以-->
    6.

6.Layout節點配置詳解

(1)layout節點配置
    layout節點只能作為<appender>的子元素。type屬性表示Layout的類型。常用子元素<param>數量0個或多個，作用設置一些參數。
    Layout用於控制Appender的輸出格式，可以使線性的也可以使XML。最常用的Layout應該是用戶自定義格式的PatternLayout，其次是SimpleLayout和ExceptionLayout。然后還有4個Layout，其中有兩個是輸出Xml的Layout，但是中文會有問題。ExceptionLayout需要給Logger的方法傳入Exception對象作為參數才起作用，否則就什么也不輸出。輸出的時候會包含Message和Trace。
(2)layout節點的type屬性取值
    ExceptionLayout         只呈現日志事件中異常的文本信息
    PatternLayout           可以通過類型字符串來配置的布局
    RawPropertyLayout       從日志事件中提取屬性值
    RawTimeStampLayout      從日志事件中提取日期
    RawUtcTimeStampLayout   從日志事件中提取UTC日期
    SimpleLayout            很簡單的布局
    XmlLayout               把日志事件格式化為XML元素的布局
(3)PatterLayout的格式化字符串
    %m、%message         輸出的日志消息
    %d、%datetime        輸出當前語句運行的時刻，格式%date{yyyy-MM-dd HH:mm:ss,fff}
    %r、%timestamp       輸出程序從運行到執行到當前語句時消耗的毫秒數
    %p、%level           日志的當前優先級別
    %c、%logger          當前日志對象的名稱
    %L、%line            輸出語句所在的行號
    %F、%file            輸出語句所在的文件名，警告：只在調試的時候有效，調用本地信息會影響性能
    %a、%appdomain       引發日志事件的應用程序域的名稱。
    %C、%class、%type    引發日志請求的類的全名，警告：會影響性能
    %exception           異常信息
    %u、%identity        當前活動用戶的名字，我測試的時候%identity返回都是空的。警告：會影響性能
    %l、%location        引發日志事件的名空間、類名、方法、行號。警告：會影響性能，依賴pdb文件
    %M、%method          發生日志請求的方法名，警告：會影響性能
    %n、%newline         換行符
    %x、%ndc             NDC(nested diagnostic context)
    %X、%mdc、%P、%properties  等介於 %property
    %property           輸出{log4net:Identity=, log4net:UserName=, log4net:HostName=} 
    %t、%thread         引發日志事件的線程，如果沒有線程名就使用線程號。
    %w、%username       當前用戶的WindowsIdentity,類似：HostName/Username。警告：會影響性能
    %utcdate            發生日志事件的UTC時間。例如：%utcdate{HH:mm:ss,fff}
    %%                  輸出一個百分號
(4)PatterLayout格式修飾符
    格式修飾符       對齊      最小寬 最大寬     說明
    %20logger       右對齊     20        無     如果logger名不足20個字符，就在左邊補空格
    %-20logger      左對齊     20        無     如果logger名不足20個字符，就在右邊補空格
    %.30logger      左對齊     無        30     超過30個字符將截斷
    %20.30logger    右對齊     20        30     logger名要在20到30之間，少了在左邊補空格，多了截斷
    %-20.30logger   左對齊     20        30     logger名要在20到30之間，少了在右邊補空格，多了截斷
(5)layout的使用示例 
   
   
   
           
    
    
    
    
            
  1. <layout type="log4net.Layout.PatternLayout">
    2. 
    
    
    
            
  2.  <conversionPattern value="%d [%t] %-5p %c [%x] - %m%n"/>
    3. 
    
    
    
            
  3. </layout>
    4.

7.其它節點的說明與配置

(1)param節點
    <param>元素可以是如何元素的子元素，包含的屬性：name、value、type。name：必須的，取值是父對象的參數名。value：可選的，value是一個能被轉化為參數值的字符串。type：可選的，value和type中，必須有一個屬性被指定。type是一個類型名，如果type不是在log4net程序集中定義的，就需要使用全名。
    param節點的主要作用是可以代替其他任何節點，例如： 
   
   
   
           
    
    
    
    
            
  1. <layout type="log4net.Layout.PatternLayout">
    2. 
    
    
    
            
  2.  <conversionPattern value="%5p %n"/>
    3. 
    
    
    
            
  3.  <!--可以使用：<param name="ConversionPattern" value="%5p %n"/>-->
    4. 
    
    
    
            
  4. </layout>
    5. 
    
    
    
            
  5. <filter type="log4net.Filter.LevelMatchFilter">
    6. 
    
    
    
            
  6.  <levelToMatch value="FATAL"/>
    7. 
    
    
    
            
  7.  <!--可以使用：<param name="LevelToMatch" value="FATAL"/>-->
    8. 
    
    
    
            
  8. </filter>
    9. 
    
    
    
            
  9. <filter type="log4net.Filter.DenyAllFilter" />
    10.
(2)root節點
    root節點的作用是所有其它logger都默認繼承它。root元素沒有屬性。root節點的子元素與logger一樣有appender-ref、level、param。
    使用示例： 
   
   
   
           
    
    
    
    
            
  1. <root xmlns="">
    2. 
    
    
    
            
  2.  <level value="WARN" />
    3. 
    
    
    
            
  3.  <appender-ref ref="LogFileAppender" />
    4. 
    
    
    
            
  4.  <appender-ref ref="ConsoleAppender" />
    5. 
    
    
    
            
  5. </root>
    6.
(3)log4net節點
    Log4net節點是整個日志配置的根節點，包含的屬性：debug、update、threshold。debug：可選，取值是true或false，默認是false。設置為true，開啟log4net的內部調試。update：可選，取值是Merge(合並)或Overwrite(覆蓋)，默認值是Merge。設置為Overwrite，在提交配置的時候會重置已經配置過的庫。threshold：可選，取值是repository（庫）中注冊的level，默認值是ALL。
    Log4net節點支持的子元素：appender(0或多個)、logger (0或多個)、renderer (0或多個)、root(最多一個)、param(0或多個)。
(4)configSections節點
    配置log4net需要在configSections節點中加入節點section，例如： 
   
   
   
           
    
    
    
    
            
  1. <configSections>
    2. 
    
    
    
            
  2.  <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>
    3. 
    
    
    
            
  3. </configSections>
    4.

8.配置文件

(1)配置文件結構圖

(2)配置文件示例 
   
   
   
           
    
    
    
    
            
  1. <log4net xmlns="urn:log4net">
    2. 
    
    
    
            
  2.  <root xmlns="">
    3. 
    
    
    
            
  3.  <level value="FATAL"/>
    4. 
    
    
    
            
  4.  <appender-ref ref="控制台輸出"/>
    5. 
    
    
    
            
  5.  </root>
    6. 
    
    
    
            
  6.  <logger xmlns="" name="Test">
    7. 
    
    
    
            
  7.  <level value="ALL"/>
    8. 
    
    
    
            
  8.  <appender-ref ref="控制台輸出"/>
    9. 
    
    
    
            
  9.  </logger>
    10. 
    
    
    
            
  10.  <logger xmlns="" name="Test.lzw" additivity="false">
    11. 
    
    
    
            
  11.  <level value="WARN"/>
    12. 
    
    
    
            
  12.  <appender-ref ref="文件輸出"/>
    13. 
    
    
    
            
  13.  </logger>
    14. 
    
    
    
            
  14.  <appender xmlns="" name="控制台輸出" type="log4net.Appender.ConsoleAppender">
    15. 
    
    
    
            
  15.  <layout type="log4net.Layout.PatternLayout">
    16. 
    
    
    
            
  16.  <conversionPattern value="%5p %n"/>
    17. 
    
    
    
            
  17.  </layout>
    18. 
    
    
    
            
  18.  <filter type="log4net.Filter.LevelMatchFilter">
    19. 
    
    
    
            
  19.  <levelToMatch value="FATAL"/>
    20. 
    
    
    
            
  20.  </filter>
    21. 
    
    
    
            
  21.  <filter type="log4net.Filter.DenyAllFilter" />
    22. 
    
    
    
            
  22.  </appender>
    23. 
    
    
    
            
  23.  <appender xmlns="" name="文件輸出" type="log4net.Appender.FileAppender">
    24. 
    
    
    
            
  24.  <file value="F:\ServerLog.txt" />
    25. 
    
    
    
            
  25.  <appendToFile value="false"/>
    26. 
    
    
    
            
  26.  <layout type="log4net.Layout.PatternLayout">
    27. 
    
    
    
            
  27.  <param name="ConversionPattern" value="%property %n" />
    28. 
    
    
    
            
  28.  </layout>
    29. 
    
    
    
            
  29.  </appender>
    30. 
    
    
    
            
  30. </log4net>
    31.
(3)關聯配置文件
    log4net默認關聯的是應用程序的配置文件App.config或Web.config，可以使用程序集自定義屬性來進行設置。下面來介紹一下這個自定義屬性：log4net.Config.XmlConifguratorAttribute。
    XmlConfiguratorAttribute有3個屬性：ConfigFile、ConfigFileExtension、Watch。
    ConfigFile：配置文件的名字，文件路徑相對於應用程序目錄。ConfigFileExtension：配置文件的擴展名，文件路徑相對於應用程序的目錄，不能和ConfigFile屬性一起使用。Watch：如果將Watch屬性設置為true，就會監視配置文件，當配置文件發生變化的時候，就會重新加載。例如：
          // 監視默認的配置文件，App.exe.config 
          [ assembly : log4net.Config. XmlConfigurator (Watch = true )]
 
          // 配置文件：App.exe.log4net
          [ assembly : log4net.Config. XmlConfigurator (ConfigFileExtension = "log4net" )]
 
          // 配置文件：log4net.config
          [ assembly : log4net.Config. XmlConfigurator (ConfigFile = "log4net.config" )]
     也可以在Global.asax的Application_Start里或者是Program.cs中的Main方法中添加，注意這里一定是絕對路徑，如下所示：
           log4net.Config. XmlConfigurator .Configure( new FileInfo ( @"F:/log4net.config" ));
(4)Log4j的配置文件例子 
   
   
   
           
    
    
    
    
            
  1. <?xml version="1.0" encoding="UTF-8" ?> 
    2. 
    
    
    
            
  2. <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
    3. 
    
    
    
            
  3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    4. 
    
    
    
            
  4.  <!-- 
    5. 
    
    
    
            
  5.  根節點的配置順序：
    6. 
    
    
    
            
  6.  renderer
    7. 
    
    
    
            
  7.  appender
    8. 
    
    
    
            
  8.  plugin
    9. 
    
    
    
            
  9.  logger
    10. 
    
    
    
            
  10.  category
    11. 
    
    
    
            
  11.  root
    12. 
    
    
    
            
  12.  loggerfactory
    13. 
    
    
    
            
  13.  categoryfactory
    14. 
    
    
    
            
  14.  -->
    15. 
    
    
    
            
  15.  <!-- ========================================================================================= -->
    16. 
    
    
    
            
  16.  <!-- 
    17. 
    
    
    
            
  17.  org.apache.log4j.ConsoleAppender 控制台輸出
    18. 
    
    
    
            
  18.  org.apache.log4j.FileAppender 文件日志輸出
    19. 
    
    
    
            
  19.  org.apache.log4j.DailyRollingFileAppender 每個時間段產生一個日志文件
    20. 
    
    
    
            
  20.  org.apache.log4j.RollingFileAppender 文件大小到達指定尺寸的時候產生一個新的文件
    21. 
    
    
    
            
  21.  org.apache.log4j.WriterAppender 將日志信息以流格式發送到任意指定的地方
    22. 
    
    
    
            
  22.  org.apache.log4j.net.SMTPAppender 發郵件輸出日志
    23. 
    
    
    
            
  23.  org.apache.log4j.net.SocketAppender Socket日志
    24. 
    
    
    
            
  24.  org.apache.log4j.nt.NTEventLogAppender Window NT日志
    25. 
    
    
    
            
  25.  org.apache.log4j.net.SyslogAppender
    26. 
    
    
    
            
  26.  org.apache.log4j.net.JMSAppender
    27. 
    
    
    
            
  27.  org.apache.log4j.AsyncAppender
    28. 
    
    
    
            
  28.  org.apache.log4j.varia.NullAppender
    29. 
    
    
    
            
  29.  org.apache.log4j.jdbc.JDBCAppender 
    30. 
    
    
    
            
  30.  -->
    31. 
    
    
    
            
  31.  <!-- ========================================================================================= -->
    32. 
    
    
    
            
  32.  <!-- 
    33. 
    
    
    
            
  33.  控制台輸出：org.apache.log4j.ConsoleAppender
    34. 
    
    
    
            
  34.  Threshold=WARN 指定日志消息的輸出最低層次。 
    35. 
    
    
    
            
  35.  ImmediateFlush=true 默認值是 true,意謂着所有的消息都會被立即輸出。 
    36. 
    
    
    
            
  36.  Target=System.err 默認情況下是：System.out,指定輸出控制台 
    37. 
    
    
    
            
  37.  -->
    38. 
    
    
    
            
  38.  <appender name="Console" class="org.apache.log4j.ConsoleAppender">
    39. 
    
    
    
            
  39.  <param name="Threshold" value="ALL"></param>
    40. 
    
    
    
            
  40.  <param name="ImmediateFlush" value="true"></param>
    41. 
    
    
    
            
  41.  <param name="Target" value="System.out"></param>
    42. 
    
    
    
            
  42.  <layout class="org.apache.log4j.TTCCLayout" />
    43. 
    
    
    
            
  43.  </appender>
    44. 
    
    
    
            
  44.  <!-- ========================================================================================= -->
    45. 
    
    
    
            
  45.  <!-- 
    46. 
    
    
    
            
  46.  文件日志輸出：org.apache.log4j.FileAppender
    47. 
    
    
    
            
  47.  Threshold=WARN 指定日志消息的輸出最低層次。 
    48. 
    
    
    
            
  48.  ImmediateFlush=true 默認值是 true,意謂着所有的消息都會被立即輸出。 
    49. 
    
    
    
            
  49.  File=mylog.txt 指定消息輸出到 mylog.txt 文件。 
    50. 
    
    
    
            
  50.  Append=false 默認值是 true,即將消息增加到指定文件中，false 指將消息覆蓋指定的文件內容。 
    51. 
    
    
    
            
  51.  -->
    52. 
    
    
    
            
  52.  <appender name="File" class="org.apache.log4j.FileAppender">
    53. 
    
    
    
            
  53.  <param name="Threshold" value="ALL"></param>
    54. 
    
    
    
            
  54.  <param name="ImmediateFlush" value="true"></param>
    55. 
    
    
    
            
  55.  <param name="File" value="F:\\FileAppender.txt"></param>
    56. 
    
    
    
            
  56.  <param name="Append" value="false"></param>
    57. 
    
    
    
            
  57.  <layout class="org.apache.log4j.TTCCLayout" />
    58. 
    
    
    
            
  58.  </appender>
    59. 
    
    
    
            
  59.  <!-- ========================================================================================= -->
    60. 
    
    
    
            
  60.  <!-- 
    61. 
    
    
    
            
  61.  每個時間段產生一個日志文件：org.apache.log4j.DailyRollingFileAppender
    62. 
    
    
    
            
  62.  Threshold=WARN 指定日志消息的輸出最低層次。 
    63. 
    
    
    
            
  63.  ImmediateFlush=true 默認值是 true,意謂着所有的消息都會被立即輸出。 
    64. 
    
    
    
            
  64.  File=mylog.txt 指定消息輸出到 mylog.txt 文件。 
    65. 
    
    
    
            
  65.  Append=false 默認值是 true,即將消息增加到指定文件中，false 指將消息覆蓋指定的文件內容。 
    66. 
    
    
    
            
  66.  DatePattern=.yyyy-ww 每周滾動一次文件，即每周產生一個新的文件。
    67. 
    
    
    
            
  67.  當然也可以指定按月、周、天、時和分。即對應的格式如下： 
    68. 
    
    
    
            
  68.  .yyyy-MM 每月 
    69. 
    
    
    
            
  69.  .yyyy-ww 每周 
    70. 
    
    
    
            
  70.  .yyyy-MM-dd 每天 
    71. 
    
    
    
            
  71.  .yyyy-MM-dd-a 每天兩次 
    72. 
    
    
    
            
  72.  .yyyy-MM-dd-HH 每小時 
    73. 
    
    
    
            
  73.  .yyyy-MM-dd-HH-mm 每分鍾 
    74. 
    
    
    
            
  74.  -->
    75. 
    
    
    
            
  75.  <appender name="DailyRollingFile" class="org.apache.log4j.DailyRollingFileAppender">
    76. 
    
    
    
            
  76.  <param name="Threshold" value="ALL"></param>
    77. 
    
    
    
            
  77.  <param name="ImmediateFlush" value="true"></param>
    78. 
    
    
    
            
  78.  <param name="File" value="F:\\DailyRollingFileAppender.txt"></param>
    79. 
    
    
    
            
  79.  <param name="Append" value="false"></param>
    80. 
    
    
    
            
  80.  <param name="DatePattern" value=".yyyy-MM-dd-HH-mm"></param>
    81. 
    
    
    
            
  81.  <layout class="org.apache.log4j.TTCCLayout" />
    82. 
    
    
    
            
  82.  </appender>
    83. 
    
    
    
            
  83.  <!-- ========================================================================================= -->
    84. 
    
    
    
            
  84.  <!-- 
    85. 
    
    
    
            
  85.  文件大小到達指定尺寸的時候產生一個新的文件：org.apache.log4j.RollingFileAppender
    86. 
    
    
    
            
  86.  Threshold=WARN 指定日志消息的輸出最低層次。 
    87. 
    
    
    
            
  87.  ImmediateFlush=true 默認值是 true,意謂着所有的消息都會被立即輸出。 
    88. 
    
    
    
            
  88.  File=mylog.txt 指定消息輸出到 mylog.txt 文件。 
    89. 
    
    
    
            
  89.  Append=false 默認值是 true,即將消息增加到指定文件中，false 指將消息覆蓋指定的文件內容。 
    90. 
    
    
    
            
  90.  MaxFileSize=100KB 后綴可以是 KB, MB 或者是 GB. 在日志文件到達該大小時，將會自動滾動，即將原來的內容移到 mylog.log.1 文件。 
    91. 
    
    
    
            
  91.  MaxBackupIndex=2 指定可以產生的滾動文件的最大數。 
    92. 
    
    
    
            
  92.  -->
    93. 
    
    
    
            
  93.  <appender name="RollingFile" class="org.apache.log4j.RollingFileAppender">
    94. 
    
    
    
            
  94.  <param name="Threshold" value="ALL"></param>
    95. 
    
    
    
            
  95.  <param name="ImmediateFlush" value="true"></param>
    96. 
    
    
    
            
  96.  <param name="File" value="F:\\RollingFileAppender.txt"></param>
    97. 
    
    
    
            
  97.  <param name="Append" value="false"></param>
    98. 
    
    
    
            
  98.  <param name="MaxFileSize" value="1KB"></param>
    99. 
    
    
    
            
  99.  <param name="MaxBackupIndex" value="3"></param>
    100. 
    
    
    
            
  100.  <layout class="org.apache.log4j.TTCCLayout" />
    101. 
    
    
    
            
  101.  </appender>
    102. 
    
    
    
            
  102.  <!-- ========================================================================================= -->
    103. 
    
    
    
            
  103.  <!-- ========================================================================================= -->
    104. 
    
    
    
            
  104.  <!-- 
    105. 
    
    
    
            
  105.  org.apache.log4j.HTMLLayout 以HTML表格形式布局
    106. 
    
    
    
            
  106.  org.apache.log4j.PatternLayout 可以靈活地指定布局模式
    107. 
    
    
    
            
  107.  org.apache.log4j.xml.XMLLayout XML文件布局日志
    108. 
    
    
    
            
  108.  org.apache.log4j.SimpleLayout 包含日志信息的級別和信息字符串
    109. 
    
    
    
            
  109.  org.apache.log4j.TTCCLayout 包含日志產生的時間、線程、類別等等信息 
    110. 
    
    
    
            
  110.  -->
    111. 
    
    
    
            
  111.  <!-- ========================================================================================= -->
    112. 
    
    
    
            
  112.  <!-- 
    113. 
    
    
    
            
  113.  以HTML表格形式布局：org.apache.log4j.HTMLLayout
    114. 
    
    
    
            
  114.  LocationInfo=true 默認值是false,輸出java文件名稱和行號
    115. 
    
    
    
            
  115.  Title=日志信息 默認值是"Log4J Log Messages" 
    116. 
    
    
    
            
  116.  -->
    117. 
    
    
    
            
  117.  <appender name="HTML" class="org.apache.log4j.ConsoleAppender">
    118. 
    
    
    
            
  118.  <layout class="org.apache.log4j.HTMLLayout">
    119. 
    
    
    
            
  119.  <param name="LocationInfo" value="true"></param>
    120. 
    
    
    
            
  120.  <param name="Title" value="日志信息"></param>
    121. 
    
    
    
            
  121.  </layout>
    122. 
    
    
    
            
  122.  </appender>
    123. 
    
    
    
            
  123.  <!-- ========================================================================================= -->
    124. 
    
    
    
            
  124.  <!-- 
    125. 
    
    
    
            
  125.  可以靈活地指定布局模式：org.apache.log4j.PatternLayout
    126. 
    
    
    
            
  126.  ConversionPattern=%m%n 指定怎樣格式化指定的消息，如：%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
    127. 
    
    
    
            
  127.  -->
    128. 
    
    
    
            
  128.  <appender name="Pattern" class="org.apache.log4j.ConsoleAppender">
    129. 
    
    
    
            
  129.  <layout class="org.apache.log4j.PatternLayout">
    130. 
    
    
    
            
  130.  <param name="ConversionPattern" value="級別:[%-6p] 時間:[%d{yyy-MMM-dd HH:mm:ss,SSS}] %-50l %m%n"></param>
    131. 
    
    
    
            
  131.  </layout>
    132. 
    
    
    
            
  132.  </appender>
    133. 
    
    
    
            
  133.  <!-- ========================================================================================= -->
    134. 
    
    
    
            
  134.  <!-- 
    135. 
    
    
    
            
  135.  XML文件布局日志：org.apache.log4j.xml.XMLLayout
    136. 
    
    
    
            
  136.  LocationInfo=true 默認值是 false,輸出 java 文件和行號 
    137. 
    
    
    
            
  137.  -->
    138. 
    
    
    
            
  138.  <appender name="XML" class="org.apache.log4j.ConsoleAppender">
    139. 
    
    
    
            
  139.  <layout class="org.apache.log4j.xml.XMLLayout">
    140. 
    
    
    
            
  140.  <param name="LocationInfo" value="true"></param>
    141. 
    
    
    
            
  141.  </layout>
    142. 
    
    
    
            
  142.  </appender>
    143. 
    
    
    
            
  143.  <!-- ========================================================================================= -->
    144. 
    
    
    
            
  144.  <!-- ========================================================================================= -->
    145. 
    
    
    
            
  145.  <logger name="ConsoleLog" additivity="false">
    146. 
    
    
    
            
  146.  <level value="WARN" />
    147. 
    
    
    
            
  147.  <appender-ref ref="Console" />
    148. 
    
    
    
            
  148.  </logger>
    149. 
    
    
    
            
  149.  <logger name="FileLog" additivity="false">
    150. 
    
    
    
            
  150.  <level value="WARN" />
    151. 
    
    
    
            
  151.  <appender-ref ref="File" />
    152. 
    
    
    
            
  152.  </logger>
    153. 
    
    
    
            
  153.  <logger name="DailyRollingFileLog" additivity="false">
    154. 
    
    
    
            
  154.  <level value="WARN" />
    155. 
    
    
    
            
  155.  <appender-ref ref="DailyRollingFile" />
    156. 
    
    
    
            
  156.  </logger>
    157. 
    
    
    
            
  157.  <logger name="RollingFileLog" additivity="false">
    158. 
    
    
    
            
  158.  <level value="WARN" />
    159. 
    
    
    
            
  159.  <appender-ref ref="RollingFile" />
    160. 
    
    
    
            
  160.  </logger>
    161. 
    
    
    
            
  161.  <logger name="HTMLLog" additivity="false">
    162. 
    
    
    
            
  162.  <level value="WARN" />
    163. 
    
    
    
            
  163.  <appender-ref ref="HTML" />
    164. 
    
    
    
            
  164.  </logger>
    165. 
    
    
    
            
  165.  <logger name="PatternLog" additivity="false">
    166. 
    
    
    
            
  166.  <level value="WARN" />
    167. 
    
    
    
            
  167.  <appender-ref ref="Pattern" />
    168. 
    
    
    
            
  168.  </logger>
    169. 
    
    
    
            
  169.  <logger name="XMLLog" additivity="false">
    170. 
    
    
    
            
  170.  <level value="WARN" />
    171. 
    
    
    
            
  171.  <appender-ref ref="XML" />
    172. 
    
    
    
            
  172.  </logger>
    173. 
    
    
    
            
  173.  <!-- ========================================================================================= -->
    174. 
    
    
    
            
  174.  <!-- 
    175. 
    
    
    
            
  175.  優先級：ALL < DEBUG < INFO <WARN < ERROR < FATAL < OFF 
    176. 
    
    
    
            
  176.  -->
    177. 
    
    
    
            
  177.  <root>
    178. 
    
    
    
            
  178.  <priority value="ALL" />
    179. 
    
    
    
            
  179.  <appender-ref ref="Console" />
    180. 
    
    
    
            
  180.  </root>
    181. 
    
    
    
            
  181. </log4j:configuration> 
    182.
-------------------------------------------------------------------------------------------------------------------------------





免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 Log4Net使用詳解（續） Log4Net 配置詳解 log4net配置詳解 Log4net 參數詳解 Log4Net 使用記錄 Log4Net配置以及使用 log4net簡單使用 log4net各種Filter使用 log4net配置及使用 wpf log4net使用
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM