VB.net 2010 视频教程 VB.net 2010 视频教程 python基础视频教程
SQL Server 2008 视频教程 c#入门经典教程 Visual Basic从门到精通视频教程
当前位置:
首页 > Python基础教程 >
  • C#教程之NLog组件

接触.net项目的同志们都清楚,最初在项目中记录日志常用的是log4net日志组件,随着.net框架的不对优化升级,最近新流行的日志框架nlog,下面我就对nlog组件说说自己的认知:

下载

通过Nuget安装NLog

 

 配置

在项目根目录下新建一个NLog.config(在Nuget包中也可以下载NLog.config包,下载默认的位置是C盘,可能和你的工程不在同一个文件夹,不建议使用),基本目录结构:targets下面配置日志输出目标及相关参数,rules下面配置目标输出规则:

复制代码
 1 <?xml version="1.0" ?>
 2 <nlog>
 3     <targets>
 4         <target></target>
 5         <target></target>
 6     </targets>
 7     <rules>
 8         <logger></logger>
 9         <logger></logger>
10     </rules>
11 </nlog>
复制代码

记得在NLog.config的属性中设置 Copy to Output Directory: Copy always,作用是每次重新生成解决方案的时候都会将改配置文件复制的本地目录,否则本地找不到配置文件无法将日志记录到文件中:

完整的配置文件如下,日志配置文件尽量单独创建一个文件:

复制代码
 1 <?xml version="1.0" encoding="utf-8" ?>
 2 <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 3   <targets>
 4     <!--写入文件-->
 5     <target   xsi:type="File" name="DebugFile"   fileName="Logs\Debug\${shortdate}.log"
 6      layout="日志时间:${longdate}${newline}日志来源:${callsite}${newline}日志级别:${uppercase:${level}}${newline}消息内容:${message}${newline}异常信息:${exception}${newline}==============================================================${newline}" >
 7     </target>
 8     <target   xsi:type="File" name="InfoFile"    fileName="Logs\Info\${shortdate}.log"
 9       layout="日志时间:${longdate}${newline}日志来源:${callsite}${newline}日志级别:${uppercase:${level}}${newline}消息内容:${message}${newline}异常信息:${exception}${newline}==============================================================${newline}" >
10     </target>
11     <target  xsi:type="File"  name="ErrorFile"   fileName="Logs\Error\${shortdate}.log"
12       layout="日志时间:${longdate}${newline}日志来源:${callsite}${newline}日志级别:${uppercase:${level}}${newline}消息内容:${message}${newline}异常信息:${exception}${newline}==============================================================${newline}" >
13     </target>
14 
15     <target xsi:type="Database" name="NewDatabase" >
16       <dbProvider>System.Data.SqlClient</dbProvider>
17       <connectionString>
18         Data Source=127.0.0.1;Initial Catalog=FlightAnalysis;Persist Security Info=true;User ID=sa;Password=111111;       
19       </connectionString>
20       <commandText>
21         insert into OperatorLog(Id,AppName,ModuleName,ProcName,OperationType,Logger,LogMessage,IP,UserName,LogLevel)
22         <!--values(@Id,'','','',0,'','','','','',getdate())-->
23         values(@Id,@AppName,@ModuleName,@ProcName,@OperationType,@Logger,@LogMessage,@IP,@UserName,@LogLevel)
24       </commandText>
25       <parameter name="@Id" layout="${event-context:item=Id}" />
26       <parameter name="@AppName" layout="${event-context:item=AppName}" />
27       <parameter name="@ModuleName" layout="${event-context:item=ModuleName}" />
28       <parameter name="@ProcName" layout="${event-context:item=ProcName}" />
29       <parameter name="@OperationType" layout="${event-context:item=OperationType}" />
30       <parameter name="@Logger" layout="${event-context:item=Logger}" />
31       <parameter name="@LogMessage" layout="${event-context:item=LogMessage}" />
32       <parameter name="@IP" layout="${event-context:item=IP}" />
33       <parameter name="@Longdate" layout="${event-context:item=Longdate}" />
34       <parameter name="@UserName" layout="${event-context:item=UserName}" />
35       <parameter name="@Createdate" layout="${longdate}" />
36       <parameter name="@LogLevel" layout="${level}" />
37     </target>
38   </targets>
39 
40   <rules>
41     <!--根据日志级别分别写文件,也可以放一个文件中-->
42     <!--<logger name="DbLogger" levels="Debug,Info,Error" writeTo="MyFile" />-->
43     <logger name="MyLogger" level="Debug" writeTo="DebugFile" />
44     <logger name="MyLogger" level="Info" writeTo="InfoFile" />
45     <logger name="MyLogger" level="Error" writeTo="ErrorFile" />
46     <!--写数据库-->
47     <logger name="MyLogger" levels="Trace,Debug,Info,Error"  writeTo="NewDatabase"/>
48   </rules>
49 </nlog>
复制代码
  • 如在根节点(nlog)配置 internalLogLevel, internalLogFile,可以查看NLog输出日志时的内部信息,比如你配置文件有错误,很有帮助,不过项目发布后还是关闭比较好,以免影响效率;
  • 在target外面罩了一个 <target>并且xsi:type为 AsyncWrapper,即表示这条 target 将异步输出,这里我将文件和数据库日志异步输出;
  • db target内指定了数据库连接字符串 connectionString,SQL语句,SQL参数,还可以指定数据库/表创建和删除的脚本(推荐看NLog源码示例,这里不介绍),同时我们自定义了2个参数 action和amount;
  • target参数里有些是NLog内置参数,比如message,level,date,longdate,exception,stacktrace等,NLog在输出时会自动赋值;
  • layout设置了每条日志的格式;
  • 在rules节点,我们分别指定了三个target输出日志的级别,NLog 用于输出日志的级别包括:Trace,Debug,Info,Warn,Error,Fatal,可以设置 minlevel设置最小级别,也可以用 levels定义你所有需要的级别(多个用逗号分隔)。
  • event-context代表自定义的参数。

 数据库连接示例: https://www.cnblogs.com/weiweictgu/p/5848805.html

 

 

