.net 簡單實用Log4net（多個日誌配置文件）

前言：

  幾乎全部的大型應用都會有本身的用於跟蹤調試的API。由於一旦程序被部署之後，就不太可能再利用專門的調試工具了。然而一個管理員可能須要有一套強大的日誌系統來診斷和修復配置上的問題。因此這個時候就須要一個記錄日誌的工具。log4net是.net中經常使用的一個日誌記錄工具，及那年先來介紹一下：

 

  開發工具vs2017

【注意項目名稱不要爲log4net，否者在以後配置log4net出錯】

1】NuGet中引用Log4net包

2】添加web配置文件命名爲log4new.config並在中寫入如下代碼

<?xml version="1.0" encoding="utf-8"?>
<configuration>

  <system.web>
    <compilation debug="true" targetFramework="4.5" />
    <httpRuntime targetFramework="4.5" />
  </system.web>
  <configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net-net-1.2" />
  </configSections>
  <!--配置log4net--> 
  <log4net>
    <root>
    </root>
    <logger name="RollingLogFileAppender">
      <level value="ALL" />
      <appender-ref ref="RollingFileDebug" />
      <appender-ref ref="RollingFileInfo" />
      <appender-ref ref="RollingFileWarn" />
      <appender-ref ref="RollingFileError" />
      <appender-ref ref="RollingFileFatal" />
    </logger>
    <appender name="RollingFileDebug" type="log4net.Appender.RollingFileAppender">
      <!--文件路徑 若是不設置（去掉 value="Log/Debug/"）會默認保存到[App_Data]文件夾中-->
      <param name="File" value="Log/Debug/"/>
      <!--追加到文件-->
      <param name="AppendToFile" value="true"/>
      <!--最多保留的文件數，設爲"-1"則不限-->
      <param name="MaxSizeRollBackups" value="10"/>
      <!--寫到一個文件-->
      <param name="StaticLogFileName" value="false"/>
      <!--文件名，按日期命名-->
      <param name="DatePattern" value="yyyyMMdd&quot;.log&quot;"/>
      <!--建立日誌文件的方式，可選值：Date[日期],文件大小[Size],混合[Composite]-->
      <param name="RollingStyle" value="Date"/>
      <!--日誌格式-->
      <layout type="log4net.Layout.PatternLayout">
        <!--%newline輸出的日誌會換行 [%date{HH:mm:ss fff}]表示記錄的時間   -->
        <conversionPattern value="[%date{HH:mm:ss fff}] %- %message%newline" />
        <!--若是想本身設置格式就只須要-->
        <!--<conversionPattern value="%message"/>-->
      </layout>
      <lockingmodel type="log4net.appender.fileappender+minimallock" />
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="Debug" />
        <param name="LevelMax" value="Debug" />
      </filter>
    </appender>
    <appender name="RollingFileInfo" type="log4net.Appender.RollingFileAppender">
      <param name="File" value="Log/Info/"/>
      <param name="AppendToFile" value="true"/>
      <param name="MaxSizeRollBackups" value="10"/>
      <param name="StaticLogFileName" value="false"/>
      <param name="DatePattern" value="yyyyMMdd&quot;.log&quot;"/>
      <param name="RollingStyle" value="Date"/>
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%date{HH:mm:ss fff}] %- %message%newline" />
      </layout>
      <lockingmodel type="log4net.appender.fileappender+minimallock" />
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="INFO" />
        <param name="LevelMax" value="INFO" />
      </filter>
    </appender>
    <appender name="RollingFileWarn" type="log4net.Appender.RollingFileAppender">
      <param name="File" value="Log/Warn/"/>
      <param name="AppendToFile" value="true"/>
      <param name="MaxSizeRollBackups" value="10"/>
      <param name="StaticLogFileName" value="false"/>
      <param name="DatePattern" value="yyyyMMdd&quot;.log&quot;"/>
      <param name="RollingStyle" value="Date"/>
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%date{HH:mm:ss fff}] %- %message%newline" />
      </layout>
      <lockingmodel type="log4net.appender.fileappender+minimallock" />
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="WARN" />
        <param name="LevelMax" value="WARN" />
      </filter>
    </appender>
    <appender name="RollingFileError" type="log4net.Appender.RollingFileAppender">
      <param name="File" value="Log/Error/"/>
      <param name="AppendToFile" value="true"/>
      <param name="MaxSizeRollBackups" value="10"/>
      <param name="StaticLogFileName" value="false"/>
      <param name="DatePattern" value="yyyyMMdd&quot;.log&quot;"/>
      <param name="RollingStyle" value="Date"/>
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%date{HH:mm:ss fff}] %- %message%newline" />
      </layout>
      <lockingmodel type="log4net.appender.fileappender+minimallock" />
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="ERROR" />
        <param name="LevelMax" value="ERROR" />
      </filter>
    </appender>
    <appender name="RollingFileFatal" type="log4net.Appender.RollingFileAppender">
      <param name="File" value="Log/Fatal/"/>
      <param name="AppendToFile" value="true"/>
      <param name="MaxSizeRollBackups" value="10"/>
      <param name="StaticLogFileName" value="false"/>
      <param name="DatePattern" value="yyyyMMdd&quot;.log&quot;"/>
      <param name="RollingStyle" value="Date"/>
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="[%date{HH:mm:ss fff}] %- %message%newline" />
      </layout>
      <lockingmodel type="log4net.appender.fileappender+minimallock" />
      <filter type="log4net.Filter.LevelRangeFilter">
        <param name="LevelMin" value="FATAL" />
        <param name="LevelMax" value="FATAL" />
      </filter>
    </appender>

  </log4net> 
</configuration>

View Code

 

