這是在ASP.NET Core 3.X中使用Serilog.AspNetCore系列文章的第二篇文章：。
- 第1部分-使用Serilog RequestLogging減少日志詳細程度
- 第2部分-使用Serilog記錄所選的終結點屬性（本文）
- 第3部分-使用Serilog.AspNetCore記錄MVC屬性
- 第4部分-從Serilog請求日志記錄中排除健康檢查端點
作者：依樂祝
在我的上一篇文章中，我描述了如何配置Serilog的RequestLogging中間件為每個請求創建“摘要”日志，以替換默認情況下從ASP.NET Core獲取的10個或更多日志。
在本文中，我將展示如何向Serilog的摘要請求日志中添加其他元數據，例如請求的主機名，響應的內容類型或從ASP.NET Core 3.0中使用的終結點路由中間件所選擇的端點名稱。
ASP.NET Core基礎結構日志很詳細，但是默認情況下具有太多詳細信息
正如我在上一篇文章(https://andrewlock.net/using-serilog-aspnetcore-in-asp-net-core-3-reducing-log-verbosity/)中所展示的那樣，在開發環境中，ASP.NET Core基礎架構將為每一個RazorPage處理程序生成10條日志消息：
通過安裝了Serilog.AspNetCore的 NuGet包后並引入RequestLoggingMiddleware之后，可以將其精簡為一條日志消息：
本文中使用的所有日志圖片均來自一款優秀的為結構化日志提供可視化界面的工具-Seq
顯然，原始的日志集更加冗長，並且其中大部分不是特別有用的信息。但是，如果您將原始的10條日志作為一個整體來看，則與Serilog摘要日志相比，它們確實會在結構日志模板中記錄一些其他屬性。
由ASP.NET Core基礎結構記錄的而Serilog 未記錄的擴展內容包括（下面這些還是英文的看着順眼）：
- Host (
localhost:5001) - Scheme (
https) - Protocol (
HTTP/2) - QueryString (
test=true) - EndpointName (
/Index) - HandlerName (
OnGet/SerilogRequestLogging.Pages.IndexModel.OnGet) - ActionId (
1fbc88fa-42db-424f-b32b-c2d0994463f1) - ActionName (
/Index) - RouteData (
{page = "/Index"}) - ValidationState (
True/False) - ActionResult (
PageResult) - ContentType (
text/html; charset=utf-8)
我認為如果要把上述屬性中的其中一些包含在摘要日志消息中，將非常有用。例如，如果您的應用程序綁定到多個主機名，那么Host絕對是重要的日志。QueryString可能是另一個有用的字段。EndpointName/ HandlerName，ActionId並且ActionName似乎不那么重要，因為您應該能夠推斷出給定的請求路徑，但是顯式記錄它們將幫助您更加方便的捕獲錯誤，並使過濾針對特定操作的所有請求變得更加容易。
概括地說，您可以將這些屬性分為兩類：
- 請求/響應特性：如
Host，Scheme，ContentType，QueryString，EndpointName - MVC / RazorPages相關的屬性：如
HandlerName，ActionId，ActionResult等
在這篇文章中，我將展示如何添加這些類別中的第一種，即與請求/響應相關的屬性，在下一篇文章中，我將展示如何添加基於MVC / RazorPages的屬性。
向Serilog請求日志添加擴展數據
在上一篇文章中，我展示了如何將Serilog請求日志記錄添加到您的應用程序中，因此在此不再贅述。現在，我假設您已經進行了設置，並且您擁有一個包含以下內容的Startup.Configure方法：
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
// ... Error handling/HTTPS middleware
app.UseStaticFiles();
app.UseSerilogRequestLogging(); // <-- Add this line
app.UseRouting();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
endpoints.MapRazorPages();
});
}
該UseSerilogRequestLogging()擴展方法將Serilog RequestLoggingMiddleware添加到請求管道中。您還可以通過調用重載來配置RequestLoggingOptions的實例。此類具有幾個屬性，可以讓您自定義請求記錄器如何生成日志語句：
public class RequestLoggingOptions
{
public string MessageTemplate { get; set; }
public Func<HttpContext, double, Exception, LogEventLevel> GetLevel { get; set; }
public Action<IDiagnosticContext, HttpContext> EnrichDiagnosticContext { get; set; }
}
該MessageTemplate屬性控制將日志呈現為的字符串格式，GetLevel允許您控制給定日志索要記錄的級別，如 Debug/ Info/ Warning等。這里我們所關心的是EnrichDiagnosticContext屬性。
設置了該屬性的Action<>之后，在生成日志消息時它將被Serilog中間件調用並執行。它在日志寫入之前運行，這意味着它在中間件管道執行之后運行。例如，在下圖中（取自我的書《 ASP.NET Core in Action》），當響應“回傳”到中間件管道時，在第5步寫入日志：
在管道處理之后寫入日志這一事實意味着兩件事：
- 我們可以訪問Response的屬性，例如狀態碼，經過的時間或內容類型
- 我們可以訪問在管道后面設置的中間件的功能，例如，由
EndpointRoutingMiddleware（通過UseRouting()添加的）設置的功能：IEndpointFeature
在下一部分中，我將提供一個幫助程序功能，該功能會將所有“缺少”屬性添加到Serilog請求日志消息中。
在IDiagnosticContext中設置擴展值
Serilog.AspNetCore會將接口IDiagnosticContext作為單例添加到DI容器中，因此您可以從任何類中訪問它。然后，您可以調用Set()方法，將其他屬性附加到請求日志消息中。
例如，如文檔所示，您可以從操作方法中添加任意值：
public class HomeController : Controller
{
readonly IDiagnosticContext _diagnosticContext;
public HomeController(IDiagnosticContext diagnosticContext)
{
_diagnosticContext = diagnosticContext;
}
public IActionResult Index()
{
// The request completion event will carry this property
_diagnosticContext.Set("CatalogLoadTime", 1423);
return View();
}
}
然后，結果摘要日志將包含屬性CatalogLoadTime。
RequestLoggingOptions通過設置所提供IDiagnosticContext實例的值，我們基本上使用完全相同的方法來定制中間件所使用的方法。下面的靜態幫助器類從當前HttpContext上下文檢索值，並在值可用時對其進行設置。
下面的靜態helper類從當前HttpContext檢索值，並在值可用時設置它們。
public static class LogHelper
{
public static void EnrichFromRequest(IDiagnosticContext diagnosticContext, HttpContext httpContext)
{
var request = httpContext.Request;
// Set all the common properties available for every request
diagnosticContext.Set("Host", request.Host);
diagnosticContext.Set("Protocol", request.Protocol);
diagnosticContext.Set("Scheme", request.Scheme);
// Only set it if available. You're not sending sensitive data in a querystring right?!
if(request.QueryString.HasValue)
{
diagnosticContext.Set("QueryString", request.QueryString.Value);
}
// Set the content-type of the Response at this point
diagnosticContext.Set("ContentType", httpContext.Response.ContentType);
// Retrieve the IEndpointFeature selected for the request
var endpoint = httpContext.GetEndpoint();
if (endpoint is object) // endpoint != null
{
diagnosticContext.Set("EndpointName", endpoint.DisplayName);
}
}
}
上面的幫助器函數從“Request”，“Response”以及其他中間件（端點名稱）設置的功能中檢索值。您可以擴展它，以根據需要在請求中添加其他值。
您可以在你的Startup.Configure()方法中通過調用UseSerilogRequestLogging的EnrichDiagnosticContext屬性，來注冊上面的幫助類：
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
// ... Other middleware
app.UseSerilogRequestLogging(opts
=> opts.EnrichDiagnosticContext = LogHelper.EnrichFromRequest);
// ... Other middleware
}
現在，當您發出請求時，您將看到添加到Serilog結構化日志中的所有其他屬性：
只要您具有通過當前HttpContext可供中間件管道使用的值，就可以使用此方法。但是MVC的相關屬性是個例外，它們是MVC中間件“內部”的特性，例如action 名稱或RazorPage處理程序名稱。在下一篇文章中，我將展示如何將它們添加到Serilog請求日志中。
總結
默認情況下，用Serilog的請求日志記錄中間件替換ASP.NET Core基礎結構日志記錄時，與開發環境的默認日志記錄配置相比，您會丟失一些信息。在本文中，我展示了如何通過自定義Serilog RequestLoggingOptions來添加這些附加屬性。
這樣的做法非常簡單-您可以訪問HttpContext，因此你可以檢索它包含的任何可用的值，並將它們設置為IDiagnosticContext所提供的屬性。這些屬性將作為附加屬性添加到Serilog生成的結構化日志中。在下一篇文章中，我將展示如何將MVC特定的屬性值添加到請求日志中。敬請期待吧！