一个简单好用的日志框架NLog

时间 2019-11-11

标签一个简单好用日志框架 nlog 繁體版

原文原文链接

以前我介绍过如何使用log4net来记录日志，但最近喜欢上了另外一个简单好用的日志框架NLog。关于NLog和log4net的比较这里就很少讨论了，感兴趣的朋友能够参看.NET日志工具介绍和log4net vs. Nlog这两篇文章。本文主要介绍一下如何在项目中使用NLog。html

在Nuget中安装NLog git

NLog能够直接使用Nuget安装：　PM > Install-Package Nloggithub

使用NLog web

NLog的使用方式基本上和其它的Log库差很少，分为Trace、Debug、Info、Error、Fatal五个等级数据库

    private static Logger logger = LogManager.GetCurrentClassLogger();
    static void Main(string[] args)
    {
        logger.Trace("Trace Message");
        logger.Debug("Debug Message");
        logger.Info("Info Message");
        logger.Error("Error Message");
        logger.Fatal("Fatal Message");
    }网络

不过它提供的方法却是蛮多的，光Trace就有42种重载形式。虽然功能强大事件好事，但某种程度上也增长了学习成本。 app

配置NLog 框架

执行了上面的语句后，其实是没有任何效果的。由于咱们尚未配置日志的输出路径。这个输出路径通常是在配置文件中配置的（也支持硬编码），NLog支持两种配置文件格式 ide

配置信息嵌入在.NET应用程序标准的*.exe.config或者web.config文件里
保存在独立文件里，也叫单一格式

第一张方式比较常规，但我不喜欢这种方式，由于它和其它与日志无关的配置写在一起了，不方便在不一样的项目中共享配置。这里主要介绍下独立文件的方式。NLog支持以下三种文件名的配置文件："NLog.config"、"*.exe.nlog"和"NLog.dll.nlog"，我比较喜欢第一种。无论哪种，其内容是同样的，一个简单的示例以下：工具

它主要包括两个部分：输出目标target和路由规则rule。下面就分别介绍一下他们。

输出目标target

每一个target表明一个输出目标，它主要包含两个属性：name和type。name是输出模板的名称，在后面的路由规则中使用，type则是输出类型，常见的有

Console 输出到控制台
Debugger 输出到
File 输出到文件
Mail 输出为邮件发送
Network 输出到网络地址
Database 输出到数据库

当选择某一种类型的时候，还须要配置相应的参数。如输出类型是File时，咱们要配置日志路径filename，这里是可使用一些变量的（花括号里面的部分），我这里的例子：

fileName="${basedir}/Logs/Error/${shortdate}/error.txt"

输出的日志格式为 /Log/2014-10-01/err.txt 天天生成一个文件夹，很是方便。

输出格式的控制：

有的时候，咱们须要对时间、异常等这些对象的输出格式进行控制。它们能够经过修改layout参数来实现。这一部分是相对比较复杂的，不在本文讨论范围之列，有空的话我再专门介绍下。

参考示例：

网上有许多现成的示例，直接参考一下比从头写起要们节省很多时间，这里我简单的列举两个，欢迎读者朋友推荐。

顺便这儿也贴一个我经常使用的配置文档：

<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <targets>
        
        <target name="console" xsi:type="ColoredConsole"
                        layout="${date:format=HH\:mm\:ss}> ${message}"/>

        
        <target name="debugger" xsi:type="Debugger"
                        layout="${date:format=HH\:mm\:ss} | ${level:padding=-5} | ${message}" />

        
        <target name="error_file" xsi:type="File" maxArchiveFiles="30"
                        fileName="${basedir}/Logs/Error/${shortdate}/error.txt"
                        layout="${longdate} | ${level:uppercase=false:padding=-5} | ${message} ${onexception:${exception:format=tostring} ${newline} ${stacktrace} ${newline}" />
    </targets>
    <rules>
        
        <logger name="*" minlevel="Debug" writeTo="debugger" />
        <logger name="*" minlevel="Error" writeTo="error_file" />
    </rules>
