NLog详解

最新推荐文章于 2024-08-06 23:24:07 发布
最新推荐文章于 2024-08-06 23:24:07 发布
阅读量3.1k 收藏 16
点赞数 1
分类专栏： .Net 文章标签： NLog c#
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/liwan09/article/details/134069932
版权

目录

1.简介

2.项目中使用NLog

2.1 快速使用NLog

2.2 通过配置文件使用NLog

3.NLog配置参数详解

3.1 全局配置

3.2 根元素

3.2.1 targets

3.2.1.1 layout

3.2.2 rules

3.2.3 extensions

3.2.4 include

3.2.5 variable

4.附录

1.简介

NLog是一个基于.NET平台编写的类库，我们可以使用NLog在应用程序中添加极为完善的跟踪调试代码。

NLog是一个简单灵活的.NET日志记录类库。通过使用NLog，我们可以在任何一种.NET语言中输出带有上下文的（contextual information）调试诊断信息，根据喜好配置其表现样式之后发送到一个或多个输出目标（target）中。

NLog的API非常类似于log4net，且配置方式非常简单。NLog使用路由表（routing table）进行配置，但log4net却使用层次性的appender配置，这样就让NLog的配置文件非常容易阅读，并便于今后维护。

官网：NLog

文档地址：Home · NLog/NLog Wiki · GitHub

2.项目中使用NLog

首先使用VS2022创建基于.Net6的WebApi项目MyNLog，然后项目中创建类库项目MyNLog.Utils

2.1 快速使用NLog

1）MyNLog.Utils项目，从nuget中引入NLog

2） MyNLog.Utils项目中创建类NLogService.cs，使用NLog最简单的方法写日志

using NLog;

namespace MyNLog.Utils
{
    public class NLogService
    {
        /// <summary>
        /// 写日志
        /// </summary>
        /// <param name="content"></param>
        public static void WriteLog(string content)
        {
            var config = new NLog.Config.LoggingConfiguration();// 创建一个配置文件对象
            //创建日志写入目的地
            var logfile = new NLog.Targets.FileTarget("logfile") { FileName = $"logs/{DateTime.Now.ToString("yyyy-MM-dd")}.txt" };
            //添加日志路由规则
            config.AddRule(LogLevel.Debug, LogLevel.Fatal, logfile);
            //配置文件生效
            LogManager.Configuration = config;
            //创建日志记录对象方式1
            Logger Logger = LogManager.GetCurrentClassLogger();
            //创建日志记录对象方式2，手动命名
            //Logger Logger2 = LogManager.GetLogger("MyLogger");
            //打出日志
            Logger.Info(content);
        }
    }
}

3）项目 MyNLog中引用MyNLog.Utils项目，然后在WeatherForecastController中调用日志写入方法

using Microsoft.AspNetCore.Mvc;

namespace MyNLog.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

        //private readonly ILogger<WeatherForecastController> _logger;

        //public WeatherForecastController(ILogger<WeatherForecastController> logger)
        //{
        //    _logger = logger;
        //}

        [HttpGet(Name = "GetWeatherForecast")]
        public IEnumerable<WeatherForecast> Get()
        {
            MyNLog.Utils.NLogService.WriteLog("Hello NLog");//写日志
            return Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = DateTime.Now.AddDays(index),
                TemperatureC = Random.Shared.Next(-20, 55),
                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
            })
            .ToArray();
        }
    }
}

4）启动项目，Swagger中调用接口，会在bin/Debug/net6.0/logs中看见写入的日志

2.2 通过配置文件使用NLog

参见 Getting started with ASP.NET Core 6 · NLog/NLog Wiki · GitHub

1）修改NLogService中的代码

using System;
using System.Diagnostics;
using System.IO;
using System.Reflection;
using System.Xml;
using NLog.Config;
using NLog;

