由於以前在項目開發中一直都是使用的Log4Net做爲項目的日誌記錄框架,最近突然感受對它已經有點膩了,因此嘗試着使用了NLog做爲新項目的日誌記錄框架(固然做爲一名有志向的攻城獅永遠都不能只侷限於眼前的技術,要不斷的使用和學習新的技術)。固然serilog也是一個不錯的日誌記錄框架喲,不過今天主要仍是要講述的是NLog在項目中的配置和使用。html
NLog框架源碼:https://github.com/NLog/NLoggit
注意:在這裏我是專門新建了一個NLog.config 配置文件用來進行獨立配置,固然你也能夠在web.config中完成相應的配置!!
NLog詳細配置文件信息,請查看官網說明:https://github.com/nlog/nlog/wiki/configuration-file
可參考曉晨大佬的NLog配置:http://www.javashuo.com/article/p-phutxffu-dc.htmlgithub
<?xml version="1.0" encoding="utf-8" ?> <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <targets> <!--此部分中的全部目標將自動異步--> <target name="asyncFile" xsi:type="AsyncWrapper"> <!--項目日誌保存文件路徑說明fileName="${basedir}/保存目錄,以年月日的格式建立/${shortdate}/${記錄器名稱}-${單級記錄}-${shortdate}.txt"--> <target name="log_file" xsi:type="File" fileName="${basedir}/ProjectLogs/${shortdate}/${logger}-${level}-${shortdate}.txt" layout="${longdate} | ${message} ${onexception:${exception:format=message} ${newline} ${stacktrace} ${newline}" archiveFileName="${basedir}/archives/${logger}-${level}-${shortdate}-{#####}.txt" archiveAboveSize="102400" archiveNumbering="Sequence" concurrentWrites="true" keepFileOpen="false" /> </target> <!--使用可自定義的着色將日誌消息寫入控制檯--> <target name="colorConsole" xsi:type="ColoredConsole" layout="[${date:format=HH\:mm\:ss}]:${message} ${exception:format=message}" /> </targets> <!--規則配置,final - 最終規則匹配後不處理任何規則--> <rules> <logger name="Microsoft.*" minlevel="Info" writeTo="" final="true" /> <logger name="*" minlevel="Info" writeTo="asyncFile" /> <logger name="*" minlevel="Warn" writeTo="colorConsole" /> </rules> </nlog>
規則是logger具備如下屬性的元素:
name - 記錄器名稱過濾器 - 可能包含通配符(*和?)
minlevel - 記錄的最低級別
maxlevel - 記錄的最高級別
level - 單級記錄
levels - 逗號分隔的記錄級別列表
writeTo - 逗號分隔的要寫入的目標列表
final - 最終規則匹配後不處理任何規則
enabled- 設置爲false禁用規則而不刪除它
ruleName- 規則標識符,容許使用Configuration.FindRuleByName和進行規則查找Configuration.RemoveRuleByName。在NLog 4.6.4中引入
注意:雖然命名了規則logger,但它沒有定義記錄器。它引用一個或多個記錄器。
經過將規則name模式與記錄器名稱匹配,將規則映射到記錄器。規則name屬性能夠包括通配符(*和?),以經過通配符匹配來匹配記錄器名稱。
* - 匹配0個或更多字符
? - 剛好匹配1個字符web
每一個目標由一個target元素表示。每一個目標須要兩個屬性:
name - 目標名稱
type - 目標類型 - 例如「文件」,「數據庫」,「郵件」。使用名稱空間時,此屬性已命名xsi:type。
除了這些屬性以外,目標一般還接受其餘參數,這些參數會影響診斷跟蹤的寫入方式。每一個目標都有一組不一樣的參數,它們在項目主頁上有詳細描述,而且它們是上下文相關的。Intellisense也能夠在Visual Studio中使用。
例如,File目標接受fileName定義輸出文件名的參數,Console目標具備error參數,該參數肯定診斷跟蹤是否寫入標準錯誤(stderr)而不是進程的標準輸出(stdout)。
此示例演示了一個targets定義多個目標的部分:兩個文件,一個網絡目標和OutputDebugString目標:數據庫
< targets > < target name = 「 f1 」 xsi :type = 「 File 」 fileName = 「 file1.txt 」 /> < target name = 「 f2 」 xsi :type = 「 File 」 fileName = 「 file2.txt 」 /> < target name = 「 n1 」 xsi :type = 「 Network 」 address = 「 tcp:// localhost:4001 」 /> < target name = 「 ds 」 xsi :type = 「 OutputDebugString 」 /> </ targets >
NLog提供了許多預約義的目標。實際上建立本身的目標很是容易 - 請參閱如何編寫自定義目標。網絡
在這裏,我封裝了一個NLog使用幫助類,提供給全站調用,這樣就能夠避免在不一樣的類中實例化Nlog對象的步驟。app
LoggerHelper.cs:框架
/// <summary> /// nLog使用幫助類 /// </summary> public class LoggerHelper { /// <summary> /// 實例化nLog,即爲獲取配置文件相關信息(獲取以當前正在初始化的類命名的記錄器) /// </summary> private readonly NLog.Logger _logger = LogManager.GetCurrentClassLogger(); private static LoggerHelper _obj; public static LoggerHelper _ { get => _obj ?? (new LoggerHelper()); set => _obj = value; } #region Debug,調試 public void Debug(string msg) { _logger.Debug(msg); } public void Debug(string msg, Exception err) { _logger.Debug(err, msg); } #endregion #region Info,信息 public void Info(string msg) { _logger.Info(msg); } public void Info(string msg, Exception err) { _logger.Info(err, msg); } #endregion #region Warn,警告 public void Warn(string msg) { _logger.Warn(msg); } public void Warn(string msg, Exception err) { _logger.Warn(err, msg); } #endregion #region Trace,追蹤 public void Trace(string msg) { _logger.Trace(msg); } public void Trace(string msg, Exception err) { _logger.Trace(err, msg); } #endregion #region Error,錯誤 public void Error(string msg) { _logger.Error(msg); } public void Error(string msg, Exception err) { _logger.Error(err, msg); } #endregion #region Fatal,致命錯誤 public void Fatal(string msg) { _logger.Fatal(msg); } public void Fatal(string msg, Exception err) { _logger.Fatal(err, msg); } #endregion }
由於我在NLog.config配置文件中配置的日誌存儲路徑爲:ProjectLogs/當前時間(yyyy-MM-dd)/
以下圖所示:異步