?譯者 | 李睿
審校 | 孫淑娟
開發(fā)人員可以利用ASP.NET Core 6中的跟蹤偵聽器為其應用程序添加性能和調(diào)試工具。
在處理使用ASP.NET Core 6構建的應用程序時，開發(fā)人員可能經(jīng)常希望使用跟蹤和日志記錄來監(jiān)控應用程序的性能并診斷錯誤，還可以在生產(chǎn)環(huán)境中使用跟蹤來衡量應用程序在運行時的執(zhí)行情況。
本文討論如何在ASP.NET Core 6使用跟蹤偵聽器，研究如何使用跟蹤偵聽器收集跟蹤消息，并使用ILogger將跟蹤輸出定向??到事件日志。
要使用本文中提供的代碼示例，應該在系統(tǒng)中安裝Visual Studio 2022。
在Visual Studio 2022中創(chuàng)建ASP.NET Core Web API項目
首先，在Visual Studio 2022中創(chuàng)建一個ASP.NET Core項目。按照以下步驟將在Visual Studio 2022中創(chuàng)建一個新的ASP.NET Core 6 Web API項目：
（1）啟動Visual Studio 2022 IDE。
（2）點擊“創(chuàng)建新項目”。
（3）在“創(chuàng)建新項目”窗口中，從顯示的模板列表中選擇“ASP.NET Core Web API”。
（4）單擊“下一步”。
（5）在“配置新項目”窗口中，指定新項目的名稱和位置。
（6）根據(jù)偏好，可以選擇選中“將解決方案和項目放在同一目錄中”復選框。
（7）單擊“下一步”。
（8）在接下來顯示的“附加信息”窗口中，確保選中“使用控制器...”復選框，因為在這示例中不會使用最少的API。將“身份驗證類型”保留為“無”（默認）。
（9）確保未選中“啟用Docker”、“為HTTPS配置”和“啟用開放API支持”復選框，因為不會在此處使用任何這些功能。
（10）單擊創(chuàng)建。
在本文中，將使用這個ASP.NET Core 6 Web API項目來處理跟蹤偵聽器。
什么是跟蹤？
與跟蹤主要事件的事件日志相比，跟蹤允許更完整地查看正在運行的應用程序及其組件。日志包含結構化或非結構化時間戳數(shù)據(jù)，這些數(shù)據(jù)顯示應用程序中發(fā)生的事件的記錄。跟蹤提供了對單個請求及其處理方式的更多可見性。
System.Diagnostics命名空間包含跟蹤類和調(diào)試類。跟蹤類用于生產(chǎn)環(huán)境，而調(diào)試類用于開發(fā)時。
跟蹤通常涉及以下三個階段：
- 檢測：編寫必要的代碼來捕獲相關信息。
- 跟蹤：將跟蹤消息寫入指定的目標，即事件日志、文本文件、數(shù)據(jù)庫表等。
- 分析：分析從跟蹤中收集的信息以確定應用程序中的瓶頸。
什么是跟蹤偵聽器？為什么需要它們？
跟蹤偵聽器收集跟蹤消息、存儲它們，并將它們定向到適當?shù)哪繕耍缥谋疚募?NET提供了幾個跟蹤偵聽器，其中包括：
- ConsoleTraceListener——將跟蹤消息發(fā)送到控制臺窗口。
- DefaultTraceListener——將跟蹤消息發(fā)送到標準調(diào)試輸出。
- DelimitedListTraceListener——以分隔格式將跟蹤輸出發(fā)送到流、流編寫器或文本編寫器。
- EventLogTraceListener——將跟蹤消息發(fā)送到事件日志。
- TextWriterTraceListener——將跟蹤消息發(fā)送到文本文件。
- XmlWriterTraceListener——將跟蹤消息轉(zhuǎn)換為XML。
System.Diagnostics.Debug和System.Diagnostics.Trace類可以將消息發(fā)送到跟蹤偵聽器，這些偵聽器又將消息路由到適當?shù)哪繕恕?/p>
在ASP.NET Core 6中使用配置文件創(chuàng)建跟蹤偵聽器
開發(fā)人員可以使用配置文件或編寫自定義代碼來創(chuàng)建跟蹤偵聽器。下面顯示的代碼片段說明了如何使用應用程序配置文件創(chuàng)建跟蹤偵聽器。
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="MyFirstListener"
type="System.Diagnostics.TextWriterTraceListener"
initializeData="TraceOutput.txt" />
<remove name="Default" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
添加到Listeners集合的所有偵聽器都將接收跟蹤輸出。但是，可以使用偵聽器而不將其添加到偵聽器集合中。在這種情況下，使用偵聽器中的Write或WriteLine方法發(fā)送輸出。
以下的代碼演示了一個偵聽器，該偵聽器未添加到偵聽器集合，但仍能夠?qū)⒏櫹l(fā)送到輸出窗口、文件或任何預配置的輸出。
TextWriterTraceListener myFirstListener = new
TextWriterTraceListener("Output.txt", "myFirstListener");
myFirstListener.WriteLine("This is a test message.");
myFirstListener.Flush();
在ASP.NET Core 6中創(chuàng)建自定義跟蹤偵聽器
在大多數(shù)情況下，.NET 6附帶的跟蹤偵聽器將滿足要求。但是，如果開發(fā)人員想將跟蹤消息輸出到不同的目的地，可以實現(xiàn)自己的跟蹤偵聽器。
要構建自定義跟蹤偵聽器，應該創(chuàng)建一個擴展TraceListener抽象類的類。TraceListener類中有幾個虛擬和抽象方法。開發(fā)人員至少應該實現(xiàn)Write和WriteLine方法。自定義跟蹤偵聽器如下所示：
public class CustomTraceListener : TraceListener
{
public CustomTraceListener(ILoggerFactory loggerFactory)
{
}
public override void Write(string? message, string? category)
{
}
public override void Write(string? message)
{
}
public override void WriteLine(string? message)
{
}
}
因此，自定義跟蹤偵聽器類必須具有參數(shù)構造函數(shù)以及Write和WriteLine方法。
開發(fā)人員還需要一個表示記錄器的ILogger實例、一個創(chuàng)建記錄器的ILoggerFactory和一個StringBuilder來存儲跟蹤消息，然后再將它們發(fā)送到日志目標。
private readonly ILoggerFactory _loggerFactory;
private readonly ILogger _iLogger;
private readonly StringBuilder _stringBuilder = new();
開發(fā)人員可以利用依賴注入在構造函數(shù)中注入ILoggerFactory的實例，然后使用該實例創(chuàng)建ILogger的實例。
public CustomTraceListener(ILoggerFactory loggerFactory)
{
_loggerFactory = loggerFactory;
_iLogger = loggerFactory.CreateLogger(nameof(CustomTraceListener));
}
下面是Write和WriteLine方法的最小實現(xiàn)：
public override void Write(string? message, string? category)
{
_stringBuilder.Append(message + "-" + category);
}
public override void Write(string? message)
{
_stringBuilder.Append(message);
}
public override void WriteLine(string? message)
{
_stringBuilder.AppendLine(message);
_iLogger.LogInformation(_stringBuilder.ToString());
_stringBuilder.Clear();
}
ASP.NET Core 6中完整的自定義跟蹤偵聽器示例
以下是自定義跟蹤偵聽器的最小實現(xiàn)的完整源代碼，以供參考。
using System.Collections.Concurrent;
using System.Diagnostics;
using System.Text;
namespace TraceListenerDemo
{
public class CustomTraceListener : TraceListener
{
private readonly ILoggerFactory _loggerFactory;
private readonly ILogger _iLogger;
private readonly StringBuilder _stringBuilder = new();
public CustomTraceListener(ILoggerFactory loggerFactory)
{
_loggerFactory = loggerFactory;
_iLogger =
loggerFactory.CreateLogger(nameof(CustomTraceListener));
}
public override void Write(string? message, string? category)
{
_stringBuilder.Append(message + "-" + category);
}
public override void Write(string? message)
{
_stringBuilder.Append(message);
}
public override void WriteLine(string? message)
{
_stringBuilder.AppendLine(message);
_iLogger.LogInformation(_stringBuilder.ToString());
_stringBuilder.Clear();
}
}
}
在Program.cs文件中注冊自定義跟蹤偵聽器
要使用自定義跟蹤偵聽器，應該使用以下代碼將其注冊到Listeners集合。
var loggerFactory = app.Services.GetRequiredService<ILoggerFactory>();
Trace.Listeners.Add(new LoggerTraceListener(loggerFactory));
因為自定義跟蹤偵聽器已經(jīng)添加到偵聽器集合中，所以它將捕獲運行時生成的所有跟蹤消息，并將輸出發(fā)送到記錄器。它還將發(fā)送在應用程序中顯式發(fā)送的任何跟蹤消息（就像在前面的myFirstListener示例中所做的那樣）。
因此，添加到Listeners集合的任何偵聽器都可以捕獲運行時生成的跟蹤以及在應用程序中顯式發(fā)送的任何跟蹤消息。但是，如果未將跟蹤偵聽器添加到集合中，則它只能發(fā)送在應用程序中顯式發(fā)送的跟蹤消息。它不會捕獲運行時生成的任何跟蹤消息。
使用自定義跟蹤偵聽器時，必須記住關閉或刷新跟蹤偵聽器以確保清空輸出緩沖區(qū)。可以利用StringBuilderCache類來優(yōu)化使用StringBuilder的代碼（在CustomTraceListener類中）。
原文標題：??How to work with trace listeners in ASP.NET Core 6???，作者：Joydip Kanjilal?