namespace MyNLog.Utils
{
    public class NLogService
    {
		private static ILogger _logger;
		/// <summary>
		/// 
		/// </summary>
		static NLogService()
		{
			//判断配置文件NLog.config是否存在
			bool flag = File.Exists(Path.Combine(Path.GetDirectoryName(typeof(NLogService).Assembly.Location), "NLog.config"));
			//获取配置信息
			LogManager.Configuration = GetXmlLoggingConfiguration(!flag);
		}
		/// <summary>
		/// 
		/// </summary>
		private NLogService()
		{
		}
		/// <summary>
		/// logger 初始化
		/// </summary>
		private static void SetLogger()
		{
			StackFrame stackFrame = new StackFrame(2, false);
			MethodBase method = stackFrame.GetMethod();
			_logger = LogManager.GetLogger(string.Format("{0}.{1}", method.DeclaringType, method.Name));
		}
		/// <summary>
		/// 获取logger 配置信息
		/// </summary>
		/// <param name="fromManifestResource"></param>
		/// <returns></returns>
		public static XmlLoggingConfiguration GetXmlLoggingConfiguration(bool fromManifestResource = true)
		{
			XmlLoggingConfiguration result;
			if (fromManifestResource)
			{
				Type declaringType = MethodBase.GetCurrentMethod().DeclaringType;
				string text = ((declaringType != null) ? declaringType.Namespace : null) ?? "Logging.NLog";
				Assembly executingAssembly = Assembly.GetExecutingAssembly();
				Stream manifestResourceStream = executingAssembly.GetManifestResourceStream(text + ".nlog.config");
				XmlTextReader xmlTextReader = new XmlTextReader(manifestResourceStream);
				result = new XmlLoggingConfiguration(xmlTextReader);
			}
			else
			{
				string text2 = Path.Combine(Path.GetDirectoryName(typeof(NLogService).Assembly.Location), "nlog.config");
				bool flag = !File.Exists(text2);
				if (flag)
				{
					throw new FileNotFoundException("nlog.config文件未找到。");
				}
				result = new XmlLoggingConfiguration(new FileInfo(text2).FullName);
			}
			return result;
		}
		/// <summary>
		/// write info log
		/// </summary>
		/// <param name="msg"></param>
		public static void Info(string msg)
		{
			SetLogger();
			_logger.Info(msg);
		}
		/// <summary>
		/// write warn log
		/// </summary>
		/// <param name="msg"></param>
		public static void Warn(string msg)
		{
			SetLogger();
			_logger.Warn(msg);
		}
		/// <summary>
		/// write debug log
		/// </summary>
		/// <param name="msg"></param>
		public static void Debug(string msg)
		{
			SetLogger();
			_logger.Debug(msg);
		}
		/// <summary>
		/// write error log
		/// </summary>
		/// <param name="msg"></param>
		public static void Error(string msg)
		{
			SetLogger();
			_logger.Error(msg);
		}
		/// <summary>
		/// write exception log
		/// </summary>
		/// <param name="e"></param>
		public static void Exception(Exception e)
		{
			SetLogger();
			_logger.Error<Exception>(e);
		}
	}
}

