.netcore3.1使用log4net/nlog记录日志

使用log4net

第一步、在对应项目中引入log4net.Extensions.Logging

log4net.Extensions.Logging依赖于log4net，所以在引入时自动引入了log4net

第二步、创建log4net.config文件

详细的配置说明请参照文档：https://dotnetgreen.com/log4net-configuration/；http://logging.apache.org/log4net/release/manual/configuration.html，

创建log4net.config，配置好日志参数。并将改文件设置成【始终复制】或者【如果较新则复制】

log4net.config文件内容示例

<?xml version="1.0" encoding="utf-8"?>
<log4net>
        <!-- Define some output appenders -->
        <appender name="rollingAppender" type="log4net.Appender.RollingFileAppender">
               <file value="log\log.txt" />
               <!--追加日志内容-->
               <appendToFile value="true" />
               <!--防止多线程时不能写Log,官方说线程非安全-->
               <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
               <!--可以为:Once|Size|Date|Composite-->
               <!--Composite为Size和Date的组合-->
               <rollingStyle value="Composite" />
               <!--当备份文件时,为文件名加的后缀-->
               <datePattern value="yyyyMMdd.txt" />
               <!--日志最大个数,都是最新的-->
               <!--rollingStyle节点为Size时,只能有value个日志-->
               <!--rollingStyle节点为Composite时,每天有value个日志-->
               <maxSizeRollBackups value="20" />
               <!--可用的单位:KB|MB|GB-->
               <maximumFileSize value="5MB" />
               <!--置为true,当前最新日志文件名永远为file节中的名字-->
               <staticLogFileName value="true" />
               <!--输出级别在INFO和ERROR之间的日志-->
    <!--过滤级别 FATAL > ERROR > WARN > INFO > DEBUG-->
               <filter type="log4net.Filter.LevelRangeFilter">
                       <param name="LevelMin" value="WARN" />
                       <param name="LevelMax" value="FATAL" />
               </filter>
               <layout type="log4net.Layout.PatternLayout">
                       <conversionPattern value="%date [%thread] %-5level %logger -  %message%newline"/>
               </layout>
        </appender>
        <root>
               <priority value="ALL"/>
               <level value="ALL"/>
               <appender-ref ref="rollingAppender" />
        </root>
</log4net>

第三步、代码注入log4net，记录日志

在startup.cs中注入log4net替换原有的日志组件

1             services.AddLogging(logBuilder=> {
2                 logBuilder.ClearProviders();
3                 logBuilder.AddLog4Net();
4             });

记录日志

 1     [Route("api/[controller]")]
 2     [ApiController]
 3     public class TestLoggerController : ControllerBase
 4     {
 5         private readonly ILogger<TestLoggerController> _logger;
 6         public TestLoggerController(ILogger<TestLoggerController> logger)
 7         {
 8             this._logger = logger;
 9         }
10 
11         [HttpPost("testWriteLogException")]
12         public void TestWriteLogException()
13         {
14             _logger.LogError("这是一个简单日志测试");
15              
16         }
17     }

结果

------------------------------------

使用NLog

第一步，项目中引入NLog.Extensions.Logging

第二步、创建nlog.config文件

详细的配置说明请参照NLog官方文档https://github.com/nlog/nlog/wiki/Configuration-file。

创建nlog.config文件，设置好日志记录规则信息，并将改文件设置成【始终复制】或者【如果较新则复制】

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"
      autoReload="true"
      internalLogLevel="Off"
      internalLogFile="d:\temp\internal-nlog.txt">

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

  <!-- the targets to write to -->
  <targets>
    <!-- write logs to file  -->
    <target xsi:type="File" name="allfile" fileName="${basedir}/logs/${shortdate}.log"
            layout="${longdate} ${level:uppercase=true} ${event-context:item=Action} ${message} ${event-context:item=Amount} ${stacktrace} ${newline} ${exception:format=tostring} ${newline}" />

    <!-- another file log, only own logs. Uses some ASP.NET core renderers -->
    <target xsi:type="Debugger" name="debugger" layout="${date:format=HH\:mm\:ss.fff}: ${message}"  />
  </targets>

  <!-- rules to map from logger name to target -->
  <rules>
    <!--Skip non-critical Microsoft logs and so log only own logs-->
    <!--<logger name="Microsoft.*" maxlevel="Error" final="true" />-->
    <logger name="*" minlevel="Debug" writeTo="allfile" />
    <!--<logger name="*" minlevel="Info" writeTo="allfile" />-->
  </rules>