3】在Global.asax中添加代碼 

//配置log4
log4net.Config.XmlConfigurator.Configure(new System.IO.FileInfo(Server.MapPath("~/Web.config")));

View Code

 

 4】寫一個 LogHelper.cs可是注意在這個.cs文件的命名空間寫上 [assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config", Watch = true)]

注意ConfigFile 後面跟的是配置文件的相對路徑

 

LogHelper代碼

    public class LogHelper
    {
        public static readonly ILog Log = LogManager.GetLogger("RollingLogFileAppender");
 

        //        log4j定義了8個級別的log（除去OFF和ALL，能夠說分爲6個級別），優先級從高到低依次爲：OFF、FATAL、ERROR、WARN、INFO、DEBUG、TRACE、 ALL。 
        //ALL 最低等級的，用於打開全部日誌記錄。
        //DEBUG 指出細粒度信息事件對調試應用程序是很是有幫助的，主要用於開發過程當中打印一些運行信息。 
        //INFO 消息在粗粒度級別上突出強調應用程序的運行過程。打印一些你感興趣的或者重要的信息，這個能夠用於生產環境中輸出程序運行的一些重要信息，
        //WARN 代表會出現潛在錯誤的情形，有些信息不是錯誤信息，可是也要給程序員的一些提示。
        //ERROR 指出雖然發生錯誤事件，但仍然不影響系統的繼續運行。打印錯誤和異常信息，若是不想輸出太多的日誌，可使用這個級別。
        //FATAL 指出每一個嚴重的錯誤事件將會致使應用程序的退出。這個級別比較高了。重大錯誤，這種級別你能夠直接中止程序了。

        //TRACE designates finer-grained informational events than the DEBUG.Since:1.2.12，很低的日誌級別，通常不會使用。  
        //OFF 最高等級的，用於關閉全部日誌記錄。
        //若是將log level設置在某一個級別上，那麼比此級別優先級高的log都能打印出來。例如，若是設置優先級爲WARN，那麼OFF、FATAL、ERROR、WARN 4個級別的log能正常輸出，而INFO、DEBUG、TRACE、 ALL級別的log則會被忽略。Log4j建議只使用四個級別，優先級從高到低分別是ERROR、WARN、INFO、DEBUG。

        #region DEBUG 指出細粒度信息事件對調試應用程序是很是有幫助的，主要用於開發過程當中打印一些運行信息。 
        public static void debug(string write)
        {

            Log.Debug("日誌記錄:" + write);
        }
        public static void debug(string write, Exception ex)
        {
            Log.Debug("日誌記錄:" + write + "。錯誤記載：" + ex.ToString());
        }
        #endregion
        #region INFO 消息在粗粒度級別上突出強調應用程序的運行過程。打印一些你感興趣的或者重要的信息，這個能夠用於生產環境中輸出程序運行的一些重要信息，
        /// <summary>
        /// 1
        /// </summary>
        /// <param name="write"></param>
        public static void Info(string write)
        {
            Log.Info("日誌記錄:" + write);
        }
        public static void Info(string write, Exception ex)
        {
            Log.Info("日誌記錄:" + write + "。錯誤記載：" + ex.ToString());
        }
        #endregion
        #region WARN 代表會出現潛在錯誤的情形，有些信息不是錯誤信息，可是也要給程序員的一些提示。，可使用這個級別。
        public static void warn(string write)
        {
            Log.Warn("日誌記錄:" + write);
        }
        public static void warn(string write, Exception ex)
        {
            Log.Warn("日誌記錄:" + write + "。錯誤記載：" + ex.ToString());
        }
        #endregion

        #region ERROR 指出雖然發生錯誤事件，但仍然不影響系統的繼續運行。打印錯誤和異常信息，若是不想輸出太多的日誌，可使用這個級別。
        public static void error(string write)
        {
            Log.Error("日誌記錄:" + write);
        }
        public static void error(string write, Exception ex)
        {
            Log.Error("日誌記錄:" + write + "。錯誤記載：" + ex.ToString());
        }
        #endregion
        #region FATAL 指出每一個嚴重的錯誤事件將會致使應用程序的退出。這個級別比較高了。重大錯誤，這種級別你能夠直接中止程序了。
        public static void fatal(string write)
        {
            Log.Fatal("日誌記錄:" + write);
        }
        public static void fatal(string write, Exception ex)
        {
            Log.Fatal("日誌記錄:" + write + "。錯誤記載：" + ex.ToString());
        }
        //#endregion


        #endregion



        //定義輸出的日誌內容
        public static string logMessage(SysLogMsg logMessage)
        {
            StringBuilder strInfo = new StringBuilder();
            strInfo.Append("\r\n1. 錯誤: >> 操做時間: " + logMessage.OperationTime + "   操做人: " + logMessage.UserName + " \r\n");
            strInfo.Append("2. 類名: " + logMessage.Class + " \r\n");
            strInfo.Append("3. 內容: " + logMessage.Content + "\r\n");
            strInfo.Append("-----------------------------------------------------------------------------------------------------------------------------\r\n");
            return strInfo.ToString();
        }
    }

View Code

 

5】最後能夠開始寫日誌  ，能夠本身定義一種日誌格式【本身寫一個model，定義幾個參數  時間、操做人、類名等等】

 

 

 最後根據log4new.config設置的路徑找到日誌所在【未定義的話通常在項目的bin/Debug 或者 bin/Release目錄下】  第一個是默認格式日誌，第二個是本身定的格式日誌【都是string類型，只不過第二個使用\t\n換行，稍微美化一下輸出格式】

  <param name="File" value="Log/Debug/"/>  表示在當前文件夾Log/Debug中

 

 

 最後附上githup地址