2）接口启动项目中，新增NLog.config配置文件

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.nlog-project.org/schemas/NLog.xsd NLog.xsd"
      autoReload="true"
      internalLogLevel="Info"
      internalLogFile="nlog-internal.log">

	<!--Nlog 文档参考地址：https://github.com/NLog/NLog/wiki-->
	<!--internalLogLevel Nlog内部日志记录为Off关闭。除非纠错，不可以设为Trace否则速度很慢，起码Debug以上-->
	<!--自定义日志输出文件路径及命名规则-->
	<variable name="logDir" value="${basedir}/nlogs/${date:format=yyyyMMdd}/${level}.log"/>
	<!-- Load the ASP.NET Core plugin,enable asp.net core layout renderers-->
	<extensions>
		<add assembly="NLog.Web.AspNetCore" />
	</extensions>
	<!--define various log targets-->
	<targets async="true">
		<!--写入文件-->
		<!--滚动日志文件上限数，滚动日志文件数达到上限新的文件内容会覆盖旧文件内容 -->
		<!--archiveAboveSize每个日志文件大小的最大值（单位：字节），主日志文件超过大小超过该值时会将文件内容写入滚动日志并清空主日志文件内容-->
		<!--${basedir}表示当前应用程序域所在的根目录-->
		<target name="allfile" xsi:type="File"
				fileName="${basedir}/adminlogs/all.txt"
				archiveFileName="${basedir}/adminlogs/all.{###}.txt"
				archiveEvery="Day"
				archiveNumbering="DateAndSequence"
				archiveAboveSize="20000000"
				maxArchiveFiles="30"
				keepFileOpen="true"
				layout="${longdate} | ${event-properties:item=EventId_Id} | ${uppercase:${level}} | ${logger} | ${aspnet-request-iP:CheckForwardedForHeader=true} | ${event-properties:item=user} | ${aspnet-request-url} | ${message} | ${event-properties:item=requestParam} | ${event-properties:item=jsonResult} | ${onexception:${exception:format=tostring}"/>

		<!--SQL-->
		<target name="sqlfile" xsi:type="File"
			fileName="${basedir}/adminlogs/all-sql.txt"
			archiveFileName="${basedir}/adminlogs/all.sql{###}.txt"
			archiveEvery="Day"
			archiveNumbering="DateAndSequence"
			archiveAboveSize="20000000"
			maxArchiveFiles="30"
			keepFileOpen="false"
			layout="===========================================${newline} ${longdate} - ${aspnet-request-iP} - ${aspnet-request-headers:HeaderNames=userid} - ${aspnet-request-url} ${newline} ${message}"/>

		<!--写入控制台-->
		<target name="console" xsi:type="ColoredConsole" layout="${date:format=MM-dd HH\:mm\:ss} | ${uppercase:${level}} | ${logger} | ${aspnet-request-iP} | ${aspnet-request-url} | ${message}"/>
		<!--SQL写入控制台-->
		<target name="consoleSql" xsi:type="ColoredConsole" layout="${date:format=MM-dd HH\:mm\:ss} | ${aspnet-request-url} ${newline} ${message}"/>
		<!--写入黑洞-->
		<target name="blackhole" xsi:type="Null" />
	</targets>
	<!--define various log rules-->
	<rules>
		<!-- 除非调试需要，把 .NET Core 程序集的 Debug 输出都屏蔽 Trace -> Debug-> Info ->Warn-> Error-> Critical-->
		<!--All logs, including from Microsoft-->
		<logger name="*" minlevel="Trace" writeTo="allfile" />
		<!-- 除非调试需要，把系统的 Debug 输出都屏蔽 -->
		<logger name="*" minLevel="Debug" writeTo="console"/>
		<!--跳过所有级别的Microsoft组件的日志记录-->
		<logger name="Microsoft.*" writeTo="blackhole" final="true" />		
		<!--<logger name="System.*" writeTo="blackhole" final="true" />-->
	</rules>
</nlog>

项目运行后的日志：

 

3.NLog配置参数详解

关于配置文件相关参数说明参见：https://github.com/NLog/NLog/wiki/Configuration-file

3.1 全局配置

<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.nlog-project.org/schemas/NLog.xsd NLog.xsd"
      autoReload="true"
      internalLogLevel="Info"
      internalLogFile="nlog-internal.log">

 

参数名称说明参数值
autoReload修改配置文件后是否允许自动加载无须重启程序true/false
throwExceptions内部日志系统抛出异常true/false
internalLogLevel可选Trace|Debug|Info|Warn|Error|Fatal决定内部日志的级别 Off 关闭

Trace|Debug|Info|Warn|Error|Fatal

Off为关闭

internalLogFile把内部的调试和异常信息写入指定的文件指定路径下的文件名称，自定义

3.2 根元素

在配置文件的根元素中，我们可以指定如下的子元素。其中前两个是必须设定的，其余三个为可选设定。
  • targets：定义日志的输出目标
  • rules：定义对日志信息的路由规则
  • extensions：定义从其他dll文件中加载的NLog扩展模块
  • include：引入外部的配置文件
  • variable：定义配置文件中用到的变量

3.2.1 targets

