快捷導(dǎo)航

.Net項(xiàng)目中NLog的配置和使用實(shí)例詳解

更新時(shí)間：2019年07月15日 09:13:33 作者：追逐時(shí)光

這篇文章主要給大家介紹了關(guān)于.Net項(xiàng)目中NLog的配置和使用的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家學(xué)習(xí)或者使用.Net具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧

引言：

因?yàn)橹霸陧?xiàng)目開發(fā)中一直都是使用的Log4Net作為項(xiàng)目的日志記錄框架，最近忽然感覺對它已經(jīng)有點(diǎn)膩了，所以嘗試著使用了NLog作為新項(xiàng)目的日志記錄框架（當(dāng)然作為一名有志向的攻城獅永遠(yuǎn)都不能只局限于眼前的技術(shù)，要不斷的使用和學(xué)習(xí)新的技術(shù)）。當(dāng)然serilog也是一個(gè)不錯(cuò)的日志記錄框架喲，不過今天主要還是要講述的是NLog在項(xiàng)目中的配置和使用。

NLog框架源碼：https://github.com/NLog/NLog

一、導(dǎo)入NLog NuGet PackAge：

二、配置NLog 配置文件：

注意：在這里我是專門新建了一個(gè)NLog.config 配置文件用來進(jìn)行獨(dú)立配置，當(dāng)然你也可以在web.config中完成相應(yīng)的配置??！

NLog詳細(xì)配置文件信息，請查看官網(wǎng)說明：https://github.com/nlog/nlog/wiki/configuration-file

可參考曉晨大佬的NLog配置：http://m.fzitv.net/article/165343.htm

a、我的NLog.config 配置代碼:

<?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>
 <!--此部分中的所有目標(biāo)將自動異步-->
 <target name="asyncFile" xsi:type="AsyncWrapper">
  <!--項(xiàng)目日志保存文件路徑說明fileName="${basedir}/保存目錄，以年月日的格式創(chuàng)建/${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>

 <!--規(guī)則配置,final - 最終規(guī)則匹配后不處理任何規(guī)則-->
 <rules>
 <logger name="Microsoft.*" minlevel="Info" writeTo="" final="true" />
 <logger name="*" minlevel="Info" writeTo="asyncFile" />
 <logger name="*" minlevel="Warn" writeTo="colorConsole" />
 </rules>
</nlog>

b、NLog配置文件信息簡單概述：

1、rules【規(guī)則】說明：

　　規(guī)則是logger具有以下屬性的元素：

name - 記錄器名稱過濾器 - 可能包含通配符（*和？）

minlevel - 記錄的最低級別

maxlevel - 記錄的最高級別

level - 單級記錄

levels - 逗號分隔的記錄級別列表

writeTo - 逗號分隔的要寫入的目標(biāo)列表

final - 最終規(guī)則匹配后不處理任何規(guī)則

enabled- 設(shè)置為false禁用規(guī)則而不刪除它

ruleName- 規(guī)則標(biāo)識符，允許使用Configuration.FindRuleByName和進(jìn)行規(guī)則查找Configuration.RemoveRuleByName。

在NLog 4.6.4中引入

注意：雖然命名了規(guī)則logger，但它沒有定義記錄器。它引用一個(gè)或多個(gè)記錄器。

通過將規(guī)則name模式與記錄器名稱匹配，將規(guī)則映射到記錄器。規(guī)則name屬性可以包括通配符（*和？），以通過通配

符匹配來匹配記錄器名稱。

* - 匹配0個(gè)或更多字符

? - 恰好匹配1個(gè)字符

2、targets【目標(biāo)】：

　　每個(gè)目標(biāo)由一個(gè)target元素表示。每個(gè)目標(biāo)需要兩個(gè)屬性：

name - 目標(biāo)名稱

type - 目標(biāo)類型 - 例如“文件”，“數(shù)據(jù)庫”，“郵件”。使用名稱空間時(shí)，此屬性已命名xsi:type。

除了這些屬性之外，目標(biāo)通常還接受其他參數(shù)，這些參數(shù)會影響診斷跟蹤的寫入方式。每個(gè)目標(biāo)都有一組不同的參數(shù)，它們在項(xiàng)目主頁上有詳細(xì)描述，并且它們是上下文相關(guān)的。Intellisense也可以在Visual Studio中使用。

例如，F(xiàn)ile目標(biāo)接受fileName定義輸出文件名的參數(shù)，Console目標(biāo)具有error參數(shù)，該參數(shù)確定診斷跟蹤是否寫入標(biāo)準(zhǔn)錯(cuò)誤（stderr）而不是進(jìn)程的標(biāo)準(zhǔn)輸出（stdout）。

此示例演示了一個(gè)targets定義多個(gè)目標(biāo)的部分：兩個(gè)文件，一個(gè)網(wǎng)絡(luò)目標(biāo)和OutputDebugString目標(biāo)：

< 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提供了許多預(yù)定義的目標(biāo)。實(shí)際上創(chuàng)建自己的目標(biāo)非常容易 - 請參閱如何編寫自定義目標(biāo)。

三、NLog使用：

　　在這里，我封裝了一個(gè)NLog使用幫助類，提供給全站調(diào)用，這樣就可以避免在不同的類中實(shí)例化Nlog對象的步驟。

LoggerHelper.cs：

/// <summary>
 /// nLog使用幫助類
 /// </summary>
 public class LoggerHelper
 {
  /// <summary>
  /// 實(shí)例化nLog，即為獲取配置文件相關(guān)信息
  /// </summary>
  private readonly NLog.Logger _logger = LogManager.GetCurrentClassLogger();

  private static LoggerHelper _obj;

  public static LoggerHelper _
  {
   get => _obj ?? (new LoggerHelper());
   set => _obj = value;
  }

  #region Debug，調(diào)試
  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，錯(cuò)誤
  public void Error(string msg)
  {
   _logger.Error(msg);
  }

  public void Error(string msg, Exception err)
  {
   _logger.Error(err, msg);
  }
  #endregion

  #region Fatal,致命錯(cuò)誤
  public void Fatal(string msg)
  {
   _logger.Fatal(msg);
  }

  public void Fatal(string msg, Exception err)
  {
   _logger.Fatal(err, msg);
  }
  #endregion
 }

四、運(yùn)行記錄結(jié)果：

　　因?yàn)槲以贜Log.config配置文件中配置的日志存儲路徑為：ProjectLogs/當(dāng)前時(shí)間（yyyy-MM-dd）/
如下圖所示：