NLogStudy/NLogStudy.CoreWeb2.Default/Document/使用NLog.md

ASP.NET Core 2.x 使用Nlog

第一步

创建一个 ASP.NET Core 2.ｘ 项目

第二步

添加nuget包

• NLog
• NLog.Web.AspNetCore
• NLog.Extensions.Logging

第三步

根目录创建配置文件 nlog.config, 至少配置一项Target和一项Rules

第四步

配置文件属性配置为"复制到输出目录"

第五步

更新 program.cs

using NLog.Web;
using Microsoft.Extensions.Logging;

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<Startup>()
        .ConfigureLogging(logging =>
        {
            logging.ClearProviders();
            logging.SetMinimumLevel(Microsoft.Extensions.Logging.LogLevel.Trace);
        })
        .UseNLog();  // NLog: setup NLog for Dependency injection

第六步

配置 appsettings.json

在appsettings.json中指定的日志配置将覆盖对setminimumlevel的任何调用。所以要么去掉“默认”：要么根据你的需要调整它。

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

记住还要更新任何特定于环境的配置，以避免任何意外。例如：appsettings.development.json

第七步

写日志：在controller中，注入 ILogger

using Microsoft.Extensions.Logging;

public class HomeController : Controller
{
    private readonly ILogger<HomeController> _logger;

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

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

第八步

查看日志