<targets async="true">
		<!--写入文件-->
		<!--滚动日志文件上限数，滚动日志文件数达到上限新的文件内容会覆盖旧文件内容 -->
		<!--archiveAboveSize每个日志文件大小的最大值（单位：字节），主日志文件超过大小超过该值时会将文件内容写入滚动日志并清空主日志文件内容-->
		<!--${basedir}表示当前应用程序域所在的根目录-->
		<target name="allfile" xsi:type="File"
				fileName="${basedir}/adminlogs/all.txt"
				archiveFileName="${basedir}/adminlogs/all.{###}.txt"
				archiveEvery="Day"
				archiveNumbering="DateAndSequence"
				archiveAboveSize="20000000"
				maxArchiveFiles="30"
				keepFileOpen="true"
				layout="${longdate} | ${event-properties:item=EventId_Id} | ${uppercase:${level}} | ${logger} | ${aspnet-request-iP:CheckForwardedForHeader=true} | ${event-properties:item=user} | ${aspnet-request-url} | ${message} | ${event-properties:item=requestParam} | ${event-properties:item=jsonResult} | ${onexception:${exception:format=tostring}"/>
	</targets>

 Nlog允许用户配置单个文件大小, 放置在内容过长效率过慢,配置了大小之后, Nlog会自动创建一个新的文件副本,插入新的日志输出。

常用的参数配置说明：

参数名说明备注
name输出目标的名称，用于rules中路由规则writeTo指定
layout用来规定输出内容格式，语法“${属性}”，可以把上下文信息插入到日志中详情参见3.2.1.1layout
xsi:type输出类型
fileName包含完整的生成文件的路径和文件名以下值使NLog根据应用程序运行目录中的日志级别将日志事件写入文件$｛basedir｝/$｛level｝.log所有调试消息将转到Debug.log，所有信息消息将转到Info.log，依此类推。您可以组合任意数量的布局渲染器来生成任意的日志文件名
maxArchiveFiles应保留的存档文件的最大数量
archiveAboveSize日志文件将自动存档的大小（以字节为单位）
archiveEvery

指示是否在每次指定时间过后自动存档日志文件

targets更多参数配置参见：File target · NLog/NLog Wiki · GitHub

3.2.1.1 layout

layout参数配置用来规定输出内容格式，必填项及默认值：${longdate}|${level:uppercase=true}|${logger}|${message:withexception=true}

  • $ {cached} -  将缓存应用于另一个布局输出。
  • $ {db-null} - 为数据库渲染DbNull
  • $ {exception} - 通过调用Logger方法之一提供的异常信息
  • $ {level} - 日志级别（例如ERROR，DEBUG）或级别序数（数字）
  • $ {literal} - 字符串文字。（文本）-有用，以逃避括号
  • $ {logger} - 记录器名称。GetLogger，GetCurrentClassLogger等
  • $ {message} - （格式化的）日志消息。
  • $ {newline} - 换行文字。
  • $ {object-path} -  渲染对象的（嵌套）属性
  • $ {onexception} -  仅在为日志消息定义了异常时才输出内部布局。
  • $ {var} - 渲染变量

呼叫站点和堆栈跟踪

  • $ {callsite} - 调用站点（类名，方法名和源信息）
  • $ {callsite-linenumber} - 呼叫站点源行号。
  • $ {stacktrace} - 渲染堆栈跟踪

条件

  • $ {when} -  仅在满足指定条件时输出内部布局。
  • $ {whenempty} -  当内部布局产生空结果时，输出替代布局。

上下文信息

  • $ {activityid} - 将System.Diagnostics跟踪关联ID记录到日志中。
  • $ {all-event-properties} - 记录所有事件上下文数据。
  • $ {event-context} -  记录事件属性数据-替换为$ {event-properties}
  • $ {event-properties} - 记录事件属性数据-重命名$ {event-context}
  • $ {gdc} - 全局诊断上下文项。包含每个应用程序实例值的字典结构。
  • $ {install-context} - 安装参数（传递给InstallNLogConfig）。
  • $ {mdc} - 映射诊断上下文-线程局部结构。
  • $ {mdlc} - 异步映射诊断上下文-线程局部结构。MDC的异步版本
  • $ {ndc} - 嵌套诊断上下文-线程局部结构。
  • $ {ndlc} - 异步嵌套诊断上下文-线程本地结构。

专柜

  • $ {counter} - 一个计数器值（在每个布局渲染中增加）
  • $ {guid} - 全局唯一标识符（GUID）。
  • $ {sequenceid} - 日志序列号

