c#的日誌外掛程式NLog基本使用

標籤：nlog   繼承   完整   報錯   檔案中   seq   ace   nal   配置資訊   

本文介紹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基本使用