ASP.NET Core 中依賴注入是一個很重要的環節。因為幾乎所有的對象都是由它創建的（相關文章請參見《ASP.NET Core 沉思錄 - ServiceProvider 的二度出生》）。因此整個日志記錄的相關類型也被直接添加到了 IServiceCollection 中。今天我們將介紹各個接口/類型之間的關系，并找到介入日志記錄功能的兩個主要的入口。

ASP.NET Core 的日志功能結構

為什么當我們恰當對日志進行配置之后就可以記錄日志呢。那是因為 Framework 一定已經將最關鍵的類型添加到了 IServiceCollection 中。在 ASP.NET Core 中，應用程序的啟動一定會創建 WebHost 而創建 WebHost 一般會用到 WebHostBuilder。在 WebHostBuilder 創建過程中就將一些核心的日志記錄相關類型添加到了 IServiceCollection 中。

前面我們介紹過，IServiceProvider 有兩次創建過程，一次是在調用 WebHostBuilder.Build 時創建的 Hosting 相關的 IServiceProvider，另一次是在 WebHost.StartXxx 方法時創建的應用程序使用的 IServiceProvider。而日志相關類型第一次的 IServiceProvider 創建之前就已經添加到 IServiceCollection 中了。

在本文寫作時，第一次 IServiceCollection 實例的創建是在 WebHostBuilder.BuildCommonServices 方法中，大概的流程是：

• 創建 ServiceCollection

• 調用 AddLogging 擴展方法

• 將 IOptions<>; 及其它形式、ILoggerFactory、ILogger<>、IConfigurator、IConfigureOptions 添加到 ServiceCollection 中。

• 如果在配置 IWebHostBuilder 過程中調用過 ConfigureLogging 則調用相關委托添加或替換相關日志記錄的類型。

代碼請參見：WebHostBuilder.cs (https://github.com/aspnet/AspNetCore/blob/master/src/Hosting/Hosting/src/WebHostBuilder.cs) 以及LoggingServiceCollectionExtensions.cs (https://github.com/aspnet/Extensions/blob/master/src/Logging/Logging/src/LoggingServiceCollectionExtensions.cs)。

因此，以上提到的類型就是日志功能的核心類型了。梳理一下這些類型的依賴關系就可以弄清 ASP.NET Core 的日志功能結構了。

弄清一個結構需要關注兩個部分的內容，第一個部分是聲明上的依賴關系（靜態），另一個部分是調用上的依賴關系（動態）。因此我們也會采用這種方式進行梳理。首先聲明上的依賴關系如下：

以上結構在運行時會創建三層 ILogger 實現

• 最外面的一層就是我們使用的 ILogger<> 實現。它是由 IServiceProvider 直接創建的。

• 第二層是 LoggerFactory 創建的 Logger，它是一個組合 Logger。

• 第三層是由 ILoggerProvider 實現創建的負責具體記錄日志的 ILogger 實現。這些 Logger 都會添加到第二層的組合 Logger 中。

而后，在日志記錄時，正是按照這三層結構進行任務分發的。

介入日志功能的幾個入口

在了解上述結構之后不難使用我們的具體實現替換默認的 .NET 日志記錄結構。首先在使用上 ASP.NET Core 上使用的日志記錄接口有兩種，第一種即 ILoggerFactory，進而創建 ILogger。例如 這里。而另外一種則是直接使用 ILogger<>。因此我們的介入點有兩個：

• 直接替換 ILoggerFactory 的實現，這樣可以完全定義自己的 Logger -> Sink 結構和過濾邏輯；但工作量較大。

• 實現 ILoggerProvider，并將其添加到 IServiceCollection 中。這樣可以復用現有的日志邏輯。

很多第三方日志庫就是有選擇的采用了上述一種或者兩種方式。例如，以 Serilog 為例，它支持上述兩種接口：

首先、我們可以使用 webHostBuilder.UseSerilog(...) 的方式將其納入應用程序中。而這種方式使用第一種介入方法。具體代碼請看：https://github.com/serilog/serilog-aspnetcore/blob/dev/src/Serilog.AspNetCore/SerilogWebHostBuilderExtensions.cs。

其次、我們可以使用 loggerBuilder.AddSerilog(...) 的方式將其納入應用程序中。而這種方式使用第二種介入方法。具體代碼請看：https://github.com/serilog/serilog-extensions-logging/blob/dev/src/Serilog.Extensions.Logging/SerilogLoggingBuilderExtensions.cs。

總結

日志記錄有很多可以思考的地方，今天我們只關注 ASP.NET Core 中日志介入的入口。總結起來有兩個主要入口：

• 第一、直接替換 ILoggerFactory 實現；

• 第二、實現具體的 ILoggerProvider 并將其添加到 IServiceCollection 中。

如果您覺得本文對您有幫助，也歡迎分享給其他的人。我們一起進步。歡迎關注我的博客（https://clrdaily.com）和微信公眾號：

總結

以上是生活随笔為你收集整理的ASP.NET Core 沉思录 - Logging 的两种介入方法的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。