一个简单好用的日志框架NLog
之前我介绍过如何使用log4net来记录日志,但最近喜欢上了另一个简单好用的日志框架NLog。 关于NLog和log4net的比较这里就不多讨论了,感兴趣的朋友可以参看.NET日志工具介绍和log4net vs. Nlog这两篇文章。本文主要介绍一下如何在项目中使用NLog。
在Nuget中安装NLog
NLog可以直接使用Nuget安装: PM > Install-Package Nlog
使用NLog
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种重载形式。虽然功能强大事件好事,但某种程度上也增加了学习成本。
配置NLog
执行了上面的语句后,实际上是没有任何效果的。因为我们还没有配置日志的输出路径。这个输出路径一般是在配置文件中配置的(也支持硬编码),NLog支持两种配置文件格式
- 配置信息嵌入在.NET应用程序标准的*.exe.config或者web.config文件里
- 保存在独立文件里,也叫单一格式
第一张方式比较常规,但我不喜欢这种方式,因为它和其它与日志无关的配置写在一块儿了,不方便在不同的项目中共享配置。这里主要介绍下独立文件的方式。NLog支持如下三种文件名的配置文件:"NLog.config"、"*.exe.nlog"和"NLog.dll.nlog",我比较喜欢第一种。不管哪一种,其内容是一样的,一个简单的示例如下:
<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="Console" />
<target name="debugger" xsi:type="Debugger" layout="${date:format=HH\:mm\:ss.fff}: ${message}" />
<target name="error_file" xsi:type="File"
fileName="${basedir}/Logs/Error/${shortdate}/error.txt" maxArchiveFiles="30"
layout="${longdate} | ${level:uppercase=false} | ${message} ${onexception:${exception:format=tostring} ${newline} ${stacktrace} ${newline}" />
</targets>
<rules>
<!--<logger name="*" writeTo="console" />-->
<logger name="*" minlevel="Debug" writeTo="debugger" />
<logger name="*" minlevel="Error" writeTo="error_file" />
</rules>
</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的官方示例
- Most useful NLog configurations
顺便这儿也贴一个我常用的配置文档:
<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}"/>
<!--VS输出窗口-->
<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="*" writeTo="console" />-->
<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
另外,网上也有不少写得非常好的入门介绍文档,也可以学习一下:
- Introduction to NLog
- Trace Activities with NLog
- Logging setup in 5 minutes with NLog
- 介紹好用函式庫:NLog - Advanced .NET Logging
一个简单好用的日志框架NLog相关推荐
- github密码格式_如何使用GitHub构建一个简单的网页 (不用框架版本)
1.申请GitHub账号 进入GitHub官网,点击右上角的Sign up进行注册, 注册很简单,只要填写好用户名,邮箱,密码就行(已注册的用户名,邮箱不能再进行注册) 下面有一个你是人类的验证(照着 ...
- Unity PureMVC 之 PureMVC 框架的下载,以及一个简单应用学会使用 PureMVC 框架
Unity PureMVC 之 PureMVC 框架的下载,以及一个简单应用学会使用 PureMVC 框架 目录 Unity PureMVC 之 PureMVC 框架的下载,以及一个简单应用学会 ...
- Moon转告给你一个比Log4net更好日志框架--TracerX Logger 及其对应的日志查看器
一.介绍 TracerX logger是一个易于上手,且拥有众多高级特性的.NET日志框架. 它能够发送输出结果到多目的地(循环文件.事件日志等....).它也能生成文本和二进制文件. 它拥有一个强大 ...
- 一个简单且完整的PyTorch框架
PyTorch framework 该框架适合懂一点PyTorch但没有完整加载自己数据跑过实验的人,以及完整跑过实验但代码写的不优雅的人.可以在该框架上直接迁移到自己任务上,只需要更改dataloa ...
- 一个简单好用的后台框架模板
一个无刷新的简单好用的后台框架模板 下载地址:https://www.lmcjl.com/index/javascript/jqueryview?id=39 里面还有很多的模板与工具,希望可以帮助到您
- Pico.css大道至简返璞归真--一个简单轻量化的CSS框架
Pico.css是什么? Pico.css是一个简单轻量化的CSS UI框架,最大的特点是样式都基于HTML原始的标签名和内置的属性,少用甚至是不用class来定义样式,写出来的代码语义清晰,可维护性 ...
- 日志框架NLog之将日志发送到邮件
背景 NLog可以将日志输出到不同的媒介上,邮件是其中一个,通过邮件可以让我们第一时间收到信息.使用SMTP协议通过电子邮件发送日志消息.与FallbackGroup Target很好地结合在一起,以 ...
- 一个简单又高效的日志系统
摘要:本文给出一个性能高,使用简单的日志解决方案.本模块实现日志信息的批量写入文件,定时自动flush到文件中,写入文件的日志级别可动态调整,单个日志文件大小可配置,循环对日志文件写入,这样不会造成机 ...
- 一个简单的桌面应用程序框架示例(Java SE9)
1. 创建主窗体界面 package com.ys;import java.awt.Dimension; import java.awt.Toolkit; import java.awt.event. ...
最新文章
- 自动化测试基础篇--Selenium框架设计(POM)
- Java NIO系列教程(九) ServerSocketChannel
- anaconda切换盘符以及手动安装包
- Uploadify导致Chrome频繁崩溃Crash
- redis中执行lua脚本命令
- 动态规划下的巴什博弈
- 数学物理方法pdf_中考状元笔记九科(语文+数学+物理+化学+英语+历史+地理+政治+生物)(高清PDF);...
- 关系数据库第一第二第三范式
- iOS开发-- 使用TestFlight进行Beta测试
- mysql 找表重复数据_mysql 数据表中查找重复记录
- java replace三个参数_javascript replace()第二个参数为函数时的参数用法
- 兵家必争之地——关于O2O商业模式的一点遐想
- python按位置从字符串提取子串的操作是_Python基础-字符串操作和“容器”的操作...
- 查看linux系统是centos还是ubuntu的方法
- win10如何开启电源高性能模式
- 如何用html5实现网页聊天,HTML5 WebSocket实现点对点聊天的示例代码
- .Net 根据年份计算周次和起止日期
- 学编程看书好还是看视频好?
- 计算机专业要不要考研——写的很棒
- 在线客服系统解决方案:金融行业
热门文章
- 学院教务管理系统oracle设计,浙工院教学教务管理信息系统的设计与实现
- 7.23 ToolTip 实现全介绍
- Ba Gua Zhen
- Python的第三方库fileType
- linux 高性能日志,linux日志系统
- 暗黑系游戏_暗黑系冒险游戏,剧情引人入胜!
- linux 将结果放入数组,linux-如何将值添加到bash数组?
- python程序员怎么建议_资深程序员对Python新手的八个建议,超级实用!
- keygenerator php,学习PHP生成器的使用
- 蓝宝石显卡bios_狼神矿卡烤机89°C!强刷蓝宝石RX570超白金显卡BIOS降温75°教程...