.net core3.x使用nlog

下载依赖：

<ItemGroup>
  <PackageReference Include="Nlog" Version="4.7.13" />
  <PackageReference Include="NLog.Web.AspNetCore" Version="4.14.0" />
</ItemGroup>

或者使用命令下载：

Install-Package NLog
Install-Package NLog.Web.AspNetCore

添加一个nlog配置文件


配置文件选择：web配置文件即可


如下：

<?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" >
  <targets>
    <!--这个目标:最终输出文件类型, 位于根目录中得logs文件夹中, 名称以每日得时间一次生成log文件 , layout: 这个选项为生成的格式-->
    <target xsi:type="File" name="file" 
            fileName="${basedir}/logs/nlog-aj-${shortdate}.log"
            layout="${longdate} ${uppercase:${level}} ${message}" />
  </targets>

  <rules>
    <!--设定了一个Debug得路由, 最终指向了一个f名称得目标 -->
    <logger name="*" minlevel="Debug" writeTo="file" />
  </rules>
</nlog>

主要是两个内容，一个是规则配置，比如设定日志等级，然后有个writeTo和上面的目标进行关联，目标可以设置文件名的规则，输出内容的规则等。
比如输出具体某几个日志等级

<logger name="*" level="Debug,Warn,Trace,Error,Fatal" writeTo="seq" />

name - 日志源/记录者的名字 (允许使用通配符*)

minlevel - 该规则所匹配日志范围的最低级别

maxlevel - 该规则所匹配日志范围的最高级别

level - 该规则所匹配的单一日志级别

levels - 该规则所匹配的一系列日志级别，由逗号分隔。

writeTo - 规则匹配时日志应该被写入的一系列目标，由逗号分隔。

final - 标记当前规则为最后一个规则。其后的规则即时匹配也不会被运行。

小例子：

<logger name="Name.Space.Class1" minlevel="Debug" writeTo="f1" /> - 名字空间Name.Space下的Class1这个类的所有级别等于或者高于Debug的日志信息都写入到“f1”这个目标里。

<logger name="Name.Space.Class1" levels="Debug,Error" writeTo="f1" /> -名字空间Name.Space下的Class1这个类的所有级别等于Debug或Error的日志信息都写入到“f1”这个目标里。

<logger name="Name.Space.*" writeTo="f3,f4" /> -名字空间Name.Space下所有类的所有级别的日志信息都写入到“f3”和“f4”这两个目标里。

<logger name="Name.Space.*" minlevel="Debug" maxlevel="Error" final="true" /> - 名字空间Name.Space下所有类的、级别在Debug和Error之间的(包括Debug,Info,Warn,Error) 日志信息都不会被记录(因为这条规则没有定义writeTo)，同时其它后续规则也都会被忽略(因为这里设置了final="true")。

使用日志,日志等级

如下：

public IActionResult Index(string value)
{
    var nlog = NLog.LogManager.GetCurrentClassLogger();

    nlog.Info("一般信息");
    nlog.Error("错误信息");
    nlog.Warn("警告信息");
    nlog.Trace("Trace信息");
    nlog.Debug("调试信息");

    return View();
}

日志输出位置默认在\Debug\netcoreapp3.1\logs下面。



根据上图我们可以看到日志输出内容，但是为什么没有看到Trace信息呢。是因为日志等级的原因，上面的日志等级设置是minlevel="Debug"，最低日志等级是Debug所以输出不了Trace信息。我们可以在配置一个规则，把日志等级修改成Trace即可。

修改配置文件为：

<?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" >
	<targets>
		<target xsi:type="File" name="fffff"
				fileName="${basedir}/logs/nlog-aj-${shortdate}.log"
				layout="${longdate} ${uppercase:${level}} ${message}" />

		<target xsi:type="File" name="xxx"
		fileName="${basedir}/logs/${shortdate}.log"
		layout="${longdate} ${uppercase:${level}} ${message}" />
	</targets>

	<rules>
		<logger name="*" minlevel="Debug" writeTo="fffff" />
		<logger name="*" minlevel="Trace" writeTo="xxx" />
	</rules>
</nlog>

我们增加了一个规则和输出目标，其中一个日志最小等级是Bebug，另外一个是Trace。上面两个目标的文件名也不一样。
生成的日志文件如下：


日志最小等级是Trace的内容：可以看到所有日志信息都已经输出了


日志最小等级是Trace的内容：


其他的什么日志等级可以按自己的需要配置，可以配置最低日志等级，最高日志等级，具体的某个或者某几个日志等级，比较灵活！



添加NLOG依赖，让项目默认的日志使用NLOG作为日志输出
如下：

如果不要这步.net core自带的日志输出就不会在nlog里边


使用.net core自带的日志输出：

因为我们配置了项目日志使用nlog所以这个日志的输出也是在nlog里边

private readonly ILogger<HomeController> _logger;

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

public IActionResult Index()
{
    _logger.LogInformation("自带log测试_普通信息日志");
    _logger.LogDebug("自带log测试_调试日志");
    _logger.LogError("自带log测试_错误日志");
    _logger.LogWarning("自带log测试_警告日志");
    _logger.LogTrace("自带log测试_跟踪日志");

    return View();
}

然后我们看看日志输出：自带的输出日志也有了


但是我们日志写了5个，这里只输出了3个，缺少了trace和debug。自带的控制台日志里边也没有trace和debug

和nlog的日志等级设置一样，这也是因为日志等级的问题，.net core自带的日志等级设置是在appsettings.json配置文件
关于日志等级的设置:

{
  "Logging": {
    "LogLevel": {
      "Default": "Trace",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*"
}

一般设置默认情况下的”Default”: “Trace”即可，默认”Default”设置是Information所以会缺少。

注意：还请确保检查任何特定于环境的应用程序设置，比如appsettings.development.json，开发环境下应该是设置appsettings.development.json而不是appsettings.json
我们把appsettings.development.json的Default日志等级设置一下：设置成最低等级Trace

然后在看日志输出：会发现所有的都能看到了



.net core项目的默认日志使用nlog作为日志框架后，日志等级会先受到自带日志等级的配置影响，然后也会收到nlog日志等级配置的影响