C# 使用NLog記錄日誌入門操作

 環境：win7 64位， VS2010

1、首先用VS2010創建命令行工程NLogDemo

2、在程式包管理器控制臺中輸入：Install-Package NLog -Version 4.4.12

　　這句是怎麼來的，要是你用過nuget包管理工具，那就可以跳過這裡的說明瞭。

　　要使用nuget添加NLog包到項目中。請看下圖。

然後在程式包管理工具控制臺下輸入：Install-Package NLog -Version 4.4.12

再看看Install-Package NLog -Version 4.4.12這個怎麼找。

打開百度搜索：Nuget

然後在Nuget官網上搜索欄輸入：Nlog 回車

選擇第一項Nlog

然後在 Version History 下選擇 4.4.12 這個版本

至於為什麼選擇這個版本，因為這個版本下載的次數多。嘿嘿，沒辦法，隨大流。當然還要看這個版本包的依賴項

這個包的沒有什麼特殊依賴項，所以可以使用。然後拷貝

 這裡這句話就是要我們要找的。是不是挺簡單的。

當我們在包程式包管理器控制臺中輸入：Install-Package NLog -Version 4.4.12 然後按下回車鍵，VS IDE 會自動到 nuget.org 這裡下載依賴包。

NLog 包添加完之後，還要添加 NLog.config（4.4.12）（Install-Package NLog.Config -Version 4.4.12） 這個包，按道理 NLog 和 NLog.config 應該一起的，

突然從某個版本開始分開了，要單獨添加。具體情況可以去官網看介紹：https://nlog-project.org/

添加 NLog.config 的方法跟上面添加 NLog 的方法一樣。

3、簡單封裝 Log

　　添加類Log.cs到工程中，修改代碼如下：

public sealed class Log
{
    private static NLog.Logger _logger = NLog.LogManager.GetCurrentClassLogger();

    private Log() { }

    public static void Trace(string strMsg)
    {
        _logger.Trace(strMsg);
    }

    public static void Debug(string strMsg)
    {
        _logger.Debug(strMsg);
    }

    public static void Info(string strMsg)
    {
        _logger.Info(strMsg);
    }

    public static void Warn(string strMsg)
    {
        _logger.Warn(strMsg);
    }

    public static void Error(string strMsg)
    {
        _logger.Error(strMsg);
    }

    public static void Fatal(string strMsg)
    {
        _logger.Fatal(strMsg);
    }

}

4、修改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"
      xsi:schemaLocation="http://www.nlog-project.org/schemas/NLog.xsd NLog.xsd"
      autoReload="true"
      throwExceptions="false"
      internalLogLevel="Off" internalLogFile="c:\temp\nlog-internal.log">

  <!-- optional, add some variables
  https://github.com/nlog/NLog/wiki/Configuration-file#variables
  -->
    <!--
  <variable name="myvar" value="myvalue"/>
    -->
    <variable name="fileFormat"
            value="
            ${newline}date：${date}
            ${newline}level：${level}
            ${newline}logger：${logger}
            ${newline}machinename：${machinename}
            ${newline}message：${message}
            ${newline}appdomain：${appdomain}
            ${newline}assembly-version：${assembly-version}
            ${newline}basedir：${basedir}
            ${newline}callsite：${callsite}
            ${newline}counter：${counter}
            ${newline}nlogdir：${nlogdir}
            ${newline}processid：${processid}
            ${newline}processname：${processname}
            ${newline}specialfolder：${specialfolder}
            ${newline}stacktrace: ${stacktrace}
            ${newline}------------------------------------------------------------" />

  <!--
  See https://github.com/nlog/nlog/wiki/Configuration-file
  for information on customizing logging rules and outputs.
   -->
  <targets>

    <!--
    add your targets here
    See https://github.com/nlog/NLog/wiki/Targets for possible targets.
    See https://github.com/nlog/NLog/wiki/Layout-Renderers for the possible layout renderers.
    -->

    <!--
    Write events to a file with the date in the filename.
    <target xsi:type="File" name="f" fileName="${basedir}/logs/${shortdate}.log"
            layout="${longdate} ${uppercase:${level}} ${message}" />
    -->

      <target name="file" xsi:type="File"
            fileName="${basedir}/Logs/${date:format=yyyy-MM}/${shortdate}.log"
            layout="${fileFormat}"
            maxArchiveFiles="5"
            archiveAboveSize="10240"
            archiveEvery="Day"/>
      
  </targets>

  <rules>
    <!-- add your logging rules here -->

    <!--
    Write all events with minimal level of Debug (So Debug, Info, Warn, Error and Fatal, but not Trace)  to "f"
    <logger name="*" minlevel="Debug" writeTo="f" />
    -->

    <!--
        Level    Example
        Fatal    Highest level: important stuff down
        Error    For example application crashes / exceptions.
        Warn    Incorrect behavior but the application can continue
        Info    Normal behavior like mail sent, user updated profile etc.
        Debug    Executed queries, user authenticated, session expired
        Trace    Begin method X, end method X etc
    -->
    <!--
        Logging 水平分為以下等級“Trace<<Debug<<Info<<Warn<<Error<<Fatal ”，如果我們選擇Info值，則Trace和Debug等級的信息不會被輸出。
    -->
     <logger name="*" minlevel="Trace" writeTo="file"/>
  </rules>
</nlog>

簡單解釋：

variable  log文件的內容輸出格式

targets 目標文件（要生成的Log文件）的配置（文件名、格式變數、文件個數、文件大小等等）

rules 規則，也就是俗話說的Log輸出級別

以上內容不進行過多解釋了，再多解釋也不如官網的說明。詳細介紹請看官網：https://github.com/nlog/NLog/wiki/Configuration-file#configuration-file-format

5、使用Log輸出日誌到文件，簡單示例代碼如下

class Program
{
    static void Main(string[] args)
    {
        RunTest();
        
        Console.WriteLine("Press a key end ...");
        Console.ReadKey(true);
    }

    static void RunTest()
    {
        for (int i = 0; i < 1000; i++)
        {
            Log.Info(string.Format("{0}", i + 1));

            System.Threading.Thread.Sleep(10);
        }
    }

}

輸出路徑結構

輸出文件內容：

以上內容輸出格式可以在NLog.config中根據需求進行裁剪。

demo下載