NLog 记录文本日志使用步骤

//NuGet

NLog.Extensions.Logging

1）项目根目录下建nlog.config，设置“如果较新则复制”

注意：必须是这个名称，需要注意文件名的大小写(考虑linux，linux在意大小写)。遵循约定大于配置的原则，如果是其他文件名，需要单独配置

2）拷贝官网的默认配置，更改路径

www.nuget.org/

3）logBuilder.AddNLog()

Nlog默认配置文件下载

1、Nuget官网搜索NLog

2、Project website

3、Getting started for ASP.NET Core 6

进入项目地址

4、拷贝example的配置文件

<?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"
  autoReload="true"
  internalLogLevel="Info"
  <!--internalLogFile 更改日志文件路径 -->
  <internalLogFile="c:\temp\internal-nlog-AspNetCore.txt">

  <!-- enable asp.net core layout renderers -->
  <extensions>
    <add assembly="NLog.Web.AspNetCore"/>
  </extensions>

  <!-- targets代表日志可以输出到哪儿，NLog会输出给一个或多个target（也可以是控制台、数据库等） -->  
  <targets>
    <!-- File Target for all log messages with basic details -->
    <target xsi:type="File" name="allfile" fileName="c:\temp\nlog-AspNetCore-all-${shortdate}.log"
      layout="${longdate}|${event-properties:item=EventId:whenEmpty=0}|${level:uppercase=true}|${logger}|${message} ${exception:format=tostring}" />

    <!-- File Target for own log messages with extra web details using some ASP.NET core renderers -->
    <target xsi:type="File" name="ownFile-web" fileName="c:\temp\nlog-AspNetCore-own-${shortdate}.log"
      layout="${longdate}|${event-properties:item=EventId:whenEmpty=0}|${level:uppercase=true}|${logger}|${message} ${exception:format=tostring}|url: ${aspnet-request-url}|action: ${aspnet-mvc-action}|${callsite}" />

    <!--Console Target for hosting lifetime messages to improve Docker / Visual Studio startup detection -->
    <target xsi:type="Console" name="lifetimeConsole" layout="${MicrosoftConsoleLayout}" />
  </targets>

  <!--rules节点 日志输出到哪儿的target规则。rules节点下可以添加多个logger -->
  <rules>
    <!--All logs, including from Microsoft-->
    <logger name="*" minlevel="Trace" writeTo="allfile" />

    <!--Output hosting lifetime messages to console target for faster startup detection -->
    <logger name="Microsoft.Hosting.Lifetime" minlevel="Info" writeTo="lifetimeConsole, ownFile-web" final="true" />

    <!--Skip non-critical Microsoft logs and so log only own logs (BlackHole) -->
    <logger name="Microsoft.*" maxlevel="Info" final="true" />
    <logger name="System.Net.Http.*" maxlevel="Info" final="true" />

    <logger name="*" minlevel="Trace" writeTo="ownFile-web" />
  </rules>
</nlog>

target节点属性

属性名	含义
name	target的名字
fileName	文件名
layout	输出的格式
archiveAboveSize	单个日志文件超过多少字节就把日志存档”，单位为字节，这样可以避免单个文件太大
maxArchiveFiles	最多保持的文件数，如果不设定，则文件日志存档文件的数量会一直增加。设定maxArchiveFiles参数后，则最多保存maxArchiveFiles指定数量个数的存档文件，旧的会被删掉
maxArchiveDays	也可以不设置maxArchiveFiles参数，而设置maxArchiveDays参数，这样可以设定保存若干天的日志存档

logger节点：日志输出时，会从上往下匹配rules节点下所有的logger，若发现当前日志的名字的Level符合这个logger的name的通配符，就会把日志输出给这个logger。如果匹配多个logger，就把这条日志输出给多个logger。但是如果一个logger设置了final="true"，那么如果匹配到这个logger，就不继续向下匹配其他logger了

属性名	含义
name	name是通配符格式的，target的name如果匹配此name，则输出到此target
minlevel、maxlevel	表示这个logger接受日志的最低级别和最高级别。注意Fatal对应critical