NLog文章系列——入门教程（下）

作者：Jarosław Kowalski <jaak@jkowalski.net>

翻译：Dflying Chen：http://dflying.cnblogs.com/

原文：http://www.nlog-project.org/tutorial.html

本文为《NLog文章系列》的第四篇，即入门教程的最后一篇。将继续描述演示用NLog书写日志的方法。

 

自动重新配置

NLog的配置文件将在程序启动之后自动加载。对于某些将长时间运行的进程（例如Windows服务或ASP.NET应用程）来说，往往需要在程序运行当中临时性地提高记录等级，而这时我们却并不希望重新启动该应用程序。NLog可以自动跟踪其配置文件的变化，一旦配置文件被修改，NLog将立即自动重新加载。我们可以通过在配置文件中设置<nlog autoReload="true" />来实现该需求。这种自动重新配置功能也会应用到被包含的文件上，也就是说若包含文件发生了变化，NLog同样将自动重新加载整个的配置文件。

 

日志功能排错

虽然已经配置好了NLog，可是有些时候应用程序仍旧会出现一些难以理解的问题，例如没有任何日志输出。其中最常见的原因就是ASP.NET的权限——ASP.NET的aspnet_wp.exe或w3wp.exe可能没有对NLog配置文件中指定目录的写入权限。NLog对于其自身运行中发生的异常有着很强的监测能力。如下设定可以将这些监测结果输出至指定位置，或是对这些异常进行相应的处理（默认设定将忽略自身异常）：

• <nlog throwExceptions="true" />- 当NLog自身掷出异常时，该选项可以将异常掷回日志的调用者。在开发过程中，这个设定将变得非常有用，能够迅速帮助我们定位异常的位置以及原因。而当程序开发结束并部署到应用环境时，应该尽快设定throwExceptions为false，免得NLog自身的异常导致整个应用程序的崩溃。
• <nlog internalLogFile="file.txt" />- 让NLog将自身运行过程中的日志信息（包括可能出现的异常）写入到文件中。
• <nlog internalLogLevel="Trace|Debug|Info|Warn|Error|Fatal" /> - 选择写入内部日志的记录等级。该等级设定的越高，相应的输出日志文件将越小。
• <nlog internalLogToConsole="false|true" /> - 将内部日志信息发送至控制台。
• <nlog internalLogToConsoleError="false|true" /> - 将内部日志信息发送至标准异常输出（stderr）。

 

异步处理、包装器（Warpper）以及复合输出目标

NLog的包装器和复合输出目标特性让我们能够修改输出目标的默认行为，这种修改体现在如下几个方面：

• 异步处理（向目标输出将用单独的线程处理）
• 异常时自动重试
• 负载平衡
• 缓存 
• 过滤 
• 备用输出目标（主输出目标失败时启用备用输出目标）
• 其他，请参考http://www.nlog-project.org/targets.html

只要在配置文件中将若干个target节点嵌套起来，即可完成对包装器或复合输出目标的定义。嵌套深度没有任何限制。例如为某个输出目标添加异步处理以及异常自动重试功能，只要按照如下代码配置NLog即可：

<targets> 

  <target name="n" xsi:type="AsyncWrapper"> 

    <target xsi:type="RetryingWrapper"> 

      <target xsi:type="File" fileName="${file}.txt"/> 

    </target> 

  </target> 

</targets> 

 

异步处理特性极为常用，因此NLog提供了一种简写方式——即<targets async="true" />，这样该输出目标将自动应用AsyncWrapper包装器。

 

以编程方式进行配置

某些情况下我们可能不愿用配置文件来配置NLog，而是选择使用NLog的配置API进行。对这些API的详细介绍已经超过了本文的范围，所以我们这里仅仅简单介绍一些。若希望以编程的方式对NLog进行配置，我们需要：

1. 创建一个LoggingConfiguration对象，用来保存配置信息
2. 至少创建一个输出目标对象
3. 设置该输出目标对象的属性
4. 设置LoggingRule对象，并将其添加到LoggingConfiguration对象的LoggingRules集合中
5. 启用该LoggingConfiguration对象（将LogManager.Configuration设定为该LoggingConfiguration对象即可）

下面的代码片段以编程方式创建了两个输出目标对象——支持颜色的控制台和文件，并将记录等级等于或高于Debug的日志信息发送至这两个输出目标：

using NLog; 

using NLog.Targets; 

using NLog.Config; 

using NLog.Win32.Targets; 

class Example 

{ 

    static void Main(string[] args) 

    { 

        // Step 1. Create configuration object 

        LoggingConfiguration config = new LoggingConfiguration(); 

        // Step 2. Create targets and add them to the configuration 

        ColoredConsoleTarget consoleTarget = new ColoredConsoleTarget(); 

        config.AddTarget("console", consoleTarget); 

        FileTarget fileTarget = new FileTarget(); 

        config.AddTarget("file", fileTarget); 

        // Step 3. Set target properties 

        consoleTarget.Layout = "${date:format=HH//:MM//:ss} ${logger} ${message}"; 

        fileTarget.FileName = "${basedir}/file.txt"; 

        fileTarget.Layout = "${message}"; 

        // Step 4. Define rules 

        LoggingRule rule1 = new LoggingRule("*", LogLevel.Debug, consoleTarget); 

        config.LoggingRules.Add(rule1); 

        LoggingRule rule2 = new LoggingRule("*", LogLevel.Debug, fileTarget); 

        config.LoggingRules.Add(rule2); 

        // Step 5. Activate the configuration 

        LogManager.Configuration = config; 

        // Example usage 

        Logger logger = LogManager.GetLogger("Example"); 

        logger.Trace("trace log message"); 

        logger.Debug("debug log message"); 

        logger.Info("info log message"); 

        logger.Warn("warn log message"); 

        logger.Error("error log message"); 

        logger.Fatal("fatal log message"); 

    } 

}

 

 

NLog还能干点儿啥？

NLog supports some more logging scenarios, which couldn't be fully described here. See the links below for more information:

除此之外，NLog还支持一些更加复杂的需要日志记录的场景。限于篇幅，这里无法一一列出，若你对其感兴趣，可以参考如下链接：

• 异常日志记录 - http://sourceforge.net/mailarchive/forum.php?thread_id=6766833&forum_id=41984
• 条件表达式语言 - http://www.nlog-project.org/conditions.html
• NLogViewer - 实时的日志记录查看器（当前还在pre-alpha阶段）- http://viewer.nlog-project.org/

Last updated: 2006-07-10 11:32:55

 

译注and后记

CrazyCoder朋友将加入到NLog文档的翻译过程中，他目前已经完成了对NLog配置文件这一节的翻译，不日即将发布。我非常感谢CrazyCoder的无私奉献精神！

由于某些原因，这一段时间我又会忙起来了…………可能不会如这一个月一样这样频繁地更新这个Blog，当然对于留言，我仍会尽量及时答复的。十分感谢朋友们一贯的支持！

虽然很不情愿，但是很有可能这个《NLog文章系列》也没办法继续写下去了……我真的非常希望有热心的朋友可以参与进来，既可以帮助开源社区的发展，也可以学习到新的知识，与朋友们进行交流，更能够顺便提高自己的英文能力。

如果你愿意奉献出自己的一点点时间，参与《NLog文章系列》的翻译，烦请你和我联系。参与翻译之后，如果你有能力且愿意的话，我也十分愿意尽自己微薄之力，帮你和出版社联系并翻译出版真正的图书。