NLog的配置和使用（一）

NLog是一款拥有丰富的途径选择和管理能力的可用于.net、Silverlight和Windows Phone的免费开源框架.它可以将任何.net语言产生的调试信息转化为上下文信息（包括日期和时间，严重程度，进程，线程，环境信息），根据你喜好的形式发送到一个或者多个目标存储。那么，我们如何在一个应用程序上配置使用NLog,将日志输出到控制台和文件？
首先，打开VS2012创建一个控制台应用程序，添加NLog.dll引用。

在Program.cs文件中，获取一个Logger实例，取名为NLogConsoleExample（名字可任意），也可采用 LogManager.GetCurrentClassLogger()来获取一个以当前类名为名称的Logger实例；然后我们在main方法中添加几行简单调用NLog输出不同级别的日志信息的代码，如下图：

接下来，开始配置NLog配置文件，NLog配置文件支持两种方式：
1）是将配置写到应用程序的配置文件（通常是applicationName.exe.config）或者Web.config文件中；
2）独配置到一个文件，通常是NLog.config
    这里采用第一种方法，首先我们需要在配置文件中增加如下形式的配置

name="nlog" type="NLog.Config.ConfigSectionHandler, NLog"/>

在节点中，有五个子节点可让我们配置，前两个节点是配置必须的，而后面的几个是可选，可用于更高级的场景。

•  –定义日志记录输出的目标位置，可以配置为输出到控制台，文件，数据库，事件日志等等
•  –定义日志输出路径规则
•  –定义从某个*.dll获取Nlog扩展
• – 包含外部的配置文件
•  – 设置配置变量的值

简单的配置如下图，标出的序号要点在图下方将进行讲解注释。

注释：

1. autoReload="true"表示在不重新启动应用程序的情况下，修改配置文件，NLog会自动加载应用；
   
2. internalLogLevel="Trace"internalLogFile="logs/internalLog.txt"这个设置可以将NLog内部的日志消息写到应用程序目录下的logs文件夹里的internalLog.txt文件中；（这个配置常用于调试Nlog的配置是否正确，调试完成后，最好关闭以提高性能）
3. 的配置：type="File|Console" 属性是设置日志输出目标是"File"(文件)或者"Console"（控制台）；
   type="File"的时候要指定fileName属性， fileName="${basedir}/logs/${shortdate}.log" 设置日记记录文件的路径和名称，即应用程序下的log目录里格式为yyyy-MM-DD.log；
   layout="${date:format=yyyyMMddHHmmss} ${callsite} ${level} ${message}" 设置日志输出格式(可查阅官网说明).
4. name="NLogConsoleExample"表示配置的规则适用于Logger名称为“NLogConsoleExample”，如果填*，则表示所有的Logger都运用这个规则。
5. minlevel="Debug"maxlevel="Error"用来配置记录的级别为最小是"Debug"最大为"Error"(备注：此处也可以用levels="Debug,Error"来设置，说明只输出Debug级别以及Error级别的日志，官网此处解说有误：)
6. writeTo="t1,t2"其中t1,t2分别代表上面设置的targets名称为t1以及t2的目标输出，此处表示将分别将日志信息输出到文件和控制台。
   

附上整个配置文件的完整代码：

xml version="1.0" encoding="utf-8" ?>

name="nlog" type="NLog.Config.ConfigSectionHandler, NLog"/>

autoReload="true" internalLogLevel="Trace" internalLogFile="logs/internalLog.txt">

name="t1" type="File" fileName="${basedir}/logs/${shortdate}.log"

layout="${longdate} ${callsite} ${level}:

${message} ${event-context:item=exception} ${stacktrace} ${event-context:item=stacktrace}"/>

name="t2" type="Console" layout="${date:format=yyyyMMddHHmmss} ${callsite} ${level} ${message}"/>

name="NLogConsoleExample" minlevel="Debug" maxlevel="Error" writeTo="t1,t2" />

version="v4.0" sku=".NETFramework,Version=v4.5" />

最后示例结果显示：

图一：运行程序后，控制台输出指定格式的符合设置级别（Debug到Error）的日志信息,并且在应用程序目录生成一个名为logs的目录。

图二：logs目录下分别含有记录Nlog内部跟踪日志信息的文件internalLog.txt以及形式为yyyy-MM-DD.log的存放对应级别（Debug到Error）的日志输出。

图三：2016-07-15.log内容展示：

图四：internalLog.txt内容展示：（这个文件记录的内容常用于调试Nlog一些配置错误或者其他内部错误）

PS：NLog 官网地址  http://nlog-project.org/