ASP.NET?Core的日志系統實例分析

本文小編為大家詳細介紹“ASP.NET Core的日志系統實例分析”，內容詳細，步驟清晰，細節處理妥當，希望這篇“ASP.NET Core的日志系統實例分析”文章能幫助大家解決疑惑，下面跟著小編的思路慢慢深入，一起來學習新知識吧。

.net core是內置了日志系統的，如下是一個簡單的示例： 

var service = new ServiceCollection()
    .AddLogging(logging => { logging.AddConsole(); });
 
var provider   = service.BuildServiceProvider();
var logFactory = provider.GetService<ILoggerFactory>();
var logger     = logFactory.CreateLogger("MyLogger");
 
logger.LogInformation("hello world. {0}", DateTime.Now);

主要步驟如下：

• 在DI服務中通過AddLogging的配置日志服務

• 通過DI服務獲取ILoggerFactory

• 通過日志工廠創建ILogger

• 通過ILogger寫日志

需要注意的是，日志是異步輸出的，如果調用logger.LogInformation后程序馬上結束，是不會有日志輸出的。

ILogger和ILogger<T>

ILogger是我們實際用-來記錄日志的對象，前面的例子已經演示了它的使用方法，在.net core日志系統中，還提供了另一個接口ILogger<T>，它的創建方式如下：

var logger = logFactory.CreateLogger<Program>();

ILogger<T>本身也是繼承自ILogger的，也就是說，他們的用法基本一樣，ILogger<T>的主要區別是創建的時候無需制定數據源名稱，它的數據源就是類名，也就是說，它和如下方式創建的ILogger功能基本上是一致的。

var logger = logFactory.CreateLogger(typeof(Program).FullName);

那么為什么要創建一個ILogger<T>呢？我個人認為應為因為獲取它是不需要制定參數，更容易和DI框架集成，我們可以通過如下代碼獲取ILogger<T>，而不需要先獲取ILoggerFactory

var logger = provider.GetService<ILogger<Program>>();

日志結構

.net core的日志系統支持不同的日志框架，并且對外統一了日志的格式，不管使用哪種庫，它的格式是一樣的。這樣的好處是切換日志框架時，上層應用無需修改。一個基本的日志樣例為：

info: MyLogger[0]
hello world. 03/23/2019 22:37:58

它主要包括如下幾個部分：

• 日志級別： 日志級別定義在LogLevel枚舉中，它包含如下幾個級別：Trace、Debug、Information、Warning、Error、Critical。另外還有一個特殊級別None，它的值比Critical還高，主要用于關閉日志輸出， 當配置最小輸出級別時None時，由于它的級別比Critical還高，則所有的日志都不會輸出。

• 日志源： 用于標志日志的數據源，它是一個字符串，保存在具體的ILog對象中，本例中就是"MyLogger"

• 事件Id： 它標志了日志的序列號，大部分的時候都不會用到它

• 日志體： 日志內容

日志提供程序

ASP.NET Core 內置了如下幾種日志提供程序：

• 控制臺

• 調試

• EventSource

• EventLog

• TraceSource

前面的示例中，如果要增加其他的日志提供程序，可以在DI框架初始化的時候進行。 

var service = new ServiceCollection()
    .AddLogging(logging => { logging.AddConsole(); });
 
var provider   = service.BuildServiceProvider();
var logFactory = provider.GetService<ILoggerFactory>();
var logger     = logFactory.CreateLogger("MyLogger");
 
logger.LogInformation("hello world. {0}", DateTime.Now);

雖然系統內置了這些日志框架比較方便，但實際上用起來是不夠用的，比如說它不能輸出到文件，不過好在.net core提供了比較強大的擴展機制。

采用同樣的方式，我們也可以使用NLog、Seriallog等更為專業的日志框架，甚至他們已經做好了適配，直接拿來用都可以。

• elmah.io

• Gelf

• JSNLog

• KissLog.net

• Loggr

• NLog

• Sentry

• Serilog

• Stackdriver

Log配置文件

一個典型的日志系統的配置文件如下：

{
    "Logging": { 
        "LogLevel": { // 表示全局 
            "Default": "Warning" // 不指定CategoryName，應用于所有Category 
        },
        "Console": { // 指定 ProviderName，僅針對于 ConsoleProvider 
            "Default": "Warning",
            "Microsoft": "Error" // 指定CategoryName為Microsoft的日志級別為Error
        }
    }
}

我們可以通過AddConfiguration函數指定日志配置文件： 

var configBuilder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
var config        = configBuilder.Build();

var service = new ServiceCollection()
    .AddLogging(logging =>
    {
        logging.AddConfiguration(config.GetSection("Logging"));
        logging.AddConsole();
    });

讀到這里，這篇“ASP.NET Core的日志系統實例分析”文章已經介紹完畢，想要掌握這篇文章的知識點還需要大家自己動手實踐使用過才能領會，如果想了解更多相關內容的文章，歡迎關注億速云行業資訊頻道。