本文介紹c#的日誌插件NLog

安裝插件
創建logger
日誌級別
書寫日誌信息
配置
包裝器
布局

1. 安裝插件

   直接下載插件包 Install-Package NLog.Config

2. 創建logger

   使用LogManager創建Logger實例，最好一個類裏面一個Logger實例
       寫法一
           這種寫法，記錄的日誌文件，顯示的logger名字，是命名空間加上logger所在類的類名，如 ConsoleApp1.Program
           private static Logger mylogger = LogManager.GetCurrentClassLogger
    
   (); 
       寫法二
           這種寫法，可以手動設置日誌文件中的logger名字
           Logger mylogger = LogManager.GetLogger("myTest");

3. 日誌級別

   級別由低到高
   Trace 記錄完整的信息，一般只用在開發環境
   Debug 記錄調試信息，沒有Trace信息完整，一般也只用在開發環境
   Info 簡單的信息，一般用在生產環境
   Warn 記錄警告信息，一些可以解決的小問題
   Error 記錄報錯信息，一般都是Exceptions信息
   Fatal 非常嚴重的錯誤信息

4. 書寫日誌信息

   logger.Trace("Sample trace message"
    
   );
   logger.Debug("Sample debug message");
   logger.Info("Sample informational message");
   logger.Warn("Sample warning message");
   logger.Error("Sample error message");
   logger.Fatal("Sample fatal error message");
   或者使用
   logger.Log(LogLevel.Info, "Sample informational message");
   支持格式化 mylogger.Fatal("Sample {0} error message"
    
   , "fetal");
   盡量使用NLog內置的格式化工具，NLog做了優化工作

5. 配置

   最基礎的配置
       第一步，打開NLog.config配置文件，添加如下配置
           <targets>
               <target name="logfile" xsi:type="File" fileName="file.txt" /> // 創建一個target，代表輸出日誌文件的配置
           </targets>
           <rules>
               <logger name="*" minlevel="Info" writeTo="logfile" /> // 設置Info級別以上的日誌，才能夠輸入到什麽名為logfile的target當中
               /*
                   1.這裏logger自己還有一個name，這個name對應類名，也就是說什麽樣的類名可以輸出日誌，如ConsoleApp1.Program
                   2.可以添加final="true"屬性，表示後面的所有針對此指定名字的logger都無效
               */
           </rules>
       第二步，運行代碼即可
   多target配置
       <targets>
           <target name="logfile" xsi:type="File" fileName="file.txt" />
           <target name="console" xsi:type="Console" /> // 創建一個target表示用控制臺輸出日誌信息
       </targets>
       <rules>
           <logger name="*" minlevel="Trace" writeTo="logfile" />
           <logger name="*" minlevel="Info" writeTo="console" /> // 將Info級別以上的配置信息輸出到名為console的target中
       </rules>

6. 包裝器

   異步包裝器配置
       <targets>
           <target name="asyncFile" xsi:type="AsyncWrapper">
               <target name="logfile" xsi:type="File" fileName="file.txt"/>
           </target>
       </targets>
       <rules>
           <logger name="*" minlevel="Trace" writeTo="asyncFile"/>
       </rules>
   還有很多包裝器，按需自查

7. 布局

   布局是用來格式化日誌輸出信息的
       simple日誌格式化 
           <target name="logfile" xsi:type="File" fileName="file.txt" layout="${date:format=yyyyMMddHHmmss} ${message} ${counter:increment=3:sequence=Layout:value=5}"/>
           還有很多格式化寫法，自行查閱

8. 子類繼承log

   public class Demo1
   {
       protected Logger Log { get; set; }
       protected Demo1()
       {
           Log = LogManager.GetLogger(GetType().FullName);
       }
   }
   public class Demo2: Demo1
   {
       public Demo2():base() { }
   }

c#的日誌插件NLog基本使用