Log4Net使用學習筆記

項目源文件下載https://files.cnblogs.com/files/ckym/Log4NetTestSourceCode.zip

Log4net是一款很是好用的日誌記錄的框架,使用它能夠實現將日誌輸出到控制檯,文件,數據庫等功能

網上有不少log4net的使用教程,一些很是簡陋,一些又很深奧,我學習使用log4net的時候查閱了不少資料,爲了能夠記住相關功能的實現方式,故記錄這篇文章,僅用於初學者使用此文檔來進行學習,若有錯誤,請大神不吝賜教,更多深刻用法和原理請你們查詢相關文檔。

1. 1.   新建一個控制檯應用程序(Core)
2. 2.   在Nuget中安裝log4net完成以後新建一個log4net的配置文件,配置文件示例以下

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

<log4net>

  <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">

    <layout type="log4net.Layout.PatternLayout" value="%date [%thread] %-5level %logger - %message%newline" />

  </appender>

 

  <appender name="FileAppender" type="log4net.Appender.FileAppender">

    <file value="log-file.log" />

    <appendToFile value="true" />

    <layout type="log4net.Layout.PatternLayout">

      <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />

    </layout>

  </appender>

 

  <appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">

    <file value="Log/" />

    <appendToFile value="true" />

    <rollingStyle value="Composite" />

    <staticLogFileName value="false" />

    <datePattern value="yyyyMMdd'.log'" />

    <maxSizeRollBackups value="10" />

    <maximumFileSize value="1MB" />

    <layout type="log4net.Layout.PatternLayout">

      <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />

    </layout>

  </appender>

 

  <!-- name屬性指定其名稱,type則是log4net.Appender命名空間的一個類的名稱,意思是,指定使用哪一種介質-->

  <appender name="ADONetAppender" type="MicroKnights.Logging.AdoNetAppender, log4net.AdoNetAppender">

    <!--日誌緩存寫入條數 設置爲0時只要有一條就馬上寫到數據庫-->

    <bufferSize value="1" />

    <!--日誌數據庫鏈接串-->

    <connectionType value="System.Data.SqlClient.SqlConnection, System.Data" />

    <connectionString value="Data Source=(localdb)\MSSQLLocalDB;Initial Catalog=SCTest;Integrated Security=True;Connect Timeout=30;Encrypt=False;TrustServerCertificate=False;ApplicationIntent=ReadWrite;MultiSubnetFailover=False;" />

    <!--日誌數據庫腳本-->

    <commandText value="INSERT INTO Sys_Logs (ID,CreateTime,CreateUser,LogLevel,Message,UserIP) VALUES (4,@CreateTime,@CreateUser,@LogLevel,@CustomMessage,@UserIP)" />

    <!--日誌時間LogDate -->

    <parameter>

      <parameterName value="@CreateTime" />

      <dbType value="DateTime" />

      <layout type="log4net.Layout.RawTimeStampLayout" />

    </parameter>

    <parameter>

      <parameterName value="@LogLevel" />

      <dbType value="String" />

      <size value="200" />

      <layout type="log4net.Layout.PatternLayout">

        <conversionPattern value="%p" />

      </layout>

    </parameter>

    <parameter>

      <parameterName value="@CustomMessage" />

      <dbType value="String" />

      <size value="3000" />

      <layout type="Log4NetTest.CustomLayout,Log4NetTest">

        <conversionPattern value="%CustomMessage{CustomMessage}" />

      </layout>

    </parameter>

    <!--自定義UserName -->

    <parameter>

      <parameterName value="@CreateUser" />

      <dbType value="String" />

      <size value="30" />

      <layout type="Log4NetTest.CustomLayout,Log4NetTest" >

        <conversionPattern value = "%CreateUser{CreateUser}"/>

      </layout>

    </parameter>

    <parameter>

      <parameterName value="@UserIP" />

      <dbType value="String" />

      <size value="20" />

      <layout type="Log4NetTest.CustomLayout,Log4NetTest" >

        <conversionPattern value = "%UserIP{UserIP}"/>

      </layout>

    </parameter>

  </appender>

 

  <!-- Setup the root category, add the appenders and set the default level -->

  <root>

    <level value="ALL" />

    <appender-ref ref="ConsoleAppender" />

    <appender-ref ref="FileAppender" />

    <appender-ref ref="RollingLogFileAppender" />

    <appender-ref ref="ADONetAppender" />

  </root>

</log4net>

接着在App.config中添加以下行

<configuration>

  <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />

</configuration>

而後再Main文件中添加以下代碼

ILoggerRepository repository = LogManager.CreateRepository("MyCustomRepository");

            //BasicConfigurator.Configure(repository);//簡單配置,只能寫日誌到控制檯

            //讀取配置文件的方式實現

            //var log4NetConfig = new XmlDocument();

            //log4NetConfig.Load(File.OpenRead("log4net.config"));

            //XmlConfigurator.Configure(repository, log4NetConfig["log4net"]);

            //直接使用文件的方式

            //注意,要求全部的配置文件必須放置在Debug文件夾下面,不然會形成程序不報錯,可是也不能正確寫入文件的問題

            XmlConfigurator.Configure(repository, new FileInfo("log4net.config"));

            ILog log = LogManager.GetLogger(repository.Name,"MyCustomLogger");

 

             //log.Debug("This is a Log info From Log4net Test");

             //log.Info("NETCorelog4net log");

             //log.Info("test log");

             //log.Error("error");

             //log.Info("linezero");

 

             //記錄日誌到數據庫

            CustomLogInfo logInfo = new CustomLogInfo() { ID = new Random().Next(1, 100), Message = "This is a Log info By Log4Net", CreateUser = "SC", UserIP = Dns.GetHostAddresses(Dns.GetHostName())[0].ToString() };

            log.Debug(logInfo);

            Console.WriteLine("日誌記錄完成!");

            Console.ReadKey();

根據註釋取消或者註釋掉相關的代碼,點擊運行,能夠看到日誌輸出到文件，或者控制檯,或者數據庫文件

異常處理：

1. 找不到AdoNetAppender

在使用log4net2.0.8的時候咱們運行會發現報錯,由於2.0.8的版本沒有提供AdoNetAppender,因此須要咱們本身去實現,源代碼在項目中能夠找到,其餘數據庫,例如MySql,Oracle等數據庫同樣的實現方式

1. 實現自定義的轉換器和佈局,這個能夠參考原代碼的實現和註釋,便可實現相關的功能(注意須要反射的只是).

下面是輸出的日誌模板的一下縮寫對應的關係,能夠參考,這些是log4net中自帶的轉換器實現的。

1）NewLinePatternConverter

做用：換行；通配符：%newline，%n

2）LoggerPatternConverter

做用：顯示Logger名；通配符：%logger，%c

3）TypeNamePatternConverter

做用：顯示類名；通配符：%C，%class，%type

4）DatePatternConverter

做用：顯示時間；通配符：%d，%date

5）ExceptionPatternConverter

做用：異常信息；通配符：%exception

6）LineLocationPatternConverter

做用：語句所在的行號；通配符：%L，%line

7）MessagePatternConverter

做用：信息內容；通配符：%message，%m

8）LevelPatternConverter

做用：消息等級；通配符：%level，%p