日期和时间

  • $ {date} - 当前日期和时间。
  • $ {longdate} - 日期和时间，采用可排序的长格式`yyyy-MM-dd HH：mm：ss.ffff`。
  • $ {qpc} - 高精度计时器，基于QueryPerformanceCounter返回的值。
  • $ {shortdate} - 短日期，格式为yyyy-MM-dd。
  • $ {ticks} - 当前日期和时间的“ Ticks”值。
  • $ {时间} - 在24小时，可排序的格式HH的时间：MM：ss.mmm。

编码和字符串转换

  • $ {json-encode} -  使用JSON规则转义另一个布局的输出。
  • $ {left} -  文字的左半部分
  • $ {小写} -  将另一个布局输出的结果转换为小写。
  • $ {norawvalue} -  防止将另一个布局渲染器的输出视为原始值
  • $ {pad} -  将填充应用于另一个布局输出。
  • $ {replace} -  将另一个布局的输出中的字符串替换为另一个字符串。正则表达式可选
  • $ {replace-newlines} -  用另一个字符串替换换行符。
  • $ {right} -  文字的右侧
  • $ {rot13} -  使用ROT-13解码“加密”的文本。
  • $ {substring} -  文本的子字符串
  • $ {trim-whitespace} -  从另一个布局渲染器的结果修剪空白。
  • $ {uppercase} -  将另一个布局输出的结果转换为大写。
  • $ {url-encode} -  编码另一个布局输出的结果，以供URL使用。
  • $ {wrapline} -  以指定的行长包装另一个布局输出的结果。
  • $ {xml-encode} -  将另一个布局输出的结果转换为XML兼容的。

环境和配置文件

  • $ {appsetting} -. config文件 NLog.Extended中的应用程序配置设置
  • $ {configsetting} - 来自appsettings.json或ASP.NET Core和.NET Core中其他配置的值 NLog.Extensions.Logging NLog.Extensions.Hosting NLog.Web.AspNetCore
  • $ {environment} - 环境变量。（例如PATH，OSVersion）
  • $ {environment-user} - 用户身份信息（用户名）。
  • $ {}注册表 - 从Windows注册表中的值。

文件和目录

  • $ {basedir} - 当前应用程序域的基本目录。
  • $ {currentdir} - 应用程序的当前工作目录。
  • $ {file-contents} - 呈现指定文件的内容。
  • $ {filesystem-normalize} -  通过将文件名替换为安全字符来过滤文件名中不允许的字符。
  • $ {} nlogdir - 其中NLog.dll所在的目录。
  • $ {specialfolder} - 系统专用文件夹路径（包括“我的文档”，“我的音乐”，“程序文件”，“桌面”等）。
  • $ {tempdir} - 临时目录。

身分识别

  • $ {identity} - 线程身份信息（名称和身份验证信息）。
  • $ {windows-identity} - 线程Windows身份信息（用户名）
  • $ {windows-identity} - 线程Windows身份信息（用户名） Nlog.WindowsIdentity

整合方式

  • $ {gelf} - 将日志转换为GELF格式 NLog.GelfLayout 外部
  • $ {log4jxmlevent} - 与log4j，Chainsaw和NLogViewer兼容的XML事件描述。

进程，线程和程序集

  • $ {appdomain} - 当前的应用程序域。
  • $ {assembly-version} - 默认应用程序域中可执行文件的版本。
  • $ {gc} - 有关垃圾收集器的信息。
  • $ {hostname} - 运行该进程的计算机的主机名。
  • $ {local-ip} - 来自网络接口的本地IP地址。
  • $ {machinename} - 运行进程的计算机名。
  • $ {performancecounter} - 性能计数器。
  • $ {processid} - 当前进程的标识符。
  • $ {processinfo} - 有关正在运行的进程的信息。例如StartTime，PagedMemorySize
  • $ {processname} - 当前进程的名称。
  • $ {processtime} - 格式为HH：mm：ss.mmm的处理时间。
  • $ {threadid} - 当前线程的标识符。
  • $ {threadname} - 当前线程的名称。

Silverlight

  • $ {document-uri} - 承载当前Silverlight应用程序的HTML页面的URI。
  • $ {sl-appinfo} - 有关Silverlight应用程序的信息。