</nlog>

第三步、代码中注入NLog

在startup.cs中注入NLog替换原来的日志组件

1             services.AddLogging(logBuilder=> {
2                 logBuilder.ClearProviders();
3                 logBuilder.AddNLog();
4             });

记录日志

    [Route("api/[controller]")]
    [ApiController]
    public class TestLoggerController : ControllerBase
    {
        private readonly ILogger<TestLoggerController> _logger;
        public TestLoggerController(ILogger<TestLoggerController> logger)
        {
            this._logger = logger;
        }

        [HttpPost("testWriteLogException")]
        public void TestWriteLogException()
        {
            _logger.LogError("这是一个简单日志测试-----NLog");
             
        }
    }

结果

-----------------------------------------

附，配置全局异常过滤

程序在运行中避免会出现各种异常，而我们不可能在所有地方都进行try..catch捕获异常记录日志。这时我们可以定义全局异常捕获并记录日志。

在netcore中我们只需要定义对应的异常过滤类（其必须继承自ExceptionFilterAttribute或者是实现接口IExceptionFilter；ExceptionFilterAttribute实现了接口IExceptionFilter），并在程序中进行注入异常过滤即可（日志的记录还是要依赖具体的实现，可以是log4net、NLog或者其他）。

以下定义了GlobalExceptionFilter

   
    public class GlobalExceptionFilter : ExceptionFilterAttribute
    {
        private readonly ILogger<GlobalExceptionFilter> _logger;
        public GlobalExceptionFilter(ILogger<GlobalExceptionFilter> logger)
        {
            _logger = logger;
        }

        public override void OnException(ExceptionContext context)
        {

            var operation = context.HttpContext.Request.RouteValues["controller"] + "/" + context.HttpContext.Request.RouteValues["action"];
            
            _logger.LogError(context.Exception,$"{operation}  Exception:" + context.Exception.Message); //记录错误日志
            //拦截处理
            if (!context.ExceptionHandled)
            {
                context.Result = new JsonResult(new 
                {
                    status = false,
                    msg ="系统内部错误:"+ context.Exception.Message
                });
                context.ExceptionHandled = true;
            } 
        }
    }

修改startup.cs添加异常过滤

 public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            services.AddMvc(p => {
                p.Filters.Add(typeof(GlobalExceptionFilter)); //添加异常过滤
            });  

....
        }

示例

    [Route("api/[controller]")]
    [ApiController]
    public class TestLoggerController : ControllerBase
    {
        private readonly ILogger<TestLoggerController> _logger;
        public TestLoggerController(ILogger<TestLoggerController> logger)
        {
            this._logger = logger;
        }

        [HttpPost("testWriteLogException")]
        public void TestWriteLogException()
        {
            throw new Exception("这是没有捕获的异常");
             
        }
    }

结果

-----------------------------------------

posted on 2020-05-23 01:14 john_yong 阅读(2182) 评论(0) 编辑收藏举报

刷新页面返回顶部

登录后才能查看或发表评论，立即登录或者逛逛博客园首页

阅读排行：
· 震惊！C++程序真的从main开始吗？99%的程序员都答错了
· 【硬核科普】Trae如何「偷看」你的代码？零基础破解AI编程运行原理
· 单元测试从入门到精通
· 上周热点回顾（3.3-3.9）
· winform 绘制太阳，地球，月球运作规律

john_yong