路由规则(Rules)

   <rules />区域定义了日志的路由规则。每一个路由表项就是一个<logger />元素。<logger />有以下属性:

  1. name - 日志源/记录者的名字 (允许使用通配符*)
  2. minlevel - 该规则所匹配日志范围的最低级别
  3. maxlevel - 该规则所匹配日志范围的最高级别
  4. level - 该规则所匹配的单一日志级别
  5. levels - 该规则所匹配的一系列日志级别,由逗号分隔。
  6. writeTo - 规则匹配时日志应该被写入的一系列目标,由逗号分隔。
  7. final - 标记当前规则为最后一个规则。其后的规则即时匹配也不会被运行

封装

对NLog.config的Logger进行简单封装:

复制代码
  1  /// <summary>
  2     /// 日志类,只提供接口
  3     /// 2018-11-6 15:32:01
  4     /// </summary>
  5     public class Logger
  6     {
  7         #region 初始化
  8         //获取指定的名称为logger。
  9         //private static NLog.Logger _dblogger = NLog.LogManager.GetLogger("MyLogger");
 10         /// <summary>
 11         /// 日事件间类
 12         /// </summary>
 13         private LogEventInfo lei = new LogEventInfo();
 14         /// <summary>
 15         /// 数据错误无法获取用户时使用
 16         /// </summary>
 17         public static string DefaultUser = "system";
 18         /// <summary>
 19         /// 默认IP地址
 20         /// </summary>
 21         public static string DefaultIP = "127.0.0.1";
 22         /// <summary>
 23         /// 提供日志接口和实用程序功能
 24         /// </summary>
 25         private  NLog.Logger _logger = null;
 26         /// <summary>
 27         /// 自定义日志对象供外部使用
 28         /// </summary>
 29         public static Logger Default { get; private set; }
 30          
 31         private Logger(NLog.Logger logger)
 32         {
 33             _logger = logger;
 34         }
 35         public Logger(string name) : this(LogManager.GetLogger(name))
 36         { }
 37        
 38         static Logger()
 39         {
 40             //获取具有当前类名称的日志程序。
 41             Default = new Logger("MyLogger");
 42         }
 43         #endregion 
 44 
 45         #region Debug
 46         public void Debug(string msg, params object[] args)
 47         {
 48             _logger.Debug(msg, args);
 49         }
 50 
 51         public void Debug(string msg, Exception err)
 52         {
 53             _logger.Debug(err, msg);
 54         }
 55         #endregion
 56 
 57         #region Info
 58         public void Info(string msg, params object[] args)
 59         {
 60             _logger.Info(msg, args);
 61         }
 62 
 63         public void Info(string msg, Exception err)
 64         {
 65             _logger.Info(err, msg);
 66         }
 67         #endregion
 68 
 69         #region Warn
 70         /// <summary>
 71         ///警告
 72         /// </summary>
 73         /// <param name="msg">警告信息</param>
 74         /// <param name="args">动态参数</param>
 75         public void Warn(string msg, params object[] args)
 76         {
 77             _logger.Warn(msg, args);
 78         }
 79         /// <summary>
 80         ///警告
 81         /// </summary>
 82         /// <param name="msg">警告信息</param>
 83         /// <param name="err">异常信息</param>
 84         public void Warn(string msg, Exception err)
 85         {
 86             _logger.Warn(err, msg);
 87         }
 88         #endregion
 89 
 90         #region Trace
 91         /// <summary>
 92         /// 使用指定的参数在跟踪级别写入诊断消息
 93         /// </summary>
 94         /// <param name="msg">跟踪信息</param>
 95         /// <param name="args">动态参数</param>
 96         public void Trace(string msg, params object[] args)
 97         {
 98             _logger.Trace(msg, args);
 99         }
100         /// <summary>
101         /// 使用指定的参数在跟踪级别写入诊断消息
102         /// </summary>
103         /// <param name="msg">跟踪信息</param>
104         /// <param name="args">异常信息</param>
105         public void Trace(string msg, Exception err)
106         {
107             _logger.Trace(err, msg);
108         }
109         #endregion
110 
111         #region Error
112         /// <summary>
113         /// 使用指定的参数在错误级别写入诊断消息。
114         /// </summary>
115         /// <param name="msg">错误信息</param>
116         /// <param name="args">动态参数</param>
117         public void Error(string msg, params object[] args)
118         {
119             _logger.Error(msg, args);
120         }
121         /// <summary>
122         /// 使用指定的参数在错误级别写入诊断消息。
123         /// </summary>
124         /// <param name="msg">错误信息</param>
125         /// <param name="args">异常信息</param>
126         public void Error(string msg, Exception err)
127         {
128             _logger.Error(err, msg);
129         }
130         #endregion
131 
132         #region Fatal
133         /// <summary>
134         /// 使用指定的参数在致命级别写入诊断消息。
135         /// </summary>
136         /// <param name="msg">致命错误</param>
137         /// <param name="args">动态参数</param>
138         public void Fatal(string msg, params object[] args)
139         {
140             _logger.Fatal(msg, args);
141         }
142         /// <summary>
143         /// 使用指定的参数在致命级别写入诊断消息。
144         /// </summary>
145         /// <param name="msg">致命错误</param>
146         /// <param name="args">异常信息</param>
147         public void Fatal(string msg, Exception err)
148         {
149             _logger.Fatal(err, msg);
150         }
151         /// <summary>
152         /// 刷新所有挂起的日志消息(在异步目标的情况下)。
153         /// </summary>
154         /// <param name="timeoutMilliseconds">最大的时间允许冲洗。此后的任何消息都将被丢弃。</param>
155         public void Flush(int? timeoutMilliseconds = null)
156         {
157             if (timeoutMilliseconds != null)
158                 NLog.LogManager.Flush(timeoutMilliseconds.Value);
159 
160             NLog.LogManager.Flush();
161         }
162         #endregion
163 
164 
165         #region Operator日志写入
166         /// <summary>
167         /// 写入日志信息
168         /// </summary>
169         /// <param name="operatorLogModel">操作信息</param>
170         public void InsOperatorLog(OperatorLogModel operatorLogModel)
171         {
172             var level = LogLevel.Info;
173             if (operatorLogModel.LogLevel == NLog.LogLevel.Trace)
174                 level = LogLevel.Trace;
175             else if (operatorLogModel.LogLevel == NLog.LogLevel.Debug)
176                 level = LogLevel.Debug;
177             else if (operatorLogModel.LogLevel == NLog.LogLevel.Info)
178                 level = LogLevel.Info;
179