Web，ASP.NET和ASP.NET Core

  • $ {ASPNET-appbasepath} - ASP.NET应用程序的基本路径（内容根） NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET应用} - ASP.NET应用程序变量。 网络日志
  • $ {ASPNET环境} - ASP.NET环境名称 NLog.Web.AspNetCore
  • $ {ASPNET项} - ASP.NET`HttpContext`项变量。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-MVC-行动} - ASP.NET MVC动作名称 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-MVC控制器} - ASP.NET MVC控制器名称 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求} - ASP.NET请求变量。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-请求的contentType} - ASP.NET Content-Type头（实施例应用/ JSON） NLog.Web.AspNetCore
  • $ {ASPNET请求，饼干} - ASP.NET请求的cookie的内容。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求形式} - ASP.NET请求表的内容。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求报头} - ASP.NET部首键/值对。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求主机} - ASP.NET请求主机。 NLog.Web NLog.Web.AspNetCore
  • $ {aspnet-request-ip} - 客户端IP。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求-方法} - ASP.NET请求方法（GET，POST等）。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求，贴体} - ASP.NET贴体/净荷 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-请求的查询字符串} - ASP.NET请求的查询字符串。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET，请求引荐} - ASP.NET请求引用。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求的URL} - ASP.NET请求URL。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET请求，用户代理} - ASP.NET请求用户代理。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-响应的StatusCode} - ASP.NET响应状态代码的内容。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET会话} - ASP.NET Session变量。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-的SessionID} - ASP.NET会话ID的变量。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-traceidentifier} - ASP.NET跟踪标识 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET用户-的authType} - ASP.NET用户验证。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET用户身份} - ASP.NET用户变量。 NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET用户-isauthenticated} - ASP.NET用户身份验证？ NLog.Web NLog.Web.AspNetCore
  • $ {ASPNET-webrootpath} - ASP.NET Web根目录路径（wwwroot文件） NLog.Web NLog.Web.AspNetCore
  • $ {iis-site-name} - IIS网站的名称。 NLog.Web NLog.Web.AspNetCore

3.2.2 rules

规则部分控制如何将Logger对象中的LogEvents重定向到输出目标。其中记录器名称和日志级别可用于筛选。

当创建一个NLogLogger对象时，必须提供一个类似NLog.LogManager.GetLogger的记录器名称（“我的记录器名称”）。也可以使用NLog.LogManager.GetCurrentClassLogger（）从类上下文中提取记录器名称，其中记录器名称变为“NameSpace.ClassName”。

<rules>
		<!-- 除非调试需要，把 .NET Core 程序集的 Debug 输出都屏蔽 Trace -> Debug-> Info ->Warn-> Error-> Critical-->
		<!--All logs, including from Microsoft-->
		<logger name="*" minlevel="Trace" writeTo="allfile" />
		<!-- 除非调试需要，把系统的 Debug 输出都屏蔽 -->
		<logger name="*" minLevel="Debug" writeTo="console"/>
		<!--跳过所有级别的Microsoft组件的日志记录-->
		<logger name="Microsoft.*" writeTo="blackhole" final="true" />		
		<!--<logger name="System.*" writeTo="blackhole" final="true" />-->
	</rules>

 参数配置说明

参数名说明备注
name匹配logger对象的记录器名称-可能包括通配符(* and ?)
minlevel要记录的最低级别（与指定级别和以上级别相匹配）
maxlevel要记录的最大级别（与指定级别和以下级别匹配）
level要记录的单个级别
levels要记录的级别的逗号分隔列表
writeTo要写入的目标的逗号分隔列表
final最终规则匹配后不处理任何规则
enabled设置为false可禁用规则而不删除它
ruleName允许使用配置进行规则查找的规则标识符
finalMinLevel记录器匹配将被限制为以下规则的指定最低级别

官方文档参见：https://github.com/NLog/NLog/wiki/Configuration-file#rules

3.2.3 extensions

可以将扩展配置为包括其他NLog包或自定义包：

只需在＜extensions/＞中的配置中引用DLL

<extensions>
  <add assembly="NLog.Web.AspNetCore" />
</extensions>

3.2.4 include