</nlog>

路由规则rule

路由规则主要用于将日志和输出目标匹配起来，它通常有以下几个属性

name - 记录者的名字 (容许使用通配符*)
minlevel - 匹配日志范围的最低级别
maxlevel - 匹配日志范围的最高级别
level - 匹配的单一日志级别
levels - 匹配的一系列日志级别，由逗号分隔。
writeTo - 规则匹配时日志应该被写入的一系列目标，由逗号分隔。

看上去有好几个属性，实际上用起来仍是比较简单的，例如我前面的三条规则解释以下：

    <logger name="*" writeTo="console" />    将全部的日志输出到控制台中
    <logger name="*" minlevel="Debug" writeTo="debugger" />            将Debug级别以上的日志输出到Debugger中
    <logger name="*" minlevel="Error" writeTo="error_file" />        将Error级别以上的日志输出到文件中

另外，NLOG支持配置多个路由规则，能够很是方便咱们的输出。

因为篇幅有限，这里介绍得比较简略。更详细的配置文件设置能够参看官方文档：https://github.com/nlog/NLog/wiki/Configuration-file#configuration-file-locations

简单的封装：

前面已经列举过NLog的使用方法，虽然其使用并不算发杂，但一个简单的Wrapper能够下降使用门槛，规范使用方式，甚至方便后期切换日志框架，不少时候仍是很是有必要的。这里给一个简单的封装：

 1     class Logger
 2     {
 3         NLog.Logger logger;
 4 
 5         private Logger(NLog.Logger logger)
 6         {
 7             this.logger = logger;
 8         }
 9 
10         public Logger(string name)
11             :this(NLog.LogManager.GetLogger(name))
12         {
13         }
14 
15         public static Logger Default { get; private set; }
16         static Logger()
17         {
18             Default = new Logger(NLog.LogManager.GetCurrentClassLogger());
19         }
20 
21         public void Debug(string msg, params object[] args)
22         {
23             logger.Debug(msg, args);
24         }
25 
26         public void Debug(string msg, Exception err)
27         {
28             logger.Debug(msg, err);
29         }
30 
31         public void Info(string msg, params object[] args)
32         {
33             logger.Info(msg, args);
34         }
35 
36         public void Info(string msg, Exception err)
37         {
38             logger.Info(msg, err);
39         }
40 
41         public void Trace(string msg, params object[] args)
42         {
43             logger.Trace(msg, args);
44         }
45 
46         public void Trace(string msg, Exception err)
47         {
48             logger.Trace(msg, err);
49         }
50 
51         public void Error(string msg, params object[] args)
52         {
53             logger.Error(msg, args);
54         }
55 
56         public void Error(string msg, Exception err)
57         {
58             logger.Error(msg, err);
59         }
60 
61         public void Fatal(string msg, params object[] args)
62         {
63             logger.Fatal(msg, args);
64         }
65 
66         public void Fatal(string msg, Exception err)
67         {
68             logger.Fatal(msg, err);
69         }
70     }

View Code

虽然比较简单，但大多数简单的场景下仍是够用的。若是要更强大一点的封装能够考虑 Common.Logging, SimpleLoggingFacade等一些成型的库。

第三方查看工具

和log4net同样，NLog也是被一些第三方log查看工具所支持的，我这里就搜索到了两个：Sentinel和 Harvester 。我用这些查看工具的地方不大多，没有具体去研究它们。不过NLog是支持DB输出的，感受输出到DB中后用SQL查询要更加方便而强大些，就是实时性差些。

学习资料：

本文这里只是方便NLOG快速入门，仍属于管中窥豹阶段，NLOG自己仍是很是强大的，园子里有一系列文章进行了比较深刻的介绍，有这方面需求的朋友能够看看：

http://www.cnblogs.com/dflying/category/78087.html

另外，网上也有很多写得很是好的入门介绍文档，也能够学习一下：