.NET Core项目NLog日志框架使用

项目中日志是比较常见的一个功能模块，在开发阶段和运维阶段我们可以根据日志排查项目出现的问题，同时可以为项目运营阶段提供业务数据分析。所以日志是项目中不可或缺的功能模块，项目中一般会根据项目需要开发偏向业务的日志模块，而本博客主要介绍第三方日志框架NLog。通过引入NLog日志框架，项目中可以快速的实现基本的日志模块，大大的提高了开发效率。

NLog的Github地址：https://github.com/NLog/NLog， 官网地址：https://nlog-project.org/。

本博客主要介绍使用VS开发项目，引入NLog日志框架。

引入NLog包

首先在项目中通过Nuget引入NLog的相关包NLog和NLog.Web.AspNetCore，在VS中的程序包管理控制台依次输入Install-Package NLog -Version 4.6.6 和 Install-Package NLog.Web.AspNetCore -Version 4.8.4命令完成包的安装。如果官方包有更新可以更改版本号，安装最新版本的包。

创建NLog对应的nlog.config配置文件

在项目的根目录下创建nlog.config配置文件，通过属性并将该文件设置为“始终复制”或者“较新复制”，文件的内容可以参考如下设置，项目设置参考官方文档https://github.com/NLog/NLog/wiki/Configuration-file。

program.cs文件完成初始化配置

    public class Program
    {
        public static void Main(string[] args)
        {
            // NLog: setup the logger first to catch all errors
            var logger = NLog.Web.NLogBuilder.ConfigureNLog("nlog.config").GetCurrentClassLogger();
            try
            {
                logger.Debug("init main");
                CreateWebHostBuilder(args).Build().Run();
            }
            catch (Exception ex)
            {
                //NLog: catch setup errors
                logger.Error(ex, "Stopped program because of exception");
                throw;
            }
            finally
            {
                // Ensure to flush and stop internal timers/threads before application-exit (Avoid segmentation fault on Linux)
                NLog.LogManager.Shutdown();
            }
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup()
            .ConfigureLogging(logging => {
                logging.ClearProviders();
                logging.SetMinimumLevel(LogLevel.Information);
            }).UseNLog();
    }

appsettings.json文件中配置

在根目录的appsettings.json文件中增加日志等级配置，其中Default配置会覆盖program.cs中初始化方法SetMininumLevel，需要注意Default的配置。

{
    "Logging": {
        "LogLevel": {
            "Default": "Trace",
            "Microsoft": "Information"
        }
    }
}

调用方法写入日志

在program.cs文件初始化中调用了UseNLog()方法将NLog添加进项目的依赖注入中，项目中调用的时候可以通过依赖注入的方式调用NLog写入日志。如下是Controller中和其他类中通过依赖注入获取logger并写入日志的示例：

using Microsoft.Extensions.Logging;

public class HomeController : Controller
{
    private readonly ILogger _logger;

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

    public IActionResult Index()
    {
        _logger.LogInformation("Index page says hello");
        return View();
    }

            //通过IServiceProvider依赖注入获取logger,Aplication封装了IServiceProvider
            var logger = Application.Resolve>();

            try
            {
                if(logger != null)
                    logger.LogInformation($"计划任务 {Key} 开始运行");

                ExecuteTask();

                if (logger != null)
                    logger.LogInformation($"计划任务 {Key} 结束运行");
            }
            catch (Exception exc)
            {
                ScheduleTask.Enabled = !ScheduleTask.StopOnError;
                ScheduleTask.LastEndUtc = DateTime.UtcNow;
                RedisHelper.Set(Key, ScheduleTask);

                if (logger != null)
                    logger.LogError(exc, $"计划任务 {Key} 运行异常");
                if (throwException)
                    throw;
            }

日志示例

运行项目之后，会在对应的日志文件中记录日志：

总结

通过熟悉NLog的文档，项目中引入了NLog框架补充了日志模块，NLog上手还是较快，社区文档也较多。但是对于NLog的一些高级用法以及配置没做进一步的研究，以后有机会再研究。希望本博客可以为其他开发人员提供一些帮助，如果文中表述不对，欢迎大家反馈。