NLog提供了包含文件功能，因此配置可以存储在多个文件中

<include file="nlog-common.config" />

与NLog-config中的大多数属性一样，file属性可能引用变量。下面的示例包括一个与nlog运行的计算机名称相同的文件。

<include file="${machinename}.config"/>

3.2.5 variable

NLog配置变量允许您通过减少重复文本来简化配置。变量可用于为常用的（或长而复杂的）NLog布局指定人名。这样可以更容易地组织和构造NLog配置。

<!--自定义日志输出文件路径及命名规则-->
<variable name="logDir" value="${basedir}/nlogs/${date:format=yyyyMMdd}/${level}.log"/>

4.附录

输出日志到数据库参见：Database target · NLog/NLog Wiki · GitHub

输出日志到控制台参见：ColoredConsole target · NLog/NLog Wiki · GitHub

蓝晶之心
关注
专栏目录
.NET NLog 详解(二)
便当的专栏
11-09 527
Git是个很好的源码管理系统，你可以瞬间切换为任何历史版本。为了更好的解析NLog这个组件，我们将时钟倒拨回2004年。(注意：NLog v0.9 has been released 是在2005-06-09) 架构 首先主体项目的代码结构是这个样子的： 逻辑上是这个样子的： 测试 这个时候，代码还没有很多的test case，处于相当的简单粗暴阶段。 static void Main(str
nlog官方帮助_NLog类库使用探索——详解配置
weixin_39979332的博客
12-21 417
https://www.cnblogs.com/fuchongjundream/p/3936431.html1 配置文件的位置(Configuration file locations)通过在启动的时候对一些常用目录的扫描，NLog会尝试使用找到的配置信息进行自动的自我配置。1.1 单独的*.exe客户端单独的客户端，NLog将在以下目录搜索配置信息：标准的程序配置文件(通常为程序名.exe.c...
nlog 完整的配置文件 log 分.1 .2 保留原日志
最新发布
qq_26864945的博客
08-06 184
C# XML nlog.config
【日志】Nlog
在这里你大概率会有所收获，欢迎指错||纠正||建议||水评+点赞&&评论&&关注&&转发
07-18 1010
NLog是一个基于.NET平台编写的类库，主要用于在应用程序中实现灵活和可配置的日志记录。以下是对NLog的详细介绍：
常见日志库NLog、log4net、Serilog和Microsoft.Extensions.Logging介绍和区别
星河队长
06-11 1090
在C#中，日志库的选择主要取决于项目的具体需求，包括性能、易用性、可扩展性等因素。以下是关于NLog、log4net、Serilog和Microsoft.Extensions.Logging的基本介绍和使用示例。
.Net项目中NLog的配置与使用
dfj66154的博客
07-14 663
引言： 　　因为之前在项目开发中一直都是使用的Log4Net作为项目的日志记录框架，最近忽然感觉对它已经有点腻了，所以尝试着使用了NLog作为新项目的日志记录框架（当然作为一名有志向的攻城狮永远都不能只局限于眼前的技术，要不断的使用和学习新的技术）。当然serilog也是一个不错的日志记录框架哟，不过今天主要还是要讲述的是NLog在项目中的配置和使用。 NLog框架源码：https:...
NLog简单使用教程
架构师之路，举步维艰。
03-08 3716
NLog简单使用教程 NLog介绍 NLog是一个记录日志的模块，简单配置就能使用。 如何获得 在visual studio里面的NuGet程序包管理器里面直接搜NLog 和 NLog.config添加上就可以了。这里稍微说下，NLog是模块主体，NLog.config是一个配置文件，如果你对NLog足够了解可以自己配置文件。 配置文件 这是一个配置文件例子 <?xml version="1.0" encoding="utf-8" ?> <!-- add your
Nlog详解---非常详细
LongtengGensSupreme博客
08-11 1万+
Nlog详解
.NET使用NLog记录日志信息（一）
Jason 的专栏
11-06 803
应用程序跟踪介绍 很久以前，在那个没有调试器，软件也大都是基于控制台的年代里，开发者习惯于使用printf()语句输出跟踪调试信息。而现在，世界发生了翻天覆地般的变化——printf()被Console.WriteLine()代替了…… 我们都曾经书写过类似如下的代码： static void Main() { Console.WriteLine("SuperA...
NLog配置文件详解
Schaffer的博客
11-22 1916
NLog属性详解
Nlog详解
热门推荐
李宥的博客
06-21 1万+
NLog是一个基于.NET平台编写的日志记录类库，我们可以使用NLog在应用程序中添加极为完善的跟踪调试代码。可以在任何一种.NET语言中输出带有上下文的（contextual information）调试诊断信息，根据喜好配置其表现样式之后发送到一个或多个输出目标（target）中。官网地址：https://nlog-project.org/文档地址：https://github.com/NLog/NLog/wiki （2）代码实现 （3）运行结果 （2）配置文件 （3）代码实现 （4）运行
.Net项目中NLog的配置和使用实例详解
10-16
主要给大家介绍了关于.Net项目中NLog的配置和使用的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用.Net具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
很实用的NLog配置分享
01-01
前言 NLog是一个基于.NET平台编写的类库，我们可以使用NLog在应用程序中添加极为完善的跟踪调试代码。本文主要介绍的是关于NLog配置的相关内容，下面话不多说了，来一起看看详细的介绍吧 NLog配置 新建一个文件命名为NLog.Config，然后添加如下代码 <?xml version=1.0 encoding=utf-8 ?>
.NET NLog 详解 (三) - LayoutRender
便当的专栏
11-09 1491
这期将NLog Git版本指向2005-06-09，NLog v0.9 released。这个时候的代码结构升级为这样： 和上期的版本相比，最明显的莫过于原先的Appender全套更名为Target。这期让我们来关注LayoutRender相关的实现。 LayoutRender 首先LayoutRender 继承自抽象类LayoutRenderer，并且以属性[LayoutRenderer("t
.NET NLog 详解(五) - Condition Expression
便当的专栏
11-09 803
.Net NLog Condition Expression
.NET NLog 详解(四) - filter
便当的专栏
11-09 570
我们将版本向前切换到20051025，这期的关注点是filter。我们在使用日志的时候可能希望加上一些过滤器，在满足某些特定条件的时候才输出。举个简单的使用方式如下： 初始化 FilterFactory负责初始化程序集中的Filter public sealed cl
Nlog 的使用
songhuangong123的博客
04-13 1354
${appdomain} 当前应用程序域l ${assembly-version} 应用程序 ${basedir} 应用程序域的基本目录。 ${callsite} (类名称、方法名称和相关信息的源信息)。 ${counter} 数值 ${date} 当前日期和时间。 ${environment} 环境变量 ${exception} exception信息 ${guid} GUID ${identity} 线程标识信息 ${level} 级别。 ${log4jx..
NLog基本讲解以及使用
妖精的尾巴
12-05 4706
Nlog和Log4net 基本一样。 通俗讲都是记录日志的。今天先讲Nlog的使用。具体原理。。。。。，先略。 第一步：下载 通过Nuget安装NLog，（找到项目里的“引用”，右键,管理Nuget程序包，搜索Nlog, ） 这步很简单。。。。。。  第二步：修改Nlog.Config  这块配置说简单也简单，说复杂也复杂， 这次先配置几个简单的。 第一种：保存到文件  &...
NLog.NLogConfigurationException
10-20
NLog是一个流行的日志记录库，它提供了丰富的功能和灵活的配置选项。NLogConfigurationException是NLog库中的一个异常类型，它表示NLog配置文件中存在错误或不一致性。 当NLog配置文件中存在错误时，NLog将抛出NLogConfigurationException异常。例如，如果配置文件中缺少必需的属性或元素，或者属性值不正确，就会抛出此异常。此外，如果NLog无法解析配置文件，也会抛出此异常。 以下是一个示例代码，演示如何捕获NLogConfigurationException异常： ``` try { // Load NLog configuration from file LogManager.LoadConfiguration("nlog.config"); } catch (NLogConfigurationException ex) { // Handle NLog configuration exception Console.WriteLine("NLog configuration error: " + ex.Message); } ``` 在上面的代码中，我们尝试从文件加载NLog配置。如果存在配置错误，则会抛出NLogConfigurationException异常，并在catch块中进行处理。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值